From e37f8d8b477143660887da5bee40907f68b6552f Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 3 Nov 2026 11:14:26 +0800 Subject: [PATCH 1/5] i18n: sync zh/ja/ko Router pages with upstream/main (2026-11-03) --- ja/development/comfy-router/api.mdx | 5 +- ja/development/comfy-router/limitations.mdx | 17 +- .../dreamina-seedance-2-0-260128/code.mdx | 148 +++--- .../code.mdx | 150 +++--- .../dreamina-seedance-2-0-mini/code.mdx | 133 +++--- .../dreamina-seedance-2-5-260628/code.mdx | 122 +++-- .../byteplus/seedance-1-0-pro-250528/code.mdx | 179 +++----- .../seedance-1-0-pro-fast-251015/code.mdx | 121 ++--- .../byteplus/seedance-1-5-pro-251215/code.mdx | 141 +++--- .../models/kling/kling-3-0-turbo/code.mdx | 81 ++-- .../models/kling/kling-image-o1/code.mdx | 11 +- .../models/kling/kling-v2-5-turbo/code.mdx | 91 ++-- .../models/kling/kling-v2-6/code.mdx | 85 ++-- .../models/kling/kling-v3-omni/code.mdx | 81 ++-- .../models/kling/kling-v3/code.mdx | 87 ++-- .../models/kling/kling-video-o1/code.mdx | 81 ++-- .../kling/videos-avatar-image2video/code.mdx | 9 +- .../models/kling/videos-lip-sync/code.mdx | 11 +- .../models/runway/gen4-image/code.mdx | 9 +- .../xai/grok-imagine-image-2-0/code.mdx | 9 +- .../xai/grok-imagine-image-pro/code.mdx | 9 +- .../xai/grok-imagine-image-quality/code.mdx | 9 +- .../models/xai/grok-imagine-image/code.mdx | 9 +- ja/development/comfy-router/realtime.mdx | 223 +++++++++ ja/development/comfy-router/reference.mdx | 432 +++++++++--------- ko/development/comfy-router/api.mdx | 5 +- ko/development/comfy-router/limitations.mdx | 15 +- ko/development/comfy-router/realtime.mdx | 223 +++++++++ zh/development/comfy-router/api.mdx | 5 +- zh/development/comfy-router/limitations.mdx | 15 +- .../dreamina-seedance-2-0-260128/code.mdx | 126 ++--- .../code.mdx | 136 +++--- .../dreamina-seedance-2-0-mini/code.mdx | 153 ++++--- .../dreamina-seedance-2-5-260628/code.mdx | 147 +++--- .../byteplus/seedance-1-0-pro-250528/code.mdx | 145 +++--- .../seedance-1-0-pro-fast-251015/code.mdx | 155 +++---- .../byteplus/seedance-1-5-pro-251215/code.mdx | 129 +++--- .../models/kling/kling-3-0-turbo/code.mdx | 89 ++-- .../models/kling/kling-image-o1/code.mdx | 13 +- .../models/kling/kling-v2-5-turbo/code.mdx | 73 +-- .../models/kling/kling-v2-6/code.mdx | 59 +-- .../models/kling/kling-v3-omni/code.mdx | 67 +-- .../models/kling/kling-v3/code.mdx | 51 ++- .../models/kling/kling-video-o1/code.mdx | 69 +-- .../kling/videos-avatar-image2video/code.mdx | 11 +- .../models/kling/videos-lip-sync/code.mdx | 11 +- .../models/runway/gen4-image/code.mdx | 7 +- .../xai/grok-imagine-image-2-0/code.mdx | 11 +- .../xai/grok-imagine-image-pro/code.mdx | 11 +- .../xai/grok-imagine-image-quality/code.mdx | 11 +- .../models/xai/grok-imagine-image/code.mdx | 9 +- zh/development/comfy-router/realtime.mdx | 223 +++++++++ zh/development/comfy-router/reference.mdx | 382 ++++++++-------- 53 files changed, 2643 insertions(+), 1961 deletions(-) create mode 100644 ja/development/comfy-router/realtime.mdx create mode 100644 ko/development/comfy-router/realtime.mdx create mode 100644 zh/development/comfy-router/realtime.mdx diff --git a/ja/development/comfy-router/api.mdx b/ja/development/comfy-router/api.mdx index c6f3fadec0..64274f7267 100644 --- a/ja/development/comfy-router/api.mdx +++ b/ja/development/comfy-router/api.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API の概要" sidebarTitle: "概要" description: "Comfy Router API の仕組み: モデル ID ごとに 1 つのルート。検出、スキーマ、キュー中のリクエスト、エラー、課金に関するガイドを用意しています。" -translationSourceHash: dac7e853 +translationSourceHash: cb493feb translationFrom: development/comfy-router/api.mdx --- @@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx - [クイックスタート](/ja/development/comfy-router/quickstart): インストール、呼び出し、画像の保存。 - [モデル](/ja/development/comfy-router/models): カタログをブラウズし、モデル固有のリクエスト例を確認します。 - [ヘッダー](/ja/development/comfy-router/headers): 認証、冪等性、リクエスト ID、リトライのペース配分。 -- [API リファレンス](/ja/development/comfy-router/reference): エンドポイントのパラメータ、スキーマ、レスポンスコード。 \ No newline at end of file +- [API リファレンス](/ja/development/comfy-router/reference): エンドポイントのパラメータ、スキーマ、レスポンスコード。 +- [リアルタイム音声](/ja/development/comfy-router/realtime): Grok Voice WebSocket セッションを開きます。課金は秒単位で行われます。 \ No newline at end of file diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index e251530d59..c023005423 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: 235802c5 +translationSourceHash: b4d8209c translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": cf6e2050 - "Models without a pre-flight estimate": 495bdb2b + "Models without a pre-flight estimate": f6dfd921 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -28,6 +28,7 @@ translationBlockHashes: + Router はパートナーモデルを、1回の同期 HTTP 呼び出し、または送信して後で結果を取得するキュー中のリクエストを通じて実行します。アプリケーションが完了した結果を待つことができ、あるいは後で結果を取得でき、さらにモデル自身の入力フィールドと出力フィールドを処理できる場合に使用します。 ## Router がサポートするもの @@ -109,28 +110,24 @@ Router は最終レスポンスのみを返し、ストリーミングされる ## 事前見積もりのないモデル -Router は、以下のモデルへの呼び出しを実行前に確実に価格算出することがまだできません。そのため、これらのモデルについては `/estimate` およびキュー中の送信の `estimate` が `source: unknown` を返します。ただし、特定のリクエストボディに対して数値を返す場合もあります。`unknown` は数値が提示されなかったことを意味し、実行が無料であることを意味するものではありません。[Comfy の課金と使用量](#comfy-の課金と使用量) のルールは引き続き適用されます。自身のプロバイダーキーでの実行は Comfy から課金されず、`X-Comfy-Credits-Used` は任意であるため、ヘッダーが不足している場合はコストが報告されなかったことを意味します。ここに記載されていないモデルでも、特定のリクエストボディに対して `unknown` を返すことがあるため、すべての見積もりで `source` を確認してください。 +Router は、以下のモデルへの呼び出しを実行前に確実に価格算出することがまだできません。そのため、これらのモデルについては `/estimate` およびキュー中の送信の `estimate` が `source: unknown` を返します。ただし、特定のリクエストボディに対しては数値を返す場合もあります。`unknown` は数値が提示されなかったことを意味し、実行が無料であることを意味するものではありません。[Comfy の課金と使用量](#comfy-charges-and-usage) のルールは引き続き適用されます。自身のプロバイダーキーでの実行は Comfy から課金されず、`X-Comfy-Credits-Used` は任意であるため、ヘッダーが不足している場合はコストが報告されなかったことを意味します。ここに記載されていないモデルでも、特定のリクエストボディに対して `unknown` を返すことがあるため、すべての見積もりで `source` を確認してください。 このリストは見積もりカバレッジの拡大に伴い縮小していきます。これは Router 自身の価格算出コードから生成されており、公開されていないモデルは決して掲載されません。 {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} - **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` -- **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **fal**: `fal/crystal-upscaler`, `fal/crystal-video-upscaler`, `fal/fal-gpt-image-2`, `fal/fal-gpt-image-2.5-flare`, `fal/fal-gpt-image-2.5-sunburst`, `fal/fal-nano-banana-2`, `fal/fal-nano-banana-pro`, `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`, `fal/flux-3-max`, `fal/patina` +- **fal**: `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5` - **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`, `ideogram/p-image-ideogram` -- **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` -- **luma**: `luma/photon-1`, `luma/photon-flash-1` -- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` +- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` +- **kling**: `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` - **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` - **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/clean-audio`, `veed/clean-audio-video`, `veed/fabric-1.0`, `veed/lipsync-2.0`, `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 */} 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 3a23417044..307173d070 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: 9604ca27 +translationSourceHash: 70ec471f translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 6c5da06a + "Schema": 8c0478c9 "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、Base64 エンコーディング、またはアセット ID。 +オーディオ URL: オーディオの公開 URL(wav、mp3)。 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 を再利用します。これらを再度送信しないでください。解像度はデフォルトで 1080p となり、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,44 @@ 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,67 +287,68 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ ビデオ URL またはアセット ID。 -ビデオ URL: ビデオ(mp4、mov)の公開 URL。 +ビデオ URL: ビデオの公開 URL(mp4、mov)。 アセット ID: 形式 asset://\ - Seedance 2.5 のみ。480p のドラフトビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。ドラフトタスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1 (自動)。 - 範囲: `2` から `30` + 指定可能な値: `-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 でサポートされています。生成されるビデオに映像と同期したオーディオが含まれるかどうか。 -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 の最初のフレーム / 最初と最後のフレームからの生成: 出力は最初のフレームのアスペクト比に従うため、`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 をサポートします。 - 取り得る値: `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` @@ -346,45 +356,45 @@ false: 生成されたビデオの最終フレーム画像を返しません。 処理のサービスティア。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 自身のものです。Nullable: 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 時間しかないものが返る可能性があります。再ホストを実行できなかった場合は、このフィールドは 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キーなど)では含まれず、生成から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 を保存するのではなくビデオをダウンロードしてください。 @@ -392,7 +402,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 生成されたビデオの再生時間(秒)。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す一方、BytePlus の関連サーフェスでは小数の再生時間が報告されることが観測されており、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 + 生成されたビデオの再生時間(秒)です。BytePlus がこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数の秒を返すことや、同系列の BytePlus の画面が小数の再生時間を報告することが観察されているため、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 @@ -400,31 +410,27 @@ 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 - - - + タスクで使用されたモデルの名前とバージョン - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedanceのビデオタスククエリはここでこの値を返します。BytePlus独自のフィールドで、変更されずにそのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。 - 生成済みビデオの解像度(例: `1080p`)。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -436,7 +442,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - タスクが最後に更新された時間。値はUNIXタイムスタンプ(秒単位)です。 + タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒単位)です。 @@ -448,7 +454,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 b33007d441..9f23f3146c 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: b02c6ed1 +translationSourceHash: 8036f4db translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": e03c503a + "Schema": 90b60b2e "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"; @@ -177,12 +178,12 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ -## スキーマ +## Schema ### 入力 - 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりにタスクステータスのルートをポーリングして結果を取得してください。 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりに結果を取得するにはタスクステータスのルートをポーリングしてください。 形式: `uri` @@ -192,19 +193,19 @@ 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 のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。これは唯一のコンテンツ項目でなければなりません。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を引き継ぎます。これらを再度送信しないでください。解像度のデフォルトは 1080p のみをサポートします。 @@ -216,117 +217,119 @@ 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 自身のバリデータが応答します。 -実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトがこれによって -判定されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 +文字数(バイト数ではない)でカウントするため、マルチバイトのプロンプトは +送信時にこのサイズの数倍になる可能性があります。これはこの 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://\ +アセット ID: 形式は asset://\ - Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 返されたタスク ID を `draft_task` コンテンツ項目に渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 - 範囲: `2` から `30` + 指定可能な値: `-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)。色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 +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 をサポートします。 指定可能な値: `480p`、`720p`、`1080p`、`4k` - 生成されたビデオの最後のフレーム画像を返すかどうか。 -true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会する呼び出しによって最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用し、複数の連続したビデオを迅速に生成できます。 -false: 生成されたビデオの最後のフレーム画像を返しません。 + 生成されたビデオの最終フレーム画像を返すかどうか。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報を照会する呼び出しによって最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオを素早く生成できます。 +false: 生成されたビデオの最終フレーム画像を返しません。 @@ -336,7 +339,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません - 処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 + 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex (オフライン推論) をサポートしません。 指定可能な値: `default`、`flex` @@ -345,46 +348,46 @@ false: 生成されたビデオの最後のフレーム画像を返しません 生成されたビデオにウォーターマークを含めるかどうか。 -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 が配信するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 - ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード 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 時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは 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 です。`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 をクリアすると存在しなくなります。これは署名付きオブジェクトストレージ 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,15 +395,14 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.js - 上流の 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 @@ -408,15 +410,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 +426,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 +442,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 1fc770ca00..bc71e43744 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: 28c5c053 +translationSourceHash: a1d75c67 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 3c26a330 + "Schema": ebf1fc3a "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 タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。解像度のデフォルトは 1080p で、1080p のみをサポートします。 - Draft ビデオを `draft` を true に設定して作成したときに返されたタスク ID。 + `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 @@ -217,9 +218,9 @@ Base64: 形式 data:audio/\;base64,\ 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) -画像URL: 画像URLにアクセス可能であることを確認してください。 -Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります -アセット ID: 形式 asset://\ +画像 URL: 画像 URL にアクセスできることを確認してください。 +Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります。 +アセット ID: 形式は asset://\ @@ -228,7 +229,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` @@ -236,7 +237,7 @@ 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) @@ -249,90 +250,91 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を -受け付けました。バイト数ではなく文字数をカウントするため、マルチバイトの -プロンプトは通信時にこのサイズの数倍になることがあります。これはこの 1 つの +受け付けました。カウント対象はバイト数ではなく文字数であるため、マルチバイトの +プロンプトは通信時にこの数倍のサイズになることがあります。これはこの 1 つの フィールドを制限するものであり、リクエスト全体を制限するものではありません: `content` は配列であり、ドキュメント全体を制限するのはリクエストごとの ボディ上限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model}) -であり、v1 /proxy への直接呼び出しでは BytePlus 自身のバリデータが代わりに -応答します。実際のトラフィックよりはるかに高く設定されているため、正規の -プロンプトがこれによって判断されることはありません。呼び出し元がより多くを -必要とする場合は引き上げてください。 +であり、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 日間有効です。 +返されたタスク ID を `draft_task` コンテンツ項目に渡すと、最終的な 1080p ビデオをレンダリングできます。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 プロ: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 - 範囲: `2` 〜 `30` + 指定可能な値: `-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` + 指定可能な値: `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 をサポートします。 - 指定可能な値: `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` @@ -340,69 +342,68 @@ false: 生成されたビデオの最終フレーム画像を返しません。 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`, `flex` + 指定可能な値: `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 が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に 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を保存するのではなくフレームをダウンロードしてください。 - 生成済みビデオのコンテナ形式(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時間しかない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の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 エラーメッセージ - - ビデオ生成タスクのID +The ID of the video generation task @@ -410,15 +411,15 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 - 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -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 32aea062d4..311f748975 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: 07fd9c64 +translationSourceHash: 3606fb83 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0a76af44 + "Schema": d2c28a84 "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、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 を再利用します。これらを再度送信しないでください。解像度はデフォルトで 1080p になり、1080p のみをサポートします。 - Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。 + `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 @@ -231,7 +232,7 @@ Base64: 形式 data:audio/\;base64,\ 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) 画像 URL: 画像 URL にアクセスできることを確認してください。 -Base64 エンコーディングされたコンテンツ: 形式は data:image/\;base64,\ である必要があります +Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります アセット ID: 形式 asset://\ @@ -241,44 +242,36 @@ Base64 エンコーディングされたコンテンツ: 形式は data: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) +- --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 のみがサポートします。 @@ -292,10 +285,10 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ 返されたタスク ID を `draft_task` コンテンツ項目で渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動)。 - 範囲: `2` から `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` @@ -305,40 +298,41 @@ Comfy 側のガードレールであり、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` を継承するため、代わりに `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 をサポートします。 指定可能な値: `480p`, `720p`, `1080p`, `4k` 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報をクエリする呼び出しで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオを素早く生成できます。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報の照会を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用できるため、複数の連続したビデオをすばやく生成できます。 false: 生成されたビデオの最終フレーム画像を返しません。 @@ -349,71 +343,71 @@ 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-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 自身のものです。null 許容: 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時間程度のものが返されることがあります。再ホストを実行できなかった場合は、代わりに 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の寿命)を加えた時刻のいずれか早い方です。`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 などです。これは 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の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 エラーメッセージ - - ビデオ生成タスクの ID + + ビデオ生成タスクのID @@ -421,15 +415,15 @@ 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 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 形式: `int64` @@ -441,7 +435,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 + タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒単位)です。 @@ -453,7 +447,7 @@ 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 89d9be1b9f..94ef7a5347 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: 450bbe6e +translationSourceHash: 642f85ab translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": fc979e05 + "Schema": b57b84de "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 を再利用します。これらを再度送信しないでください。解像度はデフォルトで 1080p となり、1080p のみをサポートします。 - `draft` を true に設定してドラフトビデオを作成したときに返されるタスクID。 + `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 @@ -216,15 +217,15 @@ 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 のみ)。 @@ -234,28 +235,20 @@ Base64エンコードされたコンテンツ: 形式は data:image/\;ba モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 +テキストプロンプト(必須): 生成するビデオの説明を中国語と英語の文字で記述します。 -パラメータ(任意): テキストプロンプトの後に --[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` は配列であり、ドキュメント全体を制限するのはリクエストごとの body 制限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})です。直接の v1 /proxy 呼び出しでは、代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックをはるかに上回る値に設定されているため、正当なプロンプトを判定することはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 @@ -265,182 +258,148 @@ 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: ビデオ(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` コンテンツ項目で渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 1.0 pro と 1.0 pro fast: [2,12]。 - 範囲: `2` 〜 `30` + 指定可能な値: `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 のみ。出力ビデオのコンテナ形式。 -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 をサポートしています。 指定可能な値: `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` - 生成されたビデオにウォーターマークを含めるかどうか。 + 生成されたビデオにウォーターマークが含まれるかどうか。 -Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 +Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/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: 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 は存在する方のフィールドを読み取ります。 + 生成されたビデオのコンテナ形式(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の失敗タスク応答の両方でポリシーファミリーを認識しますが、トランスポート層の失敗を上書きすることはありません。 エラーメッセージ - - The ID of the video generation task +The ID of the video generation task - タスクで使用されたモデルの名前とバージョン - - - - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 自身のフィールドで、変更されずにそのまま転送されます。 - - - - 生成済みビデオの解像度。例えば `1080p` です。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - - - - タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - - 形式: `int64` - - - - タスクの状態 - - 取りうる値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - - - - タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 - - - - リクエストのトークン使用量 - - - - モデルによって生成されたトークン数 - - - - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens となります。 + ビデオ生成タスクのID。タスクで使用されたモデルの名前とバージョン。 + + 待って、原文を確認します。 ## 例 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 0d3cd6f3c6..f8da5ea68f 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: 43683424 +translationSourceHash: 61dd0135 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": a882b2d8 + "Schema": dd74b012 "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"; @@ -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://\ +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 を再利用するため、これらを再度送信しないでください。resolution はデフォルトで 1080p となり、1080p のみをサポートします。 @@ -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://\ @@ -228,15 +229,15 @@ 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] を追加してビデオの仕様を制御します: +パラメータ(任意): テキストプロンプトの後に --[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) @@ -248,22 +249,22 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を +テキスト長の上限を公開しておらず、テスト(2026-09-17)では 40,000 文字を 受け付けました。バイト数ではなく文字数をカウントするため、マルチバイトの -プロンプトはワイヤ上でこのサイズの数倍になる可能性があります。これはこの -1 つのフィールドを制限するものであり、リクエスト全体ではありません。 +プロンプトは通信時にこのサイズの数倍になることがあります。これはこの 1 つの +フィールドを制限するものであり、リクエストを制限するものではありません: `content` は配列であり、リクエスト全体のドキュメントを制限するのは -リクエストごとのボディ制限です。これを適用するのは Comfy Router -(/v2/models/byteplus/\{model})であり、v1 /proxy を直接呼び出した場合は +リクエストごとのボディ上限です。これを強制するのは 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` @@ -273,136 +274,136 @@ BytePlus 自身のバリデータが応答します。実際のトラフィッ ビデオ URL またはアセット ID。 ビデオ URL: ビデオの公開 URL(mp4、mov)。 -アセット ID: 形式 asset://\ +アセット ID: 形式は asset://\ - Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 返されたタスク ID を `draft_task` コンテンツ項目に渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 1.0 pro および 1.0 pro fast: [2,12]。 - 範囲: `2` から `30` + 指定可能な値: `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` を継承するため、代わりに `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` - 生成されたビデオの比率。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 をサポートします。 指定可能な値: `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` - 生成されたビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -`GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。 +Generated from the schema Router serves at `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`, the same document it validates a call against before the request reaches the provider. ### 出力 - ビデオ生成タスクが完了した後の出力で、出力ビデオのダウンロード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として文書化しているが、ルーターは提供されたバイト列をそのまま再ホストし、上流のContent-Typeまたはコンテンツスニッフィングから型を判定する。`image/jpeg` は両方が失敗した場合の最後の手段のフォールバックにすぎない。ルーターは最終フレームを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` フィールドを参照)。ルーターは存在する方のフィールドを読み取る。 - 上流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回はルーター自身の再ホストで消費される。 - 出力ビデオのダウンロードURL。RouterはビデオをComfyのストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再送されるため、後のポーリングでは残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりにBytePlus独自のURLを保持し、BytePlusはタスクの24時間後にそれを消去し、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURL。ルーターはビデオを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 のように、ドット区切りの理由が付くことがある。これは列挙型ではなくオープンな文字列であり、他のコードは検証およびプロバイダーの失敗を表す。ルーターはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識するが、トランスポートの失敗を上書きすることはない。 エラーメッセージ - - The ID of the video generation task +ビデオ生成タスクのID @@ -410,15 +411,15 @@ false: 生成されたビデオの最後のフレーム画像を返しません - 生成済みビデオのコンテナ形式 (`mp4` または `mov`)。Seedance のビデオタスククエリが返す場所である、`content` の兄弟としてトップレベルで返されます。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 独自のフィールドで、変更されずに転送されます。 - 生成済みビデオの解像度 (例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 形式: `int64` @@ -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/seedance-1-5-pro-251215/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 7a54185e4e..54e0c430ef 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: 1d016721 +translationSourceHash: 2263b4cf translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 35f3b5dc + "Schema": f4d67fb6 "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,7 +193,7 @@ 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 はオーディオのみの入力をサポートします。 @@ -204,7 +205,7 @@ Base64: 形式 data:audio/\;base64,\ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。resolution のデフォルトは 1080p で、1080p のみをサポートします。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。解像度はデフォルトで 1080p になり、1080p のみをサポートします。 @@ -217,55 +218,56 @@ Base64: 形式 data:audio/\;base64,\ 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 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] を追加して、ビデオの仕様を制御します: +パラメータ(オプション): ビデオの仕様を制御するには、テキストプロンプトの後に --[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 自身のバリデータが代わりに応答します。 -実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトが -これによって判定されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 +テキスト長の制限を公開しておらず、テストでは 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 のみがビデオ入力をサポートします。 @@ -275,58 +277,60 @@ v1 /proxy を直接呼び出した場合は BytePlus 自身のバリデータが - Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で指定して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +最終的な 1080p ビデオをレンダリングするには、返されたタスク ID を `draft_task` コンテンツ項目に渡します。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間(秒)。Seedance 1.5 pro: [4,12] または -1(auto)。 - 範囲: `2` から `30` + 可能な値: `-1`, `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 でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 -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 の呼び出し元は省略します。 + +The ID of the model to call. サポートされているモデル: 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 をサポートします。 - 取り得る値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`, `720p`, `1080p`, `4k` - 生成されたビデオの最後のフレーム画像を返すかどうか。 -true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、「ビデオ生成タスクの情報を照会する」を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用し、複数の連続したビデオをすばやく生成できます。 -false: 生成されたビデオの最後のフレーム画像を返しません。 + 生成済みビデオの最後のフレーム画像を返すかどうか。 +true: 生成済みビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会する API を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル幅と高さは生成済みビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。つまり、前の生成済みビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用でき、複数の連続したビデオを素早く生成できます。 +false: 生成済みビデオの最後のフレーム画像を返しません。 @@ -336,71 +340,70 @@ 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` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるのと同じドキュメントです。 ### 出力 - ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード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時間しかない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キーなど)も同様です。また、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の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 エラーメッセージ - - ビデオ生成タスクのID +The ID of the video generation task @@ -408,15 +411,15 @@ false: 生成されたビデオの最後のフレーム画像を返しません - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてTOP LEVELで返されます。Seedanceのビデオタスククエリがこの位置で返すためです。BytePlus自身のフィールドであり、変更されずに転送されます。 + 生成されたビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドであり、そのまま転送されます。 - 生成済みビデオの解像度(例: `1080p`)。BytePlus自身のフィールドであり、成功したビデオタスクで返され、変更されずに転送されます。 + 生成されたビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、そのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus自身のフィールドであり、成功したビデオタスクで返され、変更されずに転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、そのまま転送されます。 形式: `int64` @@ -424,11 +427,11 @@ false: 生成されたビデオの最後のフレーム画像を返しません タスクの状態 - 取り得る値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 取り得る値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - タスクが最後に更新された時間。値は秒単位のUNIXタイムスタンプです。 + タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒)です。 @@ -440,7 +443,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません - ビデオ生成モデルでは入力トークン数は計算されず、0が既定値です。したがって、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは、入力トークン数は計算されず、0 がデフォルトです。したがって、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx index e387986e28..a707c7f8ca 100644 --- a/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で Kling 3.0 Turbo を使用する" description: "Comfy Router 経由で kling/kling-3.0-turbo を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling 3.0 Turbo" -translationSourceHash: 301a1ee1 +translationSourceHash: d09b3876 translationFrom: development/comfy-router/models/kling/kling-3-0-turbo/code.mdx translationBlockHashes: "_intro": 5a8c5f4b "Quick start": a2145573 "Serving providers": 7ec93d4f - "Schema": 1f5f61c1 - "Examples": 0a9a8bbe + "Schema": 992b8da2 + "Examples": 5ce1484a --- + {/* 生成済みファイル。`pnpm code-pages:gen` によって router-schemas/kling/kling-3.0-turbo.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -181,13 +182,13 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID ビデオのアスペクト比 - 指定可能な値: `16:9`, `9:16`, `1:1` + 指定可能な値: `16:9`、`9:16`、`1:1` - ビデオの長さ(秒) + ビデオの再生時間(秒) - 指定可能な値: `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` @@ -195,11 +196,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - タスク結果のコールバック通知 URL。タスクのステータスが変化したときにサーバーが通知します。 + タスク結果を受け取るためのコールバック通知 URL。タスクのステータスが変化するとサーバーが通知します。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 - カスタムタスク ID。システムが生成したタスク ID を上書きすることはありませんが、クエリに使用できます。1 つのユーザーアカウント内で一意である必要があります。 + カスタムタスク ID。システムが生成したタスク ID は上書きされませんが、クエリに使用できます。単一のユーザーアカウント内で一意である必要があります。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 @@ -207,11 +208,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - true の場合はウォーターマーク付きの結果を生成し、false の場合は生成しません。デフォルトは false。 + true はウォーターマーク付きの結果を生成する、false は生成しないことを意味します。デフォルトは false です。 - ポジティブとネガティブの両方の記述を含めることができるプロンプト。推奨の長さは 2500 文字以下です。マルチショットビデオでは "shot n, m, words; shot n, m, words;" の形式を使用します。 + ポジティブとネガティブの両方の記述を含められるプロンプト。推奨長は 2500 文字以内です。マルチショットビデオでは "shot n, m, words; shot n, m, words;" という形式を使用します。 @@ -219,24 +220,24 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 生成されるフレームのアスペクト比(幅:高さ)。"16:9"、"9:16"、"1:1" のいずれか。デフォルトは "16:9"。 + 生成されるフレームのアスペクト比(幅:高さ)。"16:9"、"9:16"、"1:1" のいずれか。デフォルトは "16:9" です。 - 指定可能な値: `16:9`, `9:16`, `1:1` + 指定可能な値: `16:9`、`9:16`、`1:1` - ビデオの長さ(秒)。対応する値は 3 から 15 です。デフォルトは 5。 + ビデオの再生時間(秒)。3 から 15 の値に対応しています。デフォルトは 5 です。 範囲: `3` から `15` - 生成されるビデオの鮮明さ。"720p" または "1080p" のいずれか。デフォルトは "720p"。 + 生成されるビデオの鮮明さ。"720p" または "1080p" のいずれか。デフォルトは "720p" です。 - 指定可能な値: `720p`, `1080p` + 指定可能な値: `720p`、`1080p` -Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供するスキーマから生成されており、これはリクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。 +`GET /v2/models/kling/kling-3.0-turbo/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するものと同じドキュメントです。 ### 出力 @@ -256,18 +257,30 @@ Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供する 消費量。小数点以下 2 桁まで正確です。 + + 料金の引き落とし元となる現金アカウント(charge_type が "cash" の場合のみ存在)。例: "balance"。タスクによっては返され、省略される場合もあります。 + + - 消費アカウントの種類。残高の場合は "cash"、リソースパッケージの場合は "unit"。 + 消費アカウントの種類。"cash" は残高、"unit" はリソースパッケージです。 + + + + `amount` と `list_price` の ISO 4217 通貨コード。例: "USD"。タスクによっては返され、省略される場合もあります。 + + + + 割引前のタスクの定価(小数の文字列)。タスクによっては返され、省略される場合もあります。 - 消費可能なリソースバンドルの種類(charge_type が "unit" の場合のみ存在)。"video"、"image"、"audio" のいずれか。 + 消費可能なリソースバンドルの種類(charge_type が "unit" の場合のみ存在)。"video"、"image"、"audio" のいずれかです。 - タスクの作成時刻。ミリ秒単位の Unix タイムスタンプ。 + タスクの作成時間。ミリ秒単位の Unix タイムスタンプ。 - フォーマット: `int64` + 形式: `int64` @@ -287,7 +300,7 @@ Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供する - 生成されるビデオの再生時間(秒)。 + 生成されたビデオの再生時間(秒)。 @@ -299,15 +312,15 @@ Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供する - 生成される MP3 オーディオの再生時間(秒)。 + 生成された MP3 オーディオの再生時間(秒)。 - 生成されるオーディオの MP3 URL(直リンク防止あり)。 + 生成されたオーディオの MP3 URL(直リンク保護あり)。 - 生成されるマテリアルの名前。 + 生成されたマテリアルの名前。 @@ -315,37 +328,37 @@ Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供する - マテリアルのステータス。"succeeded" または "deleted" のいずれか。 + マテリアルのステータス。"succeeded" または "deleted" のいずれかです。 - 出力コンテンツの種類。"video"、"image"、"audio"、"voice"、"element" のいずれか。 + 出力コンテンツの種類。"video"、"image"、"audio"、"voice"、"element" のいずれかです。 - 生成された結果の URL(直リンク防止あり)。30 日後にクリアされます。 + 生成された結果の URL(直リンク保護あり)。30 日後にクリアされます。 - ウォーターマーク付きの結果の URL(直リンク防止あり)。 + ウォーターマーク付き結果の URL(直リンク保護あり)。 - 生成される WAV オーディオの再生時間(秒)。 + 生成された WAV オーディオの再生時間(秒)。 - 生成されるオーディオの WAV URL(直リンク防止あり)。 + 生成されたオーディオの WAV URL(直リンク保護あり)。 - タスクのステータス。"submitted"、"processing"、"succeeded"、"failed" のいずれか。 + タスクのステータス。"submitted"、"processing"、"succeeded"、"failed" のいずれかです。 - タスクの更新時刻。ミリ秒単位の Unix タイムスタンプ。 + タスクの更新時間。ミリ秒単位の Unix タイムスタンプ。 - フォーマット: `int64` + 形式: `int64` @@ -386,7 +399,7 @@ Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供する "duration": "5", "id": "kling-v2-output-2b1a0f9e8d7c", "type": "video", - "url": "https://example.invalid/kling/kling-3.0-turbo/generated.mp4" + "url": "https://example.invalid/kling/v2/generated.mp4" } ], "status": "succeeded", diff --git a/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx b/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx index 1dfb6f8731..cffa2335db 100644 --- a/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Kling Image O1 を使用する" description: "Comfy Router を通じて kling/kling-image-o1 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling Image O1" -translationSourceHash: cf053382 +translationSourceHash: ca32c929 translationFrom: development/comfy-router/models/kling/kling-image-o1/code.mdx translationBlockHashes: "_intro": 513c65df "Quick start": 6256a30d - "Schema": d18a5393 + "Schema": 60d9f6fd "Examples": 826db173 --- + {/* GENERATED FILE. Generated from router-schemas/kling/kling-image-o1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -166,7 +167,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクステータスが変化したときにサーバーから能動的に通知されます。 + このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクステータスが変化したときにサーバーから能動的に通知されます。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router が代わりにポーリングします。 形式: `uri` @@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。 + カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router が代わりにポーリングします。 @@ -214,7 +215,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 単一の画像を生成するか、一連の画像を生成するかを制御します。 + 単一の画像を生成するか、一連の画像を生成するかを制御します。series は kling-image-o1 ではサポートされません (v1 プロキシが model_name を省略した場合に使用する値でもあります)。そのようなリクエストは HTTP 400 で拒否されます。 指定可能な値: `single`, `series` 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 a69f9bf8a4..d0152494e8 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,16 +2,17 @@ title: "Kling V2.5 Turbo を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-v2-5-turbo を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1a5ec6e5 +translationSourceHash: 1671e7b6 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 2495a4d3 "Quick start": dc63b3ac - "Schema": 68d50e72 + "Schema": 3bcb036e "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"; @@ -160,13 +161,13 @@ 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 がユーザーに代わってポーリングします。 形式: `uri` @@ -180,132 +181,132 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - カメラの水平軸(x軸)に沿った移動を制御します。負の値は左、正の値は右を示します。 + カメラの水平軸(x軸)に沿った動きを制御します。負の値は左、正の値は右を示します。 - 範囲: `-10` ~ `10` + 範囲: `-10` から `10` 垂直面内でのカメラの回転(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` + 可能な値: `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 + カスタムタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 - ビデオ生成モード。std: コスト効率の良いスタンダードモード。pro: プロフェッショナルモードで、より長い再生時間と高品質な出力のビデオを生成します。 + ビデオ生成モード。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 未満にもできません。すべてのストーリーボードの再生時間の合計がタスク全体の再生時間と等しくなります。 - ショットの順番 + ショットの順序番号 - このストーリーボードのプロンプト。最大長は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。 - 透かし入りの結果を同時に生成するかどうか。現時点ではカスタム透かしはサポートされていません。 + 透かし入りの結果を同時に生成するかどうか。カスタム透かしは現在サポートされていません。 - true は透かしを生成することを意味し、false は生成しないことを意味します。 + true はウォーターマークを生成することを意味し、false は生成しないことを意味します。 -`GET /v2/models/kling/kling-v2-5-turbo/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 +`GET /v2/models/kling/kling-v2-5-turbo/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 @@ -318,7 +319,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - タスク作成時間、Unix タイムスタンプ(ミリ秒) + タスク作成時間。Unix タイムスタンプ(ミリ秒) @@ -356,27 +357,27 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_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 86f2e928dc..2728637bb7 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,16 +2,17 @@ title: "Comfy Router で Kling V2.6 を使用する" description: "Comfy Router 経由で kling/kling-v2-6 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V2.6" -translationSourceHash: 1e64e957 +translationSourceHash: c445a7bd translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": 04868509 "Quick start": 48a3d970 - "Schema": 9d23ff94 + "Schema": a61a551f "Examples": 8623c725 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-v2-6.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -162,11 +163,11 @@ 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 がユーザーに代わってポーリングします。 形式: `uri` @@ -180,49 +181,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` + 指定可能な値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` - ビデオ生成における柔軟性。値が高いほどモデルの柔軟性の度合いが低くなり、ユーザーのプロンプトとの関連性が強くなります。 + ビデオ生成における柔軟性。値が高いほどモデルの柔軟性が低くなり、ユーザーのプロンプトへの関連性が強くなります。 範囲: `0` から `1` @@ -230,31 +231,31 @@ 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 + カスタムタスク ID。無視されます: comfy-api は転送前にこのフィールドを削除します。Comfy Router がユーザーに代わってポーリングします。 - ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間で、より高品質な出力のビデオを生成します。 + ビデオ生成モード。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 未満にもできません。すべてのストーリーボードの再生時間の合計が、タスク全体の再生時間と等しくなります。 @@ -266,35 +267,35 @@ 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。 @@ -302,10 +303,10 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - true はウォーターマークを生成することを意味し、false は生成しないことを意味します。 + true は透かしを生成することを意味し、false は生成しないことを意味します。 -Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 +`GET /v2/models/kling/kling-v2-6/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に参照するドキュメントと同じものです。 ### 出力 @@ -318,15 +319,15 @@ Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキ - タスク作成時間。Unix タイムスタンプ(ミリ秒) + タスクの作成時間、Unixタイムスタンプ(ミリ秒) - タスクの消費ユニット数 + タスクの控除ユニット数 - タスク ID + タスクID @@ -350,33 +351,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 +393,7 @@ Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキ - リクエスト 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 d6e09f2638..a4fff59474 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: 226ee8a6 +translationSourceHash: 29d1799c translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": f9b37353 + "Schema": 68bd0500 "Examples": 6c2642d6 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-v3-omni.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -160,67 +161,67 @@ 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 がユーザーに代わってポーリングします。 - フォーマット: `uri` + 形式: `uri` ビデオの長さ(秒)。ビデオ編集機能(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` - エレメントIDの設定に基づく参照エレメントリスト。 + 要素IDの設定に基づく参照要素リスト。 - エレメントID + 要素ID - フォーマット: `int64` + 形式: `int64` - カスタムタスクID。単一のユーザーアカウント内で一意である必要があります。 + カスタマイズされたタスクID。単一のユーザーアカウント内で一意である必要があります。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 - 参照画像リスト。エレメント、シーン、スタイルなどの参照画像を含めることができ、また先頭または最後のフレームとしてビデオを生成するために使用できます。 + 参照画像リスト。要素、シーン、スタイルなどの参照画像を含めることができ、ビデオを生成するための最初または最後のフレームとして使用することもできます。 - 画像のBase64エンコードまたは画像URL(アクセス可能であることを確認してください)。サポートされるフォーマットには .jpg/.jpeg/.png が含まれます。ファイルサイズは10MBを超えることはできません。幅と高さの寸法は300px以上、アスペクト比は1:2.5~2.5:1の範囲である必要があります。 + 画像の Base64 エンコーディングまたは画像URL(アクセス可能であることを確認)。サポートされる形式には .jpg/.jpeg/.png が含まれます。ファイルサイズは 10MB を超えることはできません。幅と高さは 300px 以上である必要があり、アスペクト比は 1:2.5 ~ 2.5:1 の範囲です。 - 画像が先頭フレームか最後のフレームかを示します。first_frame は先頭フレーム、end_frame は最後のフレームです。現在、最後のフレームのみはサポートされていません。 + 画像が最初のフレームか最後のフレームかを指定します。first_frame は最初のフレーム、end_frame は最後のフレームです。現在、最後のフレームのみの指定はサポートされていません。 - 取り得る値: `first_frame`, `end_frame` + 指定可能な値: `first_frame`, `end_frame` - ビデオ生成モード。std: スタンダードモード、720Pビデオを生成、コスト効率が良い。pro: プロフェッショナルモード、1080Pビデオを生成、より高品質なビデオ出力。 + ビデオ生成モード。std: スタンダードモードで、720P ビデオを生成し、コスト効率に優れます。pro: プロフェッショナルモードで、1080P ビデオを生成し、より高品質なビデオ出力が得られます。 - 取り得る値: `pro`, `std` + 指定可能な値: `pro`, `std` - モデル名。Comfy Routerを使用する場合は省略するかnullを送信してください。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致する必要があります。 + モデル名。Comfy Router を使用する場合は省略するか null を送信してください。モデルはリクエストパスによって選択されます。指定された名前はそのパスと一致している必要があります。 - 各ストーリーボードに関する情報(プロンプトや再生時間など)。最大6つのストーリーボードをサポートし、最小1つです。multi_shot が true で shot_type が customize の場合に必須です。 + 各ストーリーボードに関する情報(プロンプトや再生時間など)。最大 6 個のストーリーボードをサポートし、最小は 1 です。multi_shot が true で shot_type が customize の場合に必須です。 - このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1未満であってはなりません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 + このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満であってはなりません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 @@ -228,7 +229,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - このストーリーボードのプロンプトワード。最大長512文字。 + このストーリーボードのプロンプト。最大長は 512 文字です。 @@ -236,39 +237,39 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - テキストプロンプトワード。ポジティブおよびネガティブな記述を含めることができます。2,500文字を超えてはなりません。\<\<\<>>> の形式でエレメント、画像、ビデオを指定できます。例: \<\>、\<\<\>>、\<\<\>>。 + テキストプロンプト。ポジティブおよびネガティブな説明を含めることができます。2,500 文字を超えてはなりません。要素、画像、またはビデオを \<\<\<>>> 形式で指定できます。例: \<\>、\<\<\>>、\<\<\>>。 ストーリーボード方法。multi_shot パラメータが true に設定されている場合に必須です。 - 取り得る値: `customize`, `intelligence` + 指定可能な値: `customize`, `intelligence` - ビデオ生成時に同時にサウンドを生成するかどうか。 + ビデオ生成時にサウンドを同時に生成するかどうか。 - 取り得る値: `on`, `off` + 指定可能な値: `on`, `off` - 参照ビデオリスト。特徴の参照ビデオとして、または編集対象のビデオとして使用できます。デフォルトでは編集対象のビデオです。 + 参照ビデオリスト。feature 用の参照ビデオとして、または編集対象のビデオとして使用できます。デフォルトは編集対象のビデオです。 ビデオのオリジナルサウンドを保持するかどうか。yes は保持、no は保持しないことを示します。 - 取り得る値: `yes`, `no` + 指定可能な値: `yes`, `no` - 参照ビデオタイプ。feature は特徴参照ビデオ、base は編集対象のビデオです。 + 参照ビデオの種類。feature は機能参照ビデオ、base は編集対象のビデオです。 - 取り得る値: `feature`, `base` + 指定可能な値: `feature`, `base` - アップロードされたビデオのURL。.mp4/.mov フォーマットのみサポートされます。再生時間は3~10秒。解像度は720px~2160pxである必要があります。24~60 fpsのフレームレートをサポートします。アップロードできるビデオは1つだけで、サイズは200MBを超えてはなりません。 + アップロードするビデオの URL。サポートされるのは .mp4/.mov 形式のみです。再生時間は 3~10 秒です。解像度は 720px~2160px の範囲である必要があります。24~60 fps のフレームレートをサポートします。アップロードできるビデオは 1 本のみで、サイズは 200MB を超えてはなりません。 @@ -276,10 +277,10 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - true はウォーターマークを生成、false は生成しないことを意味します。 + true はウォーターマークを生成することを意味し、false は生成しないことを意味します。 -Routerが `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するスキーマから生成されており、これはリクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。 +Router が `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 @@ -292,11 +293,11 @@ Routerが `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するス - タスク作成時間、Unixタイムスタンプ(ミリ秒) + タスクの作成時間、Unixタイムスタンプ(ミリ秒) - タスクの消費ユニット数 + タスクの控除ユニット @@ -324,17 +325,17 @@ Routerが `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するス - 生成されたビデオのID + 生成済みビデオID - 生成されたビデオのURL + 生成済みビデオのURL 形式: `uri` - ウォーターマーク付きの生成されたビデオのURL、直リンク防止形式 + ウォーターマーク付きの生成済みビデオのURL(ホットリンク保護形式) 形式: `uri` @@ -342,15 +343,15 @@ Routerが `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するス タスクステータス - 取り得る値: `submitted`、`processing`、`succeed`、`failed` + 可能な値: `submitted`, `processing`, `succeed`, `failed` - タスクステータス情報。タスクが失敗した場合は失敗理由が表示されます + タスクステータス情報。タスクが失敗した場合は失敗理由を表示します - タスク更新時間、Unixタイムスタンプ(ミリ秒) + タスクの更新時間、Unixタイムスタンプ(ミリ秒) 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 bd8c4f29cf..d58d60fa1d 100644 --- a/ja/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Kling V3 を使用する" description: "Comfy Router 経由で kling/kling-v3 を呼び出します。エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V3" -translationSourceHash: ecfa3f9b +translationSourceHash: e07d4035 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 74a12e0f "Quick start": 09c0a41a "Serving providers": a8b20c72 - "Schema": 77550c0a + "Schema": 8e8b04e6 "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"; @@ -173,11 +174,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 がユーザーに代わってポーリングします。 形式: `uri` @@ -191,45 +192,45 @@ 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` + 可能な値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` @@ -241,39 +242,39 @@ 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 + カスタムタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 - ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間のビデオを生成しますが、出力品質は高くなります。 + ビデオ生成モード。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 未満であってはなりません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 - ショットの連番 + ショットの順序番号 - このストーリーボードのプロンプトワード。最大長 512 文字。 + このストーリーボードのプロンプト。最大長は 512 文字です。 @@ -281,42 +282,42 @@ 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` + 可能な値: `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 は生成しないことを意味します。 -Router が `GET /v2/models/kling/kling-v3/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に Router が使用するドキュメントと同じです。 +`GET /v2/models/kling/kling-v3/openapi.json` で Router が提供するスキーマから生成済みです。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 @@ -329,11 +330,11 @@ Router が `GET /v2/models/kling/kling-v3/openapi.json` で提供するスキー - タスク作成時間、Unix タイムスタンプ(ミリ秒) + タスクの作成時間。Unix タイムスタンプ(ミリ秒) - タスクの消費ユニット数 + タスクの控除ユニット数 @@ -361,33 +362,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/kling/kling-video-o1/code.mdx b/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx index 1bc4fa1c1c..2495f2759e 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: 3c228231 +translationSourceHash: 892ccf77 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": 6f4cf55b + "Schema": f693e2ef "Examples": 6c2642d6 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-video-o1.json から生成されています。 */} import RouterCodeFooter from "/snippets/ja/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` + 指定可能な値: `16:9`、`9:16`、`1:1` - このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーから能動的に通知されます。 + このタスクの結果を受け取るコールバック通知アドレス。設定すると、タスクステータスが変更されたときにサーバーが能動的に通知します。無視されます: comfy-api は転送前にこのフィールドを削除し、Comfy Router がユーザーに代わってポーリングします。 形式: `uri` @@ -174,11 +175,11 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ ビデオの長さ(秒)。ビデオ編集機能(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` - element ID の設定に基づく参照エレメントリスト。 + エレメントIDに基づいて設定する参照エレメントのリスト。 @@ -188,87 +189,87 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - カスタムタスクID。1 つのユーザーアカウント内で一意である必要があります。 + カスタマイズされたタスクID。単一のユーザーアカウント内で一意である必要があります。無視されます: comfy-api は転送前にこのフィールドを削除し、Comfy Router がユーザーに代わってポーリングします。 - 参照画像リスト。エレメント、シーン、スタイルなどの参照画像を含めることも、ビデオを生成するための先頭フレームまたは終了フレームとして使用することもできます。 + 参照画像リスト。エレメント、シーン、スタイルなどの参照画像を含めることも、ビデオ生成の最初または最後のフレームとして使用することもできます。 - 画像の Base64 エンコードまたは画像URL(アクセス可能であることを確認してください)。サポートされる形式は .jpg/.jpeg/.png です。ファイルサイズは 10MB を超えることはできません。幅と高さの寸法は 300px 以上である必要があり、アスペクト比は 1:2.5 ~ 2.5:1 の範囲です。 + 画像のBase64エンコードまたは画像URL(アクセス可能であることを確認してください)。サポートされる形式は.jpg/.jpeg/.pngです。ファイルサイズは10MBを超えることはできません。幅と高さの寸法は300px以上、アスペクト比率は1:2.5~2.5:1の範囲である必要があります。 - 画像が先頭フレームか終了フレームかを指定します。first_frame は先頭フレーム、end_frame は終了フレームです。現時点では終了フレームのみを指定することはサポートされていません。 + 画像が最初のフレームか最後のフレームかを指定します。first_frameは最初のフレーム、end_frameは最後のフレームです。現在、最後のフレームのみの指定はサポートされていません。 - 指定可能な値: `first_frame`, `end_frame` + 指定可能な値: `first_frame`、`end_frame` - ビデオ生成モード。std: スタンダードモード。720P のビデオを生成し、コスト効率に優れます。pro: プロフェッショナルモード。1080P のビデオを生成し、より高品質なビデオを出力します。 + ビデオ生成モード。std: スタンダードモード。720Pのビデオを生成し、コスト効率に優れます。pro: プロフェッショナルモード。1080Pのビデオを生成し、より高品質なビデオを出力します。 - 指定可能な値: `pro`, `std` + 指定可能な値: `pro`、`std` - モデル名。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パラメータは無効です。 - テキストプロンプト。ポジティブおよびネガティブな記述を含めることができます。2,500 文字を超えることはできません。エレメント、画像、ビデオを \<\<\<>>> の形式で指定できます。例: \<\>, \<\<\>>, \<\<\>>。 + テキストプロンプト。ポジティブおよびネガティブな記述を含めることができます。2,500文字を超えることはできません。`\<\>`、`\<\<\>>`、`\<\<\>>` のように `\<\<\<>>>` 形式でエレメント、画像、ビデオを指定できます。 - ストーリーボード方式。multi_shot パラメータが true に設定されている場合に必須です。 + ストーリーボード方式。multi_shotパラメータがtrueに設定されている場合に必須です。 - 指定可能な値: `customize`, `intelligence` + 指定可能な値: `customize`、`intelligence` - ビデオ生成時にサウンドを同時に生成するかどうか。 + ビデオ生成時に同時にサウンドを生成するかどうか。 - 指定可能な値: `on`, `off` + 指定可能な値: `on`、`off` - 参照ビデオのリスト。feature の参照ビデオとして、または編集対象のビデオとして使用できます。デフォルトは編集対象のビデオです。 + 参照ビデオのリスト。機能の参照ビデオとして、または編集対象のビデオとして使用でき、デフォルトでは編集対象のビデオになります。 - ビデオのオリジナルサウンドを保持するかどうか。yes は保持、no は保持しないことを示します。 + ビデオのオリジナルサウンドを保持するかどうか。yesは保持、noは保持しないことを示します。 - 指定可能な値: `yes`, `no` + 指定可能な値: `yes`、`no` - 参照ビデオのタイプ。feature は feature 参照ビデオ、base は編集対象のビデオです。 + 参照ビデオのタイプ。featureは機能参照ビデオ、baseは編集対象のビデオです。 - 指定可能な値: `feature`, `base` + 指定可能な値: `feature`、`base` - アップロードするビデオの URL。.mp4/.mov 形式のみサポートされます。再生時間は 3~10 秒です。解像度は 720px 以上 2160px 以下である必要があります。フレームレートは 24~60 fps をサポートします。アップロードできるビデオは 1 本のみで、サイズは 200MB を超えることはできません。 + アップロードするビデオのURL。.mp4/.mov形式のみサポートされています。再生時間は3~10秒です。解像度は720px~2160pxの範囲である必要があります。フレームレートは24~60 fpsをサポートしています。アップロードできるビデオは1つのみで、サイズは200MBを超えることはできません。 @@ -276,10 +277,10 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - true はウォーターマークを生成、false は生成しないことを意味します。 + trueはウォーターマークを生成する、falseは生成しないことを示します。 -`GET /v2/models/kling/kling-video-o1/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。 +`GET /v2/models/kling/kling-video-o1/openapi.json` でRouterが提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 ### 出力 @@ -292,11 +293,11 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - タスク作成時間、Unix タイムスタンプ(ミリ秒) + タスク作成時間、Unix タイムスタンプ(ミリ秒) - タスクの控除ユニット数 + タスクの控除単位 @@ -320,11 +321,11 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - ビデオの合計再生時間(秒) + ビデオの総再生時間(秒) - 生成済みビデオ ID + 生成済みビデオの ID @@ -334,7 +335,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - ウォーターマーク付きの生成済みビデオの URL(直リンク防止形式) + ウォーターマーク付きの生成済みビデオの URL(ホットリンク保護形式) 形式: `uri` @@ -342,7 +343,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ タスクステータス - 有効な値: `submitted`、`processing`、`succeed`、`failed` + 取り得る値: `submitted`、`processing`、`succeed`、`failed` @@ -350,7 +351,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - タスク更新時間、Unix タイムスタンプ(ミリ秒) + タスク更新時間、Unix タイムスタンプ(ミリ秒) diff --git a/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx index 46daa06fdf..0a697ac2cd 100644 --- a/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx +++ b/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Videos Avatar Image 2video を使用する" description: "Comfy Router 経由で kling/videos-avatar-image2video を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Videos Avatar Image 2video" -translationSourceHash: 444b1395 +translationSourceHash: 5181e917 translationFrom: development/comfy-router/models/kling/videos-avatar-image2video/code.mdx translationBlockHashes: "_intro": baca1542 "Quick start": 5605d33f - "Schema": eeb06fe1 + "Schema": 073bf8b2 "Examples": ce6803dd --- + {/* GENERATED FILE. Generated from router-schemas/kling/videos-avatar-image2video.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -164,13 +165,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R - このタスクの結果を受け取るコールバック通知アドレス。 + このタスクの結果を受け取るコールバック通知アドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーの代わりにポーリングします。 形式: `uri` - カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。 + カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーの代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx index 80a7965e28..314362e9dd 100644 --- a/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx +++ b/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Videos Lip Sync を使う" description: "Comfy Router 経由で kling/videos-lip-sync を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて。" sidebarTitle: "Videos Lip Sync" -translationSourceHash: ddd2a405 +translationSourceHash: 6103bea9 translationFrom: development/comfy-router/models/kling/videos-lip-sync/code.mdx translationBlockHashes: "_intro": 0477697a "Quick start": e13a4628 - "Schema": 90571e9f + "Schema": 4fb7c777 "Examples": d1dd6ed8 --- + {/* GENERATED FILE. Generated from router-schemas/kling/videos-lip-sync.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -176,7 +177,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID ### 入力 - コールバック通知アドレス。タスクのステータスが変更されるとサーバーから通知されます。 + コールバック通知アドレス。タスクのステータスが変更されるとサーバーから通知されます。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 形式: `uri` @@ -246,7 +247,7 @@ Router が `GET /v2/models/kling/videos-lip-sync/openapi.json` で提供する - タスク作成時間、Unix タイムスタンプ(ミリ秒) + タスク作成時間 @@ -300,7 +301,7 @@ Router が `GET /v2/models/kling/videos-lip-sync/openapi.json` で提供する - タスク更新時間、Unix タイムスタンプ(ミリ秒) + タスク更新時間 diff --git a/ja/development/comfy-router/models/runway/gen4-image/code.mdx b/ja/development/comfy-router/models/runway/gen4-image/code.mdx index 02df1cab50..c90c83b9f5 100644 --- a/ja/development/comfy-router/models/runway/gen4-image/code.mdx +++ b/ja/development/comfy-router/models/runway/gen4-image/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Gen 4 Image を使用する" description: "Comfy Router 経由で runway/gen4_image を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Gen 4 Image" -translationSourceHash: c5792f5c +translationSourceHash: 51dc9815 translationFrom: development/comfy-router/models/runway/gen4-image/code.mdx translationBlockHashes: "_intro": f3b89ce9 "Quick start": 82a202eb - "Schema": d889abf3 + "Schema": 1160ec6d "Examples": 291dbf54 --- + {/* GENERATED FILE. Generated from router-schemas/runway/gen4_image.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -168,7 +169,7 @@ curl https://api.comfy.org/v2/models/runway/gen4_image/requests/$REQUEST_ID \ - エンコードされた画像を含む HTTPS URL またはデータ URI + エンコードされた画像を含む HTTPS URL、Runway のアップロード URI(runway://)、またはデータ URI Router が `GET /v2/models/runway/gen4_image/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 @@ -186,7 +187,7 @@ Router が `GET /v2/models/runway/gen4_image/openapi.json` で提供するスキ - 完了した生成のアセット URL。`runway/gen4_image` の場合、各要素は画像 URL です。タスクが正常に終了すると含まれます。このリストが結果そのものです。 + 完了した生成のアセット URL。`runway/gen4_image` の場合、各要素は画像URL です。タスクが正常に終了すると含まれます。このリストが結果そのものです。 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 b0b1763d17..1b71dd32b0 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,16 +2,17 @@ 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: 83fe91a1 +translationSourceHash: e062dc40 translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: "_intro": 614e2e15 "Quick start": ff9945c8 - "Schema": faf9e081 + "Schema": cb29dfae "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"; @@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES - 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します(low/medium。デフォルトは medium)。その他のモデルは現在これを無視します。 + 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します(low、medium、または auto。省略時は xAI のデフォルトとなり、auto は生成時には low、編集時には medium として扱われます)。その他のモデルはこれを無視します。 - 指定可能な値: `low`, `medium`, `high` + 指定可能な値: `low`, `medium`, `high`, `auto` 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 ea409df086..253d97c259 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,16 +2,17 @@ title: "Grok Imagine Image Pro を Comfy Router で使用する" description: "Comfy Router 経由で xai/grok-imagine-image-pro を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。" sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: 7932bb72 +translationSourceHash: 773b1560 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: "_intro": 97d341e4 "Quick start": 3a4bd585 - "Schema": 5d56d158 + "Schema": 805c771c "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"; @@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES - 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します(low/medium、デフォルトは medium)。その他のモデルでは現在無視されます。 + 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します: low、medium、または auto(省略時の xAI のデフォルト。auto は生成時には low、編集時には medium として提供されます)。その他のモデルでは無視されます。 - 指定可能な値: `low`, `medium`, `high` + 指定可能な値: `low`, `medium`, `high`, `auto` 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 5f7d233efb..7e70c49bfd 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,16 +2,17 @@ title: "Comfy Router で Grok Imagine Image Quality を使用する" description: "Comfy Router 経由で xai/grok-imagine-image-quality を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて。" sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 923968d2 +translationSourceHash: 9f6e16d5 translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: "_intro": 72081c22 "Quick start": 799275b8 - "Schema": e0fcef44 + "Schema": e2c96ff6 "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"; @@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE - 出力画像の品質。grok-imagine-image-2.0 では価格ティア(low/medium。デフォルトは medium)を選択します。その他のモデルは現在この項目を無視します。 + 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します: low、medium、または auto(省略時は xAI のデフォルト。auto は生成時には low、編集時には medium を提供します)。その他のモデルはこの項目を無視します。 - 指定可能な値: `low`、`medium`、`high` + 指定可能な値: `low`、`medium`、`high`、`auto` 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 92b8b1dfc1..0fefac3e30 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,16 +2,17 @@ title: "Comfy Router で Grok Imagine Image を使う" description: "Comfy Router 経由で xai/grok-imagine-image を呼び出す: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Grok Imagine Image" -translationSourceHash: 9cfb938a +translationSourceHash: 2e5c55ad translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: "_intro": a2e97c88 "Quick start": a5495331 - "Schema": 1d17b83a + "Schema": 171da7d5 "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"; @@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID - 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します(low/medium。デフォルトは medium)。その他のモデルは現在のところこれを無視します。 + 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します: low、medium、または auto(省略時は xAI のデフォルト。auto は生成時には low、編集時には medium として扱われます)。その他のモデルはこれを無視します。 - 取り得る値: `low`、`medium`、`high` + 取り得る値: `low`、`medium`、`high`、`auto` diff --git a/ja/development/comfy-router/realtime.mdx b/ja/development/comfy-router/realtime.mdx new file mode 100644 index 0000000000..f7950c99c7 --- /dev/null +++ b/ja/development/comfy-router/realtime.mdx @@ -0,0 +1,223 @@ +--- +title: "Comfy Router リアルタイム音声セッション" +sidebarTitle: "リアルタイム音声" +description: "Comfy Router 経由で Grok Voice のリアルタイム WebSocket セッションを開きます。エンドポイント、認証、秒単位の料金、セッション制限、発生する可能性のあるエラーとクローズコードについて説明します。" +translationSourceHash: e4024a38 +translationFrom: development/comfy-router/realtime.mdx +translationBlockHashes: + "_intro": a85f88e5 + "Endpoint": 2ae36abf + "Authentication": 582120fe + "Connect": b61ae8c6 + "Events": a3ac8c47 + "Pricing": 25d35f6c + "Limits": 85e21dff + "Errors": 3085ba65 + "Next": 3e8c1bd8 +--- +Comfy Routerは、falが提供するxAIのGrok Voiceとのリアルタイム音声対音声セッションを中継します。Comfy APIキーを使ってRouterへのWebSocketを1本開きます。Routerはアカウントとクレジットを確認し、上流でセッションを開いてから、イベントを双方向に中継します。セッションの秒数に応じてComfyクレジットから支払います。 + +## エンドポイント + +```text +wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime +``` + +リクエストは WebSocket アップグレードです(`GET` に `Connection: Upgrade` と `Upgrade: websocket` を指定)。それ以外のリクエストは `426` で拒否されます。 + +## 認証 + +アップグレードリクエストのヘッダーで、`X-API-Key: comfyui-...` または `Authorization: Bearer comfyui-...` のいずれかの形式で Comfy APIキーを送信してください。Router はクエリ文字列や WebSocket サブプロトコルからキーを読み取りません。 + + +ブラウザは WebSocket にヘッダーを設定できず、Comfy APIキーがブラウザに渡っては決してなりません。サーバーからセッションを開き、オーディオを自身でブラウザへ中継してください。 + + +## 接続 + +アップグレードが成功したら、xAI が Grok Voice 向けにドキュメント化しているリアルタイムイベントを送受信します。この例ではセッションを設定し、1 回のテキストターンを送信して、受信した各イベントタイプを出力します。 + + + +```python Python +# pip install websockets msgpack +import asyncio +import os + +import msgpack +import websockets + +URL = "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime" + + +async def send(ws, event): + await ws.send(msgpack.packb(event)) + + +async def main(): + async with websockets.connect( + URL, + additional_headers={"X-API-Key": os.environ["COMFY_API_KEY"]}, + ) as ws: + await send(ws, { + "type": "session.update", + "session": { + "voice": "eve", + "instructions": "You are a helpful assistant.", + "turn_detection": {"type": "server_vad"}, + }, + }) + await send(ws, { + "type": "conversation.item.create", + "item": { + "type": "message", + "role": "user", + "content": [{"type": "input_text", "text": "Hello!"}], + }, + }) + await send(ws, {"type": "response.create"}) + + async for message in ws: + if isinstance(message, str): + continue # fal 独自の x-fal-message フレーム + event = msgpack.unpackb(message) + print(event["type"]) + if event["type"] == "response.done": + break + + +asyncio.run(main()) +``` + +```javascript Node.js +// npm install ws @msgpack/msgpack +import WebSocket from "ws"; +import { encode, decode } from "@msgpack/msgpack"; + +const ws = new WebSocket( + "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime", + { headers: { "X-API-Key": process.env.COMFY_API_KEY } }, +); + +ws.on("unexpected-response", (req, res) => { + // アップグレードは拒否されました。JSON ボディに理由が示されます。 + let body = ""; + res.on("data", (chunk) => (body += chunk)); + res.on("end", () => console.error(res.statusCode, body)); +}); + +const send = (event) => ws.send(encode(event)); + +ws.on("open", () => { + send({ + type: "session.update", + session: { + voice: "eve", + instructions: "You are a helpful assistant.", + turn_detection: { type: "server_vad" }, + }, + }); + send({ + type: "conversation.item.create", + item: { + type: "message", + role: "user", + content: [{ type: "input_text", text: "Hello!" }], + }, + }); + send({ type: "response.create" }); +}); + +ws.on("message", (data, isBinary) => { + if (!isBinary) return; // fal 独自の x-fal-message フレーム + const event = decode(data); + console.log(event.type); + if (event.type === "response.done") ws.close(); +}); + +ws.on("close", (code) => console.log("closed", code)); +``` + + + +終わったらすぐにソケットを閉じてください。課金は最後のレスポンスまでではなく、セッションが閉じるまで続きます。 + +## イベント + +Router は独自のイベントプロトコルを定義していません。サーバーイベントは fal が送信するそのままの形で届き、Router が受け付けるクライアントイベントは変更されずに転送されます。イベント一覧、セッションフィールド、ボイス、オーディオ形式については、次を参照してください: + +- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) および xAI の [realtime イベントスキーマ](https://docs.x.ai/voice-realtime.ws.json) +- fal の [Grok Voice realtime モデルページ](https://fal.ai/models/xai/grok-voice/realtime) とその [API ページ](https://fal.ai/models/xai/grok-voice/realtime/api) + +各クライアントイベントは、例のように 1 つの msgpack バイナリメッセージとして送信してください。これは fal の realtime クライアントが使用するフレーミングであり、モデルのイベントも同じ方法で、`session.created` で始まる msgpack バイナリメッセージとして返されます。fal はさらに、タイプ `x-fal-message` の独自の JSON テキストメッセージ(タイミング情報)も送信します。これらはスキップできます。Router のチェックでは、クライアントイベントを 1 つの JSON テキストメッセージとして受け取ることもできますが、クライアントで JSON をテストしていない限り msgpack を使用してください。 + +Router は転送する前に各クライアントイベントをチェックします: + +- **イベントタイプ:** `session.update`、`input_audio_buffer.append`、`input_audio_buffer.commit`、`input_audio_buffer.clear`、`conversation.item.create`、`conversation.item.delete`、`conversation.item.truncate`、`response.create`、`response.cancel`、および fal の `x-fal-session.configure`。 +- **モデル:** `session.update` 内の `model` は `grok-voice-latest`、`grok-voice-3.0`、または `grok-voice-2.0` でなければなりません。 +- **ツール:** クライアントが実行する関数ツールは許可されます。サーバー側ツール(Web 検索、X 検索、ファイル検索、MCP)は拒否されます。 +- **メディア:** 画像およびビデオ入力は拒否されます。セッションは音声とテキストのみです。 +- **サイズ:** 1 つのクライアントメッセージは最大 1 MiB です。 + +拒否されたイベントは転送されず、Router はクローズコード `1008` でセッションを閉じます。 + +## 料金 + +セッションの料金は**1秒あたり$0.0011869**です(1分あたり約$0.0712、または1秒あたり0.2504クレジット、1分あたり約15.0クレジット、211クレジット = 1米ドルの場合)。セッションが開いている間は15秒単位で課金され、最後の端数分は秒単位で切り上げて課金されます。課金はアップグレード時点からソケットが閉じるまで継続し、オーディオが流れているかどうかは関係ありません。 + +## 制限 + +| 制限 | 値 | +| --- | --- | +| アカウントあたりのセッション数 | 同時に開けるセッションは 1 つです。2 つ目を開くと、`router.realtime.session_already_live` を伴う `429` が返されます。 | +| セッションの長さ | 最大 30 分で、接続時点であなたのクレジット残高が賄える時間を超えることはありません。 | +| セッション中のクレジット | Router は 15 秒ごとにあなたの残高を再確認し、残高が次の 1 秒分を賄えなくなるとセッションを終了します。 | +| 接続レート | 各アップグレード試行は、あなたの[呼び出し元ごとのリクエストレート](/ja/development/comfy-router/limitations#requests-are-rate-limited-per-caller)にカウントされ、他の Router 呼び出しと共有されます。 | + +セッションが時間制限に達した場合、またはクレジットが不足した場合、接続はクローズフレームなしで閉じられることがあります(多くの場合、クローズコード `1006` として現れます)。クレジットを追加した後にのみ再接続するか、より長い時間が必要な場合は新しいセッションを開始してください。 + +## エラー + +### アップグレード前 + +Router が接続を拒否した場合、プロトコルを切り替えずに HTTP ステータスと JSON ボディで応答します: + +```json +{ + "detail": "Insufficient credits to open a realtime session.", + "error_type": "insufficient_credits", + "code": "router.realtime.insufficient_credits" +} +``` + +分岐には `code` を使用してください。`detail` は人間向けです。 + +| ステータス | `code` | 原因 | 対処 | +| --- | --- | --- | --- | +| `426` | `router.realtime.upgrade_required` | リクエストが WebSocket のアップグレードではありませんでした。 | WebSocket クライアントで接続してください。 | +| `401` | `router.realtime.unauthorized` | APIキーが不足しているか、無効です。 | 有効なキーを `X-API-Key` または `Authorization: Bearer` で送信してください。 | +| `402` | `router.realtime.insufficient_credits` | 残高がセッションの最低1秒分にも満たない状態です。 | クレジットを追加してから再接続してください。 | +| `402` | `router.realtime.spend_denied` | セッションの課金対象となるウォレットに資金がありません。ボディ内の `denied_reason` と `billed_workspace` がどのウォレットかを示します。 | そのワークスペースにクレジットを追加してから再接続してください。 | +| `403` | `router.realtime.provider_disabled` | ワークスペースのパートナープロバイダーポリシーがこのプロバイダーを許可していません。 | ワークスペースの管理者に許可を依頼してください。 | +| `404` | `router.realtime.model_not_allowed` | URL 内のモデルはリアルタイムでは利用不可です。 | URL を確認してください。 | +| `429` | `router.realtime.rate_limited` | リクエストレートを超過しました。 | `Retry-After` の時間だけ待ってから再試行してください。 | +| `429` | `router.realtime.session_already_live` | アカウントで既に別のセッションが開かれています。 | 先にそのセッションを閉じてください。 | +| `429` | `router.realtime.concurrency_limit` | パートナーモデルの同時呼び出し数が多すぎます。 | 同時実行数を減らしてから再試行してください。 | +| `502` | `router.realtime.upstream_refused`, `router.realtime.token_mint_failed` | 上流プロバイダーがセッションを開きませんでした。 | バックオフを伴って再試行してください。 | +| `503` | その他の `router.realtime.*` コード | リアルタイムセッションが一時的に利用できません。 | バックオフを伴って再試行してください。 | + +### アップグレード後 + +| クローズコード | 意味 | 対処 | +| --- | --- | --- | +| `1008` | クライアントイベントが拒否されました([イベント](#events) を参照)。 | イベントを修正してください。セッションは終了します。 | +| `1012` | Router が再起動中です。 | 再接続してください。新しいセッションが開始され、新しいアップグレード時点から課金されます。 | +| `1006`(クローズフレームなし) | セッションが時間制限に達した、またはクレジットが不足した際にクライアントが報告する値としてよく見られます。ネットワーク切断も同じように見えます。 | クレジットを追加するか、新しいセッションを開始してください。 | + +その他のクローズコードは fal または xAI からのものです。[イベント](#events) でリンクされている各社のドキュメントを参照してください。 + +## Next + +- [課金](/ja/development/comfy-router/billing): Router の課金方法と利用量の照合方法。 +- [エラーとリトライ](/ja/development/comfy-router/errors): 他の Router 呼び出しが返すエラーの分類。 +- [制限事項](/ja/development/comfy-router/limitations): リクエストレートやその他の制限。 diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index fd47f1f242..1d1239977c 100644 --- a/ja/development/comfy-router/reference.mdx +++ b/ja/development/comfy-router/reference.mdx @@ -2,17 +2,17 @@ title: "Comfy Router API リファレンス" description: "Comfy API 契約から生成済みの、Comfy Router のすべてのエンドポイント、パラメータ、レスポンスボディ、エラーバケット。" sidebarTitle: "API リファレンス" -translationSourceHash: a6f99965 +translationSourceHash: aee933a1 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": 222fd740 + "Endpoints": e0879d3c "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 5952af3f - "Result assets": 18fe6dad + "Pre-flight cost estimates": f0ba96a1 + "Result assets": 5936427c "Per-model input and output schemas": 61c6bde8 - "Schemas": 984bd216 + "Schemas": c1245cc9 --- @@ -29,6 +29,7 @@ translationBlockHashes: + {/* 生成済みファイル: 手動で編集しないでください。 @@ -51,7 +52,7 @@ Comfy API キーは Bearer トークンとして送信することもできま ### `GET /v2/models` -**Comfy Router で実行できるモデルを一覧表示します。** +**Comfy Router が実行できるモデルを一覧表示します。** 利用可能なモデル ID と課金情報を一覧表示します。`has_more` が true の間は `next_cursor` を使用します。 @@ -60,7 +61,7 @@ Comfy API キーは Bearer トークンとして送信することもできま 不透明なページネーションカーソル。 - 型: [`RouterPageCursor`](#routerpagecursor):`next_cursor` として返される不透明なカーソル、1~512 文字 + 型: [`RouterPageCursor`](#routerpagecursor)。`next_cursor` として返される不透明なカーソル。1–512 文字 @@ -76,13 +77,13 @@ Comfy API キーは Bearer トークンとして送信することもできま **レスポンス** - OK - モデルカタログの 1 ページ。 + 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` @@ -90,49 +91,49 @@ 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` - この呼び出し元またはモデルでは、このリクエストは許可されていません。 + この呼び出し元またはモデルに対して、リクエストは許可されていません。 - ボディ: [`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` ### `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文字 - 呼び出し元が以前の `200` から保持している `ETag`。 + 呼び出し元が以前の `200` 応答から保持している `ETag`。 **レスポンス** @@ -140,81 +141,81 @@ 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` - 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 を指定してパートナーモデルを同期的に実行します。** +**正規のモデル ID でパートナーモデルを同期的に実行します。** -モデルを実行し、完了した結果を同じレスポンスで受け取ります。 +モデルを実行し、同じレスポンスで完了した結果を受け取ります。 **パラメータ** 正規の `{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 文字) - 呼び出し元が生成するキーで、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` で拒否されます(メディアを扱えるトランスレーターを持つ leg は通常どおり処理されます)。次に、BYOK 認証情報を解決したリクエストでは、そのプロバイダーがこのモデルを提供しているかどうかに関係なく、`detail` が `this request resolved a BYOK credential` で始まる `409` で拒否されます(そのレスポンスを参照)。次に、指定されたプロバイダー自身のゲートがあり、そのプロバイダーが有効になっていない場合は `error_type: not_enabled` を伴う `403`、ゲートを評価できない場合は `error_type: service_unavailable` を伴う `503` で拒否します。そしてこの 4 つすべてを通過した後にのみ、このモデル用の leg を持たない実在のプロバイダーが `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` はトランスレーターがその操作を処理できない leg にのみ適用されます。 - このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを、受け入れるのではなく拒否することをオプトインします。ネストされたフィールドはチェックされません。スキーマが未宣言のフィールドを許可しているモデル、または作成済みのスキーマを持たないモデルでは何も拒否されず、`strict_mode=true` で送信されたキュー中の送信でも同様です。 + このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを、受け入れるのではなく拒否することをオプトインします。ネストされたフィールドはチェックされず、スキーマが未宣言のフィールドを許可しているモデル、または作成済みスキーマを持たないモデルの場合、あるいは `strict_mode=true` で送信されたキュー中の送信では、何も拒否されません。 デフォルト: False @@ -223,122 +224,120 @@ 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` 内のメディア種別に従います。ビデオ入力が 1 つでもあるリクエストは動画から動画へとして課金され、そうでなければ画像が 1 つでもあれば画像から動画へ、それ以外はテキストから動画へとして課金されます。ただし `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 のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 + 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` 競合はキーに関するものではなく、新しいキーでもどちらも解消されません。1 つ目は、`model_provider` が代替プロバイダーを指定している場合に、リクエストボディがそのプロバイダーのこのモデル用トランスレーターでは処理できないマルチパート操作(編集)を選択していると拒否されるもので、`detail` は "this request's `image` selects the edit operation" で始まります。2 つ目はその後チェックされるもので、リクエストがパス内のプロバイダーに対して 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` は許容量のウィンドウが経過するまで待つことを意味します。 + `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` は実行中の呼び出しを減らすことを意味し、`rate_limited` は許容量のウィンドウを待つことを意味します。 - 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` + ボディ: [`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` - プロバイダー自身のレスポンスを結果に変換できませんでした (`provider_error`)。 + プロバイダー自身のレスポンスを結果に変換できませんでした(`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` **モデル呼び出しを実行する前に、実行せずに価格を見積もります。** -このボディをこのモデルで実行した場合のコストを米ドルで示す事前見積もりを返します。価格は、実行時の請求に使われるのと同じレートカードから算出されます(ベンダーが報告するコストで課金されるモデルの場合は、代わりにベンダーの公開価格表から見積もられます)。これは見積もりであり、最終的な請求額ではありません。実際に支払うのは、ワークスペースの利用状況および請求記録に確定した請求額です。ボディはまずモデルの入力スキーマに対して検証されます。デフォルトの実行(`strict_mode` なし、`reject_unknown_fields` なし)が検証するのと同じ方法です。そのため、モデルのスキーマに適合しないボディは、実行時と同じ `422` になります。プロバイダーには何もディスパッチされず、課金も発生しません。この応答は価格の固定ではありません。`pricing_as_of` の時点で有効な料率で価格が算出され、実行はレーティング時点で有効な料率で課金されます。この機能のロールアウト中は、このルートは `403` を返し、`error_type: not_enabled` となります。 +このモデルでこのボディを実行した場合のコストを、米ドルで事前に見積もって返します。価格は、実行時の請求に使われるのと同じレートカードから算出されます(ベンダーが報告するコストで請求されるモデルは、代わりにベンダーの公開価格表から見積もられます)。これは見積もりであり、最終的な請求額ではありません。実際に支払うのは、ワークスペースの使用状況および請求記録に確定した請求額です。ボディはまずモデルの入力スキーマに対して検証されます。デフォルトの実行(`strict_mode` なし、`reject_unknown_fields` なし)が行うのと同じ方法で検証されるため、モデルのスキーマに適合しないボディは、実行時と同じ `422` になります。プロバイダーへのディスパッチも課金も行われません。この応答は価格の固定ではありません。`pricing_as_of` の時点で有効なレートで算出され、実行は評価時点で有効なレートで請求されます。機能のロールアウト中は、このルートは `error_type: not_enabled` を伴う `403` を返します。Router がまだ実行できないモデルは、実行ルート自身の `detail` を伴う同じ `403` を返すため、両者を区別するには `detail` を参照してください。 **パラメータ** - 正規の `{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 文字 - 現在のデフォルトの代わりに、このモデルを提供する別のプロバイダーを選択します。 + このモデルを提供する代替プロバイダーを、現在のデフォルトの代わりに選択します。 **リクエストボディ** `application/json` -- [`RouterModelInput`](#routermodelinput)(必須) -パートナーモデルのネイティブな JSON 入力で、このモデルに対して同期ルートが受け付けるボディと同じものです。デフォルトの実行が検証するのと同様に、モデル自身の入力スキーマに対して検証され(このルートは `strict_mode` や `reject_unknown_fields` を受け付けません)、そのボディ自身のフィールド(出力数、入力画像が選択する操作)が何の価格を算出するかを決めます。 +パートナーモデル固有の JSON 入力で、このモデルに対して同期ルートが受け付けるボディと同じです。デフォルトの実行が行うのと同じ方法で、モデル自身の入力スキーマに対して検証され(このルートは `strict_mode` や `reject_unknown_fields` を受け付けません)、その固有のフィールド(出力数、入力画像が選択する操作)が価格の対象を決定します。 **レスポンス** - 見積もり結果。 + 見積もり結果です。 ボディ: [`RouterCostEstimate`](#routercostestimate) -- ヘッダー: `X-Comfy-Request-Id` @@ -346,63 +345,63 @@ 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` - この呼び出し元またはモデルに対してリクエストは許可されていません。 + この呼び出し元またはモデルに対してリクエストが許可されていません。 - ボディ: [`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` - 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`(容量不足による拒否のみ) ### `GET /v2/models/{provider}/{model}/openapi.json` -**1つのパートナーモデルの入力スキーマと出力スキーマを OpenAPI ドキュメントとして読み取ります。** +**パートナーモデル 1 件の入力スキーマと出力スキーマを OpenAPI ドキュメントとして取得します。** -1つのモデルの入力スキーマと出力スキーマを、単体の OpenAPI ドキュメントとして読み取ります。 +1 つのモデルの入力スキーマと出力スキーマを、単体の OpenAPI ドキュメントとして取得します。 **パラメータ** 正規の `{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 文字 @@ -414,7 +413,7 @@ Comfy API キーは Bearer トークンとして送信することもできま OK - モデルの入力スキーマと出力スキーマを、単体の OpenAPI ドキュメントとして返します。 - 本文: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` + ボディ: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` @@ -426,259 +425,258 @@ 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 が見つかりませんでした。 - 本文: [`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` - 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 - 1つの論理的な呼び出しを安全に再試行できるようにする、呼び出し元が生成するキー。 + 呼び出し元が生成するキーで、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` 認証情報が不足しているか無効です。 - ボディ: [`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 のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` この呼び出し元またはモデルに対してリクエストは許可されていません。パートナーが生成結果を直接バイトとして返すモデルはまだキューに投入できず、`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` 競合はキーとはまったく関係がなく、新しいキーでもどちらも解消されません。`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` の場合) - リクエストの内容がモデルのスキーマに対して拒否されました。 + リクエストの内容はモデルのスキーマに照らして拒否されました。 - ボディ: [`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` は、許可されている数まで未完了のキュー中リクエストをすでに保持していることを意味するため、そのうちの 1 つが完了したら再度送信してください。`rate_limited` は許可ウィンドウを待つことを意味します。 + `X-Comfy-Error-Type` を確認してください。`queue_backlog_full` は、許可されている上限まで未完了のキュー中リクエストをすでに保持していることを意味するため、そのうち 1 つが完了したら再度送信してください。`rate_limited` は許容ウィンドウを待つことを意味します。 - ボディ: [`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`、`Retry-After`(容量拒否の場合のみ) + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (容量拒否の場合のみ) ### `GET /v2/models/{provider}/{model}/requests/{request_id}` -**送信された 1 件のリクエストの結果を取得します。** +**送信した1件のリクエストの結果を収集します。** -結果収集エンドポイントです。正常に完了したリクエストに対しては、パートナーモデル自身のネイティブ出力を、同じモデル・同じ入力に対して同期ルートの `200` が返す内容とバイト単位で同一のまま返します。これにより 2 つの配信モードは 1 つの結果形状を生成し、呼び出し元は別のパーサーを用意することなく両者を切り替えられます。 +収集エンドポイントです。正常に完了したリクエストに対しては、パートナーモデル自身のネイティブ出力を返します。これは、同じモデルと同じ入力に対して同期ルートの `200` が返す内容とバイト単位で同一です。つまり、2つの配信モードは1つの結果形状を生成し、呼び出し元は2つ目のパーサーを用意せずに両者を行き来できます。 **パラメータ** 正規の `{provider}/{model}` モデル ID の小文字プロバイダーセグメント。実行対象のモデルを持つパートナーです。 - 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大 64 文字 + Type: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大64文字 正規の `{provider}/{model}` モデル ID の小文字モデルセグメント。そのプロバイダー内で実行するモデルです。 - 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字 + Type: [`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 文字 + 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文字 **レスポンス** - 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=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` - Router は一時的に利用できません。バックオフを伴って再試行してください。 + 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` は要求が受け付けられたことを意味し、実行が停止したことを意味するものではありません。パートナー側ですでに送信中の実行はそのまま完了する可能性があります。また、完了したパートナーでの生成は、誰かが結果を取得したかどうかにかかわらず課金されます。そのため実際に何が起きたかを知る必要がある呼び出し元は、後でステータスエンドポイントを参照してください。そこでは、有効になったキャンセルは他のすべての最終結果と同様に、`error_type` を持つ `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` です。 + 対象となるキュー中のリクエスト - 送信時にレスポンスボディで返された `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 文字 @@ -686,7 +684,7 @@ Comfy Router のキュー配信モードです。リクエストボディは、` **レスポンス** - 受け付け済み - `CANCELLATION_REQUESTED`。 + 受理済み - `CANCELLATION_REQUESTED`。 ボディ: [`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- ヘッダー: `X-Comfy-Request-Id` @@ -710,7 +708,7 @@ Comfy Router のキュー配信モードです。リクエストボディは、` - この呼び出し元またはモデルでは、そのリクエストは許可されていません。 + この呼び出し元またはモデルに対してリクエストは許可されていません。 ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` @@ -722,13 +720,13 @@ Comfy Router のキュー配信モードです。リクエストボディは、` - Router は一時的に利用できません。バックオフしながらリトライしてください。 + Router は一時的に利用できません。バックオフを伴って再試行してください。 ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 + Router のリクエストレベルの失敗 - リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` @@ -737,73 +735,73 @@ Comfy Router のキュー配信モードです。リクエストボディは、` **送信済みの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` です。 + 対象とするキュー中のリクエスト。送信時にボディで返された `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 - リクエストの現在のキュー状態。 + 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` - 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) を参照してください。 ## エラーバケット @@ -971,39 +969,39 @@ Router が受け付けたものの、完了できなかったリクエストに ## 事前のコスト見積もり -`POST /v2/models/{provider}/{model}/estimate` は、ボディを実行せずにその価格を算出します。また、キュー中の送信(`POST /v2/models/{provider}/{model}/requests`)は、その `201` 応答で `estimate` と同じ [`RouterCostEstimate`](#routercostestimate) を返します。どちらも、Comfy がその実行に対して請求する料率表に基づいて価格付けされます。ただし、ベンダーが報告するコストで請求されるモデルは、ベンダーの公開価格表から `estimated` として算出されます。返される数値はすべて見積もりであり、最終的な請求額ではありません。ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。自分のプロバイダーキーでの実行は Comfy からは請求されません(下記参照)。見積もりの展開中は、このルートは `403` と `error_type: not_enabled` を返し、送信レスポンスには `estimate` が含まれません。カタログには引き続き価格が掲載されていません。 +`POST /v2/models/{provider}/{model}/estimate` は、実行せずにリクエストボディの価格を算出します。キュー中の送信(`POST /v2/models/{provider}/{model}/requests`)は、その `201` で `estimate` と同じ [`RouterCostEstimate`](#routercostestimate) を返します。どちらも、Comfy がその実行の課金に用いるレートカードから価格が算出されます。ただし、ベンダーが報告するコストで課金されるモデルは例外で、その場合はベンダーが公開している価格表から `estimated` として算出されます。どちらが返す数値も見積もりであり、最終的な請求額ではありません。確定した請求額は、ワークスペースの使用状況および請求記録に記載される金額が最終です。自分のプロバイダーキーによる実行は Comfy の課金対象外です(以下を参照)。見積もりの提供を段階的に展開している間、このルートは `error_type: not_enabled` を伴う `403` を返し、送信のレスポンスには `estimate` が含まれません。カタログには引き続き価格は掲載されていません。 -金額より先に `source` を読んでください。数値の欠落は無料を意味しません。 +金額より先に `source` を確認してください。数値が不足していることは無料を意味しません。 -| `source` | 含まれるもの | 読み方 | +| `source` | 含まれる内容 | 読み方 | | --- | --- | --- | -| `exact` | `amount`、`amount_cents`、`credits` | `pricing_as_of` の料率でこのボディに対して請求される額と等しい見積もりです。ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。 | -| `estimated` | `min_amount`、`max_amount` とその `_cents` 形式、`amount` は含まれない | プロバイダーが報告する数量に請求額が依存し、その数量の上下限がボディで決まる見積もりです。請求額は上下限の範囲内になると見込まれ、ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。 | -| `free` | `amount` は "0"、`amount_cents` と `credits` は `0` | 料率表がこのリクエストをゼロで価格付けするため、見積もりは `0` です。ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。`0` と表示されるのは `free` の見積もりだけです。 | -| `unknown` | `reason`、数値なし | 実行前に価格を提示できませんでした。その他の `source` 値は `unknown` として扱ってください。 | +| `exact` | `amount`、`amount_cents`、`credits` | `pricing_as_of` のレートでこのボディに対する請求額と等しい見積もりです。確定した請求額は、ワークスペースの使用状況および請求記録に記載される金額が最終です。 | +| `estimated` | `min_amount`、`max_amount` とその `_cents` 形式。`amount` は含まれません | 請求額がプロバイダーから報告される数量に依存し、その数量をボディが上下限で制約する見積もりです。請求額はその上下限の範囲内になると見込まれ、確定した請求額は、ワークスペースの使用状況および請求記録に記載される金額が最終です。 | +| `free` | `amount` が "0"、`amount_cents` と `credits` が `0` | レートカードがこのリクエストをゼロと価格設定しているため、見積もりは `0` です。確定した請求額は、ワークスペースの使用状況および請求記録に記載される金額が最終です。`0` を示すのは `free` の見積もりだけです。 | +| `unknown` | `reason`。数値は含まれません | 実行前に価格を示すことはできませんでした。その他の `source` 値はすべて `unknown` として扱ってください。 | -`unknown` の見積もりの `reason` は次のいずれかです: +`unknown` の見積もりにおける `reason` は次のいずれかです: -- `not_quotable`: Router はこの呼び出しを実行前に価格付けできません。プロバイダーが報告する数量で請求され、その数量の上下限がボディで決まらないか、送信されたままのボディを価格付けできないためです。認識できない `reason` は `not_quotable` として扱ってください。 -- `unpriced_model`: 料率表がこのリクエストを価格付けしていません。 -- `byok`(キュー中の送信のみ): 実行は自分のプロバイダーキーを使用するため、Comfy は何も請求しません。 -- `pricing_unavailable`(キュー中の送信のみ): リクエストの受け付け時に料率表を読み取れませんでした。送信はそのまま受け付けられ、実行は通常どおり請求されます。 +- `not_quotable`: Router はこの呼び出しを実行前に価格算出できません。プロバイダーが報告する数量で課金され、その数量をボディが上下限で制約していないか、送信されたままのボディでは価格を算出できないためです。認識できない `reason` はすべて `not_quotable` として扱ってください。 +- `unpriced_model`: レートカードがこのリクエストの価格を設定していません。 +- `byok`(キュー中の送信のみ): 実行は自分のプロバイダーキーを使用するため、Comfy は何も課金しません。 +- `pricing_unavailable`(キュー中の送信のみ): リクエストを受け付けた時点でレートカードを読み取れませんでした。送信自体は受け付けられ、実行は通常どおり課金されます。 -Router がまだ実行前に価格付けできないモデルは、[事前見積もりのないモデル](/ja/development/comfy-router/limitations#事前見積もりのないモデル)に一覧されています。そこに載っていないモデルでも、特定のボディでは `unknown` を返すことがあるため、すべての見積もりで `source` を読んでください。 +Router がまだ実行前に価格を算出できないモデルは、[事前見積もりのないモデル](/ja/development/comfy-router/limitations#models-without-a-pre-flight-estimate)に一覧されています。そこに掲載されていないモデルでも、特定のボディに対しては `unknown` を返すことがあるため、すべての見積もりで `source` を確認してください。 -見積もりがフェイルクローズするのは次の場合です: +見積もりがフェイルクローズする場合: -- 数値に料率表が必要で、カードが読み込まれていないか古い場合、`/estimate` は推測ではなく `503` を返します。キュー中の送信は見積もりを理由に拒否されることはなく、代わりに `source: unknown` と `reason: pricing_unavailable` を含みます。実行前にまったく価格付けできない呼び出し(`not_quotable`)、または自分のプロバイダーキーでのキュー中の送信(`byok`)は、カードを読まずに応答されるため、その `200` はカードが新しいかどうかについては何も示しません。 -- `/estimate` はデフォルトの実行と同様に、モデル自身の入力スキーマに対してボディを検証します。そのため、モデルのスキーマに適合しないボディは、実行が返すのと同じ `422` を、同じ `detail[]` 形状で受け取ります。何も価格付けもディスパッチもされません。 -- キュー中の送信の冪等なリプレイ(`Idempotent-Replayed: true`)は `estimate` を含みません。元の見積もりが保存されていないためです。 +- 数値の算出にレートカードが必要で、カードが読み込まれていないか古い場合、`/estimate` は推測値ではなく `503` を返します。キュー中の送信が見積もりのために拒否されることはなく、代わりに `reason: pricing_unavailable` を伴う `source: unknown` が付与されます。実行前にまったく価格を算出できない呼び出し(`not_quotable`)や、自分のプロバイダーキーによるキュー中の送信(`byok`)は、カードを読まずに応答されるため、その `200` はカードが新しいかどうかを何も示しません。 +- `/estimate` はデフォルトの実行と同様に、モデル自身の入力スキーマに対してボディを検証するため、モデルのスキーマに適合しないボディは、実行が返すのと同じ `422` を、同じ `detail[]` 形状で受け取ります。価格算出もディスパッチも行われません。 +- キュー中の送信の冪等なリプレイ(`Idempotent-Replayed: true`)では、元の見積もりが保存されていないため `estimate` は含まれません。 -見積もりの限界。`200` の数値は、実行が受け付けられること、または正確にその金額が請求されることを約束するものではありません: +見積もりの限界。`200` の数値は、実行が受け付けられることや、正確にその金額が課金されることを約束するものではありません: -- `/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` の見積もりの場合はその価格表を読んだ日付です(どちらも読まれていない場合は、見積もりを返した時刻です)。これは価格の固定ではありません。実行は、レーティング時点で有効な料率で請求されます。 -- `/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` は `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 プラットフォーム上にあります。 ## 結果アセット @@ -1014,9 +1012,9 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 | `bfl/*` | 完了したアセット、および結果に含まれている場合はドラフトキャッシュのアセット | 24 時間 | | `byteplus/*` ビデオモデル (`seedance`、`dreamina-seedance`) | 完了したビデオ、および結果に含まれている場合はラストフレーム画像 | 24 時間 | | `minimax/*` | 完了したビデオ | 12 時間 | -| `xai/*` | 生成されたすべての画像、および完了したビデオ | 24 時間 | +| `xai/*` | 生成済みのすべての画像、および完了したビデオ | 24 時間 | -これらの有効期間は、URL を開いたときではなく、URL が署名されたときに開始されます。キャッシュされた URL や再利用された URL は残り時間が短い場合があります。再利用しても有効期間は更新されません。アセットは速やかにダウンロードしてください。コピーされるのは各行に記載されたアセットのみです。`byteplus/seedream-*` と `byteplus/seededit-*` の画像は BytePlus ビデオの行には含まれません。 +これらの有効期間は、URL を開いたときではなく、URL が署名されたときに開始されます。キャッシュされた URL や再利用された URL は残り時間が短い場合があります。再利用しても有効期間は更新されません。`Idempotency-Key` レコードは、それが保持する URL より長く存続する可能性があります。そのため、そのような URL の有効期限の 1 時間前になると、同じキーでの再試行は記録されたレスポンスではなく `409 invalid_input` で応答されます。ただし、返された時点ですでに有効期限がそこまで迫っていたレスポンスは、5 分間は再生可能なままです。アセットは速やかにダウンロードしてください。コピーされるのは各行に記載されたアセットのみです。`byteplus/seedream-*` と `byteplus/seededit-*` の画像は BytePlus ビデオの行には含まれません。 コピーを実行するのは、モデルのネイティブプロバイダーのみです。代替プロバイダーによって処理された実行、つまり `model_provider` が代替プロバイダーを指定している場合、またはネイティブ実行のフォールバック再試行が代替プロバイダーに到達した場合(`X-Comfy-Router-Fallback-Provider` で開示されます)は、そのプロバイダー自身の URL を返します。これらの URL はプロバイダーの有効期限に従い、コピーされません。`model_provider` の値 `default`、`comfy`、`comfyui` は代替プロバイダーを指定しないため、それらの実行はネイティブであり、上記と同様にコピーされます。フォールバック再試行がネイティブプロバイダーに戻った `model_provider` の実行も同様です。 @@ -1040,7 +1038,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 ### RouterBilledWorkspace -拒否された呼び出しが請求しようとしていたウォレットで、`RouterErrorResponse.billed_workspace` に含まれます。「どのウォレットが空なのか?」に答えるものです。呼び出し元の UI で現在選択済みのワークスペースとは限らず、チームメンバーが個人の認証情報を使っている場合は、資金のあるチームが開かれていてもここにはそのメンバーの個人ウォレットが示されます。`denied_reason` と一緒にのみ存在します。 +拒否された呼び出しが請求対象としていたウォレットで、`RouterErrorResponse.billed_workspace` に含まれます。「どのウォレットが空なのか?」に答えるものです。呼び出し元の UI が現在選択済みのワークスペースとは限らず、チームメンバーが個人の認証情報を使用している場合は、資金のあるチームが開かれていてもここにはそのメンバーの個人ウォレットが示されます。`denied_reason` と一緒にのみ存在します。 **フィールド** @@ -1053,12 +1051,12 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 - 呼び出しがクラウドワークスペースではなく、呼び出し元のワークスペース以前の Metronome 顧客に請求する場合は `legacy`。その顧客にはワークスペース ID がありません。クラウドワークスペースの場合は存在しません。 + 呼び出しがクラウドワークスペースではなく、呼び出し元のワークスペース導入以前の Metronome 顧客に請求する場合は `legacy`。その顧客にはワークスペース ID がありません。クラウドワークスペースの場合は存在しません。 ### RouterChargesOnPolicyRejection -コンテンツポリシーによる拒否がこのモデルで課金されるかどうか。不明な値は課金される可能性があるものとして扱ってください。 +コンテンツポリシーによる拒否が、このモデルで課金の対象になるかどうか。不明な値は課金される可能性があるものとして扱ってください。 型: `string` @@ -1123,7 +1121,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 - この見積もりの価格設定に使用したレートカードを取得した日時。見積もりは価格ロックではありません。実行は、評価時点で有効な料金で請求され、この時点の料金ではありません。ベンダーの公開価格表から取得した `estimated` 見積もり(ベンダーが報告するコストで請求されるモデル)では、代わりにその価格表を読み取った日付を持ちます。請求数量をその価格表から予測し、その後レートカードで価格設定するもの(ベンダーが報告するクレジットで請求されるモデル)では、2 つの日付のうち古い方を持ちます。レートカードを読み取らなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し)は、これは見積もりに回答した時点です。 + この見積もりの価格設定に使用したレートカードを取得した日時。見積もりは価格ロックではありません。実行は、評価時点で有効な料金で請求され、この時点の料金ではありません。ベンダーの公開価格表から取得した `estimated` の見積もり(ベンダーが報告するコストで請求されるモデル)では、代わりにその価格表を読み取った日付を持ちます。請求数量をベンダーの公開スケジュールから予測し、その後レートカードで価格設定する見積もりは、`exact` の回答でも `estimated` の回答でも同様に、そのスケジュールの読み取り日付とカードの取得時刻のうち古い方を持ちます(ベンダーが報告するクレジットで請求されるモデルが `estimated` の場合に当たります)。レートカードを読み取らなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し)は、これは見積もりに回答した時点です。 date-time @@ -1161,13 +1159,13 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 - 拒否された呼び出しが請求するはずだったウォレットを、`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} @@ -1212,7 +1210,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 `POST /v2/models/{provider}/{model}` で使用されるモデル ID。 -型: `string`。モデル ID(例: `anthropic/claude-opus-4-6`)、最大 193 文字。 +型: `string` -- モデル ID(例: `anthropic/claude-opus-4-6`)、最大 193 文字 ### RouterModelInput @@ -1310,7 +1308,7 @@ Router モデルカタログの 1 ページ分です。 `{provider}/{model}` 形式のモデル ID のうち、プロバイダー部分です。 -型: `string`。英数字スラッグ(例: `anthropic`)、最大 64 文字です。 +型: `string`。英数字のスラッグ(例: `anthropic`)、最大 64 文字です。 ### RouterQueueCancelResponse @@ -1334,11 +1332,11 @@ Router モデルカタログの 1 ページ分です。 このルートが実際に解決したリクエストを表す2つの結果について、キャンセル要求が見つけた内容を示します。どちらもHTTPステータスに反映されるため、クライアントはどちらを基準に分岐してもかまいません。 -型: `文字列` +型: `string` ### RouterQueuePosition -レスポンスが生成された時点で、このリクエストよりキュー内で先行しているリクエストの数。0 はこのリクエストが先頭であることを意味します。 +レスポンスが構成された瞬間に、このリクエストよりキュー内で先行しているリクエストの数。0 はこのリクエストが先頭であることを意味します。 型: `integer`、0 以上。 @@ -1356,7 +1354,7 @@ Router モデルカタログの 1 ページ分です。 ### RouterQueueStatusFields -`RouterQueueStatusResponse` のうち URL ブロックではない半分です。キュー中の 1 リクエストの識別子、その現在の状態、そしてその状態がターミナルで実行が成功しなかった場合には、その理由を示す粗い分類を持ちます。 +`RouterQueueStatusResponse` のうち URL ブロックではない半分です。キュー中の 1 リクエストの識別情報、その現在の状態、そしてその状態がターミナルで実行が成功しなかった場合には、その理由を示す粗い分類を持ちます。 **フィールド** @@ -1432,7 +1430,7 @@ Router モデルカタログの 1 ページ分です。 ### RouterQueueUrls -キュー中の1つのリクエストの残りのライフサイクルを扱う3つのURLです。有効なハンドルを含むすべてのレスポンスで返されるため、クライアントがキューのURLを自分で組み立てることはありません。 +キュー中の1つのリクエストの残りのライフサイクルに対する3つのURLです。有効なハンドルを含むすべてのレスポンスで返されるため、クライアントがキューのURLを自分で組み立てることはありません。 **フィールド** @@ -1492,7 +1490,7 @@ Router モデルカタログの 1 ページ分です。 ### RouterValidationErrorInput -プロバイダーが拒否された入力値を含める場合、その値です。 +プロバイダーがそれを含める場合の、拒否された入力値です。 ### RouterValidationErrorResponse @@ -1501,7 +1499,7 @@ Router モデルカタログの 1 ページ分です。 **フィールド** - リクエストで見つかったすべての検証失敗。問題のあるフィールドごとに1エントリです。 + リクエストで見つかったすべての検証失敗を、問題のあるフィールドごとに1エントリとして格納します。 型: [`RouterValidationErrorDetail`](#routervalidationerrordetail) の配列 diff --git a/ko/development/comfy-router/api.mdx b/ko/development/comfy-router/api.mdx index dfff2eac06..ea11c63d78 100644 --- a/ko/development/comfy-router/api.mdx +++ b/ko/development/comfy-router/api.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API 개요" sidebarTitle: "개요" description: "Comfy Router API의 작동 방식: 모델 ID당 하나의 라우트이며, 검색, 스키마, 대기 중인 요청, 오류, 결제에 대한 가이드를 제공합니다." -translationSourceHash: dac7e853 +translationSourceHash: cb493feb translationFrom: development/comfy-router/api.mdx --- @@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx - [빠른 시작](/ko/development/comfy-router/quickstart): 설치, 호출, 이미지 저장. - [모델](/ko/development/comfy-router/models): 카탈로그를 찾아보고 모델별 요청 예시를 확인합니다. - [헤더](/ko/development/comfy-router/headers): 인증, 멱등성, 요청 ID, 재시도 간격 조정. -- [API 레퍼런스](/ko/development/comfy-router/reference): 엔드포인트 파라미터, 스키마, 응답 코드. \ No newline at end of file +- [API 레퍼런스](/ko/development/comfy-router/reference): 엔드포인트 파라미터, 스키마, 응답 코드. +- [실시간 음성](/ko/development/comfy-router/realtime): Grok Voice WebSocket 세션을 열고 초 단위로 과금됩니다. \ No newline at end of file diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index 5fd22da5b6..967ebc4132 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: 235802c5 +translationSourceHash: b4d8209c translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": cf6e2050 - "Models without a pre-flight estimate": 495bdb2b + "Models without a pre-flight estimate": f6dfd921 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -28,6 +28,7 @@ translationBlockHashes: + Router는 파트너 모델을 하나의 동기식 HTTP 호출로 실행하거나, 제출한 뒤 나중에 수집하는 대기 중 요청을 통해 실행합니다. 애플리케이션이 완료된 결과를 기다리거나 나중에 결과를 수집할 수 있고, 모델 자체의 입력 및 출력 필드를 처리할 수 있는 경우에 사용하십시오. ## Router가 지원하는 기능 @@ -116,21 +117,17 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} - **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` -- **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **fal**: `fal/crystal-upscaler`, `fal/crystal-video-upscaler`, `fal/fal-gpt-image-2`, `fal/fal-gpt-image-2.5-flare`, `fal/fal-gpt-image-2.5-sunburst`, `fal/fal-nano-banana-2`, `fal/fal-nano-banana-pro`, `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`, `fal/flux-3-max`, `fal/patina` +- **fal**: `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5` - **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`, `ideogram/p-image-ideogram` -- **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` -- **luma**: `luma/photon-1`, `luma/photon-flash-1` -- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` +- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` +- **kling**: `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` - **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` - **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/clean-audio`, `veed/clean-audio-video`, `veed/fabric-1.0`, `veed/lipsync-2.0`, `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 */} diff --git a/ko/development/comfy-router/realtime.mdx b/ko/development/comfy-router/realtime.mdx new file mode 100644 index 0000000000..4fc117411a --- /dev/null +++ b/ko/development/comfy-router/realtime.mdx @@ -0,0 +1,223 @@ +--- +title: "Comfy Router 실시간 음성 세션" +sidebarTitle: "실시간 음성" +description: "Comfy Router를 통해 Grok Voice 실시간 WebSocket 세션을 엽니다. 엔드포인트, 인증, 초당 과금, 세션 제한, 그리고 받을 수 있는 오류와 종료 코드를 다룹니다." +translationSourceHash: e4024a38 +translationFrom: development/comfy-router/realtime.mdx +translationBlockHashes: + "_intro": a85f88e5 + "Endpoint": 2ae36abf + "Authentication": 582120fe + "Connect": b61ae8c6 + "Events": a3ac8c47 + "Pricing": 25d35f6c + "Limits": 85e21dff + "Errors": 3085ba65 + "Next": 3e8c1bd8 +--- +Comfy Router는 fal이 제공하는 xAI의 Grok Voice와 실시간 음성 대 음성 세션을 중계합니다. Comfy API 키를 사용해 Router에 WebSocket 하나를 엽니다. Router는 계정과 크레딧을 확인하고 업스트림에 세션을 연 뒤, 양방향으로 이벤트를 중계합니다. 비용은 세션 초 단위로 Comfy 크레딧에서 차감됩니다. + +## 엔드포인트 + +```text +wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime +``` + +요청은 WebSocket 업그레이드입니다(`Connection: Upgrade`와 `Upgrade: websocket`을 포함한 `GET`). 그 외의 요청은 `426`으로 거부됩니다. + +## 인증 + +업그레이드 요청의 헤더에 Comfy API 키를 전송하세요. `X-API-Key: comfyui-...` 또는 `Authorization: Bearer comfyui-...` 형식을 사용할 수 있습니다. Router는 쿼리 문자열이나 WebSocket 하위 프로토콜에서 키를 읽지 않습니다. + + +브라우저는 WebSocket에 헤더를 설정할 수 없으며, Comfy API 키는 절대 브라우저에 도달해서는 안 됩니다. 서버에서 세션을 열고 오디오를 브라우저로 직접 릴레이하세요. + + +## 연결 + +업그레이드가 성공하면 xAI가 Grok Voice용으로 문서화한 실시간 이벤트를 주고받습니다. 이 예제는 세션을 구성하고, 텍스트 턴을 하나 전송하며, 수신하는 각 이벤트 유형을 출력합니다. + + + +```python Python +# pip install websockets msgpack +import asyncio +import os + +import msgpack +import websockets + +URL = "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime" + + +async def send(ws, event): + await ws.send(msgpack.packb(event)) + + +async def main(): + async with websockets.connect( + URL, + additional_headers={"X-API-Key": os.environ["COMFY_API_KEY"]}, + ) as ws: + await send(ws, { + "type": "session.update", + "session": { + "voice": "eve", + "instructions": "You are a helpful assistant.", + "turn_detection": {"type": "server_vad"}, + }, + }) + await send(ws, { + "type": "conversation.item.create", + "item": { + "type": "message", + "role": "user", + "content": [{"type": "input_text", "text": "Hello!"}], + }, + }) + await send(ws, {"type": "response.create"}) + + async for message in ws: + if isinstance(message, str): + continue # fal 자체의 x-fal-message 프레임 + event = msgpack.unpackb(message) + print(event["type"]) + if event["type"] == "response.done": + break + + +asyncio.run(main()) +``` + +```javascript Node.js +// npm install ws @msgpack/msgpack +import WebSocket from "ws"; +import { encode, decode } from "@msgpack/msgpack"; + +const ws = new WebSocket( + "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime", + { headers: { "X-API-Key": process.env.COMFY_API_KEY } }, +); + +ws.on("unexpected-response", (req, res) => { + // 업그레이드가 거부되었습니다. JSON 본문에 이유가 나와 있습니다. + let body = ""; + res.on("data", (chunk) => (body += chunk)); + res.on("end", () => console.error(res.statusCode, body)); +}); + +const send = (event) => ws.send(encode(event)); + +ws.on("open", () => { + send({ + type: "session.update", + session: { + voice: "eve", + instructions: "You are a helpful assistant.", + turn_detection: { type: "server_vad" }, + }, + }); + send({ + type: "conversation.item.create", + item: { + type: "message", + role: "user", + content: [{ type: "input_text", text: "Hello!" }], + }, + }); + send({ type: "response.create" }); +}); + +ws.on("message", (data, isBinary) => { + if (!isBinary) return; // fal 자체의 x-fal-message 프레임 + const event = decode(data); + console.log(event.type); + if (event.type === "response.done") ws.close(); +}); + +ws.on("close", (code) => console.log("closed", code)); +``` + + + +작업이 끝나면 즉시 소켓을 닫으세요. 마지막 응답이 아니라 세션이 닫힐 때까지 요금이 청구됩니다. + +## 이벤트 + +Router는 자체 이벤트 프로토콜을 정의하지 않습니다. 서버 이벤트는 fal이 보내는 그대로 전달되며, Router가 허용하는 클라이언트 이벤트도 변경 없이 전달됩니다. 이벤트 목록, 세션 필드, 음성, 오디오 형식은 다음 문서를 참고하세요. + +- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) 및 xAI의 [realtime 이벤트 스키마](https://docs.x.ai/voice-realtime.ws.json) +- fal의 [Grok Voice realtime 모델 페이지](https://fal.ai/models/xai/grok-voice/realtime) 및 [API 페이지](https://fal.ai/models/xai/grok-voice/realtime/api) + +예제에서처럼 각 클라이언트 이벤트를 하나의 msgpack 바이너리 메시지로 전송하세요. 이는 fal의 realtime 클라이언트가 사용하는 프레이밍 방식이며, 모델의 이벤트도 `session.created`로 시작하는 msgpack 바이너리 메시지로 같은 방식으로 돌아옵니다. fal은 `x-fal-message` 유형의 자체 JSON 텍스트 메시지(타이밍 정보)도 보내는데, 이는 건너뛰어도 됩니다. Router의 검사는 클라이언트 이벤트를 하나의 JSON 텍스트 메시지로도 허용하지만, 클라이언트에서 JSON을 테스트해 보지 않았다면 msgpack을 사용하세요. + +Router는 전달하기 전에 각 클라이언트 이벤트를 검사합니다. + +- **이벤트 유형:** `session.update`, `input_audio_buffer.append`, `input_audio_buffer.commit`, `input_audio_buffer.clear`, `conversation.item.create`, `conversation.item.delete`, `conversation.item.truncate`, `response.create`, `response.cancel`, 그리고 fal의 `x-fal-session.configure`. +- **모델:** `session.update`의 `model`은 `grok-voice-latest`, `grok-voice-3.0`, `grok-voice-2.0` 중 하나여야 합니다. +- **도구:** 클라이언트가 실행하는 function 도구는 허용됩니다. 서버 측 도구(웹 검색, X 검색, 파일 검색, MCP)는 거부됩니다. +- **미디어:** 이미지 및 비디오 입력은 거부됩니다. 세션은 음성과 텍스트만 지원합니다. +- **크기:** 클라이언트 메시지 하나는 최대 1 MiB입니다. + +거부된 이벤트는 전달되지 않으며, Router는 종료 코드 `1008`로 세션을 닫습니다. + +## 요금 + +세션 요금은 **초당 $0.0011869**입니다(211크레딧 = $1 USD 기준으로 분당 약 $0.0712, 초당 0.2504크레딧, 분당 약 15.0크레딧). 세션이 열려 있는 동안 15초 단위로 청구되며, 마지막 남은 부분 구간은 초 단위로 올림하여 청구됩니다. 청구는 오디오가 흐르고 있는지 여부와 관계없이 업그레이드 시점부터 소켓이 닫힐 때까지 이루어집니다. + +## 제한 + +| 제한 | 값 | +| --- | --- | +| 계정당 세션 | 한 번에 하나의 세션만 열 수 있습니다. 두 번째 세션을 열면 `429`와 함께 `router.realtime.session_already_live`가 반환됩니다. | +| 세션 길이 | 최대 30분이며, 연결 시점에 보유 크레딧 잔액이 감당할 수 있는 시간을 초과할 수 없습니다. | +| 세션 중 크레딧 | Router는 15초마다 잔액을 다시 확인하며, 잔액이 다음 1초를 감당할 수 없게 되면 세션을 종료합니다. | +| 연결 속도 | 각 업그레이드 시도는 다른 Router 호출과 공유되는 [호출자별 요청 속도](/ko/development/comfy-router/limitations#요청은-호출자별로-속도-제한됩니다)에 포함됩니다. | + +세션이 시간 제한에 도달하거나 크레딧이 소진되면, 연결이 close frame 없이 끊길 수 있습니다(흔히 close code `1006`으로 표시됩니다). 크레딧을 충전한 이후에만 다시 연결하거나, 더 많은 시간이 필요하면 새 세션을 시작하세요. + +## 오류 + +### 업그레이드 이전 + +Router가 연결을 거부하면 프로토콜 전환 대신 HTTP 상태와 JSON 본문으로 응답합니다: + +```json +{ + "detail": "Insufficient credits to open a realtime session.", + "error_type": "insufficient_credits", + "code": "router.realtime.insufficient_credits" +} +``` + +`code`를 기준으로 분기하세요. `detail`은 사람이 읽기 위한 값입니다. + +| 상태 | `code` | 원인 | 해결 방법 | +| --- | --- | --- | --- | +| `426` | `router.realtime.upgrade_required` | 요청이 WebSocket 업그레이드가 아니었습니다. | WebSocket 클라이언트로 연결하세요. | +| `401` | `router.realtime.unauthorized` | API 키가 누락되었거나 유효하지 않습니다. | `X-API-Key` 또는 `Authorization: Bearer`에 유효한 키를 보내세요. | +| `402` | `router.realtime.insufficient_credits` | 잔액으로 최소 1초의 세션도 감당할 수 없습니다. | 크레딧을 추가한 후 다시 연결하세요. | +| `402` | `router.realtime.spend_denied` | 세션이 청구될 지갑에 자금이 없습니다. 본문의 `denied_reason`과 `billed_workspace`가 어느 지갑인지 알려줍니다. | 해당 워크스페이스에 크레딧을 추가한 후 다시 연결하세요. | +| `403` | `router.realtime.provider_disabled` | 워크스페이스의 파트너 공급자 정책이 이 공급자를 허용하지 않습니다. | 워크스페이스 관리자에게 허용을 요청하세요. | +| `404` | `router.realtime.model_not_allowed` | URL의 모델을 realtime에 사용할 수 없습니다. | URL을 확인하세요. | +| `429` | `router.realtime.rate_limited` | 요청 속도를 초과했습니다. | `Retry-After`만큼 기다린 후 다시 시도하세요. | +| `429` | `router.realtime.session_already_live` | 계정에 이미 다른 세션이 열려 있습니다. | 먼저 닫으세요. | +| `429` | `router.realtime.concurrency_limit` | 동시 파트너 모델 호출이 너무 많습니다. | 동시 작업을 줄이고 다시 시도하세요. | +| `502` | `router.realtime.upstream_refused`, `router.realtime.token_mint_failed` | 업스트림 공급자가 세션을 열지 못했습니다. | 백오프를 두고 다시 시도하세요. | +| `503` | 기타 `router.realtime.*` 코드 | 실시간 세션을 일시적으로 사용할 수 없습니다. | 백오프를 두고 다시 시도하세요. | + +### 업그레이드 이후 + +| 종료 코드 | 의미 | 해결 방법 | +| --- | --- | --- | +| `1008` | 클라이언트 이벤트가 거부되었습니다([이벤트](#이벤트) 참조). | 이벤트를 수정하세요. 세션은 종료됩니다. | +| `1012` | Router가 재시작 중입니다. | 다시 연결하세요. 새 세션이 시작되며 새 업그레이드 시점부터 과금됩니다. | +| `1006` (close 프레임 없음) | 세션이 시간 제한에 도달하거나 크레딧이 소진되었을 때 클라이언트가 흔히 보고하는 값입니다. 네트워크 끊김도 동일하게 보입니다. | 크레딧을 추가하거나 새 세션을 시작하세요. | + +그 외의 종료는 fal 또는 xAI에서 발생합니다. [이벤트](#이벤트) 아래에 링크된 해당 문서를 참조하세요. + +## 다음 + +- [요금 청구](/ko/development/comfy-router/billing): Router가 요금을 청구하는 방식과 사용량을 대조하는 방법입니다. +- [오류 및 재시도](/ko/development/comfy-router/errors): 다른 Router 호출이 반환하는 오류 버킷입니다. +- [제한 사항](/ko/development/comfy-router/limitations): 요청 속도 및 기타 제한입니다. diff --git a/zh/development/comfy-router/api.mdx b/zh/development/comfy-router/api.mdx index 63a66aff1a..c9d3d5fce7 100644 --- a/zh/development/comfy-router/api.mdx +++ b/zh/development/comfy-router/api.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API 概览" sidebarTitle: "概览" description: "Comfy Router API 的工作方式:每个模型 ID 对应一个路由,并提供关于发现模型、schema、排队请求、错误和计费的指南。" -translationSourceHash: dac7e853 +translationSourceHash: cb493feb translationFrom: development/comfy-router/api.mdx --- @@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx - [快速开始](/zh/development/comfy-router/quickstart):安装、调用以及保存图像。 - [模型](/zh/development/comfy-router/models):浏览目录并查看各模型专属的请求示例。 - [请求头](/zh/development/comfy-router/headers):身份验证、幂等性、请求 ID 以及重试节奏。 -- [API 参考](/zh/development/comfy-router/reference):端点参数、schema 以及响应码。 \ No newline at end of file +- [API 参考](/zh/development/comfy-router/reference):端点参数、schema 以及响应码。 +- [实时语音](/zh/development/comfy-router/realtime):开启 Grok Voice WebSocket 会话,按秒计费。 \ No newline at end of file diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index f580a19c68..362d5f9a55 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: 235802c5 +translationSourceHash: b4d8209c translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": cf6e2050 - "Models without a pre-flight estimate": 495bdb2b + "Models without a pre-flight estimate": f6dfd921 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -28,6 +28,7 @@ translationBlockHashes: + Router 通过一次同步 HTTP 调用运行合作伙伴模型,或通过一个已排队的请求运行:你提交请求,稍后再收集结果。当你的应用能够等待一个已完成的结果,或稍后收集结果,并且能够处理模型自身的输入和输出字段时,就使用它。 ## Router 支持的功能 @@ -116,21 +117,17 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价, {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} - **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` -- **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **fal**: `fal/crystal-upscaler`, `fal/crystal-video-upscaler`, `fal/fal-gpt-image-2`, `fal/fal-gpt-image-2.5-flare`, `fal/fal-gpt-image-2.5-sunburst`, `fal/fal-nano-banana-2`, `fal/fal-nano-banana-pro`, `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`, `fal/flux-3-max`, `fal/patina` +- **fal**: `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5` - **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`, `ideogram/p-image-ideogram` -- **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` -- **luma**: `luma/photon-1`, `luma/photon-flash-1` -- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` +- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` +- **kling**: `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` - **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` - **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/clean-audio`, `veed/clean-audio-video`, `veed/fabric-1.0`, `veed/lipsync-2.0`, `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 */} 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 4ddd53b499..17c54af15f 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: 9604ca27 +translationSourceHash: 70ec471f translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 6c5da06a + "Schema": 8c0478c9 "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,29 +198,29 @@ 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;请勿再次发送这些内容。resolution 默认为 1080p,且仅支持 1080p。 @@ -232,9 +233,9 @@ Base64:格式 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片 URL:确保图像 URL 可访问。 +图片网址:请确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式 asset://\ +资产 ID:格式为 asset://\ @@ -243,7 +244,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` @@ -262,14 +263,16 @@ 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 自己的验证器应答。该值设置得远高于真实流量,因此绝不会拒绝真实提示词;如果调用方需要更多,可以提高该值。 输入内容的类型 - 可能的值:`text`, `image_url`, `video_url`, `audio_url`, `draft_task` + 可能值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -278,64 +281,64 @@ Comfy 侧的保护措施,并非 BytePlus 的限制。BytePlus 未公布文本 视频 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 视频;resolution 必须为 480p。 +将返回的任务 ID 放入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长(秒)。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 - 范围:`2` 到 `30` + 可能值:`-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 支持。生成的视频是否包含与画面同步的音频。 -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 时 MUST 提供该参数,代理会以 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。 - 可选值:`480p`,`720p`,`1080p`,`4k` + 可选值:`480p`、`720p`、`1080p`、`4k` - 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将该参数设置为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false: 不返回已生成视频的最后一帧图像。 + 是否返回已生成视频的尾帧图像。 +是:返回已生成视频的尾帧图像。将此参数设为是之后,你可以通过查询视频生成任务信息来获取尾帧图像。尾帧图像为 PNG 格式,像素宽度和高度与已生成的视频一致,且不含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的尾帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +否:不返回已生成视频的尾帧图像。 @@ -345,9 +348,9 @@ false: 不返回已生成视频的最后一帧图像。 - 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 处理所用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`,`flex` + 可选值:`default`、`flex` @@ -359,79 +362,78 @@ 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 自有字段。可为 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 只剩 1 小时有效期。无法执行重新托管时,该字段会保留 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` 的生存期无关。 - 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 密钥);一旦 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 只剩 1 小时有效期。无法执行重新托管时,该字段会保留 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 失败任务响应中识别策略系列,而不会覆盖传输失败。 报错信息 - - 视频生成任务的 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` @@ -441,7 +443,7 @@ false: 不返回已生成视频的最后一帧图像。 - 请求的 token 用量 + 该请求的 token 用量 @@ -449,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-0-fast-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index e3b70a93fc..3397d6115b 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: b02c6ed1 +translationSourceHash: 8036f4db translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": e03c503a + "Schema": 90b60b2e "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,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### 输入 - 会被忽略。为兼容 BytePlus 的请求结构而接受,但在任务提交之前会被移除,因此不会发送任何回调;请改为轮询任务状态路由来获取结果。 + 已忽略。为兼容 BytePlus 的请求结构而接受此参数,但在提交任务前会将其移除,因此不会发送任何回调;请改为轮询任务状态路由以获取结果。 格式:`uri` @@ -192,7 +193,7 @@ 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 支持仅音频输入。 @@ -203,12 +204,12 @@ Base64:格式为 data:audio/\;base64,\ - 仅 Seedance 2.5 适用。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、duration、ratio、seed、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为且仅支持 1080p。 + 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的 prompt、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type,请勿再次发送这些参数。resolution 默认为且仅支持 1080p。 - 在 `draft` 设置为 true 的情况下创建 Draft 视频时返回的任务 ID。 + 创建 Draft 视频时 `draft` 设为 true 所返回的任务 ID。 @@ -218,42 +219,50 @@ 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` 供模型使用的输入文本信息。包含文本提示词和可选参数。 -文本提示词(必填):使用中英文字符描述要生成的视频。 - -参数(可选):在文本提示词之后添加 --[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) + +示例:"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` @@ -267,62 +276,63 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 仅 Seedance 2.5 适用。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;resolution 必须为 480p。 +将返回的任务 ID 放入 `draft_task` 内容项中,即可渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 - - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长(秒)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 - 范围:`2` 到 `30` + 可能的值:`-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。直接通过 v1 调用 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供该值,代理会拒绝任何其他值,也会拒绝省略该值,并返回 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.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。 可能的值:`480p`、`720p`、`1080p`、`4k` - 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false: 不返回已生成视频的最后一帧图像。 + 是否返回已生成视频的末帧图像。 +true:返回已生成视频的末帧图像。将此参数设置为 true 后,你可以通过调用查询视频生成任务信息来获取末帧图像。末帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的末帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 +false:不返回已生成视频的末帧图像。 - 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。 + 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 范围:`-1` 到 `4294967295` @@ -337,38 +347,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 +386,7 @@ false: 不返回已生成视频的最后一帧图像。 - 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这方面并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他同级接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 + 已生成视频的时长,单位为秒。声明为 number 而非 integer,因为 BytePlus 在这方面并不一致:已观察到视频任务返回整秒,而同级的 BytePlus 接口反馈的是带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 @@ -384,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 失败任务响应中识别策略系列,但不会覆盖传输层故障。 报错信息 - - 视频生成任务的 ID +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` @@ -432,7 +442,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 6995497779..f0e5e96a3f 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: 28c5c053 +translationSourceHash: a1d75c67 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 3c26a330 + "Schema": ebf1fc3a "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,9 +183,9 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 输入 - 忽略。为兼容 BytePlus 请求结构而接受,但在提交任务前会被移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。 + 已忽略。为兼容 BytePlus 的请求结构而接受该字段,但在提交任务前会将其移除,因此不会发送任何回调;请改为轮询任务状态路由来获取结果。 - 格式:`uri` + 格式: `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: 音频的公开 URL(wav、mp3)。 +Base64: 格式 data:audio/\;base64,\ +资产 ID: 格式 asset://\ 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送它们。resolution 默认为且仅支持 1080p。 +最终视频会复用 Draft 任务的 prompt、输入资产、duration、ratio、seed、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为且仅支持 1080p。 - 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 + 将 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 @@ -217,50 +218,50 @@ 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) +- --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" +示例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 侧护栏,不是 BytePlus 的限制。BytePlus 未发布 +这是 Comfy 侧的防护限制,而非 BytePlus 的约束。BytePlus 未公布 文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。 -它按字符而不是字节计数,因此多字节提示词在传输时可能达到 -此大小的数倍。它限制的是这一个字段,而不是请求: -`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` + 可能的值: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -269,39 +270,40 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; 视频 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 天。 + 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 - 范围:`2` 到 `30` + 可能的值: `-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 支持。生成的视频是否包含与画面同步的音频。 -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。直接以 v1 调用 POST /proxy/byteplus/api/v3/contents/generations/tasks 时 MUST 提供该值:代理会拒绝任何其他值,也会拒绝缺失该值,并返回 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),颜色精度高,适合后期制作;文件大小更大。 @@ -309,23 +311,23 @@ 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.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。 可选值:`480p`、`720p`、`1080p`、`4k` - 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false: 不返回已生成视频的最后一帧图像。 + 是否返回已生成视频的末帧图像。 +true: 返回已生成视频的末帧图像。将该参数设为 true 后,你可以通过调用查询视频生成任务信息接口来获取末帧图像。末帧图像为 PNG 格式,其像素宽度和高度与已生成的视频一致,且不含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的末帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 +false: 不返回已生成视频的末帧图像。 @@ -335,87 +337,86 @@ 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。`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。 + 已生成视频最后一帧的下载 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` 之前是 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` 并排逐字节原样返回。仅当 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 小时后清除该 URL,并在某些模型上将其限制为 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 失败任务响应中识别政策系列,而不会覆盖传输失败。 报错信息 - - 视频生成任务的 ID +视频生成任务的 ID - 该任务使用的模型名称及版本 + 任务所使用的模型名称和版本 - 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的兄弟字段返回,Seedance 视频任务查询即在此处返回该字段。这是 BytePlus 自有字段,原样透传。 + 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级返回,Seedance 视频任务查询就是在这里返回它。这是 BytePlus 自有字段,原样转发。 - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,原样透传。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。 - 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,原样透传。 + 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。 格式:`int64` @@ -431,7 +432,7 @@ false: 不返回已生成视频的最后一帧图像。 - 本次请求的 token 用量 + 请求的 token 用量 @@ -439,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/dreamina-seedance-2-5-260628/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 6b83dea46c..ae6c628b46 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: 07fd9c64 +translationSourceHash: 3606fb83 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0a76af44 + "Schema": d2c28a84 "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,7 +196,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 输入 - 已忽略。为兼容 BytePlus 的请求形状而接受,但在提交任务之前就会被移除,因此永远不会发送回调;请改为轮询任务状态路由来获取结果。 + 已忽略。为兼容 BytePlus 请求结构而接受,但在提交任务之前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 格式:`uri` @@ -205,41 +206,41 @@ 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)。 + 音频网址、Base64 编码或资产 ID。 +音频网址:音频的公开网址(wav、mp3)。 Base64:格式为 data:audio/\;base64,\ 资产 ID:格式为 asset://\ - 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。分辨率默认为且仅支持 1080p。 + 仅 Seedance 2.5。要作为最终视频渲染的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认且仅支持 1080p。 - 使用 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 + 创建 Draft 视频时,若 `draft` 设置为 true,返回的任务 ID。 - + 用于图生视频生成的图像内容(当 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` @@ -247,27 +248,20 @@ 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 未公布 -文本长度限制,并且在测试中接受了 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 自己的校验器给出响应。将其设置得远高于真实流量,以确保它绝不会对真实提示词作出判定;如果调用方需要更多,可以提高该值。 @@ -277,24 +271,24 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 输入视频对象。仅 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。 -在 `draft_task` 内容项中传入返回的任务 ID,以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 + 仅 Seedance 2.5。生成 480p 的 Draft 视频;resolution 必须为 480p。 +在 `draft_task` 内容项中传入返回的任务 ID,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 与 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动)。 - 范围:`2` 到 `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` @@ -305,39 +299,40 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 由 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 拒绝任何其他值,缺失时同样返回 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),颜色精度高,适合后期制作;文件大小更大。 - 可能的值:`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。 - 可能的值:`480p`, `720p`, `1080p`, `4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将此参数设为 true 后,可以通过调用“查询视频生成任务信息”来获取最后一帧图像。该最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不含水印。使用此参数可以生成多个连续视频:将先前生成的视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +true: 返回已生成视频的最后一帧图像。将该参数设为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用该参数可以生成多个连续视频:将上一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 false: 不返回已生成视频的最后一帧图像。 @@ -348,47 +343,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 生成,该文档与 Router 在请求到达提供商之前用于校验调用的文档是同一份。 ### 输出 - 视频生成任务已完成后的输出,包含输出视频的下载 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。无论哪种情况,链接都会过期,因此请下载该帧,而不要存储 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` 的生命周期无关。 + 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` + 格式: `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` 并列逐字节返回。仅当 Seedance 2.x 任务由 Comfy 已在服务器端选择加入的工作区轮询时才提供(没有请求参数);其他所有情况下均不存在,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 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 小时后清除该 URL,并在某些模型上将下载次数限制为 100 次。无论哪种方式,链接都会过期,因此请下载视频,而不是存储 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,最长有效 24 小时:签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,此字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务结束 24 小时后清除该 URL,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要存储 URL。 @@ -396,39 +391,35 @@ 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 - - - - 任务所使用的模型名称与版本 + + 该任务所使用的模型名称与版本 - 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回。Seedance 视频任务查询正是在此位置返回该字段。该字段为 BytePlus 自有字段,原样透传。 + 已生成视频的容器格式(mp4 或 mov),在顶层返回,与 `content` 同级,Seedance 视频任务查询就是在这里返回该字段的。这是 BytePlus 自有字段,原样转发。 - 已生成视频的分辨率,例如 `1080p`。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务上返回,并原样转发。 - 该任务实际使用的生成种子。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 + 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务上返回,并原样转发。 格式:`int64` @@ -436,7 +427,7 @@ false: 不返回已生成视频的最后一帧图像。 任务的状态 - 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 可能取值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` @@ -444,7 +435,7 @@ false: 不返回已生成视频的最后一帧图像。 - 本次请求的 token 用量 + 请求的 token 用量 @@ -452,7 +443,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 13ad884815..ea237df923 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: 450bbe6e +translationSourceHash: 642f85ab translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": fc979e05 + "Schema": b57b84de "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,17 +183,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 支持纯音频输入。 @@ -203,8 +204,8 @@ Base64:格式为 data:audio/\;base64,\ - 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些参数。resolution 默认为且仅支持 1080p。 + 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。分辨率默认为 1080p,且仅支持 1080p。 @@ -217,7 +218,7 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片 URL:请确保图片 URL 可访问。 +图片 URL:确保图片 URL 可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ @@ -225,37 +226,36 @@ 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` - 模型的输入文本信息。包含文本提示词和可选参数。 + 供模型使用的输入文本信息。包括文本提示词和可选参数。 文本提示词(必填):使用中英文字符描述要生成的视频。 -参数(可选):在文本提示词后添加 --[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 自己的校验器作答。将其设置得远高于实际流量,使其绝不会对 +真实提示词进行裁决;如果调用方需要更多,请提高该值。 @@ -275,58 +275,59 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; - 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 1.0 pro 和 1.0 pro fast:[2,12]。 - 范围:`2` 至 `30` + 可能的值:`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 支持。生成的视频是否包含与画面同步的音频。 -是:模型输出带同步音频的视频。 -否:模型输出无声视频。在支持该功能的模型上,生成的音轨会由提供商与视频分开进行内容审核;若音频未通过审核,会被报告为 `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 调用方会省略该字段。 + The ID of the model to call. Supported models: 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 时 MUST 提供该值 — 代理会拒绝其他任何值,缺省时也会以 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。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` - 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将该参数设为 true 后,你可以通过调用“查询视频生成任务信息”获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 -false: 不返回已生成视频的最后一帧图像。 + 是否返回已生成视频的尾帧图像。 +true:返回已生成视频的尾帧图像。将该参数设为 true 后,可通过调用查询视频生成任务信息来获取尾帧图像。尾帧图像为 PNG 格式,其像素宽度与高度与已生成视频一致,且不含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的尾帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 +false:不返回已生成视频的尾帧图像。 @@ -336,70 +337,70 @@ 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 小时。该 URL 在签发时按 24 小时签名,并从 23 小时的备忘中重放,因此之后的轮询返回的 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 小时的缓存记录中重放,因此稍后轮询可能返回剩余有效期仅一小时的 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` 一并逐字节返回。仅在由服务器端已选择加入的工作区轮询的 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 存储并重写该字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后轮询可能返回剩余有效期仅一小时的 URL。当无法执行重新托管时,该字段改为保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种方式,链接都会过期,因此请下载视频,而不是保存 URL。 - 任务创建的时间。该值为 UNIX 时间戳,单位为秒。 + 任务创建的时间。该值是一个 UNIX 时间戳,单位为秒。 - 生成视频的时长,单位为秒。声明为数字而非整数,是因为 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 @@ -408,21 +409,21 @@ 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 +441,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 573d9a16e9..dc9fefdfdd 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: 43683424 +translationSourceHash: 61dd0135 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": a882b2d8 + "Schema": dd74b012 "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 张图像或 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。 + 仅 Seedance 2.5 支持。要渲染为最终视频的草稿任务。它必须是唯一的内容项。 +最终视频会复用草稿任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些参数。分辨率默认为且仅支持 1080p。 - 将 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 + 创建草稿视频时将 `draft` 设为 true 后返回的任务 ID。 @@ -219,41 +220,41 @@ 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 未公布文本长度上限,并且在测试中(2026-09-17)接受了 40,000 个字符。它统计的是字符数而非字节数,因此多字节提示词在传输时可能达到该数值的数倍。该限制只约束这一个字段,而不约束整个请求:`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,154 +262,154 @@ Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本 - 视频 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 的草稿视频;分辨率必须为 480p。 +将返回的任务 ID 放入 `draft_task` 内容项中,即可渲染最终的 1080p 视频。草稿任务 ID 的有效期为 7 天。 - - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长,单位为秒。Seedance 1.0 pro 和 1.0 pro fast:[2,12]。 - 范围:`2` 到 `30` + 可选值:`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。 + 受 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 的最终渲染会从其草稿任务继承 `generate_audio`,因此请改为用 `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 拒绝任何其他值以及省略该值的情况。它不在本 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` + 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.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。 - 可能的值:`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` 到 `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-0-pro-fast-251015/openapi.json` 提供的 schema 生成,该文档也是 Router 在请求到达提供商之前校验调用时所依据的同一文档。 +由 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,此后轮询到的成功文档中 `content` 可能缺失或为 null。 + 视频生成任务完成后得到的输出,包含输出视频的下载链接,以及(当 BytePlus 返回时)其最后一帧的下载链接。`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。 + 生成视频最后一帧的下载链接,当请求设置了 `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` 的生命周期无关。 + 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 自己的最后一帧下载链接,与重新托管的 `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 自己的输出视频下载链接,与重新托管的 `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。 + 输出视频的下载链接。Router 会将视频重新托管到 Comfy 存储上并重写此字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL。该 URL 在生成时签名有效期为 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 失败任务响应中识别策略系列,而不会覆盖传输层失败。 报错信息 - - 视频生成任务的 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 +425,7 @@ false: 不返回已生成视频的最后一帧图像。 - 本次请求的 token 用量 + 该请求的 token 用量 @@ -432,7 +433,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-5-pro-251215/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 42cabe70ab..bb0aa1e515 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: 1d016721 +translationSourceHash: 2263b4cf translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 35f3b5dc + "Schema": f4d67fb6 "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"; @@ -179,36 +180,36 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ ## Schema -### 输入 +### Input - 已忽略。为兼容 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:格式为 data:audio/\;base64,\ -资产 ID:格式为 asset://\ +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;不要再次发送这些字段。分辨率默认为且仅支持 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,22 @@ 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 自己的验证器作出响应。该值设置得远高于真实流量,因此它永远不会裁决真实提示词;如果调用方需要更多,可以调高它。 @@ -266,54 +264,55 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 视频 URL 或资产 ID。 视频 URL:视频的公开 URL(mp4、mov)。 -资产 ID:格式为 asset://\ +资产 ID:格式 asset://\ - 仅 Seedance 2.5。生成 480p 草稿视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。草稿任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长,以秒为单位。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + + 视频时长(秒)。Seedance 1.5 pro:[4,12] 或 -1(自动)。 - 范围:`2` 至 `30` + 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12` - 任务超时阈值,以秒为单位。默认 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。 +在支持此功能的模型上,生成的音频轨道会由提供商与视频分开进行内容检查;如果音频被拒绝,会报告为 `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。输出视频的容器格式。 -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。 可选值:`480p`、`720p`、`1080p`、`4k` @@ -321,98 +320,98 @@ 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` - 已生成视频是否包含水印。 + 已生成的视频是否包含水印。 -根据 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。无论哪种情况,链接都会过期,因此请下载该帧,而不是存储 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` 之前都是 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 小时:签发时按 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 时间戳,单位为秒。 - 生成视频的时长,单位为秒。声明为数字而不是整数,因为 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 + + 视频生成任务的 ID - 任务所使用的模型名称和版本 + 该任务所使用的模型名称和版本 - 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询就是在这里返回该字段。BytePlus 自有字段,原样转发。 + 生成视频的容器格式(mp4 或 mov),会在顶层作为 `content` 的兄弟字段返回,Seedance 视频任务查询正是在此处返回该字段。这是 BytePlus 自身的字段,原样转发。 - 生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自身的字段,在成功的视频任务中返回,并原样转发。 - 任务实际使用的生成种子。BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 该任务实际使用的生成种子。这是 BytePlus 自身的字段,在成功的视频任务中返回,并原样转发。 格式:`int64` @@ -420,7 +419,7 @@ false: 不返回已生成视频的最后一帧图像。 任务的状态 - 可能的值:`queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` + 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` @@ -428,7 +427,7 @@ false: 不返回已生成视频的最后一帧图像。 - 请求的 token 使用量 + 该请求的 token 用量 diff --git a/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx index 05ce84cd96..4578986433 100644 --- a/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx @@ -2,18 +2,19 @@ title: "通过 Comfy Router 使用 Kling 3.0 Turbo" description: "通过 Comfy Router 调用 kling/kling-3.0-turbo:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling 3.0 Turbo" -translationSourceHash: 301a1ee1 +translationSourceHash: d09b3876 translationFrom: development/comfy-router/models/kling/kling-3-0-turbo/code.mdx translationBlockHashes: "_intro": 5a8c5f4b "Quick start": a2145573 "Serving providers": 7ec93d4f - "Schema": 1f5f61c1 - "Examples": 0a9a8bbe + "Schema": 992b8da2 + "Examples": 5ce1484a --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/kling/kling-3.0-turbo.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -181,13 +182,13 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID 视频宽高比 - 可选值: `16:9`, `9:16`, `1:1` + 可选值:`16:9`、`9:16`、`1:1` - 视频长度,以秒为单位 + 视频时长,单位为秒 - 可选值: `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` @@ -195,11 +196,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 任务结果回调通知 URL。当任务状态发生变化时,服务器会发送通知。 + 用于接收任务结果回调通知的链接。任务状态变化时,服务器会发出通知。此项被忽略:comfy-api 在转发前会丢弃该字段,由 Comfy Router 代为轮询。 - 自定义任务 ID。不会覆盖系统生成的任务 ID,但可用于查询。在单个用户账号内必须唯一。 + 自定义任务 ID。不会覆盖系统生成的任务 ID,但可用于查询。在单个用户账号内必须唯一。此项被忽略:comfy-api 在转发前会丢弃该字段,由 Comfy Router 代为轮询。 @@ -207,7 +208,7 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - true 表示生成带水印的结果,false 表示不生成。默认 false。 + true 表示生成带水印的结果,false 表示不生成。默认为 false。 @@ -219,24 +220,24 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 已生成画面的宽高比(width:height)。取值为 "16:9"、"9:16" 或 "1:1" 之一。默认 "16:9"。 + 生成画面的宽高比(宽度:高度)。取值为 "16:9"、"9:16" 或 "1:1"。默认为 "16:9"。 - 可选值: `16:9`, `9:16`, `1:1` + 可选值:`16:9`、`9:16`、`1:1` - 视频长度,以秒为单位。支持的取值为 3 到 15。默认 5。 + 视频时长,单位为秒。支持的值为 3 到 15。默认为 5。 - 范围: `3` 到 `15` + 范围:`3` 到 `15` - 已生成视频的清晰度。取值为 "720p" 或 "1080p" 之一。默认 "720p"。 + 生成视频的清晰度。取值为 "720p" 或 "1080p"。默认为 "720p"。 - 可选值: `720p`, `1080p` + 可选值:`720p`、`1080p` -由 Router 在 `GET /v2/models/kling/kling-3.0-turbo/openapi.json` 提供的 schema 生成,与它在请求到达提供商之前用于校验调用的文档相同。 +本文档根据 Router 在 `GET /v2/models/kling/kling-3.0-turbo/openapi.json` 提供的 schema 生成,请求到达提供商之前,Router 会依据同一份文档校验调用。 ### 输出 @@ -245,7 +246,7 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 匹配该查询的任务。 + 与查询匹配的任务。 @@ -253,25 +254,37 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 消耗金额,精确到小数点后两位。 + 消费金额,精确到两位小数。 + + + + 扣款所使用的现金账户(仅当 charge_type 为 "cash" 时出现),例如 "balance"。部分任务会返回该字段,其他任务可能省略。 - 消耗账户类型。"cash" 表示余额,"unit" 表示资源包。 + 消费账户类型。"cash" 表示余额,"unit" 表示资源包。 + + + + `amount` 和 `list_price` 的 ISO 4217 货币代码,例如 "USD"。部分任务会返回该字段,其他任务可能省略。 + + + + 任务在任何折扣前的标价,以十进制字符串表示。部分任务会返回该字段,其他任务可能省略。 - 可消耗资源包类型(仅在 charge_type 为 "unit" 时存在)。取值为 "video"、"image" 或 "audio" 之一。 + 可消耗资源包类型(仅当 charge_type 为 "unit" 时出现)。取值为 "video"、"image" 或 "audio" 之一。 - 任务创建时间。Unix 时间戳,以毫秒为单位。 + 任务创建时间。Unix 时间戳,单位为毫秒。 - 格式: `int64` + 格式:`int64` - 此任务的自定义任务 ID(如果有)。 + 此任务的自定义任务 ID(如有)。 @@ -283,27 +296,27 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 任务已生成的输出。 + 该任务的已生成输出。 - 已生成视频的时长,以秒为单位。 + 已生成视频的时长,单位为秒。 - 分组标记,仅对已分组的图像存在。 + 分组标记,仅对分组图像存在。 - 由系统生成的输出 ID。 + 系统生成的输出 ID。 - 已生成 MP3 音频的时长,以秒为单位。 + 已生成 MP3 音频的时长,单位为秒。 - 已生成音频的 MP3 URL(防盗链保护)。 + 已生成音频的 MP3 URL(防盗链)。 @@ -311,7 +324,7 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 素材来源。"kling" 表示官方库;数字为创作者 ID。 + 素材来源。"kling" 表示官方素材库;数字为创作者 ID。 @@ -323,19 +336,19 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 已生成结果的 URL(防盗链保护)。30 天后清除。 + 已生成结果的 URL(防盗链)。30 天后清除。 - 带水印结果的 URL(防盗链保护)。 + 带水印结果的 URL(防盗链)。 - 已生成 WAV 音频的时长,以秒为单位。 + 已生成 WAV 音频的时长,单位为秒。 - 已生成音频的 WAV URL(防盗链保护)。 + 已生成音频的 WAV URL(防盗链)。 @@ -343,9 +356,9 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 任务更新时间。Unix 时间戳,以毫秒为单位。 + 任务更新时间。Unix 时间戳,单位为毫秒。 - 格式: `int64` + 格式:`int64` @@ -353,7 +366,7 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 由系统生成的请求 ID。 + 系统生成的请求 ID。 ## 示例 @@ -386,7 +399,7 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID "duration": "5", "id": "kling-v2-output-2b1a0f9e8d7c", "type": "video", - "url": "https://example.invalid/kling/kling-3.0-turbo/generated.mp4" + "url": "https://example.invalid/kling/v2/generated.mp4" } ], "status": "succeeded", diff --git a/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx b/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx index e3731aac5b..63e62c7123 100644 --- a/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx @@ -2,16 +2,17 @@ title: "使用 Comfy Router 调用 Kling Image O1" description: "通过 Comfy Router 调用 kling/kling-image-o1:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling Image O1" -translationSourceHash: cf053382 +translationSourceHash: ca32c929 translationFrom: development/comfy-router/models/kling/kling-image-o1/code.mdx translationBlockHashes: "_intro": 513c65df "Quick start": 6256a30d - "Schema": d18a5393 + "Schema": 60d9f6fd "Examples": 826db173 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/kling/kling-image-o1.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -166,7 +167,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 此任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。 + 此任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。此字段会被忽略:comfy-api 在转发前会丢弃该字段,由 Comfy Router 代为轮询。 格式:`uri` @@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账户内必须唯一。 + 自定义任务 ID。在单个用户账户内必须唯一。此字段会被忽略:comfy-api 在转发前会丢弃该字段,由 Comfy Router 代为轮询。 @@ -204,7 +205,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。Omni 模型可以通过带有元素和图像的 Prompt 实现多种能力。使用 \<\<\<>>> 格式指定图像,例如 \<\<\>>。 + 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。Omni 模型可以通过结合元素和图像的提示词实现多种能力。使用 \<\<\<>>> 格式指定图像,例如 \<\<\>>。 @@ -214,7 +215,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 控制生成单张图像还是组图。 + 控制生成单张图像还是组图。kling-image-o1 不支持 series(当省略 model_name 时,v1 代理使用的也是该值);此类请求会以 HTTP 400 拒绝。 可选值:`single`、`series` 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 711df496fd..39bdb8e979 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,16 +2,17 @@ title: "将 Kling V2.5 Turbo 与 Comfy Router 搭配使用" description: "通过 Comfy Router 调用 kling/kling-v2-5-turbo:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1a5ec6e5 +translationSourceHash: 1671e7b6 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 2495a4d3 "Quick start": dc63b3ac - "Schema": 68d50e72 + "Schema": 3bcb036e "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"; @@ -166,7 +167,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 回调通知地址 + 回调通知地址。忽略:comfy-api 会在转发前丢弃此字段;Comfy Router 会代为轮询。 格式:`uri` @@ -182,71 +183,71 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID 控制相机沿水平轴(x 轴)的运动。负值表示向左,正值表示向右。 - 范围:`-10` 到 `10` + 范围:`-10` 至 `10` - 控制相机在竖直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。 + 控制相机在竖直平面(x 轴)的旋转。负值表示向下旋转,正值表示向上旋转。 - 范围:`-10` 到 `10` + 范围:`-10` 至 `10` - 控制相机的翻滚量(z 轴)。负值表示逆时针,正值表示顺时针。 + 控制相机的滚动量(z 轴)。负值表示逆时针,正值表示顺时针。 - 范围:`-10` 到 `10` + 范围:`-10` 至 `10` - 控制相机在水平平面内的旋转(y 轴)。负值表示向左旋转,正值表示向右旋转。 + 控制相机在水平平面(y 轴)的旋转。负值表示向左旋转,正值表示向右旋转。 - 范围:`-10` 到 `10` + 范围:`-10` 至 `10` 控制相机沿竖直轴(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 + 自定义任务 ID。忽略:comfy-api 会在转发前丢弃此字段;Comfy Router 会代为轮询。 - 视频生成模式。std:标准模式,更具性价比。pro:专业模式,可生成时长更长、质量更高的视频。 + 视频生成模式。std:标准模式,性价比高。pro:专业模式,可生成时长更长但质量更高的视频。 可选值:`std`、`pro` - 模型名。使用 Comfy Router 时可省略或发送 null;模型由请求路径选择。如提供名称,则必须与该路径一致。 + 模型名。使用 Comfy Router 时,请省略该字段或发送 null;模型由请求路径选择。提供的名称必须与该路径匹配。 @@ -254,15 +255,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 该分镜的时长(秒)。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 + 此分镜的时长(秒)。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 - 分镜序号 + 镜头序号 - 该分镜的提示词。最大长度 512 个字符。 + 此分镜的提示词。最大长度为 512 个字符。 @@ -270,31 +271,31 @@ 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。 - 分镜方式。当 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。 @@ -302,15 +303,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - true 表示生成水印,false 表示不生成。 + true 表示生成水印,false 表示不生成水印。 -本页面内容根据 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 在请求到达提供商之前用于校验调用的文档相同。 ### 输出 - 错误码 + 错误代码 @@ -318,11 +319,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 任务创建时间,Unix 时间戳,单位为毫秒 + 任务创建时间,Unix 时间戳(毫秒) - 任务的扣减单位 + 任务的扣减单位数 @@ -360,7 +361,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 带水印的已生成视频 URL,防盗链格式 + 已生成视频(带水印,防盗链格式)的 URL 格式:`uri` @@ -376,7 +377,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 任务更新时间,Unix 时间戳,单位为毫秒 + 任务更新时间,Unix 时间戳(毫秒) 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 ccfd89e64f..327c445a0f 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,16 +2,17 @@ title: "通过 Comfy Router 使用 Kling V2.6" description: "通过 Comfy Router 调用 kling/kling-v2-6:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Kling V2.6" -translationSourceHash: 1e64e957 +translationSourceHash: c445a7bd translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": 04868509 "Quick start": 48a3d970 - "Schema": 9d23ff94 + "Schema": a61a551f "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"; @@ -160,13 +161,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 会代为轮询。 格式:`uri` @@ -186,13 +187,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 控制相机在垂直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。 + 控制相机在竖直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。 范围:`-10` 到 `10` - 控制相机的滚动幅度(z 轴)。负值表示逆时针,正值表示顺时针。 + 控制相机的滚动量(z 轴)。负值表示逆时针,正值表示顺时针。 范围:`-10` 到 `10` @@ -218,11 +219,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,25 +233,25 @@ 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 + 自定义任务 ID。忽略:comfy-api 在转发前会丢弃该字段;Comfy Router 会代为轮询。 - 视频生成模式。std:标准模式,性价比高。pro:专业模式,生成的视频时长更长,输出质量更高。 + 视频生成模式。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 时必填。 @@ -258,11 +259,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 分镜序号 + 镜头序号 - 该分镜的提示词。最大长度为 512 个字符。 + 该分镜的提示词。最大长度 512 个字符。 @@ -274,38 +275,38 @@ 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` + 可选值:`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。 - 是否同时生成带水印的结果。当前不支持自定义水印。 + 是否同时生成带水印的结果。目前不支持自定义水印。 - true 表示生成水印,false 表示不生成。 + 是表示生成水印,否表示不生成。 -根据 Router 在 `GET /v2/models/kling/kling-v2-6/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前 Router 用于校验调用的文档相同。 +该内容根据 Router 在 `GET /v2/models/kling/kling-v2-6/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前校验调用时所依据的同一份文档。 ### 输出 @@ -322,7 +323,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 任务的扣减单位 + 任务的扣减单位数 @@ -346,11 +347,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-omni/code.mdx b/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx index 9bbff5063b..1b3275f3e0 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: 226ee8a6 +translationSourceHash: 29d1799c translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": f9b37353 + "Schema": 68bd0500 "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 会代您轮询。 格式:`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,31 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账号内必须唯一。 + 自定义任务 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` + 可能的值:`first_frame`、`end_frame` 视频生成模式。std:标准模式,生成 720P 视频,性价比高。pro:专业模式,生成 1080P 视频,视频输出质量更高。 - 可选值:`pro`、`std` + 可能的值:`pro`、`std` - 模型名。使用 Comfy Router 时可省略或发送 null,模型由请求路径选择。若提供名称,则必须与该路径一致。 + 模型名。使用 Comfy Router 时可省略或发送 null;模型由请求路径选择。提供的名称必须与该路径一致。 @@ -220,55 +221,55 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 该分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 + 此分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 - 镜头序号 + 分镜序号 - 该分镜的提示词。最大长度 512 个字符。 + 此分镜的提示词。最大长度为 512 个字符。 - 是否生成多镜头视频。为 true 时,prompt 参数无效。为 false 时,shot_type 和 multi_prompt 参数无效。 + 是否生成多分镜视频。为 true 时,prompt 参数无效。为 false 时,shot_type 和 multi_prompt 参数无效。 - 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。可通过 \<\<\<>>> 格式指定元素、图像或视频,例如 \<\>、\<\<\>>、\<\<\>>。 + 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。可按 \<\<\<>>> 格式指定元素、图像或视频,例如 \<\>、\<\<\>>、\<\<\>>。 分镜方式。当 multi_shot 参数设置为 true 时必填。 - 可选值:`customize`、`intelligence` + 可能的值:`customize`、`intelligence` 生成视频时是否同时生成声音。 - 可选值:`on`、`off` + 可能的值:`on`、`off` - 参考视频列表。可用作功能参考视频,也可用作待编辑的视频,默认为待编辑的视频。 + 参考视频列表。可用作特征参考视频,也可用作待编辑视频,默认为待编辑视频。 是否保留视频原始声音。yes 表示保留,no 表示不保留。 - 可选值:`yes`、`no` + 可能的值:`yes`、`no` - 参考视频类型。feature 为功能参考视频,base 为待编辑的视频。 + 参考视频类型。feature 为特征参考视频,base 为待编辑视频。 - 可选值:`feature`、`base` + 可能的值:`feature`、`base` - 上传视频的网址。仅支持 .mp4/.mov 格式。时长在 3-10 秒之间。分辨率必须在 720px 到 2160px 之间。支持 24-60 fps 的帧率。只能上传 1 个视频,且大小不超过 200MB。 + 上传视频的网址。仅支持 .mp4/.mov 格式。时长在 3-10 秒之间。分辨率必须在 720px 到 2160px 之间。支持 24-60 fps 的帧率。仅可上传 1 个视频,大小不超过 200MB。 @@ -279,7 +280,7 @@ 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 生成,该文档与请求到达提供商之前用于校验调用的文档相同。 +本页内容根据 Router 在 `GET /v2/models/kling/kling-v3-omni/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -296,7 +297,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 任务的扣费单位数 + 任务的扣减单位数 @@ -320,23 +321,23 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 视频总时长(秒) + 视频总时长,单位为秒 - 已生成的视频 ID + 已生成视频的 ID 已生成视频的 URL - 格式:`uri` + Format: `uri` - 已生成的带水印视频 URL,防盗链格式 + 已生成视频带水印的 URL,防盗链格式 - 格式:`uri` + Format: `uri` 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 614cc72b20..de9a587900 100644 --- a/zh/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,17 +2,18 @@ title: "通过 Comfy Router 使用 Kling V3" description: "通过 Comfy Router 调用 kling/kling-v3:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Kling V3" -translationSourceHash: ecfa3f9b +translationSourceHash: e07d4035 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 74a12e0f "Quick start": 09c0a41a "Serving providers": a8b20c72 - "Schema": 77550c0a + "Schema": 8e8b04e6 "Examples": 8623c725 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/kling/kling-v3.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -177,7 +178,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 回调通知地址 + 回调通知地址。此字段会被忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 格式:`uri` @@ -197,19 +198,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` @@ -221,19 +222,19 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/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` - 视频生成的灵活度。值越高,模型的灵活度越低,与用户提示词的相关性越强。 + 视频生成中的灵活性。该值越高,模型的灵活程度越低,与用户提示词的相关性越强。 范围:`0` 到 `1` @@ -247,17 +248,17 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 自定义任务 ID + 自定义任务 ID。此字段会被忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 - 视频生成模式。std:标准模式,性价比高。pro:专业模式,可生成时长更长、质量更高的视频。 + 视频生成模式。std:标准模式,具有成本效益。pro:专业模式,生成时长更长但质量更高的视频输出。 可选值:`std`、`pro` - 模型名。使用 Comfy Router 时可省略或传 null,模型由请求路径决定。如果提供名称,必须与该路径一致。 + 模型名。使用 Comfy Router 时请省略此字段或发送 null;模型由请求路径选择。提供的名称必须与该路径匹配。 @@ -265,47 +266,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` - 生成视频时是否同时生成声音。仅 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。 @@ -316,7 +317,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ true 表示生成水印,false 表示不生成。 -由 Router 在 `GET /v2/models/kling/kling-v3/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 +本文档根据 Router 在 `GET /v2/models/kling/kling-v3/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -357,11 +358,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 视频总时长(秒) + 视频总时长,单位为秒 - 已生成视频 ID + 已生成视频的 ID 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 1fd6d2c0a4..6425b141a5 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: 3c228231 +translationSourceHash: 892ccf77 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": 6f4cf55b + "Schema": f693e2ef "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,21 +161,21 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ ### 输入 - 生成视频画面的宽高比例(宽:高)。未使用首帧参考或视频编辑功能时必填。 + 生成视频画面的宽高比(宽度:高度)。当未使用首帧参考或视频编辑功能时必填。 - 可选值:`16:9`、`9:16`、`1:1` + 可能的值:`16:9`、`9:16`、`1:1` - 本任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。 + 本任务结果的回调通知地址。配置后,任务状态变化时服务器会主动通知。该项被忽略: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,31 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账号内必须唯一。 + 自定义任务 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` + 可能的值:`first_frame`、`end_frame` 视频生成模式。std:标准模式,生成 720P 视频,性价比高。pro:专业模式,生成 1080P 视频,视频输出质量更高。 - 可选值:`pro`、`std` + 可能的值:`pro`、`std` - 模型名。使用 Comfy Router 时可省略或传 null;模型由请求路径选择。若提供名称,则必须与该路径一致。 + 模型名。使用 Comfy Router 时可省略或传 null;模型由请求路径决定。若提供名称,则必须与该路径一致。 @@ -220,7 +221,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 本分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 + 该分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 @@ -228,7 +229,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 本分镜的提示词。最大长度为 512 个字符。 + 该分镜的提示词。最大长度 512 个字符。 @@ -236,39 +237,39 @@ 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` + 可能的值:`customize`、`intelligence` 生成视频时是否同时生成声音。 - 可选值:`on`、`off` + 可能的值:`on`、`off` - 参考视频列表。可用作功能参考视频或待编辑视频,默认为待编辑视频。 + 参考视频列表。可用作功能参考视频,或用作待编辑视频,默认为待编辑视频。 - 是否保留视频的原始声音。yes 表示保留,no 表示不保留。 + 是否保留视频原始声音。yes 表示保留,no 表示不保留。 - 可选值:`yes`、`no` + 可能的值:`yes`、`no` - 参考视频类型。feature 为特征参考视频,base 为待编辑视频。 + 参考视频类型。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,12 +280,12 @@ 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 生成,与请求到达提供商之前用于校验调用的文档相同。 +根据 Router 在 `GET /v2/models/kling/kling-video-o1/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前校验调用所使用的同一份文档。 ### 输出 - 错误码 + 错误代码 @@ -292,11 +293,11 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 任务创建时间,Unix 时间戳,单位为毫秒 + 任务创建时间,Unix 时间戳(毫秒) - 任务扣除的单位数 + 任务的扣减单位数 @@ -330,13 +331,13 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ 已生成视频的 URL - 格式:`uri` + Format: `uri` - 带水印的已生成视频的 URL,防盗链格式 + 带水印的已生成视频 URL,防盗链格式 - 格式:`uri` + Format: `uri` @@ -350,7 +351,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 任务更新时间,Unix 时间戳,单位为毫秒 + 任务更新时间,Unix 时间戳(毫秒) diff --git a/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx index f59763d31c..e39add7cbf 100644 --- a/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx +++ b/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx @@ -2,16 +2,17 @@ title: "配合 Comfy Router 使用 Videos Avatar Image 2video" description: "通过 Comfy Router 调用 kling/videos-avatar-image2video:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Videos Avatar Image 2video" -translationSourceHash: 444b1395 +translationSourceHash: 5181e917 translationFrom: development/comfy-router/models/kling/videos-avatar-image2video/code.mdx translationBlockHashes: "_intro": baca1542 "Quick start": 5605d33f - "Schema": eeb06fe1 + "Schema": 073bf8b2 "Examples": ce6803dd --- + {/* GENERATED FILE. Generated from router-schemas/kling/videos-avatar-image2video.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -164,13 +165,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R - 本任务结果的回调通知地址。 + 本任务结果的回调通知地址。此字段会被忽略:comfy-api 在转发前会丢弃该字段;Comfy Router 会代你轮询。 格式:`uri` - 自定义任务 ID。在单个用户账户内必须唯一。 + 自定义任务 ID。在单个用户账户内必须唯一。此字段会被忽略:comfy-api 在转发前会丢弃该字段;Comfy Router 会代你轮询。 @@ -216,7 +217,7 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R - 任务的扣费单元 + 任务的扣费单位 diff --git a/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx index de571505d6..c67e2e655f 100644 --- a/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx +++ b/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx @@ -2,16 +2,17 @@ title: "通过 Comfy Router 使用视频唇形同步" description: "通过 Comfy Router 调用 kling/videos-lip-sync:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "视频唇形同步" -translationSourceHash: ddd2a405 +translationSourceHash: 6103bea9 translationFrom: development/comfy-router/models/kling/videos-lip-sync/code.mdx translationBlockHashes: "_intro": 0477697a "Quick start": e13a4628 - "Schema": 90571e9f + "Schema": 4fb7c777 "Examples": d1dd6ed8 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/kling/videos-lip-sync.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -176,7 +177,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID ### 输入 - 回调通知地址。任务状态发生变化时,服务器会发出通知。 + 回调通知地址。任务状态发生变化时,服务器会发出通知。此项会被忽略:comfy-api 在转发之前会丢弃该字段,由 Comfy Router 代你轮询。 格式:`uri` @@ -246,7 +247,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID - 任务创建时间,Unix 时间戳(毫秒) + 任务创建时间 @@ -300,7 +301,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID - 任务更新时间,Unix 时间戳(毫秒) + 任务更新时间 diff --git a/zh/development/comfy-router/models/runway/gen4-image/code.mdx b/zh/development/comfy-router/models/runway/gen4-image/code.mdx index 4c11d24ba8..eb940c8368 100644 --- a/zh/development/comfy-router/models/runway/gen4-image/code.mdx +++ b/zh/development/comfy-router/models/runway/gen4-image/code.mdx @@ -2,16 +2,17 @@ title: "通过 Comfy Router 使用 Gen 4 Image" description: "通过 Comfy Router 调用 runway/gen4_image:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Gen 4 Image" -translationSourceHash: c5792f5c +translationSourceHash: 51dc9815 translationFrom: development/comfy-router/models/runway/gen4-image/code.mdx translationBlockHashes: "_intro": f3b89ce9 "Quick start": 82a202eb - "Schema": d889abf3 + "Schema": 1160ec6d "Examples": 291dbf54 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/runway/gen4_image.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -168,7 +169,7 @@ curl https://api.comfy.org/v2/models/runway/gen4_image/requests/$REQUEST_ID \ - 包含编码图像的 HTTPS URL 或 data URI + 包含编码图像的 HTTPS URL、Runway 上传 URI(runway://)或 data URI 由 Router 在 `GET /v2/models/runway/gen4_image/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前它用于校验调用的同一份文档。 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 e5f33d3207..c4299fc5a3 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,16 +2,17 @@ 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: 83fe91a1 +translationSourceHash: e062dc40 translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: "_intro": 614e2e15 "Quick start": ff9945c8 - "Schema": faf9e081 + "Schema": cb29dfae "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"; @@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES - 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位(low/medium;medium 为默认值);其他模型目前会忽略此项。 + 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位:low、medium 或 auto(省略时为 xAI 的默认值;auto 在生成时使用 low,在编辑时使用 medium)。其他模型会忽略此项。 - 可选值:`low`、`medium`、`high` + 可选值:`low`、`medium`、`high`、`auto` @@ -184,7 +185,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 提供。因此,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` 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 f2ce00dd3e..d237f1b93a 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,16 +2,17 @@ title: "配合 Comfy Router 使用 Grok Imagine Image Pro" description: "通过 Comfy Router 调用 xai/grok-imagine-image-pro:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: 7932bb72 +translationSourceHash: 773b1560 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: "_intro": 97d341e4 "Quick start": 3a4bd585 - "Schema": 5d56d158 + "Schema": 805c771c "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"; @@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES - 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位(low/medium;默认为 medium);其他模型目前会忽略该项。 + 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位:low、medium 或 auto(省略时为 xAI 的默认值;auto 在生成时使用 low,在编辑时使用 medium)。其他模型会忽略该项。 - 可选值:`low`、`medium`、`high` + 可选值:`low`、`medium`、`high`、`auto` @@ -184,7 +185,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` 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 11a69c5911..2e2915a1a8 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,16 +2,17 @@ title: "配合 Comfy Router 使用 Grok Imagine Image Quality" description: "通过 Comfy Router 调用 xai/grok-imagine-image-quality:端点、请求结构与 Router 返回的响应。" sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 923968d2 +translationSourceHash: 9f6e16d5 translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: "_intro": 72081c22 "Quick start": 799275b8 - "Schema": e0fcef44 + "Schema": e2c96ff6 "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"; @@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE - 输出图像的质量。对于 grok-imagine-image-2.0,此参数用于选择价格档位(low/medium;默认 medium);其他模型目前会忽略该项。 + 输出图像的质量。对于 grok-imagine-image-2.0,此参数用于选择价格档位:low、medium 或 auto(省略时采用 xAI 的默认值;auto 在生成时使用 low,在编辑时使用 medium)。其他模型会忽略该项。 - 可选值:`low`、`medium`、`high` + 可选值:`low`、`medium`、`high`、`auto` @@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE - 返回图像所用的响应格式。可以是 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` 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 50889fad9d..20106b0edc 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,16 +2,17 @@ title: "使用 Grok Imagine Image 与 Comfy Router" description: "通过 Comfy Router 调用 xai/grok-imagine-image:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Grok Imagine Image" -translationSourceHash: 9cfb938a +translationSourceHash: 2e5c55ad translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: "_intro": a2e97c88 "Quick start": a5495331 - "Schema": 1d17b83a + "Schema": 171da7d5 "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"; @@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID - 输出图像的质量。对于 grok-imagine-image-2.0,此参数用于选择价格档位(low/medium;默认为 medium);其他模型目前会忽略该参数。 + 输出图像的质量。对于 grok-imagine-image-2.0,此参数用于选择价格档位:low、medium 或 auto(省略时使用 xAI 的默认值;auto 在生成时使用 low,在编辑时使用 medium)。其他模型会忽略该参数。 - 可能的值:`low`, `medium`, `high` + 可能的值:`low`, `medium`, `high`, `auto` diff --git a/zh/development/comfy-router/realtime.mdx b/zh/development/comfy-router/realtime.mdx new file mode 100644 index 0000000000..35fb985474 --- /dev/null +++ b/zh/development/comfy-router/realtime.mdx @@ -0,0 +1,223 @@ +--- +title: "Comfy Router 实时语音会话" +sidebarTitle: "实时语音" +description: "通过 Comfy Router 打开 Grok Voice 实时 WebSocket 会话:端点、身份验证、按秒计费、会话限制,以及可能遇到的错误和关闭码。" +translationSourceHash: e4024a38 +translationFrom: development/comfy-router/realtime.mdx +translationBlockHashes: + "_intro": a85f88e5 + "Endpoint": 2ae36abf + "Authentication": 582120fe + "Connect": b61ae8c6 + "Events": a3ac8c47 + "Pricing": 25d35f6c + "Limits": 85e21dff + "Errors": 3085ba65 + "Next": 3e8c1bd8 +--- +Comfy Router 通过 fal 提供的 xAI Grok Voice 中转实时语音到语音会话。你只需使用自己的 Comfy API 密钥,与 Router 建立一个 WebSocket 连接。Router 会校验你的账户和积分,在上游开启会话,然后在两个方向上中转事件。会话费用按秒从你的 Comfy 积分中扣除。 + +## 端点 + +```text +wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime +``` + +该请求属于 WebSocket 升级请求(`GET`,并带有 `Connection: Upgrade` 和 `Upgrade: websocket`)。其他任何请求都会被拒绝,并返回 `426`。 + +## 身份验证 + +在升级请求的请求头中发送你的 Comfy API 密钥,可以使用 `X-API-Key: comfyui-...` 或 `Authorization: Bearer comfyui-...`。Router 不会从查询字符串或 WebSocket 子协议中读取密钥。 + + +浏览器无法为 WebSocket 设置请求头,而且 Comfy API 密钥绝不能传到浏览器。请从服务器打开会话,并自行将音频转发到浏览器。 + + +## 连接 + +升级成功后,即可收发 xAI 为 Grok Voice 文档中记录的实时事件。下面的示例会配置会话、发送一轮文本对话,并打印它收到的每个事件类型。 + + + +```python Python +# pip install websockets msgpack +import asyncio +import os + +import msgpack +import websockets + +URL = "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime" + + +async def send(ws, event): + await ws.send(msgpack.packb(event)) + + +async def main(): + async with websockets.connect( + URL, + additional_headers={"X-API-Key": os.environ["COMFY_API_KEY"]}, + ) as ws: + await send(ws, { + "type": "session.update", + "session": { + "voice": "eve", + "instructions": "You are a helpful assistant.", + "turn_detection": {"type": "server_vad"}, + }, + }) + await send(ws, { + "type": "conversation.item.create", + "item": { + "type": "message", + "role": "user", + "content": [{"type": "input_text", "text": "Hello!"}], + }, + }) + await send(ws, {"type": "response.create"}) + + async for message in ws: + if isinstance(message, str): + continue # fal 自己的 x-fal-message 帧 + event = msgpack.unpackb(message) + print(event["type"]) + if event["type"] == "response.done": + break + + +asyncio.run(main()) +``` + +```javascript Node.js +// npm install ws @msgpack/msgpack +import WebSocket from "ws"; +import { encode, decode } from "@msgpack/msgpack"; + +const ws = new WebSocket( + "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime", + { headers: { "X-API-Key": process.env.COMFY_API_KEY } }, +); + +ws.on("unexpected-response", (req, res) => { + // 升级被拒绝。JSON 响应体会说明原因。 + let body = ""; + res.on("data", (chunk) => (body += chunk)); + res.on("end", () => console.error(res.statusCode, body)); +}); + +const send = (event) => ws.send(encode(event)); + +ws.on("open", () => { + send({ + type: "session.update", + session: { + voice: "eve", + instructions: "You are a helpful assistant.", + turn_detection: { type: "server_vad" }, + }, + }); + send({ + type: "conversation.item.create", + item: { + type: "message", + role: "user", + content: [{ type: "input_text", text: "Hello!" }], + }, + }); + send({ type: "response.create" }); +}); + +ws.on("message", (data, isBinary) => { + if (!isBinary) return; // fal 自己的 x-fal-message 帧 + const event = decode(data); + console.log(event.type); + if (event.type === "response.done") ws.close(); +}); + +ws.on("close", (code) => console.log("closed", code)); +``` + + + +完成后请立即关闭 socket。计费会持续到会话关闭为止,而不是到最后一个响应结束。 + +## 事件 + +Router 不定义自己的事件协议。服务器事件会完全按照 fal 发送的原样抵达你这边,Router 接受的客户端事件也会被原样转发。关于事件列表、会话字段、音色和音频格式,请参阅: + +- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) 以及 xAI 的 [realtime 事件 schema](https://docs.x.ai/voice-realtime.ws.json) +- fal 的 [Grok Voice realtime 模型页面](https://fal.ai/models/xai/grok-voice/realtime)及其 [API 页面](https://fal.ai/models/xai/grok-voice/realtime/api) + +请像示例中那样,把每个客户端事件作为单条 msgpack 二进制消息发送。这是 fal 的 realtime 客户端所用的封装方式,模型的事件也会以同样的方式返回,即从 `session.created` 开始的 msgpack 二进制消息。fal 还会发送自己的 JSON 文本消息,类型为 `x-fal-message`(计时信息);你可以跳过它们。Router 的检查也接受把客户端事件作为单条 JSON 文本消息发送,但除非你已用你的客户端测试过 JSON,否则请使用 msgpack。 + +Router 在转发每个客户端事件之前都会进行检查: + +- **事件类型:**`session.update`、`input_audio_buffer.append`、`input_audio_buffer.commit`、`input_audio_buffer.clear`、`conversation.item.create`、`conversation.item.delete`、`conversation.item.truncate`、`response.create`、`response.cancel`,以及 fal 的 `x-fal-session.configure`。 +- **模型:**`session.update` 中的 `model` 必须是 `grok-voice-latest`、`grok-voice-3.0` 或 `grok-voice-2.0`。 +- **工具:**由你的客户端执行的函数工具是允许的。服务器端工具(搜索、X 搜索、文件搜索和 MCP)会被拒绝。 +- **媒体:**图像和视频输入会被拒绝。会话仅支持语音和文本。 +- **大小:**单条客户端消息最大为 1 MiB。 + +被拒绝的事件不会被转发,并且 Router 会以关闭码 `1008` 关闭会话。 + +## 定价 + +一次会话的费用为**每秒 $0.0011869**(约每分钟 $0.0712,或每秒 0.2504 积分、约每分钟 15.0 积分,按 211 积分 = 1 美元计算)。会话开启期间按 15 秒的增量计费,最后不足 15 秒的部分按秒计费并向上取整。计费从升级开始,直到 socket 关闭为止,无论音频是否在传输。 + +## 限制 + +| 限制 | 值 | +| --- | --- | +| 每账户会话数 | 同一时间只能有一个打开的会话。打开第二个会话会返回 `429`,错误码为 `router.realtime.session_already_live`。 | +| 会话时长 | 最长 30 分钟,且绝不会超过连接时您的积分余额所能覆盖的时长。 | +| 会话期间的积分 | Router 每 15 秒重新检查一次您的余额,当余额不足以覆盖下一秒时便结束会话。 | +| 连接速率 | 每次升级尝试都计入您的[按调用方计算的请求速率](/zh/development/comfy-router/limitations#requests-are-rate-limited-per-caller),并与其他 Router 调用共享该速率。 | + +当会话达到时间上限或积分已用完时,连接可能会在没有关闭帧的情况下关闭(通常表现为关闭码 `1006`)。请仅在上限充值之后重新连接,或者如果需要更长时间,请开启新会话。 + +## 错误 + +### 升级之前 + +如果 Router 拒绝连接,它不会切换协议,而是返回 HTTP 状态码和 JSON 响应体: + +```json +{ + "detail": "Insufficient credits to open a realtime session.", + "error_type": "insufficient_credits", + "code": "router.realtime.insufficient_credits" +} +``` + +请根据 `code` 进行判断;`detail` 供人阅读。 + +| 状态 | `code` | 原因 | 处理方法 | +| --- | --- | --- | --- | +| `426` | `router.realtime.upgrade_required` | 该请求不是 WebSocket 升级请求。 | 使用 WebSocket 客户端连接。 | +| `401` | `router.realtime.unauthorized` | API 密钥缺失或无效。 | 在 `X-API-Key` 或 `Authorization: Bearer` 中发送有效的密钥。 | +| `402` | `router.realtime.insufficient_credits` | 你的余额不足以支付至少一秒的会话。 | 添加积分,然后重新连接。 | +| `402` | `router.realtime.spend_denied` | 会话将要计费的钱包没有可用资金。响应体中的 `denied_reason` 和 `billed_workspace` 会指明是哪个钱包。 | 向该工作区添加积分,然后重新连接。 | +| `403` | `router.realtime.provider_disabled` | 你的工作区的合作伙伴提供商策略不允许此提供商。 | 请工作区管理员允许该提供商。 | +| `404` | `router.realtime.model_not_allowed` | URL 中的模型不可用于实时会话。 | 检查 URL。 | +| `429` | `router.realtime.rate_limited` | 你已超出请求速率。 | 等待 `Retry-After`,然后重试。 | +| `429` | `router.realtime.session_already_live` | 你的账号已打开另一个会话。 | 请先关闭它。 | +| `429` | `router.realtime.concurrency_limit` | 合作伙伴模型的并发调用过多。 | 减少并发工作,然后重试。 | +| `502` | `router.realtime.upstream_refused`、`router.realtime.token_mint_failed` | 上游提供商未能打开会话。 | 使用退避策略重试。 | +| `503` | 任何其他 `router.realtime.*` 代码 | 实时会话暂时不可用。 | 使用退避策略重试。 | + +### 升级之后 + +| 关闭代码 | 含义 | 处理方法 | +| --- | --- | --- | +| `1008` | 某个客户端事件被拒绝(参见[事件](#events))。 | 修复该事件。会话已结束。 | +| `1012` | Router 正在重启。 | 重新连接。将启动新会话,并从新的升级开始计费。 | +| `1006`(无关闭帧) | 通常是会话达到时间限制或积分已用完时客户端报告的结果。网络中断看起来也一样。 | 添加积分或启动新会话。 | + +任何其他关闭代码都来自 fal 或 xAI。请参阅[事件](#events)中链接的文档。 + +## 下一步 + +- [计费](/zh/development/comfy-router/billing):Router 如何计费,以及如何核对用量。 +- [错误与重试](/zh/development/comfy-router/errors):其他 Router 调用返回的错误分类。 +- [限制](/zh/development/comfy-router/limitations):请求速率及其他限制。 diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index 51f1a1ee9a..2aeacacf6c 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -2,15 +2,15 @@ title: "Comfy Router API 参考" description: "每个 Comfy Router 端点、参数、响应体和错误分类,均由 Comfy API 契约生成。" sidebarTitle: "API 参考" -translationSourceHash: a6f99965 +translationSourceHash: 194f763d translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": 222fd740 + "Endpoints": e0879d3c "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 5952af3f - "Result assets": 18fe6dad + "Pre-flight cost estimates": f0ba96a1 + "Result assets": 5936427c "Per-model input and output schemas": 61c6bde8 "Schemas": 984bd216 --- @@ -28,6 +28,7 @@ translationBlockHashes: + {/* 生成的文件:请勿手动编辑。 @@ -51,67 +52,67 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 **列出 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 个字符 每页返回的模型数量。 - 最多 100,默认值:20 + 最大 100,默认值:20 - 调用方从先前的 `200` 响应中持有的 `ETag`。 + 调用方从之前的 `200` 响应中持有的 `ETag`。 **响应** - 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` - 请求无效。请检查错误类型和请求体。 + 请求无效。请检查错误类型与请求体。 - 响应体:[`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 暂时不可用。请退避后重试。 - 响应体:[`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 读取一个合作伙伴模型的目录条目。** 无需列出完整目录即可读取单个模型的详情。 @@ -120,29 +121,29 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 规范 `{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 个字符 - 调用方从之前的 `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` @@ -150,107 +151,105 @@ 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` - 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 同步运行合作伙伴模型。** +**通过规范模型 ID 同步运行合作伙伴模型。** -运行模型,并在同一个响应中收到其已完成的结果。 +运行模型,并在同一响应中接收其已完成的结果。 **参数** - 规范 `{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 个字符 - 由调用方生成的密钥,使重试一次逻辑调用变得安全。 + 调用方生成的密钥,使重试同一逻辑调用变得安全。 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" 开头,但仅当该提供商针对此模型的转换器无法提供该操作时;转换器确实携带媒体的分支会正常进行;然后,在解析了自带密钥(BYOK)凭据的请求上,任何替代提供商都会被拒绝并返回 `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 文档。 +**响应** + 正常:未提供 `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` - 凭据缺失或无效。 + 凭证缺失或无效。 响应体:[`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` @@ -262,9 +261,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` 并复用同一个 key;`invalid_input` 则需要使用新的 key。此路由上的两种 `invalid_input` 冲突与 key 完全无关,更换新 key 也无法消除其中任何一种:当请求体选择一个 multipart 操作(一次编辑),而该提供商针对此模型的转换器无法处理该操作时,指定备用提供商的 `model_provider` 会被拒绝,其 `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` 时) @@ -274,64 +273,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` 表示应等待额度窗口。 + 请检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示应减少在途调用数;`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` - 提供商自己的响应无法转换为结果(`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`、`X-Comfy-Upstream-Status`、`Retry-After` ### `POST /v2/models/{provider}/{model}/estimate` -**在运行模型调用之前先为它定价,而无需实际运行。** +**在真正运行之前预估一次模型调用的价格,而无需运行它。** -返回一个以美元计的预检估算,表示用此模型运行该请求体将产生的费用,其定价依据与实际运行计费所依据的同一份费率卡(若某模型按其供应商上报的成本计费,则改为依据供应商公布的价格表来估算)。这是估算值,而非最终费用:你实际支付的是工作区用量与账单记录中结算后的费用。请求体会先按模型的输入 schema 进行校验,校验方式与默认运行(未设置 `strict_mode`,也未设置 `reject_unknown_fields`)相同,因此未通过模型 schema 的请求体在此处和在运行时都会得到相同的 `422`;不会向任何提供商派发请求,也不会产生任何扣费。该结果并非价格锁定:它按 `pricing_as_of` 时点生效的费率计价,而一次运行则按计费时生效的费率收费。在该功能逐步推出的期间,此路由会返回 `403`,并带有 `error_type: not_enabled`。 +返回预检估算,单位为美元,说明在此模型上运行该请求体将产生多少费用;其定价依据与运行计费相同的费率表(对于按供应商所报告成本计费的模型,则改为根据供应商公布的价格表进行估算)。这是估算值,并非最终费用:你实际支付的是工作区使用情况和账单记录中的结算费用。请求体会先按模型的输入 schema 进行校验,校验方式与默认运行(不启用 `strict_mode`,也不启用 `reject_unknown_fields`)相同,因此未能通过模型 schema 的请求体在此处与在运行路由上一样会返回 `422`;不会向提供商派发任何内容,也不会产生任何费用。该结果不构成价格锁定:它按 `pricing_as_of` 时生效的费率计价,而运行则按计费评级时生效的费率收费。在该功能逐步推出期间,此路由会返回 `403`,并带有 `error_type: not_enabled`;对于 Router 尚无法运行的模型,会返回同样的 `403`,但带有运行路由自己的 `detail`,因此请阅读 `detail` 来区分两者。 **参数** - 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即被运行模型所属的合作伙伴。 + 规范 `{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 个字符 - 选择用于提供此模型的备用提供商,以替代其当前的默认提供商。 + 选择一个备用提供商来提供此模型,而不是使用其当前默认提供商。 **请求体** -`application/json` -- [`RouterModelInput`](#routermodelinput)(必填) +`application/json`: [`RouterModelInput`](#routermodelinput)(必填) -合作伙伴模型的原生 JSON 输入,与此模型的同步路由所接受的请求体完全相同。它会按模型自身的输入 schema 进行校验,与默认运行的校验方式一致(此路由不接受 `strict_mode` 或 `reject_unknown_fields`),并由其自身的字段(输出数量、输入图像所选择的操作)决定计价内容。 +合作伙伴模型的原生 JSON 输入,与同步路由为此模型接受的请求体相同。它会按模型自身的输入 schema 进行校验,校验方式与默认运行相同(此路由不接受 `strict_mode` 或 `reject_unknown_fields`),而请求体自身的字段(输出数量、输入图像所选的操作)决定对哪些内容计价。 **响应** @@ -354,7 +353,7 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 - 此调用方或此模型不允许该请求。 + 此调用方或模型不允许该请求。 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` @@ -372,51 +371,51 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 - 估算请求的请求体未通过模型的 schema 校验,或指定的模型与路径中的模型不一致。 + 估算请求体未通过模型 schema 的校验,或者指定的模型与路径中的模型不同。 响应体:[`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 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`(仅容量拒绝时) ### `GET /v2/models/{provider}/{model}/openapi.json` -**以 OpenAPI 文档形式读取单个合作伙伴模型的输入和输出 Schema。** +**以 OpenAPI 文档的形式读取一个合作伙伴模型的输入和输出 schema。** -以独立的 OpenAPI 文档形式读取单个模型的输入和输出 Schema。 +以独立的 OpenAPI 文档形式读取一个模型的输入和输出 schema。 **参数** 规范 `{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 - 该模型的输入和输出 Schema,以独立的 OpenAPI 文档形式呈现。 + OK:该模型的输入和输出 schema,作为独立的 OpenAPI 文档。 - 响应体:[`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) - 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` + 正文:[`RouterModelInputSchemaDocument`](#routermodelinputschemadocument);响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` - Not Modified - 自调用方在 `If-None-Match` 中发送的 `ETag` 以来,文档未发生变化。 + 未修改:自调用方在 `If-None-Match` 中发送的 `ETag` 以来,文档未发生变化。 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` @@ -424,165 +423,164 @@ 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` 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` ### `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),字母数字短标识,例如 `anthropic`,最多 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内要运行的模型。 + 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即要在该提供商内运行的模型。 - 类型:[`RouterModelSegment`](#routermodelsegment):字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment),字母数字短标识,例如 `claude-opus-4-6`,最多 128 个字符 - 选择用于服务此模型的备用提供商,而不是其当前默认提供商。 + 选择一个替代提供商来服务该模型,而不是使用其当前的默认提供商。 仅在与 `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` - 凭证缺失或无效。 + 凭据缺失或无效。 - 响应体:[`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。 + 未找到该模型 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 凭证,并且(对于多部分情形)不带编辑操作。 +检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 指定的时间并复用同一个键;`invalid_input` 则需要使用新的键。此路由上的两种 `invalid_input` 冲突都与该键无关,且任何新的键都无法消除其中任何一种:当请求体选择的是该提供商针对此模型的转换器无法处理的 multipart 操作(编辑)时,用 `model_provider` 指定替代提供商会被拒绝,其 `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` 时) - 请求内容未通过模型的 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` 表示需要等待配额窗口。 + 检查 `X-Comfy-Error-Type`:`queue_backlog_full` 表示你持有的未完成排队请求数已达到允许的上限,因此请等其中一个完成后再提交;`rate_limited` 表示需要等待配额窗口结束。 - 正文:[`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`、`Retry-After`(仅容量拒绝时) + 请求体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时) ### `GET /v2/models/{provider}/{model}/requests/{request_id}` **收集一个已提交请求的结果。** -收集端点。对于已成功完成的请求,它返回合作伙伴模型自身的原生输出,与同步路由的 `200` 针对同一模型和同一输入返回的内容逐字节相同,因此两种交付模式产生同一种结果形状,调用方无需第二个解析器即可在两者之间切换。 +收集端点。对于已成功完成的请求,它返回合作伙伴模型自身的原生输出,与同步路由的 `200` 对同一模型和同一输入所承载的内容逐字节一致,因此两种交付模式产生同一种结果形状,调用方无需第二个解析器即可在两者之间切换。 **参数** - 规范 `{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 个字符 @@ -596,7 +594,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ **响应** - 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` @@ -608,7 +606,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ - 缺失或无效的凭据。 + 凭据缺失或无效。 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` @@ -626,7 +624,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ - Router 请求级失败:请求从未到达模型,或由于模型本身未报告的原因而失败。 + Router 请求级失败:请求从未到达模型,或由于模型自身未反馈的原因而失败。 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` @@ -638,7 +636,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ - 请求处于与操作冲突的状态。请检查错误类型。 + 请求处于与该操作冲突的状态。请检查错误类型。 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` @@ -650,7 +648,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ - Router 请求级失败:请求从未到达模型,或由于模型本身未报告的原因而失败。 + Router 请求级失败:请求从未到达模型,或由于模型自身未反馈的原因而失败。 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` @@ -659,7 +657,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ **请求取消一个已提交的请求。** -请求 Comfy 停止一个尚未完成的请求。这是一项请求,而不是保证,`202` 正说明了这一点:`CANCELLATION_REQUESTED` 表示该请求已被接受,并不表示运行已经停止。已经发送给合作伙伴的运行仍可能完成;而合作伙伴完成的生成会被计费,无论是否有人获取结果。因此,需要了解实际结果的调用方应随后读取状态端点,在状态端点中,已生效的取消会显示为 `COMPLETED`,并像其他所有终端结果一样带有 `error_type`。 +请求 Comfy 停止一个尚未完成的请求。这只是一个请求,而不是保证,`202` 正是这个意思:`CANCELLATION_REQUESTED` 表示该请求已被接受,而不是运行已经停止。已经在合作伙伴处开始执行的运行仍可能完成,而完成的合作伙伴生成会被计费,无论是否有人收取结果,因此,需要了解实际发生了什么的调用方随后应读取状态端点,在那里,生效的取消是 `COMPLETED`,并像其他任何终端结果一样携带 `error_type`。 **参数** @@ -670,13 +668,13 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ - 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即要在该提供商内运行的模型。 + 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即该提供商内要运行的模型。 类型:[`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 个字符 @@ -686,122 +684,122 @@ 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` - 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` -**读取一个已提交请求的队列状态。** +**读取单个已提交请求的队列状态。** -轮询端点。它返回的是请求当前的状态,而非结果,因此客户端可以持续观察一次长时间生成,而无须在每次轮询时都传输其输出。当此端点返回 `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 个字符 **响应** - OK,请求当前的队列状态。 + 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 请求级失败:请求从未到达模型,或因模型自身未反馈的原因而失败。 + 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` - Router 请求级失败:请求从未到达模型,或因模型自身未反馈的原因而失败。 + Router 请求级失败:请求从未到达模型,或因模型本身未反馈的原因而失败。 - 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`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)。 +此处描述较为简短。关于模型选择、验证、重试和计费,请参阅[使用 Comfy Router API](/zh/development/comfy-router/api);关于响应头行为,请参阅[响应头](/zh/development/comfy-router/headers)。 ## 错误分类桶 @@ -967,41 +965,41 @@ Router 错误的机器可读类别,同时也会在 `X-Comfy-Error-Type` 响应 调用方仍可启动的昂贵模型调用数;在 `429` 时为 `0`。 -## 预检成本估算 +## 运行前成本估算 -`POST /v2/models/{provider}/{model}/estimate` 会在不实际运行的情况下为一个请求体定价,而排队提交(`POST /v2/models/{provider}/{model}/requests`)会在其 `201` 响应中返回与 `estimate` 相同的 [`RouterCostEstimate`](#routercostestimate)。两者都依据 Comfy 对该次运行计费所采用的费率卡定价,唯一的例外是按供应商上报成本计费的模型,其价格取自供应商公布的价格表,标记为 `estimated`。返回的每个数字都是估算值,而非最终费用:最终以你工作区用量与账单记录中的结算费用为准。使用自有提供商密钥的运行不由 Comfy 计费(见下文)。在估算功能逐步推出期间,该路由会返回 `403`,并带有 `error_type: not_enabled`,且提交响应会省略 `estimate`。模型目录中仍然不包含价格。 +`POST /v2/models/{provider}/{model}/estimate` 会在不运行的情况下为一个请求体定价,而排队提交(`POST /v2/models/{provider}/{model}/requests`)会在其 `201` 响应中返回与 `estimate` 相同的 [`RouterCostEstimate`](#routercostestimate)。二者都依据 Comfy 为该次运行计费时所使用的费率卡定价,例外是按供应商报告的成本计费的模型,此类模型依据供应商公布的价格表给出 `estimated`。两者返回的任何数字都是估算值,而不是最终费用:以你工作区的用量和账单记录中的结算费用为准。使用你自己的提供商密钥的运行不由 Comfy 计费(见下文)。在估算功能逐步推出期间,该路由会返回 `403` 并附带 `error_type: not_enabled`,而提交响应会省略 `estimate`。目录中仍然不包含任何价格。 -在关注任何金额之前,请先读取 `source`。缺失的数值绝不意味着免费。 +在查看任何金额之前先读取 `source`。缺失的数字绝不意味着免费。 -| `source` | 携带内容 | 如何解读 | +| `source` | 携带的字段 | 如何解读 | | --- | --- | --- | -| `exact` | `amount`、`amount_cents`、`credits` | 一个估算值,等于该请求体按 `pricing_as_of` 中所列费率应收取的费用;最终以你工作区用量与账单记录中的结算费用为准。 | -| `estimated` | `min_amount`、`max_amount` 及其 `_cents` 形式,不含 `amount` | 一个估算值,其费用取决于提供商回传的某个数量,而请求体为该数量给出了边界;预期费用落在该边界之间,最终以你工作区用量与账单记录中的结算费用为准。 | -| `free` | `amount` "0",`amount_cents` 与 `credits` 为 `0` | 费率卡将该请求定价为零,因此估算值为 `0`;最终以你工作区用量与账单记录中的结算费用为准。只有 `free` 报价才读作 `0`。 | -| `unknown` | `reason`,不含任何数值 | 运行前无法给出价格。将任何其他 `source` 值都视为 `unknown`。 | +| `exact` | `amount`、`amount_cents`、`credits` | 等于按 `pricing_as_of` 中的费率对该请求体计费的估算值;以你工作区的用量和账单记录中的结算费用为准。 | +| `estimated` | `min_amount`、`max_amount` 及其 `_cents` 形式,没有 `amount` | 费用取决于供应商回报的某个量的估算值,而请求体为其设定了边界;预期费用落在该边界之内,以你工作区的用量和账单记录中的结算费用为准。 | +| `free` | `amount` 为 "0",`amount_cents` 和 `credits` 为 `0` | 费率卡将此次请求定价为零,因此估算值为 `0`;以你工作区的用量和账单记录中的结算费用为准。只有 `free` 的报价才会显示 `0`。 | +| `unknown` | `reason`,没有数字 | 在运行之前无法给出价格。任何其他 `source` 值都视为 `unknown`。 | -`unknown` 估算的 `reason` 为以下之一: +`unknown` 估算值的 `reason` 为以下之一: -- `not_quotable`:Router 无法在运行前为这次调用定价,因为它按提供商回传、而请求体未加限定的数量计费,或者请求体无法按其发送的内容定价。将任何无法识别的 `reason` 都视为 `not_quotable`。 -- `unpriced_model`:费率卡未对该请求定价。 -- `byok`(仅排队提交):该次运行使用你自己的提供商密钥,因此 Comfy 不为其计费。 -- `pricing_unavailable`(仅排队提交):请求被接受时无法读取费率卡。提交仍会被接受,运行照常计费。 +- `not_quotable`:路由器无法在运行前为此调用定价,因为它的计费基于供应商回报的某个量,而请求体并未为其设定边界;或者无法对按原样发送的请求体定价。任何无法识别的 `reason` 都视为 `not_quotable`。 +- `unpriced_model`:费率卡没有为此请求定价。 +- `byok`(仅排队提交):该次运行使用你自己的提供商密钥,因此 Comfy 不为其收取任何费用。 +- `pricing_unavailable`(仅排队提交):在请求被接纳时无法读取费率卡。提交仍会被接受,运行也照常计费。 -Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/zh/development/comfy-router/limitations#无法预先估算的模型)中。未列在该处的模型针对特定请求体仍可能返回 `unknown`,因此请对每个估算都读取 `source`。 +路由器目前还无法在运行前定价的模型列在[无法在运行前估算的模型](/zh/development/comfy-router/limitations#models-without-a-pre-flight-estimate)中。未列在该处的模型针对某个特定请求体仍可能返回 `unknown`,因此请对每个估算值都读取 `source`。 -估算采用失败关闭(fail closed)的情形: +估算的失败关闭行为如下: -- 当某个数值需要费率卡,而费率卡未加载或已过期时,`/estimate` 会返回 `503`,而不是给出猜测。排队提交绝不会因为其估算而被拒绝;它会携带 `source: unknown` 和 `reason: pricing_unavailable`。完全无法在运行前定价的调用(`not_quotable`),或使用自有提供商密钥的排队提交(`byok`),会在不读取费率卡的情况下作答,因此那个 `200` 并不说明费率卡是否最新。 -- `/estimate` 会像默认运行那样,按模型自身的输入 schema 校验请求体,因此不符合模型 schema 的请求体会得到与该次运行相同的 `422`,以及相同的 `detail[]` 形状。此时不会定价,也不会派发。 -- 排队提交的幂等重放(`Idempotent-Replayed: true`)会省略 `estimate`,因为原始报价未被存储。 +- 当某个数字需要费率卡,而卡片未加载或已过期时,`/estimate` 会返回 `503`,而不是给出猜测。排队提交绝不会因为其估算而被拒绝;它会改为携带 `source: unknown` 和 `reason: pricing_unavailable`。完全无法在运行前定价的调用(`not_quotable`),或使用你自己的提供商密钥的排队提交(`byok`),会在不读取费率卡的情况下得到响应,因此该 `200` 并不能说明卡片是否为最新。 +- `/estimate` 会像默认运行那样,依据模型自身的输入 schema 校验请求体,因此不符合模型 schema 的请求体会得到与运行相同的 `422`,`detail[]` 形状也相同。不会进行任何定价或派发。 +- 排队提交的幂等重放(`Idempotent-Replayed: true`)会省略 `estimate`,因为原始报价不会被存储。 -估算的局限。一个 `200` 的数字并不代表该次运行一定会被接受,也不代表一定按该金额收费: +估算的局限。`200` 返回的数字并不承诺该次运行会被接受,也不承诺会正好按此金额计费: -- `/estimate` 不接受 `strict_mode` 或 `reject_unknown_fields`,因此只校验模型的原生约定:一个在 `strict_mode=true` 运行中按备用提供商自身 schema 可以接受的请求体,在这里可能得到 `422`;而某个未声明的顶层字段,在 `reject_unknown_fields=true` 的运行中会被拒绝,在这里却会被定价。Anthropic Messages 模型是例外:其 schema 允许未声明字段,因此 `reject_unknown_fields=true` 的运行不会拒绝任何字段,而估算只会为未声明的顶层字段 `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` 以及空的 `mcp_servers` 定价。任何其他未声明的顶层字段都会使其返回 `unknown`,并带有 `reason: not_quotable`。 -- `pricing_as_of` 是费率卡的获取时间;对于取自供应商公布价格表的 `estimated` 报价,它是读取该价格表的日期(两者都未读取时,则为估算作答的时间)。它不是价格锁定:运行按其被计费评级时生效的费率收费。 -- `/estimate` 为 `model_provider` 指定的分支报价,或为原生提供商报价。它不接受 `fallback_provider` 或 `strict_mode` 参数。同步运行的回退重试落到另一个提供商时,按该提供商的费率计费,而该费率并非估算所报的费率;运行响应上的 `X-Comfy-Router-Fallback-Provider` 表明发生了这种情况。排队提交没有回退,因此其 `estimate` 报的就是实际运行的分支。 -- 对于 `model_provider` 分支上的同一请求体,或对于在同级操作(sibling operation)上运行的请求体,`/estimate` 与排队提交的 `estimate` 可能为略有差异的文档定价。提交的 `estimate` 是按运行实际发送的文档定价的。 -- `/estimate` 始终报出平台费用。使用自有提供商密钥的运行不由 Comfy 计费,但 `/estimate` 不会检测这一点,仍会返回一个数值;只有排队提交才会返回 `reason: byok`。- 美元金额由未舍入的美分渲染,最多保留 8 位小数,可计费的不足 1 美分的 `amount` 绝不会显示为 `0`。`credits` 为 `round(amount × 211, 2)`,这与 `X-Comfy-Credits-Used` 对一次收费所采用的换算相同,因此对于极小的非零价格,`credits` 可能舍入为 `0`;在这一点很重要时,请按 `amount` 或 `amount_cents` 编制预算,而不是按 `credits`。该响应头仍是某次运行结束后的事后数值;余额保存在 Comfy 平台上。 +- `/estimate` 不接受 `strict_mode` 或 `reject_unknown_fields`,因此它只检查模型的原生契约:某个请求体在 `strict_mode=true` 的运行中按备用提供商自身的 schema 可以通过,在这里却可能得到 `422`;而 `reject_unknown_fields=true` 的运行会拒绝的未声明顶层字段,在这里却会被定价。Anthropic Messages 模型是例外:其 schema 允许未声明字段,因此 `reject_unknown_fields=true` 的运行不会拒绝任何字段,估算只会为未声明的顶层字段 `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` 以及空的 `mcp_servers` 定价。任何其他未声明的顶层字段都会使其返回 `unknown` 和 `reason: not_quotable`。 +- `pricing_as_of` 是费率卡被获取的时间。取自供应商公布价格表的 `estimated` 报价会携带该价格表被读取的日期。计费数量依据供应商公布的费率表预测的 `exact` 或 `estimated` 报价,在该费率表的读取日期早于费率卡时,会携带该读取日期。既未读取费率卡也未读取费率表时,它是估算值被返回的时间。它不是价格锁定:运行会按其被计价时生效的费率计费。 +- `/estimate` 为 `model_provider` 指定的那一段(或原生提供商)报价。它不接受 `fallback_provider` 或 `strict_mode` 参数。同步运行的兜底重试如果落到另一个提供商,就会按该提供商的费率计费,而估算并未对此报价;运行响应中的 `X-Comfy-Router-Fallback-Provider` 会说明发生了这种情况。排队提交没有兜底,因此其 `estimate` 报价的就是实际运行的那一段。 +- 对于 `model_provider` 段上的同一个请求体,或对于在同级操作上运行的请求体,`/estimate` 与排队提交的 `estimate` 可能对略有差异的文档定价。提交的 `estimate` 是按运行实际发送的文档定价的。 +- `/estimate` 始终按平台费用报价。使用你自己的提供商密钥的运行不由 Comfy 计费,但 `/estimate` 不会检测到这一点,仍会返回一个数字;只有排队提交才会返回 `reason: byok`。- 美元金额由未舍入的美分换算渲染而来,最多保留 8 位小数,可计费的、不足一美分的 `amount` 绝不会显示为 `0`。`credits` 为 `round(amount × 211, 2)`,与 `X-Comfy-Credits-Used` 对一次扣费所采用的换算相同,因此当价格极小而并非为零时,`credits` 可能舍入为 `0`;在这种情况下,请以 `amount` 或 `amount_cents` 做预算,而不是 `credits`。该响应头仍是某次运行结束后的事后数值;余额保存在 Comfy 平台上。 ## 结果资产 @@ -1014,7 +1012,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ | `minimax/*` | 已完成视频 | 12 小时 | | `xai/*` | 每一张已生成的图像,以及已完成视频 | 24 小时 | -这些有效期从 URL 签名时开始计算,而不是从你打开它时开始。缓存或重放的 URL 可能剩余时间更少;重放不会为其续期。请及时下载资产。只有每一行中列出的资产会被复制:`byteplus/seedream-*` 和 `byteplus/seededit-*` 图像不在 BytePlus 视频行的覆盖范围内。 +这些有效期从 URL 签名时开始计算,而不是从你打开它时开始。缓存或重放的 URL 可能剩余时间更少;重放不会为其续期。`Idempotency-Key` 记录的存在时间可能长于它所保存的 URL,因此从这类 URL 过期前一小时起,使用相同键的重试会得到 `409 invalid_input`,而不是已记录下来的响应;而在被返回时就已经如此接近过期的响应,仍可在 5 分钟内重放。请及时下载资产。只有每一行中列出的资产会被复制:`byteplus/seedream-*` 和 `byteplus/seededit-*` 图像不在 BytePlus 视频行的覆盖范围内。 复制只由模型的原生提供商执行。由替代提供商提供服务的运行(`model_provider` 指定了某个替代提供商,或原生运行的回退重试落到了替代提供商上,并通过 `X-Comfy-Router-Fallback-Provider` 披露)会返回该提供商自己的 URL,这些 URL 遵循提供商的过期时间,不会被复制。`model_provider` 取值 `default`、`comfy` 和 `comfyui` 时不指定替代提供商,因此这些运行属于原生运行并按上述方式复制;`model_provider` 运行的回退重试落回原生提供商时也同样如此。 From dd26cbbedbd7a3a0f8db3385ec1e6191ecb44bcf Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 3 Nov 2026 11:15:22 +0800 Subject: [PATCH 2/5] i18n: fix glue bugs, anchors and truncated blocks in the zh/ja/ko sync --- ja/development/comfy-router/limitations.mdx | 2 +- .../dreamina-seedance-2-0-mini/code.mdx | 3 +- .../byteplus/seedance-1-0-pro-250528/code.mdx | 43 +++++++++++++++++-- .../byteplus/seedance-1-5-pro-251215/code.mdx | 3 +- ja/development/comfy-router/realtime.mdx | 8 ++-- ja/development/comfy-router/reference.mdx | 2 +- zh/development/comfy-router/limitations.mdx | 2 +- .../dreamina-seedance-2-0-260128/code.mdx | 3 +- .../code.mdx | 3 +- .../seedance-1-0-pro-fast-251015/code.mdx | 3 +- zh/development/comfy-router/realtime.mdx | 6 +-- zh/development/comfy-router/reference.mdx | 2 +- 12 files changed, 60 insertions(+), 20 deletions(-) diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index c023005423..382a56f031 100644 --- a/ja/development/comfy-router/limitations.mdx +++ b/ja/development/comfy-router/limitations.mdx @@ -110,7 +110,7 @@ Router は最終レスポンスのみを返し、ストリーミングされる ## 事前見積もりのないモデル -Router は、以下のモデルへの呼び出しを実行前に確実に価格算出することがまだできません。そのため、これらのモデルについては `/estimate` およびキュー中の送信の `estimate` が `source: unknown` を返します。ただし、特定のリクエストボディに対しては数値を返す場合もあります。`unknown` は数値が提示されなかったことを意味し、実行が無料であることを意味するものではありません。[Comfy の課金と使用量](#comfy-charges-and-usage) のルールは引き続き適用されます。自身のプロバイダーキーでの実行は Comfy から課金されず、`X-Comfy-Credits-Used` は任意であるため、ヘッダーが不足している場合はコストが報告されなかったことを意味します。ここに記載されていないモデルでも、特定のリクエストボディに対して `unknown` を返すことがあるため、すべての見積もりで `source` を確認してください。 +Router は、以下のモデルへの呼び出しを実行前に確実に価格算出することがまだできません。そのため、これらのモデルについては `/estimate` およびキュー中の送信の `estimate` が `source: unknown` を返します。ただし、特定のリクエストボディに対しては数値を返す場合もあります。`unknown` は数値が提示されなかったことを意味し、実行が無料であることを意味するものではありません。[Comfy の課金と使用量](#comfy-の課金と使用量) のルールは引き続き適用されます。自身のプロバイダーキーでの実行は Comfy から課金されず、`X-Comfy-Credits-Used` は任意であるため、ヘッダーが不足している場合はコストが報告されなかったことを意味します。ここに記載されていないモデルでも、特定のリクエストボディに対して `unknown` を返すことがあるため、すべての見積もりで `source` を確認してください。 このリストは見積もりカバレッジの拡大に伴い縮小していきます。これは Router 自身の価格算出コードから生成されており、公開されていないモデルは決して掲載されません。 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 bc71e43744..e46e68f430 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 @@ -403,7 +403,8 @@ false: 生成されたビデオの最終フレーム画像を返しません。 エラーメッセージ -The ID of the video generation task + + 動画生成タスクの 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 94ef7a5347..f153a548cb 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 @@ -393,13 +393,48 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 エラーメッセージ -The ID of the video generation task + + 動画生成タスクの ID - ビデオ生成タスクのID。タスクで使用されたモデルの名前とバージョン。 - - 待って、原文を確認します。 + タスクで使用されたモデルの名前とバージョン + + + + 生成された動画のコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance の動画タスク照会が返す位置です。BytePlus 自身のフィールドで、変更されずに転送されます。 + + + + 生成された動画の解像度(例: `1080p`)。BytePlus 自身のフィールドで、成功した動画タスクで返され、変更されずに転送されます。 + + + + タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功した動画タスクで返され、変更されずに転送されます。 + + 形式: `int64` + + + + タスクの状態 + + 指定可能な値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` + + + + タスクが最後に更新された時刻。値は UNIX タイムスタンプ(秒)です。 + + + + リクエストのトークン使用量 + + + + モデルが生成したトークン数 + + + + 動画生成モデルでは入力トークン数は計算されず 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 54e0c430ef..01a260b876 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 @@ -403,7 +403,8 @@ Router が `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で提 エラーメッセージ -The ID of the video generation task + + 動画生成タスクの ID diff --git a/ja/development/comfy-router/realtime.mdx b/ja/development/comfy-router/realtime.mdx index f7950c99c7..81773cdef5 100644 --- a/ja/development/comfy-router/realtime.mdx +++ b/ja/development/comfy-router/realtime.mdx @@ -172,7 +172,7 @@ Router は転送する前に各クライアントイベントをチェックし | アカウントあたりのセッション数 | 同時に開けるセッションは 1 つです。2 つ目を開くと、`router.realtime.session_already_live` を伴う `429` が返されます。 | | セッションの長さ | 最大 30 分で、接続時点であなたのクレジット残高が賄える時間を超えることはありません。 | | セッション中のクレジット | Router は 15 秒ごとにあなたの残高を再確認し、残高が次の 1 秒分を賄えなくなるとセッションを終了します。 | -| 接続レート | 各アップグレード試行は、あなたの[呼び出し元ごとのリクエストレート](/ja/development/comfy-router/limitations#requests-are-rate-limited-per-caller)にカウントされ、他の Router 呼び出しと共有されます。 | +| 接続レート | 各アップグレード試行は、あなたの[呼び出し元ごとのリクエストレート](/ja/development/comfy-router/limitations#リクエストは呼び出し元ごとにレート制限される)にカウントされ、他の Router 呼び出しと共有されます。 | セッションが時間制限に達した場合、またはクレジットが不足した場合、接続はクローズフレームなしで閉じられることがあります(多くの場合、クローズコード `1006` として現れます)。クレジットを追加した後にのみ再接続するか、より長い時間が必要な場合は新しいセッションを開始してください。 @@ -210,13 +210,13 @@ Router が接続を拒否した場合、プロトコルを切り替えずに HTT | クローズコード | 意味 | 対処 | | --- | --- | --- | -| `1008` | クライアントイベントが拒否されました([イベント](#events) を参照)。 | イベントを修正してください。セッションは終了します。 | +| `1008` | クライアントイベントが拒否されました([イベント](#イベント) を参照)。 | イベントを修正してください。セッションは終了します。 | | `1012` | Router が再起動中です。 | 再接続してください。新しいセッションが開始され、新しいアップグレード時点から課金されます。 | | `1006`(クローズフレームなし) | セッションが時間制限に達した、またはクレジットが不足した際にクライアントが報告する値としてよく見られます。ネットワーク切断も同じように見えます。 | クレジットを追加するか、新しいセッションを開始してください。 | -その他のクローズコードは fal または xAI からのものです。[イベント](#events) でリンクされている各社のドキュメントを参照してください。 +その他のクローズコードは fal または xAI からのものです。[イベント](#イベント) でリンクされている各社のドキュメントを参照してください。 -## Next +## 次のステップ - [課金](/ja/development/comfy-router/billing): Router の課金方法と利用量の照合方法。 - [エラーとリトライ](/ja/development/comfy-router/errors): 他の Router 呼び出しが返すエラーの分類。 diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index 1d1239977c..6e131f4990 100644 --- a/ja/development/comfy-router/reference.mdx +++ b/ja/development/comfy-router/reference.mdx @@ -987,7 +987,7 @@ Router が受け付けたものの、完了できなかったリクエストに - `byok`(キュー中の送信のみ): 実行は自分のプロバイダーキーを使用するため、Comfy は何も課金しません。 - `pricing_unavailable`(キュー中の送信のみ): リクエストを受け付けた時点でレートカードを読み取れませんでした。送信自体は受け付けられ、実行は通常どおり課金されます。 -Router がまだ実行前に価格を算出できないモデルは、[事前見積もりのないモデル](/ja/development/comfy-router/limitations#models-without-a-pre-flight-estimate)に一覧されています。そこに掲載されていないモデルでも、特定のボディに対しては `unknown` を返すことがあるため、すべての見積もりで `source` を確認してください。 +Router がまだ実行前に価格を算出できないモデルは、[事前見積もりのないモデル](/ja/development/comfy-router/limitations#事前見積もりのないモデル)に一覧されています。そこに掲載されていないモデルでも、特定のボディに対しては `unknown` を返すことがあるため、すべての見積もりで `source` を確認してください。 見積もりがフェイルクローズする場合: diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index 362d5f9a55..72e4e5fa08 100644 --- a/zh/development/comfy-router/limitations.mdx +++ b/zh/development/comfy-router/limitations.mdx @@ -106,7 +106,7 @@ Router 只返回最终响应,不提供流式 token、服务器发送事件、 模型目录提供计费事实,包括 `billing.charges_on_policy_rejection`,但不提供价格。请显式处理 `yes`、`no` 和 `unknown`。当该值为 `yes` 时,同步的 `content_policy_violation` 错误可能带有 `X-Comfy-Credits-Used`:当提供商拒绝了模型已生成的输出、且 Comfy 为该被拒绝的生成记录了用量时,就会带上该响应头,并包含该数量。输入端拒绝、同一密钥的重放,以及金额过小、无法在响应头的两位小数中显示的收费,都不会带有该响应头;没有该响应头的拒绝表示未报告,而不是免费。参见[计费](/zh/development/comfy-router/billing#模型计费事实)。 -要在运行之前查看价格,可以调用 `POST /v2/models/{provider}/{model}/estimate`,或读取已排队提交的 `201` 响应中的 `estimate` 对象。在估算功能逐步推出的期间,该路由会返回 `403`,并附带 `error_type: not_enabled`,同时提交响应中会省略 `estimate`。两者的价格都来自 Comfy 为该次运行计费所依据的费率卡(对按供应商报告的成本计费的模型,则改为依据供应商公布的价格表进行估算),但该数字只是估算值,并非最终收费;最终以你工作区的用量与计费记录中的结算金额为准。它也不是价格锁定。使用你自己的提供商密钥运行不会被 Comfy 计费,即使 `/estimate` 为其返回了数字;而 `unknown` 估算不包含任何数字,这并不意味着免费。`X-Comfy-Credits-Used` 仍然只是一次运行的事后四舍五入数字,而不是收据。关于如何解读 `exact`、`estimated` 和 `unknown`,参见[预检成本估算](/zh/development/comfy-router/reference#预检成本估算)。无法在运行前定价的模型列在[没有预检估算的模型](#无法预先估算的模型)中。 +要在运行之前查看价格,可以调用 `POST /v2/models/{provider}/{model}/estimate`,或读取已排队提交的 `201` 响应中的 `estimate` 对象。在估算功能逐步推出的期间,该路由会返回 `403`,并附带 `error_type: not_enabled`,同时提交响应中会省略 `estimate`。两者的价格都来自 Comfy 为该次运行计费所依据的费率卡(对按供应商报告的成本计费的模型,则改为依据供应商公布的价格表进行估算),但该数字只是估算值,并非最终收费;最终以你工作区的用量与计费记录中的结算金额为准。它也不是价格锁定。使用你自己的提供商密钥运行不会被 Comfy 计费,即使 `/estimate` 为其返回了数字;而 `unknown` 估算不包含任何数字,这并不意味着免费。`X-Comfy-Credits-Used` 仍然只是一次运行的事后四舍五入数字,而不是收据。关于如何解读 `exact`、`estimated` 和 `unknown`,参见[预检成本估算](/zh/development/comfy-router/reference#运行前成本估算)。无法在运行前定价的模型列在[没有预检估算的模型](#无法预先估算的模型)中。 ## 无法预先估算的模型 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 17c54af15f..3d5e238a89 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 @@ -411,7 +411,8 @@ Seedance 2.5 首帧/首尾帧生成:输出会沿用首帧的画面比例,因 报错信息 -The ID of the video generation task + + 视频生成任务的 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 3397d6115b..ecd12b9673 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 @@ -401,7 +401,8 @@ false:不返回已生成视频的末帧图像。 报错信息 -The ID of the video generation task + + 视频生成任务的 ID 视频生成任务的 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 dc9fefdfdd..d23ffbcfab 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 @@ -393,7 +393,8 @@ false: 不返回已生成视频的最后一帧图像。 报错信息 -The ID of the video generation task + + 视频生成任务的 ID diff --git a/zh/development/comfy-router/realtime.mdx b/zh/development/comfy-router/realtime.mdx index 35fb985474..7a0e407358 100644 --- a/zh/development/comfy-router/realtime.mdx +++ b/zh/development/comfy-router/realtime.mdx @@ -172,7 +172,7 @@ Router 在转发每个客户端事件之前都会进行检查: | 每账户会话数 | 同一时间只能有一个打开的会话。打开第二个会话会返回 `429`,错误码为 `router.realtime.session_already_live`。 | | 会话时长 | 最长 30 分钟,且绝不会超过连接时您的积分余额所能覆盖的时长。 | | 会话期间的积分 | Router 每 15 秒重新检查一次您的余额,当余额不足以覆盖下一秒时便结束会话。 | -| 连接速率 | 每次升级尝试都计入您的[按调用方计算的请求速率](/zh/development/comfy-router/limitations#requests-are-rate-limited-per-caller),并与其他 Router 调用共享该速率。 | +| 连接速率 | 每次升级尝试都计入您的[按调用方计算的请求速率](/zh/development/comfy-router/limitations#请求按调用方进行速率限制),并与其他 Router 调用共享该速率。 | 当会话达到时间上限或积分已用完时,连接可能会在没有关闭帧的情况下关闭(通常表现为关闭码 `1006`)。请仅在上限充值之后重新连接,或者如果需要更长时间,请开启新会话。 @@ -210,11 +210,11 @@ Router 在转发每个客户端事件之前都会进行检查: | 关闭代码 | 含义 | 处理方法 | | --- | --- | --- | -| `1008` | 某个客户端事件被拒绝(参见[事件](#events))。 | 修复该事件。会话已结束。 | +| `1008` | 某个客户端事件被拒绝(参见[事件](#事件))。 | 修复该事件。会话已结束。 | | `1012` | Router 正在重启。 | 重新连接。将启动新会话,并从新的升级开始计费。 | | `1006`(无关闭帧) | 通常是会话达到时间限制或积分已用完时客户端报告的结果。网络中断看起来也一样。 | 添加积分或启动新会话。 | -任何其他关闭代码都来自 fal 或 xAI。请参阅[事件](#events)中链接的文档。 +任何其他关闭代码都来自 fal 或 xAI。请参阅[事件](#事件)中链接的文档。 ## 下一步 diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index 2aeacacf6c..e13aa73ea2 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -985,7 +985,7 @@ Router 错误的机器可读类别,同时也会在 `X-Comfy-Error-Type` 响应 - `byok`(仅排队提交):该次运行使用你自己的提供商密钥,因此 Comfy 不为其收取任何费用。 - `pricing_unavailable`(仅排队提交):在请求被接纳时无法读取费率卡。提交仍会被接受,运行也照常计费。 -路由器目前还无法在运行前定价的模型列在[无法在运行前估算的模型](/zh/development/comfy-router/limitations#models-without-a-pre-flight-estimate)中。未列在该处的模型针对某个特定请求体仍可能返回 `unknown`,因此请对每个估算值都读取 `source`。 +路由器目前还无法在运行前定价的模型列在[无法在运行前估算的模型](/zh/development/comfy-router/limitations#无法预先估算的模型)中。未列在该处的模型针对某个特定请求体仍可能返回 `unknown`,因此请对每个估算值都读取 `source`。 估算的失败关闭行为如下: From e4e312e1d95d8e464e95c63a217cf73d492da928 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 3 Nov 2026 11:34:31 +0800 Subject: [PATCH 3/5] i18n: sync es tutorial pages (batch 1) with upstream/main --- es/tutorials/3d/hunyuan3D-2.mdx | 52 +++--- es/tutorials/3d/pixal3d.mdx | 44 +++--- es/tutorials/3d/trellis2.mdx | 24 +-- es/tutorials/3d/triposplat.mdx | 18 ++- .../video/hunyuan/hunyuan-video-1-5.mdx | 64 ++++---- es/tutorials/video/hunyuan/hunyuan-video.mdx | 86 +++++----- es/tutorials/video/kandinsky/kandinsky-5.mdx | 35 +++-- es/tutorials/video/ltx/ltx-2-3.mdx | 148 +++++++++--------- es/tutorials/video/ltx/ltx-2-5-dfr.mdx | 29 ++-- es/tutorials/video/ltxv.mdx | 7 +- .../video/minimax/minimax-h3-fastvideo.mdx | 49 +++--- .../minimax/minimax-h3-fun-controlnet.mdx | 39 ++--- .../video/minimax/minimax-h3-multiframe.mdx | 19 +-- .../video/minimax/minimax-h3-prompt-guide.mdx | 7 +- es/tutorials/video/wan/fun-control.mdx | 99 ++++++------ es/tutorials/video/wan/wan-animate-2.mdx | 56 +++---- es/tutorials/video/wan/wan-causal-forcing.mdx | 38 ++--- es/tutorials/video/wan/wan-move.mdx | 16 +- es/tutorials/video/wan/wan2-2-fun-control.mdx | 68 ++++---- es/tutorials/video/wan/wan2_2.mdx | 50 +++--- 20 files changed, 489 insertions(+), 459 deletions(-) diff --git a/es/tutorials/3d/hunyuan3D-2.mdx b/es/tutorials/3d/hunyuan3D-2.mdx index 577a584714..1b338191ae 100644 --- a/es/tutorials/3d/hunyuan3D-2.mdx +++ b/es/tutorials/3d/hunyuan3D-2.mdx @@ -2,7 +2,7 @@ title: "Hunyuan3D 2.0 y 2.1 en ComfyUI: flujos de imagen a malla 3D" description: "Genera mallas 3D en ComfyUI desde una imagen o cuatro vistas consistentes con los modelos open source Hunyuan3D 2.0, 2.1 y turbo de Tencent." sidebarTitle: "Hunyuan3D-2" -translationSourceHash: c1132014 +translationSourceHash: 6f829cc4 translationFrom: tutorials/3d/hunyuan3D-2.mdx translationBlockHashes: "_intro": 659765dd @@ -11,7 +11,9 @@ translationBlockHashes: "Hunyuan3D-2 Single View Workflow": 46e82b79 "Hunyuan3D 2.1 Single View Workflow": 5a8b9bc8 "Community Resources": d12dc58a + "Hunyuan3D 2.0 Open-Source Model Series": 363ff037 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" # Introducción a Hunyuan3D 2.0 @@ -101,7 +103,7 @@ Descarga las imágenes de abajo, las usaremos como imágenes de entrada. ![imagen de entrada](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_elf/back.png) -En este ejemplo, las imágenes de entrada ya vienen preprocesadas para eliminar el exceso de fondo. En el uso real, puedes usar Nodos personalizados como [ComfyUI_essentials](https://github.com/cubiq/ComfyUI_essentials) para eliminar automáticamente el exceso de fondo. +En este ejemplo, las imágenes de entrada ya vienen preprocesadas para eliminar el exceso de fondo. En un uso real, puedes usar nodos personalizados como [ComfyUI_essentials](https://github.com/cubiq/ComfyUI_essentials) para eliminar automáticamente el exceso de fondo. ### 2. Instalación manual del modelo @@ -129,13 +131,13 @@ Si necesitas añadir más vistas, asegúrate de cargar las otras imágenes de vi ## Flujo de trabajo Hunyuan3D-2mv-turbo -En el flujo de trabajo Hunyuan3D-2mv-turbo, usaremos el modelo Hunyuan3D-2mv-turbo para generar modelos 3D. Este modelo es una versión con destilación por pasos de Hunyuan3D-2mv, lo que permite generar modelos 3D más rápido. En esta versión del flujo de trabajo, establecemos `cfg` en 1.0 y añadimos un nodo `flux guidance` para controlar la generación con `distilled cfg`. +En el flujo de trabajo Hunyuan3D-2mv-turbo, usaremos el modelo Hunyuan3D-2mv-turbo para generar modelos 3D. Este modelo es una versión con destilación por pasos de Hunyuan3D-2mv, lo que permite generar modelos 3D más rápidamente. En esta versión del flujo de trabajo, establecemos `cfg` en 1.0 y agregamos un nodo `flux guidance` para controlar la generación con `distilled cfg`. ### HY 3D 2.0 MV Turbo {#3d_hunyuan3d_multiview_to_model_turbo} Genera modelos 3D a partir de múltiples vistas con Hunyuan3D 2.0 MV Turbo. -HY 3D 2.0 MV Turbo workflow preview +Vista previa del flujo de trabajo HY 3D 2.0 MV Turbo @@ -169,14 +171,14 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: Descarga las siguientes imágenes y arrástralas a ComfyUI para cargar el flujo de trabajo. -![Hunyuan3D-2mv-turbo workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/hunyuan-3d-turbo.webp) +![Flujo de trabajo Hunyuan3D-2mv-turbo](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/hunyuan-3d-turbo.webp) Descarga las siguientes imágenes, ya que las usaremos como imágenes de entrada. -![input image](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/front.png) -![input image](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/right.png) +![imagen de entrada](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/front.png) +![imagen de entrada](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/right.png) -### 2. Instalación manual del modelo +### 2. Instalar el modelo manualmente Descarga el siguiente modelo y guárdalo en la carpeta correspondiente de ComfyUI @@ -232,7 +234,7 @@ Descarga la imagen de abajo y arrástrala a ComfyUI para cargar el flujo de trab ![Flujo de trabajo de Hunyuan3D-2](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d-non-multiview-train.webp) -Descarga la imagen de abajo; la usaremos como imagen de entrada. +Descarga la imagen de abajo, la usaremos como imagen de entrada. ![Flujo de trabajo de ComfyUI Hunyuan 3D 2](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan_3d_v2_non_multiview_train.png) ### 2. Instalación manual del modelo @@ -252,13 +254,13 @@ ComfyUI/ ![ComfyUI hunyuan3d_2](/images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2_non_multiview.jpg) -1. Asegúrate de que el nodo `Image Only Checkpoint Loader(img2vid model)` haya cargado el modelo `hunyuan3d-dit-v2.safetensors` que renombramos +1. Asegúrate de que el nodo `Image Only Checkpoint Loader(img2vid model)` haya cargado nuestro modelo `hunyuan3d-dit-v2.safetensors` renombrado 2. Carga la imagen en el nodo `Load Image` 3. Haz clic en el botón `Queue`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo ## Flujo de trabajo de vista única de Hunyuan3D 2.1 -Hunyuan3D 2.1 es el modelo de forma posterior de Tencent, lanzado en junio de 2025. Refina la calidad geométrica de Hunyuan3D 2.0, y el checkpoint de ComfyUI reempaqueta el pipeline de forma en un solo archivo, así que este flujo de trabajo necesita una sola descarga de modelo en lugar de archivos DiT y VAE separados. Al igual que los otros flujos de trabajo de esta página, genera una malla sin textura. +Hunyuan3D 2.1 es el modelo de forma sucesor de Tencent, lanzado en junio de 2025. Refina la calidad geométrica de Hunyuan3D 2.0, y el checkpoint de ComfyUI reempaqueta el pipeline de forma en un solo archivo, así que este flujo de trabajo necesita una sola descarga de modelo en lugar de archivos DiT y VAE por separado. Al igual que los otros flujos de trabajo de esta página, genera una malla sin textura. ### HY 3D 2.1 {#3d_hunyuan3d-v2.1} @@ -314,7 +316,7 @@ La malla `.glb` generada se guarda en `ComfyUI/output/mesh/`. ## Recursos de la comunidad -A continuación, encontrarás recursos de la comunidad de ComfyUI relacionados con Hunyuan3D-2: +A continuación encontrarás recursos de la comunidad de ComfyUI relacionados con Hunyuan3D-2: - [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper) - [Kijai/Hunyuan3D-2_safetensors](https://huggingface.co/Kijai/Hunyuan3D-2_safetensors/tree/main) - [ComfyUI-3D-Pack](https://github.com/MrForExample/ComfyUI-3D-Pack) @@ -325,22 +327,22 @@ Actualmente, Hunyuan3D 2.0 ha publicado como código abierto varios modelos que **Serie Hunyuan3D-2mini** -| Modelo | Descripción | Fecha | Parámetros | Huggingface | -|-----------------------|-------------------------------|------------|------------|-------------------------------------------------------------------------------------------| -| Hunyuan3D-DiT-v2-mini | Modelo mini de imagen a forma | 2025-03-18 | 0.6B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mini/tree/main/hunyuan3d-dit-v2-mini) | +| Modelo | Descripción | Fecha | Parámetros | Huggingface | +|-----------------------|--------------------------------|------------|------------|--------------------------------------------------------------------------------------------| +| Hunyuan3D-DiT-v2-mini | Modelo mini de imagen a forma | 2025-03-18 | 0.6B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mini/tree/main/hunyuan3d-dit-v2-mini) | **Serie Hunyuan3D-2mv** -| Modelo | Descripción | Fecha | Parámetros | Huggingface | -|--------------------------|-----------------------------------------------------------------------------------------------------------------------|------------|------------|--------------------------------------------------------------------------------------------| -| Hunyuan3D-DiT-v2-mv-Fast | Versión de destilación de guía; puede reducir a la mitad el tiempo de inferencia del DIT | 2025-03-18 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv-fast) | -| Hunyuan3D-DiT-v2-mv | Modelo de imagen multivista a forma, adecuado para la creación 3D que requiere varios ángulos para entender la escena | 2025-03-18 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv) | +| Modelo | Descripción | Fecha | Parámetros | Huggingface | +|--------------------------|--------------------------------------------------------------------------------------------------------------------|------------|------------|------------------------------------------------------------------------------------------| +| Hunyuan3D-DiT-v2-mv-Fast | Versión con destilación de orientación, puede reducir a la mitad el tiempo de inferencia del DIT | 2025-03-18 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv-fast) | +| Hunyuan3D-DiT-v2-mv | Modelo de imagen multivista a forma, adecuado para creaciones 3D que requieren varios ángulos para comprender la escena | 2025-03-18 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv) | **Serie Hunyuan3D-2** -| Modelo | Descripción | Fecha | Parámetros | Huggingface | -|-------------------------|----------------------------------|------------|------------|-----------------------------------------------------------------------------------------| -| Hunyuan3D-DiT-v2-0-Fast | Modelo de destilación de guía | 2025-02-03 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-fast) | -| Hunyuan3D-DiT-v2-0 | Modelo de imagen a forma | 2025-01-21 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0) | -| Hunyuan3D-Paint-v2-0 | Modelo de generación de texturas | 2025-01-21 | 1.3B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-paint-v2-0) | -| Hunyuan3D-Delight-v2-0 | Modelo Delight de imagen | 2025-01-21 | 1.3B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-delight-v2-0) | +| Modelo | Descripción | Fecha | Parámetros | Huggingface | +|-------------------------|-----------------------------------------|------------|------------|---------------------------------------------------------------------------------------| +| Hunyuan3D-DiT-v2-0-Fast | Modelo con destilación de orientación | 2025-02-03 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-fast) | +| Hunyuan3D-DiT-v2-0 | Modelo de imagen a forma | 2025-01-21 | 1.1B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0) | +| Hunyuan3D-Paint-v2-0 | Modelo de generación de texturas | 2025-01-21 | 1.3B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-paint-v2-0) | +| Hunyuan3D-Delight-v2-0 | Modelo de eliminación de iluminación de imagen | 2025-01-21 | 1.3B | [Visitar](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-delight-v2-0) | diff --git a/es/tutorials/3d/pixal3d.mdx b/es/tutorials/3d/pixal3d.mdx index 9a2aa2df41..1016964fe3 100644 --- a/es/tutorials/3d/pixal3d.mdx +++ b/es/tutorials/3d/pixal3d.mdx @@ -2,16 +2,18 @@ title: "Pixal3D en ComfyUI: modelos 3D PBR desde una sola imagen" description: "Convierte una imagen en un modelo 3D con textura en ComfyUI con Pixal3D, el modelo de imagen a 3D de Tencent ARC con materiales PBR completos." sidebarTitle: "Pixal3D" -translationSourceHash: 489b52d9 +translationSourceHash: 6524a7b2 translationFrom: tutorials/3d/pixal3d.mdx translationBlockHashes: "_intro": c3d2e1ee "How it works": 30b7a245 "Steps to run": 1a7d044c + "Model downloads": 890d9666 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Pixal3D** es un modelo abierto de imagen a 3D de Tencent ARC, presentado en SIGGRAPH 2026. Convierte una sola imagen en un recurso 3D de alta fidelidad con materiales PBR completos. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' + +**Pixal3D** es un modelo de código abierto de imagen a 3D de Tencent ARC, presentado en SIGGRAPH 2026. Convierte una sola imagen en un recurso 3D de alta fidelidad con materiales PBR completos. La mayoría de los generadores nativos 3D sintetizan formas en un espacio canónico e inyectan señales de la imagen mediante atención, lo que deja ambiguas las asociaciones entre píxeles y 3D. Pixal3D, en cambio, usa generación alineada a píxeles: establece una correspondencia directa entre píxeles y 3D mediante retroproyección, de modo que el frente del modelo generado coincide 1:1 con tu imagen de entrada, sin texturas deformadas ni desalineadas. @@ -19,7 +21,7 @@ La mayoría de los generadores nativos 3D sintetizan formas en un espacio canón Sube una sola imagen. Genera un modelo 3D de alta fidelidad con texturas PBR completas, alineado a tu vista de entrada. -Este flujo de trabajo también incluye el pipeline de TRELLIS.2. El nodo `Boolean (Switch to Trellis2)` tiene `false` por defecto, lo que ejecuta el pipeline de Pixal3D y carga el modelo Pixal3D automáticamente. +Este flujo de trabajo también incluye el pipeline de TRELLIS.2. El nodo `Boolean (Switch to Trellis2)` tiene `false` de forma predeterminada, lo que ejecuta el pipeline de Pixal3D y carga el modelo Pixal3D automáticamente. Vista previa del flujo de trabajo de Pixal3D @@ -50,9 +52,9 @@ Sube este archivo al nodo `LoadImage`: ### Pixal3D: de varias vistas a 3D {#pixal3d-multi-views} -Genera un modelo 3D a partir de una hoja de rotación de personaje (vistas de frente, perfil y espalda en una sola imagen). El modelo multivista usa los puntos de vista adicionales para reconstruir geometría que el pipeline de una sola imagen no puede ver, lo que da perfiles laterales y traseros más precisos. +Genera un modelo 3D a partir de una hoja de vistas de personaje (vistas de frente, perfil y espalda en una sola imagen). El modelo multivista usa los puntos de vista adicionales para reconstruir geometría que el pipeline de una sola imagen no puede ver, lo que da perfiles laterales y traseros más precisos. -Usa la plantilla `Character Turnaround Sheet Generator` de la biblioteca de plantillas para producir la hoja de rotación con Nano Banana 2, o prepara tu propia imagen multivista con el sujeto separado del fondo. +Usa la plantilla `Character Turnaround Sheet Generator` de la biblioteca de plantillas para producir la hoja de vistas con Nano Banana 2, o prepara tu propia imagen multivista con el sujeto separado del fondo. Vista previa del flujo de trabajo de varias vistas de Pixal3D @@ -97,9 +99,9 @@ Este flujo de trabajo usa los modelos que se indican a continuación. Descárgal ## Cómo funciona -Pixal3D combina una generación consciente de la cámara y alineada por píxeles con un pipeline completo de posprocesamiento de malla: +Pixal3D combina la generación alineada por píxeles y consciente de la cámara con un pipeline completo de posprocesamiento de malla: -1. **Eliminación de fondo**: BiRefNet elimina el fondo de la imagen de entrada y el flujo de trabajo recorta el sujeto a un lienzo centrado. Un interruptor te permite saltar la eliminación de fondo +1. **Eliminación de fondo**: BiRefNet elimina el fondo de la imagen de entrada y el flujo de trabajo recorta el sujeto a un lienzo centrado. Un interruptor te permite omitir la eliminación de fondo 2. **Estimación de cámara**: MoGe estima la geometría y el campo de visión de la cámara a partir de la imagen. El campo de visión impulsa el acondicionamiento alineado por píxeles 3. **Generación de estructura**: se muestrea un latente de estructura dispersa y se decodifica en vóxeles, que luego se convierten en una malla aproximada 4. **Refinamiento de forma**: la etapa de forma y la etapa de upsampling refinan la malla hasta la resolución objetivo (1536) @@ -110,33 +112,33 @@ Pixal3D combina una generación consciente de la cámara y alineada por píxeles 1. **Carga una imagen**: usa el nodo `LoadImage` para cargar una sola imagen del objeto. 2. **Pon el flujo de trabajo en cola**: presiona Ctrl (Cmd en macOS) + Enter. -3. **Espera a que se complete el pipeline**: las etapas de estructura, forma y textura se ejecutan en secuencia, seguidas del posprocesamiento. -4. **Consulta el resultado**: revisa la malla en el nodo `Preview3DAdvanced`. El modelo 3D se guarda en `ComfyUI/output/3d/ComfyUI/`. +3. **Espera el pipeline**: las etapas de estructura, forma y textura se ejecutan en secuencia, seguidas del posprocesamiento. +4. **Consulta el resultado**: inspecciona la malla en el nodo `Preview3DAdvanced`. El modelo 3D se guarda en `ComfyUI/output/3d/ComfyUI/`. ## Descargas de modelos -Descarga los modelos que usa este flujo de trabajo. Los dos checkpoints de difusión son obligatorios: el interruptor elige cuál se ejecuta. Colócalos en los subdirectorios correspondientes de `models/`. +Descarga los modelos que usa este flujo de trabajo. Se requieren ambos checkpoints de difusión: el switch determina cuál se ejecuta. Colócalos en las subcarpetas correspondientes de `models/`. - pixal3d_int8_convrot.safetensors: modelo de difusión de Pixal3D, cargado de forma predeterminada + pixal3d_int8_convrot.safetensors: modelo de difusión Pixal3D, se carga de forma predeterminada - trellis_2_int8_convrot.safetensors: modelo de difusión de TRELLIS.2, cargado cuando el interruptor está en `true` + trellis_2_int8_convrot.safetensors: modelo de difusión TRELLIS.2, se carga cuando el switch se establece en `true` - - trellis_2_shape_vae_bf16.safetensors: VAE para la decodificación de estructura y forma + + trellis_2_shape_vae_bf16.safetensors: VAE para decodificar la estructura y la forma - - trellis_2_texture_vae_bf16.safetensors: VAE para la decodificación de texturas + + trellis_2_texture_vae_bf16.safetensors: VAE para decodificar texturas - dino_v3_L_naf_fp32.safetensors: codificador de visión CLIP para el acondicionamiento de imágenes + dino_v3_L_naf_fp32.safetensors: codificador CLIP vision para el acondicionamiento de imagen - - moge_2_vitl_normal_fp16.safetensors: estimación de profundidad y de cámara para el acondicionamiento alineado por píxeles + + moge_2_vitl_normal_fp16.safetensors: estimación de profundidad y cámara para el acondicionamiento alineado a píxeles - + birefnet.safetensors: modelo de eliminación de fondo para el preprocesamiento diff --git a/es/tutorials/3d/trellis2.mdx b/es/tutorials/3d/trellis2.mdx index 4c1c2c761c..5fa144c463 100644 --- a/es/tutorials/3d/trellis2.mdx +++ b/es/tutorials/3d/trellis2.mdx @@ -2,18 +2,20 @@ title: "TRELLIS.2 en ComfyUI: imagen a modelos 3D con texturas PBR" description: "Convierte una sola imagen en un modelo 3D con textura en ComfyUI con TRELLIS.2, el modelo open source de 4B de Microsoft, junto a Pixal3D en un mismo flujo." sidebarTitle: "TRELLIS.2" -translationSourceHash: 3e73a8a0 +translationSourceHash: ec22c0fe translationFrom: tutorials/3d/trellis2.mdx translationBlockHashes: "_intro": 5168e8d6 "How it works": e79c0e78 "Steps to run": f899f7e5 + "Model downloads": 125142da --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**TRELLIS.2** es un modelo de imagen a 3D de código abierto de Microsoft Research y el sucesor de TRELLIS. Es un modelo de 4B parámetros construido sobre VAE 3D nativos con compresión espacial de 16× y una representación de vóxeles dispersos llamada O-Voxel, que produce recursos 3D detallados con materiales PBR completos a partir de una sola imagen. +**TRELLIS.2** es un modelo de imagen a 3D de código abierto de Microsoft Research y el sucesor de TRELLIS. Es un modelo de 4B de parámetros construido sobre VAE 3D nativos con compresión espacial de 16× y una representación de vóxeles dispersos llamada O-Voxel, que produce recursos 3D detallados con materiales PBR completos a partir de una sola imagen. -TRELLIS.2 comparte su arquitectura base con Pixal3D: ambos usan el mismo codificador de imágenes DINOv3, los mismos VAE de forma y textura, y las mismas etapas de generación de estructura, forma y textura. Solo cambian el modelo de difusión principal y el formato de acondicionamiento. Si ya has ejecutado el [flujo de trabajo de Pixal3D](/es/tutorials/3d/pixal3d), la configuración del modelo es casi idéntica. +TRELLIS.2 comparte su arquitectura base con Pixal3D: ambos usan el mismo codificador de imágenes DINOv3, los mismos VAE de forma y textura, y las mismas etapas de generación de estructura, forma y textura. Solo difieren el modelo de difusión principal y el formato de acondicionamiento. Si ya has ejecutado el [flujo de trabajo de Pixal3D](/es/tutorials/3d/pixal3d), la configuración del modelo es casi idéntica. ### TRELLIS.2: modelo 3D a partir de una imagen {#trellis2} @@ -50,9 +52,9 @@ Sube este archivo al nodo `LoadImage`: ## Cómo funciona -TRELLIS.2 genera un recurso 3D en tres etapas de difusión y luego ejecuta un pipeline completo de posprocesamiento de la malla: +TRELLIS.2 genera un recurso 3D en tres etapas de difusión y después ejecuta un pipeline completo de posprocesamiento de la malla: -1. **Eliminación de fondo**: BiRefNet elimina el fondo de la imagen de entrada y el flujo de trabajo recorta el sujeto a un lienzo centrado. Un interruptor te permite saltar la eliminación de fondo +1. **Eliminación de fondo**: BiRefNet elimina el fondo de la imagen de entrada y el flujo de trabajo recorta el sujeto a un lienzo centrado. Un interruptor te permite saltarte la eliminación de fondo 2. **Generación de estructura**: se muestrea un latente de estructura dispersa y se decodifica en vóxeles, que luego se convierten en una malla aproximada 3. **Refinamiento de forma**: la etapa de forma y la etapa de sobremuestreo refinan la malla hasta la resolución objetivo (1536) 4. **Generación de textura**: una etapa de difusión de textura produce vóxeles de material PBR (color base, metalicidad, rugosidad) @@ -63,19 +65,19 @@ TRELLIS.2 genera un recurso 3D en tres etapas de difusión y luego ejecuta un pi 1. **Carga una imagen**: usa el nodo `LoadImage` para cargar una sola imagen del objeto 2. **Cambia al pipeline de TRELLIS.2**: establece `Boolean (Switch to Trellis2)` en `true`. El flujo de trabajo carga el checkpoint de TRELLIS.2 automáticamente 3. **Envía el flujo de trabajo a la cola**: presiona Ctrl (Cmd en macOS) + Enter -4. **Espera al pipeline**: las etapas de estructura, forma y textura se ejecutan en secuencia, seguidas del posprocesamiento +4. **Espera a que termine el pipeline**: las etapas de estructura, forma y textura se ejecutan en secuencia, seguidas del posprocesamiento 5. **Visualiza el resultado**: revisa la malla en el nodo `Preview3DAdvanced`. El modelo 3D se guarda en `ComfyUI/output/3d/ComfyUI/` -## Descarga de modelos +## Descargas de modelos -Descarga los modelos que usa este flujo de trabajo. Los dos checkpoints de difusión son obligatorios: el interruptor elige cuál se ejecuta. Colócalos en los subdirectorios correspondientes de `models/`. +Descarga los modelos que usa este flujo de trabajo. Ambos checkpoints de difusión son obligatorios: el switch selecciona cuál se ejecuta. Colócalos en las subcarpetas correspondientes de `models/`. - trellis_2_int8_convrot.safetensors: modelo de difusión de TRELLIS.2, cargado cuando el interruptor está en `true` + trellis_2_int8_convrot.safetensors: modelo de difusión TRELLIS.2, se carga cuando el switch se establece en `true` - pixal3d_int8_convrot.safetensors: modelo de difusión de Pixal3D, cargado de forma predeterminada + pixal3d_int8_convrot.safetensors: modelo de difusión Pixal3D, se carga de forma predeterminada trellis_2_shape_vae_bf16.safetensors: VAE para la decodificación de estructura y forma @@ -84,7 +86,7 @@ Descarga los modelos que usa este flujo de trabajo. Los dos checkpoints de difus trellis_2_texture_vae_bf16.safetensors: VAE para la decodificación de texturas - dino_v3_L_naf_fp32.safetensors: codificador de visión CLIP para el conditioning de imágenes. El dino_v3_vit_l.safetensors equivalente del repositorio TRELLIS.2 también funciona + dino_v3_L_naf_fp32.safetensors: codificador de visión CLIP para el acondicionamiento de imagen. El archivo equivalente dino_v3_vit_l.safetensors del repositorio de TRELLIS.2 también funciona birefnet.safetensors: modelo de eliminación de fondo para el preprocesamiento diff --git a/es/tutorials/3d/triposplat.mdx b/es/tutorials/3d/triposplat.mdx index f8f3124ab0..b60606d2ef 100644 --- a/es/tutorials/3d/triposplat.mdx +++ b/es/tutorials/3d/triposplat.mdx @@ -2,7 +2,7 @@ title: "TripoSplat en ComfyUI: imagen a Gaussian splat 3D" description: "Genera representaciones 3D Gaussian splat de alta calidad desde una sola imagen 2D con TripoSplat, con densidad y presupuesto controlables para el renderizado." sidebarTitle: "TripoSplat" -translationSourceHash: 453c982d +translationSourceHash: 12824fc1 translationFrom: tutorials/3d/triposplat.mdx translationBlockHashes: "_intro": 09a020f2 @@ -10,7 +10,9 @@ translationBlockHashes: "Workflow node guide": 83cd15a0 "Steps to run": 3bf53f69 "Output options": 9a1cc408 + "Model downloads": 33be821b --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" **TripoSplat** es un modelo de código abierto que genera representaciones de **Gaussian splat 3D** directamente a partir de una sola imagen 2D. Fue desarrollado por VAST-AI y publicado bajo una licencia de código abierto. @@ -109,7 +111,7 @@ El nodo de subgrafo principal procesa la imagen y genera el splat gaussiano 3D. ## Pasos para ejecutar 1. **Carga una imagen**: usa el nodo **LoadImage** para cargar una sola imagen 2D -2. **Ejecuta el subgrafo TripoSplat**: el modelo generará una representación Gaussian splat +2. **Ejecuta el subgrafo TripoSplat**: el modelo generará una representación de Gaussian splat 3. **Elige el formato de salida**: exporta como GLB, SPZ, video o renderiza a malla 4. **Consulta los resultados**: usa el archivo 3D creado o la vista previa renderizada @@ -122,24 +124,24 @@ El nodo de subgrafo principal procesa la imagen y genera el splat gaussiano 3D. | **RenderSplat** | Imagen 2D | Vista previa rápida del resultado desde cualquier ángulo | | **SplatToMesh** | Malla | Convierte a una malla tradicional para seguir editando | -## Descarga de modelos +## Descargas de modelos -Descarga el modelo de TripoSplat y los archivos necesarios. Colócalos en los subdirectorios correspondientes de `models/`. +Descarga el modelo TripoSplat y los archivos requeridos. Colócalos en las subcarpetas correspondientes de `models/`. - triposplat_fp16.safetensors: checkpoint del modelo de difusión de TripoSplat + triposplat_fp16.safetensors: checkpoint del modelo diffusion TripoSplat - + triposplat_vae_decoder_fp16.safetensors: decodificador VAE - + flux2-vae.safetensors: VAE de FLUX.2 para la codificación latente dino_v3_vit_h.safetensors: codificador de visión CLIP (DINOv2) - + birefnet.safetensors: modelo de eliminación de fondo para el preprocesamiento diff --git a/es/tutorials/video/hunyuan/hunyuan-video-1-5.mdx b/es/tutorials/video/hunyuan/hunyuan-video-1-5.mdx index d536767e6e..f0868fd14f 100644 --- a/es/tutorials/video/hunyuan/hunyuan-video-1-5.mdx +++ b/es/tutorials/video/hunyuan/hunyuan-video-1-5.mdx @@ -2,14 +2,17 @@ title: "HunyuanVideo 1.5 en ComfyUI: T2V e I2V en GPUs de consumo" description: "Ejecuta HunyuanVideo 1.5 en ComfyUI con una GPU de 24 GB: texto a video e imagen a video de 8.3B en 720p, más un upscaler de superresolución para 1080p." sidebarTitle: "HunyuanVideo 1.5" -translationSourceHash: 3d889bf3 +translationSourceHash: 0c287152 translationFrom: tutorials/video/hunyuan/hunyuan-video-1-5.mdx translationBlockHashes: "_intro": 74d9d0ad "Model highlights": a18b0a64 + "Common models for all workflows": eb36d964 "Hunyuan Video 1.5 Text-to-Video Workflow": a6511c93 "Hunyuan Video 1.5 Image-to-Video Workflow": 9e20cd3b + "Super-resolution upscaler": 59623be1 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; [HunyuanVideo 1.5](https://github.com/Tencent/HunyuanVideo) es un modelo ligero de 8.3B parámetros desarrollado por el equipo Hunyuan de Tencent. Ofrece generación de video con calidad de primer nivel en GPUs de consumo (24 GB de VRAM), lo que reduce enormemente la barrera de entrada sin sacrificar la calidad. @@ -18,25 +21,25 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; ## Aspectos destacados del modelo -- **Potencia compacta**: Ofrece un rendimiento SOTA comparable al de modelos más grandes mientras se ejecuta en hardware de consumo. -- **Generación versátil**: Admite generación de texto a video e imagen a video (5-10s) de alta calidad con una consistencia excepcional. -- **Control preciso**: Sigue instrucciones con solidez para movimientos de cámara, física y expresiones emocionales. -- **Calidad cinematográfica**: Salida nativa en 720p (ampliable a 1080p) con una estética profesional. -- **Funciones completas**: Admite diversos estilos (realista, anime, 3D) y renderizado de texto en el video (chino/inglés). +- **Potencia compacta**: ofrece un rendimiento SOTA comparable al de modelos más grandes mientras se ejecuta en hardware de consumo. +- **Generación versátil**: admite texto a video e imagen a video (5-10s) de alta calidad con una consistencia excepcional. +- **Control preciso**: gran capacidad de seguimiento de instrucciones para movimientos de cámara, física y expresiones emocionales. +- **Calidad cinematográfica**: salida nativa en 720p (ampliable a 1080p) con una estética profesional. +- **Funciones completas**: admite diversos estilos (realista, anime, 3D) y renderizado de texto en el video (chino/inglés). ## Modelos comunes para todos los flujos de trabajo -Los siguientes modelos se usan tanto en los flujos de trabajo de texto a video como en los de imagen a video. Descárgalos y guárdalos en los directorios indicados: +Estos modelos se usan tanto en los flujos de trabajo de texto a video como en los de imagen a video. Descárgalos y guárdalos en los directorios indicados: - qwen_2.5_vl_7b_fp8_scaled.safetensors — guárdalo en ComfyUI/models/text_encoders/ + qwen_2.5_vl_7b_fp8_scaled.safetensors: guarda en ComfyUI/models/text_encoders/ - byt5_small_glyphxl_fp16.safetensors — guárdalo en ComfyUI/models/text_encoders/ + byt5_small_glyphxl_fp16.safetensors: guarda en ComfyUI/models/text_encoders/ - - hunyuanvideo15_vae_fp16.safetensors — guárdalo en ComfyUI/models/vae/ + + hunyuanvideo15_vae_fp16.safetensors: guarda en ComfyUI/models/vae/ @@ -51,10 +54,9 @@ ComfyUI/ │ └── 📂 vae/ │ └── hunyuanvideo15_vae_fp16.safetensors ``` - ## Flujo de trabajo de texto a video de Hunyuan Video 1.5 -HunyuanVideo 1.5 Text-to-Video genera videos de 5 a 10 segundos a partir de descripciones en lenguaje natural, con mejor calidad y menores requisitos de VRAM. +HunyuanVideo 1.5 Text-to-Video genera videos de 5 a 10 segundos a partir de descripciones en lenguaje natural, con una calidad mejorada y menores requisitos de VRAM. ![Flujo de trabajo de ComfyUI - Hunyuan Video 1.5 T2V](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_hunyuan_video_1.5_720p_t2v-1.webp) @@ -71,7 +73,7 @@ HunyuanVideo 1.5 Text-to-Video genera videos de 5 a 10 segundos a partir de desc - hunyuanvideo1.5_720p_t2v_fp16.safetensors: guárdalo en ComfyUI/models/diffusion_models/ + hunyuanvideo1.5_720p_t2v_fp16.safetensors. Guárdalo en ComfyUI/models/diffusion_models/ @@ -94,26 +96,26 @@ ComfyUI/ 1. Asegúrate de que el nodo `DualCLIPLoader` tenga cargados estos modelos: - clip_name1: `qwen_2.5_vl_7b_fp8_scaled.safetensors` - clip_name2: `byt5_small_glyphxl_fp16.safetensors` -2. Asegúrate de que el nodo `Load Diffusion Model` tenga cargado `hunyuanvideo1.5_720p_t2v_fp16.safetensors` -3. Asegúrate de que el nodo `Load VAE` tenga cargado `hunyuanvideo15_vae_fp16.safetensors` +2. Asegúrate de que el nodo `Load Diffusion Model` haya cargado `hunyuanvideo1.5_720p_t2v_fp16.safetensors` +3. Asegúrate de que el nodo `Load VAE` haya cargado `hunyuanvideo15_vae_fp16.safetensors` 4. Haz clic en el botón `Queue` o usa el atajo `Ctrl(Cmd) + Enter` para ejecutar el flujo de trabajo -El flujo de trabajo incluye un nodo de superresolución. Cuando está habilitado, usa `hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors` para aumentar la resolución de la salida a 1080p. +El flujo de trabajo incluye un nodo de escalado de superresolución. Cuando está habilitado, usa `hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors` para hacer upscale de la salida a 1080p. ## Flujo de trabajo de imagen a video con Hunyuan Video 1.5 -HunyuanVideo 1.5 imagen a video transforma imágenes estáticas en videos suaves y de alta calidad, con mejor consistencia y dinámica de movimiento. +HunyuanVideo 1.5 Imagen a video transforma imágenes estáticas en videos suaves y de alta calidad, con mejor consistencia y dinámica de movimiento. -![Flujo de trabajo de ComfyUI - Hunyuan Video 1.5 I2V](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_hunyuan_video_1.5_720p_i2v-1.webp) +![Flujo de trabajo de ComfyUI: Hunyuan Video 1.5 I2V](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_hunyuan_video_1.5_720p_i2v-1.webp) Abrir en Comfy Cloud - Descarga el JSON o busca "Hunyuan Video 1.5 I2V" en la Biblioteca de plantillas + Descarga el JSON o busca "Hunyuan Video 1.5 I2V" en la biblioteca de plantillas @@ -129,10 +131,10 @@ HunyuanVideo 1.5 imagen a video transforma imágenes estáticas en videos suaves - sigclip_vision_patch14_384.safetensors: guardar en ComfyUI/models/clip_vision/ + sigclip_vision_patch14_384.safetensors: guárdalo en ComfyUI/models/clip_vision/ - hunyuanvideo1.5_720p_i2v_fp16.safetensors: guardar en ComfyUI/models/diffusion_models/ + hunyuanvideo1.5_720p_i2v_fp16.safetensors: guárdalo en ComfyUI/models/diffusion_models/ @@ -154,22 +156,22 @@ ComfyUI/ ### Pasos para ejecutar el flujo de trabajo -1. Asegúrate de que el nodo `DualCLIPLoader` haya cargado estos modelos: +1. Asegúrate de que el nodo `DualCLIPLoader` tenga cargados estos modelos: - clip_name1: `qwen_2.5_vl_7b_fp8_scaled.safetensors` - clip_name2: `byt5_small_glyphxl_fp16.safetensors` -2. Asegúrate de que el nodo `CLIPVisionLoader` haya cargado `sigclip_vision_patch14_384.safetensors` -3. Asegúrate de que el nodo `Load Diffusion Model` haya cargado `hunyuanvideo1.5_720p_i2v_fp16.safetensors` -4. Asegúrate de que el nodo `Load VAE` haya cargado `hunyuanvideo15_vae_fp16.safetensors` +2. Asegúrate de que el nodo `CLIPVisionLoader` tenga cargado `sigclip_vision_patch14_384.safetensors` +3. Asegúrate de que el nodo `Load Diffusion Model` tenga cargado `hunyuanvideo1.5_720p_i2v_fp16.safetensors` +4. Asegúrate de que el nodo `Load VAE` tenga cargado `hunyuanvideo15_vae_fp16.safetensors` 5. Haz clic en el botón `Queue` o usa el atajo `Ctrl(Cmd) + Enter` para ejecutar el flujo de trabajo -## Ampliador de superresolución +## Upscaler de superresolución -Ambos flujos de trabajo incluyen un nodo de superresolución que puede hacer upscale del video de salida de 720p a 1080p. Este ampliador opcional usa un modelo destilado para obtener una salida de alta resolución de forma eficiente. +Ambos flujos de trabajo incluyen un nodo de superresolución que puede aplicar upscale al video de salida de 720p a 1080p. Este upscaler opcional usa un modelo destilado para generar una salida de alta resolución de forma eficiente. - - hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors — guárdalo en ComfyUI/models/diffusion_models/ + + hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors: guárdalo en ComfyUI/models/diffusion_models/ -Todos los modelos compartidos y específicos de cada flujo de trabajo, en conjunto: +Combinación de todos los modelos compartidos y específicos de los flujos de trabajo: ``` ComfyUI/ diff --git a/es/tutorials/video/hunyuan/hunyuan-video.mdx b/es/tutorials/video/hunyuan/hunyuan-video.mdx index d905fdc10d..f9315fd834 100644 --- a/es/tutorials/video/hunyuan/hunyuan-video.mdx +++ b/es/tutorials/video/hunyuan/hunyuan-video.mdx @@ -2,13 +2,16 @@ title: "Ejemplos de Hunyuan Video en ComfyUI" description: "Guía para usar los flujos de trabajo texto a video e imagen a video de Hunyuan en ComfyUI" sidebarTitle: "Hunyuan Video" -translationSourceHash: b0191226 +translationSourceHash: aa9c03fe translationFrom: tutorials/video/hunyuan/hunyuan-video.mdx translationBlockHashes: "_intro": 1af8ce94 + "Common Models for All Workflows": dee5f872 "Hunyuan Text-to-Video Workflow": 8b79e012 "Hunyuan Image-to-Video Workflow": fe9a6b51 + "Try It Yourself": d46e8289 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; - Guárdalo en ComfyUI/models/vae + Guarda en ComfyUI/models/vae Ubicación de almacenamiento: @@ -65,16 +68,15 @@ ComfyUI/ │ └── vae/ │ └── hunyuan_video_vae_bf16.safetensors ``` +## Flujo de trabajo de Hunyuan Text-to-Video -## Flujo de trabajo de texto a video con Hunyuan - -Hunyuan Text-to-Video se publicó como código abierto en diciembre de 2024 y permite generar videos cortos de 5 segundos mediante descripciones en lenguaje natural, tanto en chino como en inglés. +Hunyuan Text-to-Video se publicó como código abierto en diciembre de 2024 y admite la generación de videos cortos de 5 segundos a partir de descripciones en lenguaje natural, tanto en chino como en inglés. ### 1. Flujo de trabajo -Descarga la imagen del flujo de trabajo que aparece a continuación y arrástrala a ComfyUI para cargarlo: +Descarga la imagen del flujo de trabajo que aparece a continuación y arrástrala a ComfyUI para cargar el flujo de trabajo: -![ComfyUI Workflow - Hunyuan Text-to-Video](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/hunyuan_video_text_to_video-1.webp) +![Flujo de trabajo de ComfyUI: Hunyuan Text-to-Video](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/hunyuan_video_text_to_video-1.webp) @@ -85,10 +87,10 @@ Descarga la imagen del flujo de trabajo que aparece a continuación y arrástral -### 2. Instalación manual de los modelos +### 2. Instalar los modelos manualmente - Guarda el archivo en ComfyUI/models/diffusion_models + Guárdalo en ComfyUI/models/diffusion_models Asegúrate de tener todos estos archivos de modelo en las ubicaciones correctas: @@ -106,26 +108,26 @@ ComfyUI/ ### 3. Pasos para ejecutar el flujo de trabajo -![ComfyUI Hunyuan Video T2V Workflow](/images/tutorial/advanced/hunyuanvideo/flow_diagram_t2v.jpg) +![Flujo de trabajo T2V de Hunyuan Video en ComfyUI](/images/tutorial/advanced/hunyuanvideo/flow_diagram_t2v.jpg) -1. Comprueba que el nodo `DualCLIPLoader` tenga cargados estos modelos: +1. Asegúrate de que el nodo `DualCLIPLoader` haya cargado estos modelos: - clip_name1: clip_l.safetensors - clip_name2: llava_llama3_fp8_scaled.safetensors -2. Comprueba que el nodo `Load Diffusion Model` tenga cargado `hunyuan_video_t2v_720p_bf16.safetensors` -3. Comprueba que el nodo `Load VAE` tenga cargado `hunyuan_video_vae_bf16.safetensors` +2. Asegúrate de que el nodo `Load Diffusion Model` haya cargado `hunyuan_video_t2v_720p_bf16.safetensors` +3. Asegúrate de que el nodo `Load VAE` haya cargado `hunyuan_video_vae_bf16.safetensors` 4. Haz clic en el botón `Queue` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo -Cuando el parámetro `length` del nodo `EmptyHunyuanLatentVideo` se establece en 1, el modelo puede generar una imagen estática. +Cuando el parámetro `length` del nodo `EmptyHunyuanLatentVideo` está en 1, el modelo puede generar una imagen estática. -## Flujo de trabajo de imagen a video de Hunyuan +## Flujo de trabajo de imagen a video con Hunyuan -El modelo Hunyuan Image-to-Video se publicó como código abierto el 6 de marzo de 2025, basado en el framework HunyuanVideo. Transforma imágenes estáticas en videos suaves y de alta calidad, y también ofrece código de entrenamiento de LoRA para personalizar efectos de video especiales como el crecimiento del cabello, la transformación de objetos y más. +El modelo Hunyuan Image-to-Video se publicó como código abierto el 6 de marzo de 2025, basado en el framework HunyuanVideo. Transforma imágenes estáticas en videos suaves y de alta calidad y también ofrece código de entrenamiento de LoRA para personalizar efectos de video especiales como crecimiento de cabello, transformación de objetos y más. Actualmente, el modelo Hunyuan Image-to-Video tiene dos versiones: - v1 "concat": mejor fluidez de movimiento, pero menor adherencia a la orientación de la imagen -- v2 "replace": actualizada al día siguiente de la v1, con mejor orientación de la imagen, pero al parecer menos dinámica en comparación con la v1 +- v2 "replace": actualizada un día después de la v1, con mejor orientación de la imagen, pero aparentemente menos dinámica en comparación con la v1
@@ -144,7 +146,7 @@ Actualmente, el modelo Hunyuan Image-to-Video tiene dos versiones: Guardar en ComfyUI/models/clip_vision -### Flujo de trabajo imagen a video V1 "concat" +### Flujo de trabajo de imagen a video V1 "concat" #### 1. Flujo de trabajo y recursos @@ -158,7 +160,7 @@ Descarga la imagen del flujo de trabajo que aparece a continuación y arrástral -Descarga la imagen a continuación y úsala como fotograma inicial para la generación de imagen a video: +Descarga la imagen que aparece a continuación y úsala como fotograma inicial para la generación de imagen a video: Guárdala y úsala como imagen de entrada para la generación I2V @@ -166,7 +168,7 @@ Descarga la imagen a continuación y úsala como fotograma inicial para la gener #### 2. Instalación manual de los modelos relacionados - Guarda en ComfyUI/models/diffusion_models + Guárdalo en ComfyUI/models/diffusion_models Asegúrate de tener todos estos archivos de modelo en las ubicaciones correctas: @@ -174,14 +176,14 @@ Asegúrate de tener todos estos archivos de modelo en las ubicaciones correctas: ComfyUI/ ├── models/ │ ├── clip_vision/ -│ │ └── llava_llama3_vision.safetensors // Modelo compartido de I2V +│ │ └── llava_llama3_vision.safetensors // modelo compartido para I2V │ ├── text_encoders/ -│ │ ├── clip_l.safetensors // Modelo compartido -│ │ └── llava_llama3_fp8_scaled.safetensors // Modelo compartido +│ │ ├── clip_l.safetensors // modelo compartido +│ │ └── llava_llama3_fp8_scaled.safetensors // modelo compartido │ ├── vae/ -│ │ └── hunyuan_video_vae_bf16.safetensors // Modelo compartido +│ │ └── hunyuan_video_vae_bf16.safetensors // modelo compartido │ └── diffusion_models/ -│ └── hunyuan_video_image_to_video_720p_bf16.safetensors // Modelo de la versión I2V v1 "concat" +│ └── hunyuan_video_image_to_video_720p_bf16.safetensors // modelo de la versión v1 "concat" de I2V ``` #### 3. Pasos para ejecutar el flujo de trabajo @@ -199,11 +201,11 @@ ComfyUI/ ### Flujo de trabajo de imagen a video v2 "replace" -El flujo de trabajo v2 es esencialmente el mismo que el del v1. Solo necesitas descargar el modelo **replace** y usarlo en el nodo `Load Diffusion Model`. +El flujo de trabajo v2 es esencialmente el mismo que el flujo de trabajo v1. Solo necesitas descargar el modelo **replace** y usarlo en el nodo `Load Diffusion Model`. #### 1. Flujo de trabajo y recursos -Descarga la imagen del flujo de trabajo de abajo y arrástrala a ComfyUI para cargarlo: +Descarga la imagen del flujo de trabajo que aparece a continuación y arrástrala a ComfyUI para cargarlo: ![Flujo de trabajo de ComfyUI - Hunyuan imagen a video v2](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/hunyuan-video/i2v/v2_fennec_gril.webp) @@ -213,12 +215,12 @@ Descarga la imagen del flujo de trabajo de abajo y arrástrala a ComfyUI para ca -Descarga la imagen de abajo y úsala como fotograma inicial para la generación de imagen a video: +Descarga la imagen que aparece a continuación y úsala como fotograma inicial para la generación de imagen a video: - Guarda y usa como imagen de entrada para la generación I2V + Guárdala y úsala como imagen de entrada para la generación I2V -#### 2. Instalación manual de modelos relacionados +#### 2. Instalación manual de los modelos relacionados Guárdalo en ComfyUI/models/diffusion_models @@ -229,14 +231,14 @@ Asegúrate de tener todos estos archivos de modelo en las ubicaciones correctas: ComfyUI/ ├── models/ │ ├── clip_vision/ -│ │ └── llava_llama3_vision.safetensors // Modelo compartido de I2V +│ │ └── llava_llama3_vision.safetensors // Modelo compartido para I2V │ ├── text_encoders/ │ │ ├── clip_l.safetensors // Modelo compartido │ │ └── llava_llama3_fp8_scaled.safetensors // Modelo compartido │ ├── vae/ │ │ └── hunyuan_video_vae_bf16.safetensors // Modelo compartido │ └── diffusion_models/ -│ └── hunyuan_video_v2_replace_image_to_video_720p_bf16.safetensors // Modelo de la versión v2 "replace" +│ └── hunyuan_video_v2_replace_image_to_video_720p_bf16.safetensors // Modelo de la versión "replace" de V2 ``` #### 3. Pasos para ejecutar el flujo de trabajo @@ -256,7 +258,7 @@ ComfyUI/ Aquí tienes algunas imágenes y prompts que proporcionamos. Úsalos tal cual o ajústalos para crear tu propio video. -![example](/images/tutorial/advanced/hunyuanvideo/humanoid_android_dressed_in_a_flowing.png) +![ejemplo](/images/tutorial/advanced/hunyuanvideo/humanoid_android_dressed_in_a_flowing.png) ``` Futuristic robot dancing ballet, dynamic motion, fast motion, fast shot, moving scene @@ -264,7 +266,7 @@ Futuristic robot dancing ballet, dynamic motion, fast motion, fast shot, moving --- -![example](/images/tutorial/advanced/hunyuanvideo/samurai.png) +![ejemplo](/images/tutorial/advanced/hunyuanvideo/samurai.png) ``` Samurai waving sword and hitting the camera. camera angle movement, zoom in, fast scene, super fast, dynamic @@ -272,7 +274,7 @@ Samurai waving sword and hitting the camera. camera angle movement, zoom in, fas --- -![example](/images/tutorial/advanced/hunyuanvideo/a_flying_car.png) +![ejemplo](/images/tutorial/advanced/hunyuanvideo/a_flying_car.png) ``` flying car fastly moving and flying through the city @@ -280,7 +282,7 @@ flying car fastly moving and flying through the city --- -![example](/images/tutorial/advanced/hunyuanvideo/cyber_car_race.png) +![ejemplo](/images/tutorial/advanced/hunyuanvideo/cyber_car_race.png) ``` cyberpunk car race in night city, dynamic, super fast, fast shot diff --git a/es/tutorials/video/kandinsky/kandinsky-5.mdx b/es/tutorials/video/kandinsky/kandinsky-5.mdx index 0c36c06627..2e35c90a72 100644 --- a/es/tutorials/video/kandinsky/kandinsky-5.mdx +++ b/es/tutorials/video/kandinsky/kandinsky-5.mdx @@ -2,33 +2,36 @@ title: "Kandinsky 5.0 en ComfyUI: texto a video e imagen a video" description: "Usa Kandinsky 5.0 Video Lite en ComfyUI: texto a video de hasta 10 segundos e imagen a video de 5 segundos, con variantes SFT de 2B, no-CFG y destilada." sidebarTitle: "Kandinsky 5.0" -translationSourceHash: 0766e01c +translationSourceHash: e0a46d75 translationFrom: tutorials/video/kandinsky/kandinsky-5.mdx translationBlockHashes: "_intro": cd71d0f9 "Overview": dead89b1 "Model variants": 3bdbc0cb + "Text-to-Video workflow": 8641d2fb + "Image-to-Video workflow": b945bc9a "Resources": fa8f3352 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -[Kandinsky 5.0](https://huggingface.co/kandinskylab/Kandinsky-5.0-I2V-Lite-5s) es una familia de modelos de difusión para la generación de video e imágenes desarrollada por [Kandinsky Lab](https://huggingface.co/kandinskylab). Kandinsky 5.0 T2V Lite es un modelo ligero de 2B parámetros que se ubica entre los mejores modelos de generación de video de código abierto, capaz de generar videos de hasta 10 segundos de duración. +[Kandinsky 5.0](https://huggingface.co/kandinskylab/Kandinsky-5.0-I2V-Lite-5s) es una familia de modelos de difusión para la generación de video e imágenes desarrollada por [Kandinsky Lab](https://huggingface.co/kandinskylab). El Kandinsky 5.0 T2V Lite es un modelo ligero de 2000 millones de parámetros que se encuentra entre los mejores modelos de generación de video de código abierto, capaz de generar videos de hasta 10 segundos de duración. ## Descripción general -Kandinsky 5.0 usa un pipeline de difusión latent con Flow Matching e incluye: +Kandinsky 5.0 usa un pipeline de difusión latente con Flow Matching e incluye: - **Diffusion Transformer (DiT):** Arquitectura generativa principal con atención cruzada a los embeddings de texto -- **Qwen2.5-VL y CLIP:** Proporciona embeddings de texto de alta calidad -- **HunyuanVideo 3D VAE:** Codifica y decodifica el video en un espacio latent +- **Qwen2.5-VL y CLIP:** Proporcionan embeddings de texto de alta calidad +- **HunyuanVideo 3D VAE:** Codifica y decodifica el video en un espacio latente La familia de modelos incluye varias variantes optimizadas para diferentes casos de uso: - **Modelo SFT:** Máxima calidad de generación - **CFG-distilled:** Inferencia 2× más rápida - **Diffusion-distilled:** 6× más rápida con una pérdida mínima de calidad (16 pasos) -- **Modelo preentrenado:** Diseñado para fine-tuning +- **Modelo de preentrenamiento:** Diseñado para fine-tuning Todos los modelos están disponibles en versiones de generación de video de 5 y 10 segundos. @@ -43,18 +46,18 @@ Todos los modelos están disponibles en versiones de generación de video de 5 y ## Flujo de trabajo de texto a video -### Kandinsky 5.0 Video Lite Text to Video {#video_kandinsky5_t2v} +### Kandinsky 5.0 Video Lite texto a video {#video_kandinsky5_t2v} Un modelo ligero de 2B que genera videos a partir de prompts en inglés y ruso con alta calidad visual. -Vista previa del flujo de trabajo Kandinsky 5.0 Video Lite de texto a video +Vista previa del flujo de trabajo de Kandinsky 5.0 Video Lite texto a video Abrir en Comfy Cloud - Descarga el JSON o busca "Kandinsky 5.0 Video Lite Text to Video" en la Biblioteca de plantillas + Descarga el JSON o busca "Kandinsky 5.0 Video Lite Text to Video" en la biblioteca de plantillas @@ -74,7 +77,7 @@ Un modelo ligero de 2B que genera videos a partir de prompts en inglés y ruso c **Modelo de difusión** - Modelo de difusión Kandinsky 5.0 T2V Lite SFT (5 s). Colócalo en ComfyUI/models/diffusion_models/ + Modelo de difusión Kandinsky 5.0 T2V Lite SFT (5s). Colócalo en ComfyUI/models/diffusion_models/ **VAE** @@ -92,14 +95,13 @@ ComfyUI/ │ └── 📂 vae/ │ └── hunyuan_video_vae_bf16.safetensors ``` - ## Flujo de trabajo de imagen a video ### Kandinsky 5.0 Video Lite Image to Video {#video_kandinsky5_i2v} Un modelo ligero de 2B que genera videos a partir de prompts en inglés y ruso con alta calidad visual. -Vista previa del flujo de trabajo Kandinsky 5.0 Video Lite de imagen a video +Vista previa del flujo de trabajo Kandinsky 5.0 Video Lite Image to Video @@ -129,18 +131,18 @@ Sube este archivo al nodo `LoadImage` correspondiente: **Codificadores de texto** - + Codificador de texto Qwen2.5-VL 7B (FP8). Colócalo en ComfyUI/models/text_encoders/ - + Codificador de texto CLIP-L. Colócalo en ComfyUI/models/text_encoders/ **Modelo de difusión** - - Modelo de difusión Kandinsky 5.0 I2V Lite (5 s). Colócalo en ComfyUI/models/diffusion_models/ + + Modelo de difusión Kandinsky 5.0 I2V Lite (5s). Colócalo en ComfyUI/models/diffusion_models/ **VAE** @@ -158,7 +160,6 @@ ComfyUI/ │ └── 📂 vae/ │ └── hunyuan_video_vae_bf16.safetensors ``` - ## Recursos - [Colección de modelos de Hugging Face](https://huggingface.co/collections/kandinskylab/kandinsky-50-video-lite) diff --git a/es/tutorials/video/ltx/ltx-2-3.mdx b/es/tutorials/video/ltx/ltx-2-3.mdx index 4d7e6dcbea..c459ffc765 100644 --- a/es/tutorials/video/ltx/ltx-2-3.mdx +++ b/es/tutorials/video/ltx/ltx-2-3.mdx @@ -2,18 +2,20 @@ 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: 0519dac5 +translationSourceHash: 2e21405a translationFrom: tutorials/video/ltx/ltx-2-3.mdx translationBlockHashes: "_intro": 2afce33d "Key features": 3ddea9bd "Getting started": 8bd36b77 + "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. Sobre la base de LTX-2, esta versión ofrece mejoras importantes de calidad en detalles finos, video de retratos, calidad de audio, consistencia de imagen a video, comprensión de prompts y 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 significativas de calidad en los detalles finos, el video de retratos, 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: @@ -30,10 +32,10 @@ ComfyUI incluye seis flujos de trabajo nativos para LTX-2.3, cada uno diseñado - **Detalles más finos**: nuevo espacio latente y VAE actualizado para texturas más nítidas, bordes más limpios y visuales más precisos - **Soporte para formato vertical 9:16**: calidad muy mejorada en videos verticales -- **Mejor audio**: sonido más limpio con menos ruido y diálogos mejorados +- **Mejor audio**: sonido más limpio, con menos ruido y diálogos mejorados - **Imagen a video mejorado**: movimiento más consistente y menos fallos - **Comprensión de prompts más inteligente**: codificador de texto mejorado para una interpretación más precisa -- **Soporte nativo en ComfyUI**: todos los flujos de trabajo son integrados, no se requieren Nodos personalizados +- **Soporte nativo en ComfyUI**: todos los flujos de trabajo están integrados, no se requieren nodos personalizados ## Primeros pasos @@ -47,18 +49,18 @@ LTX-2.3 es compatible de forma nativa con ComfyUI. Para empezar: ### LTX-2.3 Texto a video (T2V) -Genera videos a partir de prompts de texto con mejor comprensión de prompts y mejor renderizado de texto. +Genera videos a partir de prompts de texto con una mejor comprensión de los prompts y un mejor renderizado de texto. -### LTX-2.3 Texto a video {#video_ltx2_3_t2v} +### LTX-2.3 Text to Video {#video_ltx2_3_t2v} -Genera videos a partir de prompts de texto con mejor comprensión de prompts y mejor renderizado de texto. +Genera videos a partir de prompts de texto con mejor comprensión de las instrucciones y renderizado de texto. -Vista previa del flujo de trabajo LTX-2.3 Text to Video +LTX-2.3 Text to Video (vista previa del flujo de trabajo - + Abrir en Comfy Cloud @@ -66,7 +68,7 @@ Genera videos a partir de prompts de texto con mejor comprensión de prompts y m -#### Descarga de modelos +#### Descargas de modelos @@ -78,7 +80,7 @@ Genera videos a partir de prompts de texto con mejor comprensión de prompts y m Colócalo en ComfyUI/models/loras/ - + Colócalo en ComfyUI/models/text_encoders/ @@ -102,13 +104,11 @@ ComfyUI/ │ └── ltx-2.3-spatial-upscaler-x2-1.1.safetensors ``` -#### Consejos para escribir prompts +#### Consejos para los prompts -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 - ---- +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 los diálogos que necesita la escena ### LTX-2.3 Imagen a video (I2V) @@ -116,11 +116,11 @@ Genera videos a partir de una imagen de entrada con un movimiento más consisten -### LTX-2.3 Imagen a video {#video_ltx2_3_i2v} +### LTX-2.3 de imagen a video {#video_ltx2_3_i2v} Genera videos a partir de una imagen de entrada con una consistencia de movimiento mejorada. -Vista previa del flujo de trabajo LTX-2.3 Image to Video +LTX-2.3 de imagen a video (vista previa del flujo de trabajo @@ -137,25 +137,25 @@ Genera videos a partir de una imagen de entrada con una consistencia de movimien -#### Descarga de modelos +#### Descargas de modelos El flujo de trabajo I2V usa el mismo conjunto de modelos que el de texto a video. - Colócalo en ComfyUI/models/checkpoints/ + Coloca en ComfyUI/models/checkpoints/ - Colócalo en ComfyUI/models/loras/ + Coloca en ComfyUI/models/loras/ - Colócalo en ComfyUI/models/loras/ + Coloca en ComfyUI/models/loras/ - - Colócalo en ComfyUI/models/text_encoders/ + + Coloca en ComfyUI/models/text_encoders/ - Colócalo en ComfyUI/models/latent_upscale_models/ + Coloca en ComfyUI/models/latent_upscale_models/ @@ -179,15 +179,15 @@ ComfyUI/ ### LTX-2.3 FLF2V -Interpola entre una imagen inicial y una imagen final para generar una transición de video fluida. +Interpola entre una imagen inicial y una imagen final para generar una transición de video suave. -### LTX-2.3 Primer y último fotograma a video {#video_ltx2_3_flf2v} +### LTX-2.3 First-Last Frame to Video {#video_ltx2_3_flf2v} Interpola entre una imagen inicial y una final. -Vista previa del flujo de trabajo LTX-2.3 First-Last Frame to Video +LTX-2.3 First-Last Frame to Video ( workflow preview @@ -207,15 +207,15 @@ Interpola entre una imagen inicial y una final. -#### Descarga de modelos +#### Descargas de modelos -El flujo de trabajo FLF2V usa el checkpoint distilled en lugar del checkpoint dev. +El flujo de trabajo FLF2V usa el checkpoint destilado en lugar del checkpoint dev. Colócalo en ComfyUI/models/checkpoints/ - + Colócalo en ComfyUI/models/text_encoders/ @@ -231,19 +231,17 @@ 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 labiales sincronizados. +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 labial a partir de una imagen y audio. +Genera videos con sincronización labial a partir de una imagen y un audio. -Vista previa del flujo de trabajo LTX-2.3 Image and Audio to Video +LTX-2.3 Imagen y audio a video ( vista previa del flujo de trabajo @@ -263,9 +261,9 @@ Genera videos con sincronización labial a partir de una imagen y audio. -#### Descarga de modelos +#### Descargas de modelos -El flujo de trabajo IA2V usa el mismo conjunto de modelos que el de texto a video. +El flujo de trabajo IA2V usa el mismo conjunto de modelos que texto a video. @@ -277,10 +275,10 @@ El flujo de trabajo IA2V usa el mismo conjunto de modelos que el de texto a vide Colócalo en ComfyUI/models/loras/ - + Colócalo en ComfyUI/models/text_encoders/ - + Colócalo en ComfyUI/models/latent_upscale_models/ @@ -305,12 +303,12 @@ ComfyUI/ ### LTX-2.3 IC-LoRA Union Control -Genera videos con LTX-2.3 e IC-LoRA usando entradas de control alineadas como profundidad, pose o bordes. IC-LoRA es un LoRA in-context entrenado sobre LTX-2.3 que aplica la guía estructural de un video de referencia. Acepta señales de control de varios preprocesadores, incluidos mapas de profundidad, bordes de Canny y esqueletos de pose. Este flujo de trabajo usa un Subgraph para el procesamiento modular. +Genera videos LTX-2.3 con IC-LoRA usando entradas de control alineadas como profundidad, pose o bordes. IC-LoRA es un LoRA en contexto entrenado sobre LTX-2.3 que aplica orientación estructural a partir de un video de referencia. Acepta señales de control de distintos preprocesadores, incluidos mapas de profundidad, bordes Canny y esqueletos de pose. Este flujo de trabajo usa un subgrafo para el procesamiento modular. ![Vista previa de LTX-2.3 IC-LoRA](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_ltx2_3_ic_lora-1.webp) - + Abrir en Comfy Cloud @@ -318,7 +316,7 @@ Genera videos con LTX-2.3 e IC-LoRA usando entradas de control alineadas como pr - + Este flujo de trabajo usa un nodo Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. @@ -326,14 +324,14 @@ Genera videos con LTX-2.3 e IC-LoRA usando entradas de control alineadas como pr - Video guía del que se extrae la señal de control. + Video guía para extraer la señal de control. Imagen de referencia para el estilo y el contenido. -#### Descarga de modelos +#### Descargas de modelos @@ -371,15 +369,15 @@ ComfyUI/ --- -### Edición de video con IC-LoRA +### Editar video con IC-LoRA -Los pesos IC-LoRA no se limitan al control de la generación. La Biblioteca de plantillas incluye flujos de trabajo IC-LoRA de LTX-2.3 ya preparados para editar material existente, y cada uno se ejecuta en Comfy Cloud o de forma local en ComfyUI. Los checkpoints IC-LoRA de la comunidad entrenados sobre LTX-2.3 (por ejemplo, la familia [LTX2.3-ICEdit-Insight](https://huggingface.co/joyfox/LTX2.3-ICEdit-Insight)) también son compatibles con el modelo nativo LTX-2.3. +Los pesos IC-LoRA no se limitan al control de la generación. La Biblioteca de plantillas incluye flujos de trabajo LTX-2.3 IC-LoRA listos para editar material existente, y cada uno se ejecuta en Comfy Cloud o de forma local en ComfyUI. Los checkpoints IC-LoRA de la comunidad entrenados sobre LTX-2.3 (por ejemplo, la familia [LTX2.3-ICEdit-Insight](https://huggingface.co/joyfox/LTX2.3-ICEdit-Insight)) también son compatibles con el modelo LTX-2.3 nativo. #### Eliminar subtítulos de un video Elimina subtítulos, rótulos, marcas de agua u otras superposiciones de texto de un video: -Vista previa del flujo de trabajo de eliminación de subtítulos de LTX-2.3 +LTX-2.3 Remove Subtitles workflow preview @@ -397,16 +395,16 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo: - Descarga el video de entrada de ejemplo + Descargar video de entrada de ejemplo #### Eliminar un objeto de un video -Elimina un objeto concreto del primer plano de un video describiéndolo en el prompt: +Elimina un objeto específico del primer plano de un video describiéndolo en el prompt: -Vista previa del flujo de trabajo de eliminación de objetos de LTX-2.3 +LTX-2.3 Remove Object workflow preview @@ -424,7 +422,7 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo: - Descarga el video de entrada de ejemplo + Descargar video de entrada de ejemplo @@ -433,7 +431,7 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo: Restaura material de archivo antiguo o degradado: -Vista previa del flujo de trabajo de restauración de material de archivo de LTX-2.3 +LTX-2.3 Restore Archival Footage workflow preview @@ -451,16 +449,16 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo: - Descarga el video de entrada de ejemplo + Descargar video de entrada de ejemplo #### Outpainting de video -Amplía un video en cualquier dirección con el IC-LoRA Video Outpainting de LTX-2.3: +Expande un video en cualquier dirección con el IC-LoRA Video Outpainting de LTX-2.3: -Vista previa del flujo de trabajo de outpainting de video de LTX-2.3 +LTX-2.3 Video Outpainting workflow preview @@ -478,39 +476,38 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo: - Descarga el video de entrada de ejemplo + Descargar video de entrada de ejemplo #### Googly Eyes -Aplica el LoRA Googlyeyes de LTX-2.3 a un video de entrada para poner ojos saltones a todas las personas del fotograma: +Aplica el LoRA Googlyeyes de LTX-2.3 a un video de entrada para darle ojos saltones a todos los que aparecen en el encuadre: -Vista previa del flujo de trabajo Googly Eyes de LTX-2.3 +LTX-2.3 Googly Eyes workflow preview Abrir en Comfy Cloud - - Descarga el JSON o busca "Googly Eyes" en la Biblioteca de plantillas + Descargar JSON o buscar "Googly Eyes" en la Biblioteca de plantillas
Materiales de entrada -Descarga este video de entrada de ejemplo para probar el flujo de trabajo: +Descarga este video de entrada de muestra para probar el flujo de trabajo: - Descarga el video de entrada de ejemplo + Descargar video de entrada de muestra
-Para los IC-LoRA de la comunidad, coloca el LoRA de edición en `ComfyUI/models/loras/` y cárgalo con un cargador de LoRA junto al checkpoint de LTX-2.3; después ejecuta el flujo de trabajo con tu video como entrada y un prompt como: +Para IC-LoRAs de la comunidad, coloca el LoRA de edición en `ComfyUI/models/loras/` y cárgalo con un cargador de LoRA junto al checkpoint LTX-2.3; luego ejecuta el flujo de trabajo con tu video como entrada y un prompt como: ```text Remove subtitles, captions, and related text occlusions from the video, restoring a clean and natural underlying image. @@ -528,7 +525,7 @@ Genera videos personalizados con audio sincronizado a partir de un prompt de tex Genera videos personalizados con audio sincronizado a partir de una imagen de referencia y un clip de audio. -Vista previa del flujo de trabajo LTX-2.3 ID LoRA +LTX-2.3 ID LoRA ( workflow preview @@ -548,7 +545,7 @@ Genera videos personalizados con audio sincronizado a partir de una imagen de re -#### Descarga de modelos +#### Descargas de modelos @@ -560,7 +557,7 @@ Genera videos personalizados con audio sincronizado a partir de una imagen de re Colócalo en ComfyUI/models/loras/ - + Colócalo en ComfyUI/models/text_encoders/ @@ -583,18 +580,17 @@ ComfyUI/ │ └── 📂 latent_upscale_models/ │ └── ltx-2.3-spatial-upscaler-x2-1.1.safetensors ``` +## Consejos para los prompts -## Consejos para escribir prompts - -Cuando escribas prompts para LTX-2.3, céntrate en descripciones detalladas y cronológicas de acciones y escenas: +Al escribir prompts para LTX-2.3, céntrate en descripciones detalladas y cronológicas de acciones y 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 quieres que aparezcan en el video -3. **Audio**: Describe los sonidos y el diálogo que necesita la escena +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 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) diff --git a/es/tutorials/video/ltx/ltx-2-5-dfr.mdx b/es/tutorials/video/ltx/ltx-2-5-dfr.mdx index 14cd89b24d..4faa0969f3 100644 --- a/es/tutorials/video/ltx/ltx-2-5-dfr.mdx +++ b/es/tutorials/video/ltx/ltx-2-5-dfr.mdx @@ -2,15 +2,17 @@ title: "LTX-2.5 DFR en ComfyUI: imagen a video con audio" description: "Ejecuta el flujo de trabajo LTX-2.5 DFR en ComfyUI: tres etapas Diffusion Fidelity Rendering que generan video con audio sincronizado desde una imagen." sidebarTitle: "LTX-2.5 DFR" -translationSourceHash: 525f6be2 +translationSourceHash: 6958a6c7 translationFrom: tutorials/video/ltx/ltx-2-5-dfr.mdx translationBlockHashes: "_intro": 950d68f0 "The three stages": 1ccaf9c8 "Model downloads": c2c37fb4 + "Model storage": d7c0900c "Workflow controls": 2cf64b86 "Prompting tips": c40b888a --- + Genera un video con audio sincronizado a partir de una sola imagen mediante la ruta Diffusion Fidelity Rendering de LTX-2.5. DFR es la receta con calidad de producción: un transformer destilado combinado con un IC-LoRA de detallado, con keyframes generados dentro del clip y reutilizados como guías por las pasadas posteriores. Activa `Switch to T2V` para ejecutar el mismo pipeline solo desde texto. Para los demás flujos de trabajo de LTX-2.5, consulta la [descripción general de LTX-2.5](/es/tutorials/video/ltx/ltx-2-5). @@ -36,17 +38,17 @@ Para los demás flujos de trabajo de LTX-2.5, consulta la [descripción general | Etapa | Se ejecuta a | Pasos | Qué hace | | :---- | :------ | :---- | :----------- | -| 1. Generar | La mitad del tamaño de salida | 8 | Aplica denoising al video, con un fotograma clave de detalle por segundo, y al audio juntos en una sola pasada | -| 2. Espacial x2 | El tamaño de salida | 3 | Aplica upscale al latent de la etapa 1 y lo vuelve a muestrear con el IC-LoRA de detalle espacial de píxeles, usando el latent de media resolución como referencia | -| 3. Temporal x2 | 241 fotogramas a 48 fps | 4 | Duplica la frecuencia de fotogramas en la misma duración, con los fotogramas clave de la etapa 2 fijados como guías | +| 1. Generar | La mitad del tamaño de salida | 8 | Aplica denoising al video, con un fotograma clave de detalle por segundo, y al audio, todo en una sola pasada | +| 2. Espacial x2 | El tamaño de salida | 3 | Aplica upscale al latente de la etapa 1 y lo vuelve a muestrear con el IC-LoRA de detalle espacial de píxeles, usando el latente de media resolución como referencia | +| 3. Temporal x2 | 241 fotogramas a 48 fps | 4 | Duplica la frecuencia de cuadros en la misma duración, con los fotogramas clave de la etapa 2 fijados como guías | -Todas las etapas muestrean con el sampler `euler`, `cfg` 1.0 y una programación fija de `ManualSigmas`. El checkpoint está destilado, así que el número de pasos y las programaciones son parte de la receta: cambiarlos cambia el aspecto del resultado. +Todas las etapas hacen el muestreo con el sampler `euler`, `cfg` 1.0 y una programación fija de `ManualSigmas`. El checkpoint está destilado, así que el número de pasos y las programaciones forman parte de la receta: cambiarlos cambia el aspecto del resultado. -La tercera etapa es opcional. Desactiva `Run 3rd stage - Temporal Upscale` para saltarla y obtener en su lugar un clip con la frecuencia de fotogramas de la etapa 2. El audio se arrastra desde la etapa 1 por todo el pipeline, así que el sonido no cambia cuando se ejecuta la pasada temporal. +La tercera etapa es opcional. Desactiva `Run 3rd stage - Temporal Upscale` para saltarla y obtener en su lugar un clip con la frecuencia de cuadros de la etapa 2. El audio se conserva desde la etapa 1 a lo largo de todo el pipeline, así que el sonido no cambia cuando se ejecuta la pasada temporal. ## Descargas de modelos -El flujo de trabajo DFR carga el codificador de texto de precisión completa y añade el IC-LoRA de detallado más el escalador temporal, por lo que su conjunto de modelos difiere del de los demás flujos de trabajo de LTX-2.5. +El flujo de trabajo DFR carga el codificador de texto de precisión completa y agrega el IC-LoRA de detallado además del escalador temporal, por lo que su conjunto de modelos difiere del de los demás flujos de trabajo de LTX-2.5. @@ -94,18 +96,17 @@ ComfyUI/ │ ├── ltx-2.5-latent-spatial-upscaler-x2-bf16-1.0.safetensors │ └── ltx-2.5-latent-temporal-upscaler-x2-bf16-1.0.safetensors ``` - ## Controles del flujo de trabajo - `Start image (I2V)`: el primer fotograma. Se ignora mientras `Switch to T2V` esté activado - `Output size (aspect / megapixels)`: la relación de aspecto y el presupuesto de píxeles objetivo, redondeados a múltiplos de 32. La etapa 1 se ejecuta a la mitad de este tamaño -- `Switch to T2V`: ejecuta el pipeline solo a partir de texto, sin una imagen inicial -- `Float (fps)` y `Float (Duration)`: 24 fps durante 5 segundos por defecto, lo que da 121 fotogramas +- `Switch to T2V`: ejecuta el pipeline solo a partir de texto, sin imagen inicial +- `Float (fps)` y `Float (Duration)`: 24 fps durante 5 segundos de forma predeterminada, lo que equivale a 121 fotogramas - `Enable Prompt Enhancer`: reescribe y amplía el prompt con el pequeño codificador Gemma 4 antes del muestreo -- `Enable Tiled Decode`: decodifica el VAE en mosaicos para reducir el uso de VRAM, con un pequeño costo en el detalle fino +- `Enable Tiled Decode`: decodifica el VAE por mosaicos para reducir el uso de VRAM, con un pequeño costo en el detalle fino ## Consejos para escribir prompts -1. **Escribe para un solo plano continuo**: DFR construye el clip a partir de fotogramas clave generados, así que describe una escena que se desarrolla en una sola toma en lugar de una secuencia de cortes -2. **Audio en la misma pasada**: pon las líneas habladas entre comillas y describe el ambiente y los efectos; el modelo genera el audio junto con el video -3. **Mantén los movimientos de cámara suaves**: los movimientos rápidos sobre texturas con ruido y degradados suaves son donde el pipeline tiene más probabilidades de mostrar ebullición o banding +1. **Escribe para un plano continuo**: DFR construye el clip en torno a los fotogramas clave generados, así que describe una escena que se desarrolla en una sola toma en lugar de una secuencia de cortes +2. **El audio en la misma pasada**: pon las líneas habladas entre comillas y describe el ambiente y los efectos; el modelo genera el audio junto con el video +3. **Mantén los movimientos de cámara suaves**: los movimientos rápidos sobre texturas con ruido y degradados suaves son donde el pipeline es más propenso a mostrar boiling o banding diff --git a/es/tutorials/video/ltxv.mdx b/es/tutorials/video/ltxv.mdx index 21999ebd3e..fc51f7319e 100644 --- a/es/tutorials/video/ltxv.mdx +++ b/es/tutorials/video/ltxv.mdx @@ -2,13 +2,14 @@ title: "LTX-Video 0.9.5 en ComfyUI: T2V, I2V, control de múltiples fotogramas" sidebarTitle: "LTX-0.9.5" description: "Ejecuta LTX-Video 0.9.5 en ComfyUI para texto a video, imagen a video y control multifotograma desde imágenes inicial y final, con descarga y configuración." -translationSourceHash: b2aad3a7 +translationSourceHash: b4e3cee7 translationFrom: tutorials/video/ltxv.mdx translationBlockHashes: "_intro": 354083fd "Multi Frame Control": 0fe2f937 "Image to Video": 1072ef32 "Text to Video": 664fc166 + "Requirements": 4d0884e2 --- import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; @@ -89,10 +90,10 @@ Descarga los siguientes modelos y colócalos en las ubicaciones que se indican a - Descarga y guárdalo en ComfyUI/models/checkpoints/ + Descarga y coloca en ComfyUI/models/checkpoints/ - Descarga y guárdalo en ComfyUI/models/text_encoders/ + Descarga y coloca en ComfyUI/models/text_encoders/ ``` diff --git a/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx b/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx index 0dadd530c0..378176e5bd 100644 --- a/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx +++ b/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx @@ -2,25 +2,27 @@ title: "FastVideo FastH3: ejemplos de flujos de trabajo de ComfyUI" description: "FastVideo FastH3 genera video MiniMax H3 con audio sincronizado en 8 pasos de muestreo en ComfyUI, para flujos de texto a video y de primer/último fotograma." sidebarTitle: "FastVideo FastH3" -translationSourceHash: c9534724 +translationSourceHash: cb542dfa translationFrom: tutorials/video/minimax/minimax-h3-fastvideo.mdx translationBlockHashes: "_intro": 096c332e "Requirements": bcdeb37e - "FastH3 Text to Video": e9a7420a + "FastH3 Text to Video": 1c4cb909 "FastH3 Image to Video": ec7d82bf - "Workflow structure notes": 77b7c476 + "Model downloads": b88037db + "Workflow structure notes": 8f5d2153 --- -[FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2) es un checkpoint de MiniMax H3 destilado con DMD2 por el equipo de FastVideo que genera video con audio nativo sincronizado en **8 pasos de muestreo** en lugar de la programación completa del modelo base. Reutiliza el codificador de texto de H3, el VAE de video y el VAE de audio, así que el resultado coincide con la configuración del modelo base mientras el muestreo termina en una fracción de los pasos. -El trabajo de la versión de vista previa de FastH3 se desarrolló en colaboración con Nuva Lab y el equipo de NVIDIA FastGen; consulta el [anuncio de FastH3](https://haoailab.com/blogs/fasth3-preview/) para conocer los detalles de la destilación. ComfyUI incluye el checkpoint V2 de 8 pasos, reempaquetado por Comfy-Org en el [repositorio FastVideo-FastH3-Comfy](https://huggingface.co/FastVideo/FastVideo-FastH3-Comfy). +[FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2) es un checkpoint de MiniMax H3 destilado con DMD2 por el equipo de FastVideo que genera video con audio nativo sincronizado en **8 pasos de muestreo** en lugar de la programación completa del modelo base. Reutiliza el codificador de texto de H3, el VAE de video y el VAE de audio, así que la salida coincide con la configuración del modelo base mientras el muestreo termina en una fracción de los pasos. + +El trabajo de la vista previa de FastH3 se desarrolló en colaboración con Nuva Lab y el equipo de NVIDIA FastGen; consulta el [anuncio de FastH3](https://haoailab.com/blogs/fasth3-preview/) para conocer los detalles de la destilación. ComfyUI incluye el checkpoint V2 de 8 pasos, reempaquetado por Comfy-Org en el [repositorio FastVideo-FastH3-Comfy](https://huggingface.co/FastVideo/FastVideo-FastH3-Comfy). FastH3 sacrifica algo de fidelidad de movimiento y audio a cambio de velocidad. Úsalo para borradores, iteración y entregas rápidas; usa los flujos de trabajo base de MiniMax H3 cuando la máxima calidad sea lo importante. -El checkpoint destilado solo admite texto a video e imagen a video con primer y último fotograma. Ref2VA (conditioning con múltiples referencias) no se destiló; usa los [flujos de trabajo base de MiniMax H3](/es/tutorials/video/minimax/minimax-h3-native) para la generación basada en referencias. +El checkpoint destilado solo admite texto a video e imagen a video con primer y último fotograma. Ref2VA (acondicionamiento con múltiples referencias) no se destiló; usa los [flujos de trabajo base de MiniMax H3](/es/tutorials/video/minimax/minimax-h3-native) para la generación basada en referencias. ## Requisitos @@ -39,7 +41,9 @@ Genera video y audio sincronizados a partir de un prompt de texto en 8 pasos. Abrir en Comfy Cloud -*/} + + +*/} @@ -49,11 +53,11 @@ Genera video y audio sincronizados a partir de un prompt de texto en 8 pasos. ### Consejos para escribir prompts -1. **Describe toda la escena**: Indica primero la escena general (lugar, personaje, qué ocurre) y luego divídela en tomas con duración +1. **Describe toda la escena**: Indica primero la escena general (lugar, personaje, qué ocurre) y luego divídela en tomas con tiempos definidos 2. **Tomas, cámara y audio**: Describe las tomas, los movimientos de cámara y el audio que las acompaña (diálogo, SFX, música) en un solo bloque de prompt -3. **Resolución**: El lienzo nativo de H3 tiene un borde corto de 768px y un área de 768×1344, y las resoluciones se redondean a un múltiplo de 32. El nodo acepta tamaños mayores, pero se renderizan más lento sin añadir detalle +3. **Resolución**: El lienzo nativo de H3 tiene un borde corto de 768px y un área de 768×1344, y las resoluciones se redondean a un múltiplo de 32. El nodo acepta tamaños más grandes, pero el renderizado es más lento y no añade detalle 4. **Duración**: La entrada de duración se ajusta a la cuadrícula del modelo de 17 fotogramas por bloque (17k+5) a 24fps -5. **Los pasos son fijos en 8**: El checkpoint destilado está entrenado para exactamente 8 pasos; cambiar la cantidad de pasos en el scheduler degrada la calidad +5. **Los pasos son fijos en 8**: El checkpoint destilado está entrenado para exactamente 8 pasos; cambiar el número de pasos en el scheduler degrada la calidad Para obtener recursos sobre cómo escribir prompts, consulta la [guía de prompts](/es/tutorials/video/minimax/minimax-h3-prompt-guide). @@ -68,7 +72,9 @@ Anima una imagen fija con audio sincronizado y con control opcional de primer y Abrir en Comfy Cloud -*/} +
+ +*/} @@ -92,13 +98,13 @@ Conecta imágenes a `first_frame` y/o `last_frame` en el nodo `MiniMaxH3ImageToV ### Consejos para el prompt -1. **Describe el movimiento y el audio**: Como la imagen ya aporta la apariencia, el prompt debe centrarse en el movimiento, la cámara y el audio que lo acompaña -2. **Duración**: La entrada de duración se ajusta a la cuadrícula del modelo de 17 fotogramas por bloque (17k+5) a 24fps -3. **Los pasos están fijos en 8**: Mantén el scheduler en 8 pasos; el checkpoint está destilado para esa programación +1. **Describe el movimiento y el audio**: Como la imagen ya aporta la apariencia, el prompt debe centrarse en el movimiento, la cámara y el audio que lo acompaña. +2. **Duración**: El valor de duración se ajusta a la cuadrícula de 17 fotogramas por bloque (17k+5) del modelo a 24fps. +3. **Los pasos están fijos en 8**: Mantén el scheduler en 8 pasos; el checkpoint está destilado para esa programación. -## Descarga de modelos +## Descargas de modelos -El modelo de difusión viene del repositorio de FastVideo; el codificador de texto y los VAE se comparten con el modelo base MiniMax H3. +El modelo de diffusion proviene del repositorio de FastVideo; el text encoder y los VAE son compartidos con el modelo base MiniMax H3. @@ -128,14 +134,13 @@ ComfyUI/ │ ├── minimax_h3_video_vae_int8_convrot.safetensors │ └── minimax_h3_audio_vae_fp32.safetensors ``` - ## Notas sobre la estructura del flujo de trabajo -Ambos flujos de trabajo FastH3 comparten estos nodos con la configuración base de H3, con configuraciones específicas de destilación: +Ambos flujos de trabajo FastH3 comparten estos nodos con la configuración base de H3, con configuraciones específicas de la destilación: -- **BlockSparseAttention**: ejecuta Video Sparse Attention (VSA) con `keep_percent` 10, iniciando al 20% de la programación, lo que reduce el costo de atención mientras preserva la calidad +- **BlockSparseAttention**: ejecuta Video Sparse Attention (VSA) con `keep_percent` 10, comenzando en el 20% de la programación, lo que reduce el costo de atención sin perder calidad - **MiniMaxH3SigmaShift**: aplica el desplazamiento sigma de H3 (10 para video, 3 para audio) que coincide con la programación destilada -- **ComfyMathExpression**: convierte la entrada de duración en una `length` de fotogramas válida en la cuadrícula de 17k+5 a 24fps -- **Sampler**: sampler `res_multistep` con el scheduler `simple` a 8 pasos +- **ComfyMathExpression**: convierte la entrada de duración en una `length` de fotogramas válida en la cuadrícula 17k+5 a 24fps +- **Sampler**: sampler `res_multistep` con el scheduler `simple` en 8 pasos -Los pesos de FastH3 incluyen capas de compuerta `to_gate_compress`, que VSA lee para su rama gruesa. Los checkpoints base de H3 no las tienen. Para comparar métodos, establece `method` en `sol-attn` en el nodo **Model Sparse Attention** y mantén la misma seed. `sol-attn` no necesita pesos coincidentes y se ejecuta en cualquier checkpoint H3 con el `tau` que establezcas. +Los pesos de FastH3 incluyen capas de compuerta `to_gate_compress`, que VSA lee para su rama gruesa. Los checkpoints base de H3 no las tienen. Para comparar métodos, establece `method` en `sol-attn` en el nodo **Model Sparse Attention** y mantén la misma semilla. `sol-attn` no necesita pesos coincidentes y se ejecuta en cualquier checkpoint de H3 con el `tau` que establezcas. diff --git a/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx b/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx index 273cef655d..29f871d168 100644 --- a/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx +++ b/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx @@ -2,14 +2,16 @@ title: "ComfyUI MiniMax H3 Fun ControlNet Union: video con control de pose, profundidad y Canny" description: "Guía el movimiento de video de MiniMax H3 en ComfyUI con videos de control Canny, Depth, HED, MLSD o Pose, además de relleno inteligente con máscaras usando el parche Fun ControlNet Union." sidebarTitle: "Fun ControlNet Union" -translationSourceHash: d4c42cef +translationSourceHash: e9538916 translationFrom: tutorials/video/minimax/minimax-h3-fun-controlnet.mdx translationBlockHashes: "_intro": a84faa25 "Model downloads": 5310815d + "Model storage": b507229f "Prompting tips": 39f67d41 --- -Controla el movimiento de un video de MiniMax H3 con un video de control en lugar de solo texto. El parche Fun ControlNet Union ([alibaba-pai/MiniMax-H3-Fun-Controlnet-Union](https://huggingface.co/alibaba-pai/MiniMax-H3-Fun-Controlnet-Union), empaquetado en [Comfy-Org/MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3)) es un único checkpoint que condiciona H3 con videos de control Canny, Profundidad, HED, MLSD o Pose, y también ejecuta relleno inteligente de video con una máscara. Funciona con ambos archivos transformer `fl2va` y `ref2va`. + +Controla el movimiento de un video de MiniMax H3 con un video de control en lugar de solo texto. El parche Fun ControlNet Union ([alibaba-pai/MiniMax-H3-Fun-Controlnet-Union](https://huggingface.co/alibaba-pai/MiniMax-H3-Fun-Controlnet-Union), empaquetado en [Comfy-Org/MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3)) es un solo checkpoint que condiciona H3 con videos de control de Canny, Profundidad, HED, MLSD o Pose, y además ejecuta relleno inteligente de video con una máscara. Funciona tanto con el archivo transformer `fl2va` como con el `ref2va`. ![Vista previa del flujo de trabajo MiniMax H3 Fun ControlNet Union](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_minimax_h3_fun_controlnet_union-1.webp) @@ -28,38 +30,38 @@ Sube este archivo al nodo `Load Video` correspondiente: - Video de control de pose que usa el flujo de trabajo de ejemplo, o usa el tuyo. + Video de control de pose que usa el flujo de trabajo de ejemplo, o usa el tuyo propio. -Esta plantilla requiere ComfyUI 0.35.0 o una versión posterior. El ejemplo usa un video de control de pose: un subgrafo SDPose integrado extrae el esqueleto de la pose del video de entrada, por lo que la salida reproduce el movimiento del bailarín. También puedes conectar cualquier video de control preprocesado directamente a la entrada `control_video` del nodo `Apply MiniMax H3 Fun ControlNet`. +Esta plantilla requiere ComfyUI 0.35.0 o una versión posterior. El ejemplo usa un video de control de pose: un subgrafo SDPose integrado extrae el esqueleto de la pose del video de entrada, así que la salida reproduce el movimiento del bailarín. También puedes conectar cualquier video de control preprocesado directamente a la entrada `control_video` del nodo `Apply MiniMax H3 Fun ControlNet`. ## Descargas de modelos - Coloca en ComfyUI/models/diffusion_models/ + Colócalo en ComfyUI/models/diffusion_models/ - Coloca en ComfyUI/models/model_patches/ + Colócalo en ComfyUI/models/model_patches/ - Coloca en ComfyUI/models/text_encoders/ + Colócalo en ComfyUI/models/text_encoders/ - Coloca en ComfyUI/models/vae/ + Colócalo en ComfyUI/models/vae/ - Coloca en ComfyUI/models/vae/ + Colócalo en ComfyUI/models/vae/ - Habilita el modo turbo opcional con el Lightning LoRA. Coloca en ComfyUI/models/loras/ + Activa el modo turbo opcional del Lightning LoRA. Colócalo en ComfyUI/models/loras/ - Extractor de pose que usa el subgrafo SDPose integrado. Coloca en ComfyUI/models/checkpoints/ + Extractor de poses que usa el subgrafo SDPose integrado. Colócalo en ComfyUI/models/checkpoints/ - Detector de personas que usa el subgrafo SDPose integrado. Coloca en ComfyUI/models/diffusion_models/ + Detector de personas que usa el subgrafo SDPose integrado. Colócalo en ComfyUI/models/diffusion_models/ @@ -83,11 +85,10 @@ ComfyUI/ │ └── 📂 checkpoints/ │ └── sdpose_wholebody_fp16.safetensors ``` +## Consejos para el prompt -## Consejos para los prompts - -1. **Duración del video**: El video objetivo dura de 5 a 15 segundos en la cuadrícula de fotogramas 17n+5 a 24fps (124 fotogramas = 5 segundos). Un video de control más largo que el objetivo se recorta a sus primeros fotogramas; uno más corto mantiene su último fotograma. Para igualar exactamente la duración del video de control, conecta la salida `batch_size` calculada del ejemplo con la entrada de longitud del nodo `MiniMax H3 Reference to Video` -2. **Orientación y strength**: Mantén `guidance_scale` en 1.0. Aumenta el `strength` del patch por encima de 1 solo si el resultado se aleja del control -3. **Relleno inteligente de video**: Conecta una máscara a la entrada `mask`: las regiones marcadas con `1` se regeneran bajo el control de la entrada opcional `source_video`, mientras el resto del fotograma permanece fijo -4. **Modo turbo (opcional)**: Activa la casilla **Lightning LoRA** para usar el LoRA turbo de 4 pasos y generar mucho más rápido, con una calidad de audio y movimiento ligeramente inferior -5. **Preparar los videos de control**: ComfyUI incluye nodos de preprocesamiento integrados para cada tipo de control. Consulta el [nodo Detect Edges (Canny)](https://docs.comfy.org/built-in-nodes/Canny) para bordes y el [tutorial Depth Anything 3](https://docs.comfy.org/tutorials/utility/depth-anything-3) para mapas de profundidad +1. **Duración del video**: El video objetivo dura de 5 a 15 segundos en la cuadrícula de fotogramas 17n+5 a 24fps (124 fotogramas = 5 segundos). Un video de control más largo que el objetivo se recorta a sus primeros fotogramas; uno más corto mantiene su último fotograma. Para igualar exactamente la duración del video de control, conecta la salida `batch_size` calculada del ejemplo a la entrada de longitud del nodo `MiniMax H3 Reference to Video` +2. **Orientación y fuerza**: Mantén `guidance_scale` en 1.0. Aumenta la `strength` del parche por encima de 1 solo si la salida se aleja del control +3. **Relleno inteligente de video**: Conecta una máscara a la entrada `mask`: las regiones marcadas con `1` se regeneran bajo el control de la entrada opcional `source_video`, mientras que el resto del fotograma permanece fijo +4. **Modo turbo (opcional)**: Activa la casilla **Lightning LoRA** para usar el LoRA turbo de 4 pasos y obtener una generación mucho más rápida, con una calidad de audio y movimiento ligeramente inferior +5. **Preparar videos de control**: ComfyUI incluye nodos de preprocesamiento integrados para cada tipo de control. Consulta el [nodo Detect Edges (Canny)](https://docs.comfy.org/built-in-nodes/Canny) para bordes y el [tutorial de Depth Anything 3](https://docs.comfy.org/tutorials/utility/depth-anything-3) para mapas de profundidad diff --git a/es/tutorials/video/minimax/minimax-h3-multiframe.mdx b/es/tutorials/video/minimax/minimax-h3-multiframe.mdx index 79e7241a9d..9bde8fa5c6 100644 --- a/es/tutorials/video/minimax/minimax-h3-multiframe.mdx +++ b/es/tutorials/video/minimax/minimax-h3-multiframe.mdx @@ -2,14 +2,16 @@ title: "Flujo de trabajo de referencia multifotograma de MiniMax H3 en ComfyUI" description: "Crea continuaciones de video y escenas de varias tomas con MiniMax H3 en ComfyUI fijando fotogramas de referencia en la línea de tiempo con nodos Add Guide." sidebarTitle: "Referencia multifotograma" -translationSourceHash: 456918f4 +translationSourceHash: 92c8dde7 translationFrom: tutorials/video/minimax/minimax-h3-multiframe.mdx translationBlockHashes: "_intro": 3a03ecf1 "Model downloads": 263666fa + "Model storage": 17ed75e6 "Prompting tips": 12a34e31 "Prompt writing guide": 4f808c3a --- + Genera continuaciones de video y escenas de varios planos anclando fotogramas de referencia en puntos específicos a lo largo de la línea de tiempo de salida. El flujo de trabajo combina el nodo Reference to Video con nodos Add Guide encadenados: cada Add Guide fija una imagen estática (más audio opcional) a un índice de fotograma, de modo que el video pasa por esa composición exacta en ese momento. ![Vista previa del flujo de trabajo MiniMax H3 Multiframe Reference](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_minimax_h3_multiframe_reference-1.webp) @@ -54,7 +56,7 @@ Genera continuaciones de video y escenas de varios planos anclando fotogramas de Colócalo en ComfyUI/models/vae/ - Habilita el modo turbo opcional con el Lightning LoRA. Colócalo en ComfyUI/models/loras/ + Impulsa el modo turbo opcional del Lightning LoRA. Colócalo en ComfyUI/models/loras/ @@ -73,15 +75,14 @@ ComfyUI/ │ └── 📂 loras/ │ └── minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors ``` - ## Consejos para el prompt -1. **Haz referencia por etiqueta**: `` es la imagen conectada a la primera ranura de `ref_images`, `` a la segunda, y así sucesivamente. En este flujo de trabajo, `` es tanto el bloqueo de identidad como el primer fotograma del video -2. **Anclajes de la línea de tiempo frente a referencias**: las imágenes conectadas solo a nodos Add Guide anclan composiciones en fotogramas específicos, pero no son visibles para el codificador de texto. Conéctalas también a ranuras `ref_images` adicionales si quieres que el prompt las vea como `` -3. **Índice de fotograma**: cada Add Guide toma `frame_idx` en fotogramas a 24 fps; la plantilla lo calcula a partir de segundos con `round(seconds * 24)`. Los valores negativos cuentan desde el final del video. El índice más la longitud de la guía deben quedar dentro de la duración generada -4. **Añade más fotogramas clave**: copia un bloque de guía (Load Image + Frame Index + Math Expression + Add Guide for MiniMax H3) y mantén las salidas `positive` encadenadas en serie hacia el Basic Guider -5. **Modo turbo (opcional)**: activa la casilla **Lightning LoRA** para usar el LoRA turbo de 4 pasos y lograr una generación mucho más rápida, con una calidad de audio y movimiento ligeramente inferior +1. **Referencia por etiqueta**: `` es la imagen conectada al primer slot de `ref_images`, `` al segundo, y así sucesivamente. En este flujo de trabajo, `` es a la vez el bloqueo de identidad y el primer fotograma del video +2. **Anclajes de línea de tiempo vs. referencias**: las imágenes conectadas solo a nodos Añadir guía anclan composiciones en fotogramas concretos, pero el codificador de texto no las ve. Conéctalas también a slots `ref_images` adicionales si quieres que el prompt las vea como `` +3. **Índice de fotograma**: cada nodo Añadir guía toma `frame_idx` en fotogramas a 24 fps; la plantilla lo calcula a partir de los segundos con `round(seconds * 24)`. Los valores negativos cuentan desde el final del video. El índice más la longitud de la guía deben quedar dentro de la duración generada +4. **Añade más fotogramas clave**: copia un bloque de guía (Cargar imagen + Frame Index + Expresión matemática + Añadir guía para MiniMax H3) y mantén las salidas `positive` encadenadas en serie hacia la Guía básica +5. **Modo turbo (opcional)**: activa la casilla **Lightning LoRA** para usar el LoRA turbo de 4 pasos, que genera mucho más rápido con una calidad de audio y movimiento algo menor ## Guía para escribir prompts -El prompt de la plantilla sigue la [guía de prompts del modo de referencia completa](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md): define cada sujeto, asigna cada `` al primer fotograma o fotograma clave de un plano y corta entre planos en marcas de tiempo explícitas. Usa la misma estructura cuando escribas tus propios prompts de varios planos. La guía está resumida en la [guía de prompts](/es/tutorials/video/minimax/minimax-h3-prompt-guide). +El prompt de la plantilla sigue la [guía de prompts del modo de referencia completa](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md): define cada sujeto, asigna cada `` al primer fotograma o al fotograma clave de un plano y corta entre planos en marcas de tiempo explícitas. Usa la misma estructura cuando escribas tus propios prompts de varios planos. La guía está resumida en la [guía de prompts](/es/tutorials/video/minimax/minimax-h3-prompt-guide). diff --git a/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx b/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx index 2a9accf37c..4ea15c9007 100644 --- a/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx +++ b/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx @@ -2,16 +2,17 @@ title: "Guía de prompts de ComfyUI MiniMax H3: guías oficiales, consejos y embeddings de prompt" description: "Escribe mejores prompts de MiniMax H3 en ComfyUI: guías oficiales, consejos generales, reglas de diálogo y hablantes, y embeddings de estilo." sidebarTitle: "Guía de prompts" -translationSourceHash: 0d858ae8 +translationSourceHash: 0f1ded35 translationFrom: tutorials/video/minimax/minimax-h3-prompt-guide.mdx translationBlockHashes: "_intro": da22cc9d "Official guides": 3d762c67 - "General tips": 91822299 + "General tips": fab4ad35 "Shots and cuts": 8184dae6 "Dialogue and speakers": 4985438e "Prompt embeddings": 9c899169 --- + H3 espera planos, cámara, diálogo y SFX en un solo prompt multimodal. Esta página reúne guías oficiales, consejos entre flujos de trabajo, reglas de planos y diálogo, y embeddings de estilo. ## Guías oficiales @@ -37,7 +38,7 @@ Escribe los prompts en **inglés**. Los diálogos y las letras de canciones van 1. **Primero la escena**: la escena general, luego los planos cronometrados dentro de `[Shot 1]` de `integrated_multimodal_description` 2. **Un solo bloque**: planos, cámara y audio juntos -3. **Resolución**: nativa **1344×768** en 16:9; múltiplos de **32** +3. **Resolución**: nativa de **1344×768** en 16:9; múltiplos de **32** 4. **Longitud**: `length` son fotogramas a 24fps (predeterminado **124** ≈ 5s), ajustado a **17k+5** 5. **Texto en pantalla**: comillas dobles en inglés para cada cadena, literal (p. ej., `A red neon sign reading "营业中"`). Las líneas habladas usan ``, no comillas 6. **Marcadores de audio de R2V**: en el análisis de retención, marca cada referencia de audio como `fully_copy`, `partially_copy`, `reference` o `weak_reference` según cómo se use el clip (consulta la tabla de la guía oficial de referencias) diff --git a/es/tutorials/video/wan/fun-control.mdx b/es/tutorials/video/wan/fun-control.mdx index fc40179236..bdbe7953dc 100644 --- a/es/tutorials/video/wan/fun-control.mdx +++ b/es/tutorials/video/wan/fun-control.mdx @@ -2,28 +2,30 @@ title: "Ejemplos de video con Wan2.1 Fun Control en ComfyUI" description: "Esta guía muestra cómo usar Wan2.1 Fun Control en ComfyUI para generar videos con videos de control" sidebarTitle: "Wan2.1 Fun Control" -translationSourceHash: 2ce972d6 +translationSourceHash: 8b293934 translationFrom: tutorials/video/wan/fun-control.mdx translationBlockHashes: "_intro": b7cb8b6d "About Wan2.1-Fun-Control": 2e562079 + "Model Installation": 6ee9c5c6 "ComfyUI Native Workflow": 01fc65b5 "Workflow Using Custom Nodes": 8f081a21 "Usage Tips": 9e74c201 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; Wan2.1-Fun-Control es un modelo de generación de video de código abierto del proyecto VideoX-Fun de Alibaba que sigue condiciones de control predefinidas en lugar de depender únicamente del texto del prompt. Puedes guiar la salida con mapas de bordes Canny, mapas de profundidad, esqueletos OpenPose, bordes geométricos MLSD o trayectorias de puntos. -El modelo está disponible en dos tamaños: la versión de 1.3B (unos 19 GB) para un despliegue local ligero con menores requisitos de VRAM, y la versión de 14B (unos 47 GB de almacenamiento total del modelo, con los pesos de difusión en unos 32.8 GB) para resultados de mayor calidad. Ambas admiten predicción de video multirresolución a 512, 768 y 1024 píxeles, generan hasta 81 fotogramas (unos 5 segundos) a 16 fotogramas por segundo y aceptan prompts multilingües. ComfyUI ofrece soporte nativo para Wan2.1-Fun-Control. +El modelo está disponible en dos tamaños: la versión de 1.3B (unos 19 GB) para un despliegue local ligero con requisitos de VRAM más bajos, y la versión de 14B (unos 47 GB de almacenamiento total del modelo, con los pesos de difusión en unos 32.8 GB) para resultados de mayor calidad. Ambas admiten predicción de video multirresolución a 512, 768 y 1024 píxeles, generan hasta 81 fotogramas (unos 5 segundos) a 16 fotogramas por segundo y aceptan prompts multilingües. ComfyUI ofrece soporte nativo para Wan2.1-Fun-Control. ## Acerca de Wan2.1-Fun-Control **Wan2.1-Fun-Control** es un proyecto de generación y control de video de código abierto desarrollado por el equipo de Alibaba. Introduce mecanismos innovadores de códigos de control (Control Codes) combinados con aprendizaje profundo y entradas condicionales multimodales para generar videos de alta calidad que cumplen con condiciones de control predefinidas. El proyecto se centra en guiar con precisión el contenido del video generado mediante condiciones de control multimodales. -Actualmente, el modelo Fun Control admite diversas condiciones de control, como **Canny (arte lineal), Depth, OpenPose (postura humana), MLSD (bordes geométricos) y control de trayectoria.** -El modelo también admite predicción de video multirresolución con opciones de 512, 768 y 1024 de resolución a 16 fotogramas por segundo, generando videos de hasta 81 fotogramas (aproximadamente 5 segundos) de duración. +Actualmente, el modelo Fun Control admite diversas condiciones de control, como **Canny (arte lineal), Profundidad, OpenPose (postura humana), MLSD (bordes geométricos) y control de trayectoria.** +El modelo también admite la predicción de video en múltiples resoluciones, con opciones de 512, 768 y 1024 a 16 fotogramas por segundo, y genera videos de hasta 81 fotogramas (aproximadamente 5 segundos) de duración. Versiones del modelo: - **1.3B** Ligero: ideal para el despliegue local y la inferencia rápida con **requisitos de VRAM más bajos** @@ -55,33 +57,33 @@ Sin embargo, hemos comprobado que ofrecer una buena experiencia de usuario para -## Instalación de modelos +## Instalación del modelo -Solo tienes que instalar estos modelos una vez. Las imágenes de los flujos de trabajo también contienen la información de descarga de los modelos, así que puedes elegir el método de descarga que prefieras. +Solo necesitas instalar estos modelos una vez. Las imágenes del flujo de trabajo también contienen la información de descarga de los modelos, así que puedes elegir el método de descarga que prefieras. -Los siguientes modelos están disponibles en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged) y [Wan2.1-Fun](https://huggingface.co/collections/alibaba-pai/wan21-fun-67e4fb3b76ca01241eb7e334) +Puedes encontrar los siguientes modelos en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged) y [Wan2.1-Fun](https://huggingface.co/collections/alibaba-pai/wan21-fun-67e4fb3b76ca01241eb7e334) -Haz clic en los enlaces correspondientes para descargar. Si ya has usado flujos de trabajo de Wan, solo necesitas descargar los **modelos de difusión**. +Haz clic en los enlaces correspondientes para descargarlos. Si ya has usado flujos de trabajo relacionados con Wan, solo necesitas descargar los **modelos de difusión**. -**Modelos de difusión** -- elige 1.3B o 14B. La versión 14B tiene un tamaño de archivo mayor (32 GB) y requiere más VRAM: +**Modelos de difusión**: elige 1.3B o 14B. La versión 14B tiene un tamaño de archivo mayor (32GB) y requiere más VRAM: - Modelo de difusión Wan2.1 Fun Control 1.3B -- ligero, requiere menos VRAM + Modelo de difusión Wan2.1 Fun Control 1.3B: ligero, con menores requisitos de VRAM - Modelo de difusión Wan2.1 Fun Control 14B. Cámbiale el nombre a Wan2.1-Fun-14B-Control.safetensors después de descargarlo. Archivo de 32 GB o más, requiere más VRAM + Modelo de difusión Wan2.1 Fun Control 14B. Cambia el nombre a Wan2.1-Fun-14B-Control.safetensors después de descargarlo. Tamaño de archivo de 32GB o más, mayores requisitos de VRAM -**Codificadores de texto** -- elige uno de los siguientes modelos (la precisión fp16 tiene un tamaño mayor y requiere más rendimiento): +**Codificadores de texto**: elige uno de los siguientes modelos (la precisión fp16 tiene un tamaño mayor y requisitos de rendimiento más altos): - Codificador de texto UMT5 XXL -- precisión fp16, tamaño mayor, mayor rendimiento + Codificador de texto UMT5 XXL: precisión fp16, mayor tamaño, mayores requisitos de rendimiento - Codificador de texto UMT5 XXL -- precisión fp8, tamaño menor, requiere menos rendimiento + Codificador de texto UMT5 XXL: precisión fp8, menor tamaño, menores requisitos de rendimiento @@ -95,7 +97,7 @@ Haz clic en los enlaces correspondientes para descargar. Si ya has usado flujos Modelo CLIP Vision para procesar imágenes de referencia -Ubicación de almacenamiento de archivos: +Ubicación de almacenamiento de los archivos: ``` 📂 ComfyUI/ ├── 📂 models/ @@ -109,15 +111,14 @@ Ubicación de almacenamiento de archivos: │ └── 📂 clip_vision/ │ └── clip_vision_h.safetensors ``` - ## Flujo de trabajo nativo de ComfyUI -En este flujo de trabajo usamos videos convertidos a **formato WebP**, ya que el nodo `Load Image` no admite actualmente el formato mp4. También usamos **Canny Edge** para preprocesar el video original. -Como muchos usuarios se topan con fallos de instalación y problemas de entorno al instalar nodos personalizados, esta versión del flujo de trabajo usa solo nodos nativos para garantizar una experiencia más fluida. +En este flujo de trabajo, usamos videos convertidos a **formato WebP**, ya que el nodo `Load Image` no admite actualmente el formato mp4. También usamos **Canny Edge** para preprocesar el video original. +Como muchos usuarios encuentran fallas de instalación y problemas de entorno al instalar nodos personalizados, esta versión del flujo de trabajo usa solo nodos nativos para garantizar una experiencia más fluida. -Gracias a nuestros potentes autores de ComfyUI, que ofrecen nodos con muchas funciones. Si quieres consultar directamente la versión relacionada, mira [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados). +Gracias a nuestros grandes autores de ComfyUI, que ofrecen nodos con muchas funciones. Si quieres consultar directamente la versión relacionada, mira [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados). -### 1. Descarga del archivo del flujo de trabajo +### 1. Descargar el archivo del flujo de trabajo ![Flujo de trabajo nativo de Wan2.1 Fun Control](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/wan2.1_fun_control/wan2.1_fun_control_native.webp) @@ -125,23 +126,23 @@ Gracias a nuestros potentes autores de ComfyUI, que ofrecen nodos con muchas fun Abrir en Comfy Cloud - - Descarga la imagen del flujo de trabajo y arrástrala a ComfyUI para cargarlo + + Descarga la imagen del flujo de trabajo y arrástrala a ComfyUI para cargar el flujo de trabajo **Materiales de entrada** - + Fotograma inicial de entrada para el flujo de trabajo nativo. Descarga y usa esta imagen, o reemplázala por la tuya. - Video de control de entrada en formato WebP para el flujo de trabajo nativo. El flujo de trabajo nativo requiere formato WebP porque Load Image no admite mp4. + Video de control de entrada en formato WebP para el flujo de trabajo nativo. El flujo de trabajo nativo requiere el formato WebP, ya que Load Image no admite mp4. -### 2. Completa el flujo de trabajo paso a paso +### 2. Completar el flujo de trabajo paso a paso ![Pasos del flujo de trabajo de Wan2.1 Fun Control](/images/tutorial/video/wan/fun_control_native_flow_diagram.png) @@ -149,38 +150,38 @@ Gracias a nuestros potentes autores de ComfyUI, que ofrecen nodos con muchas fun 2. Asegúrate de que el nodo `Load CLIP` haya cargado `umt5_xxl_fp8_e4m3fn_scaled.safetensors` 3. Asegúrate de que el nodo `Load VAE` haya cargado `wan_2.1_vae.safetensors` 4. Asegúrate de que el nodo `Load CLIP Vision` haya cargado `clip_vision_h.safetensors` -5. Sube el fotograma inicial al nodo `Load Image` (renombrado como `Start_image`) -6. Sube el video de control al segundo nodo `Load Image`. Nota: este nodo actualmente no admite mp4, solo videos WebP -7. (Opcional) Modifica el prompt (se admite inglés y chino) +5. Sube el fotograma inicial al nodo `Load Image` (renombrado a `Start_image`) +6. Sube el video de control al segundo nodo `Load Image`. Nota: este nodo no admite actualmente mp4, solo videos WebP +7. (Opcional) Modifica el prompt (puedes usar inglés o chino) 8. (Opcional) Ajusta el tamaño del video en `WanFunControlToVideo`, evitando dimensiones demasiado grandes 9. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video ### 3. Notas de uso -- Como debemos introducir en el nodo `WanFunControlToVideo` el mismo número de fotogramas que tiene el video de control, si el número de fotogramas especificado supera los fotogramas reales del video de control, los fotogramas sobrantes pueden mostrar escenas que no se ajustan a las condiciones de control. Abordaremos este problema en [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados) -- Evita establecer dimensiones demasiado grandes, ya que esto puede hacer que el muestreo sea muy lento. Prueba primero con imágenes más pequeñas y luego haz upscale -- Usa tu imaginación para ampliar este flujo de trabajo añadiendo flujos de texto a imagen u otros tipos, y lograr así generación directa de texto a video o transferencia de estilo -- Usa herramientas como [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) para obtener opciones de control más ricas +- Como debemos introducir en el nodo `WanFunControlToVideo` el mismo número de fotogramas que el video de control, si el número de fotogramas especificado supera los fotogramas reales del video de control, los fotogramas sobrantes pueden mostrar escenas que no cumplen con las condiciones de control. Abordaremos este problema en [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados) +- Evita establecer dimensiones demasiado grandes, ya que esto puede hacer que el proceso de muestreo tarde mucho. Intenta generar imágenes más pequeñas primero y luego aplica upscale +- Usa tu imaginación para ampliar este flujo de trabajo añadiendo flujos de trabajo de texto a imagen u otros tipos, y lograr así la generación directa de texto a video o la transferencia de estilo +- Usa herramientas como [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) para obtener opciones de control más completas ## Flujo de trabajo con nodos personalizados Necesitaremos instalar los siguientes dos nodos personalizados: -- [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite) +- [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite) - [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) Puedes usar [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) para instalar los nodos faltantes o seguir las instrucciones de instalación de cada paquete de nodos personalizados. -### 1. Descargar el archivo del flujo de trabajo +### 1. Descarga del archivo del flujo de trabajo -![Flujo de trabajo Wan2.1 Fun Control](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/wan2.1_fun_control-1.webp) +![Flujo de trabajo de Wan2.1 Fun Control](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/wan2.1_fun_control-1.webp) Abrir en Comfy Cloud - Descarga el JSON o busca "Wan 2.1 ControlNet" en la biblioteca de plantillas + Descarga el JSON o busca "Wan 2.1 ControlNet" en la Biblioteca de plantillas @@ -188,27 +189,27 @@ Puedes usar [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) para - Fotograma inicial de entrada para el flujo de trabajo con nodos personalizados. Descarga y usa esta imagen, o reemplázala por una propia. + Fotograma inicial de entrada para el flujo de trabajo con nodos personalizados. Descarga y usa esta imagen, o reemplázala por la tuya. Video de control de entrada en formato MP4 para el flujo de trabajo con nodos personalizados. El nodo personalizado Load Video admite el formato mp4. -### 2. Completar el flujo de trabajo paso a paso +### 2. Completa el flujo de trabajo paso a paso -![Pasos del flujo de trabajo Wan2.1 Fun Control con nodos personalizados](/images/tutorial/video/wan/fun_control_using_custom_nodes_flow_diagram.png) +![Pasos del flujo de trabajo de Wan2.1 Fun Control con nodos personalizados](/images/tutorial/video/wan/fun_control_using_custom_nodes_flow_diagram.png) > La parte del modelo es esencialmente la misma. Si ya probaste el flujo de trabajo solo con nodos nativos, puedes subir directamente las imágenes correspondientes y ejecutarlo. -1. Asegúrate de que el nodo `Load Diffusion Model` haya cargado `wan2.1_fun_control_1.3B_bf16.safetensors` -2. Asegúrate de que el nodo `Load CLIP` haya cargado `umt5_xxl_fp8_e4m3fn_scaled.safetensors` -3. Asegúrate de que el nodo `Load VAE` haya cargado `wan_2.1_vae.safetensors` -4. Asegúrate de que el nodo `Load CLIP Vision` haya cargado `clip_vision_h.safetensors` +1. Asegúrate de que el nodo `Load Diffusion Model` tenga cargado `wan2.1_fun_control_1.3B_bf16.safetensors` +2. Asegúrate de que el nodo `Load CLIP` tenga cargado `umt5_xxl_fp8_e4m3fn_scaled.safetensors` +3. Asegúrate de que el nodo `Load VAE` tenga cargado `wan_2.1_vae.safetensors` +4. Asegúrate de que el nodo `Load CLIP Vision` tenga cargado `clip_vision_h.safetensors` 5. Sube el fotograma inicial al nodo `Load Image` 6. Sube un video en formato mp4 al nodo personalizado `Load Video(Upload)`. Ten en cuenta que el flujo de trabajo ha ajustado el `frame_load_cap` predeterminado -7. Para la imagen actual, el `DWPose Estimator` solo usa la opción `detect_face` -8. (Opcional) Modifica el prompt (se admiten tanto inglés como chino) +7. Para la imagen actual, `DWPose Estimator` solo usa la opción `detect_face` +8. (Opcional) Modifica el prompt (se admiten inglés y chino) 9. (Opcional) Ajusta el tamaño del video en `WanFunControlToVideo`, evitando dimensiones demasiado grandes 10. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video @@ -216,7 +217,7 @@ Puedes usar [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) para Gracias a los autores de la comunidad de ComfyUI por sus paquetes de nodos personalizados: - Este ejemplo usa `Load Video(Upload)` para admitir videos mp4 -- El `video_info` que se obtiene de `Load Video(Upload)` nos permite mantener los mismos `fps` en el video de salida +- El `video_info` que se obtiene de `Load Video(Upload)` nos permite mantener el mismo `fps` en el video de salida - Puedes reemplazar `DWPose Estimator` por otros preprocesadores del paquete de nodos `ComfyUI-comfyui_controlnet_aux` - Los prompts admiten varios idiomas @@ -224,10 +225,10 @@ Gracias a los autores de la comunidad de ComfyUI por sus paquetes de nodos perso ![Aplicar varios videos de control](/images/tutorial/video/wan/apply_multi_control_videos.jpg) -- Un consejo útil es que puedes combinar varias técnicas de preprocesamiento de imágenes y luego usar el nodo `Image Blend` para lograr el objetivo de aplicar varios métodos de control al mismo tiempo. +- Un consejo útil: puedes combinar varias técnicas de preprocesamiento de imágenes y luego usar el nodo `Image Blend` para lograr aplicar varios métodos de control al mismo tiempo. - Puedes usar el nodo `Video Combine` de `ComfyUI-VideoHelperSuite` para guardar videos en formato mp4 -- Usamos `SaveAnimatedWEBP` porque actualmente no admitimos incrustar el flujo de trabajo en **mp4** y algunos Nodos personalizados también pueden no admitir la incrustación del flujo de trabajo. Para conservar el flujo de trabajo en el video, elegimos el nodo `SaveAnimatedWEBP`. -- En el nodo `WanFunControlToVideo`, `control_video` no es obligatorio, así que a veces puedes Saltar el uso de un video de control, primero Generar un video de tamaño muy pequeño como 320x320 y luego usarlo como Entrada de video de control para lograr resultados consistentes. +- Usamos `SaveAnimatedWEBP` porque actualmente no admitimos incrustar el flujo de trabajo en **mp4**, y puede que algunos otros nodos personalizados tampoco admitan incrustar el flujo de trabajo. Para conservar el flujo de trabajo en el video, elegimos el nodo `SaveAnimatedWEBP`. +- En el nodo `WanFunControlToVideo`, `control_video` no es obligatorio, así que a veces puedes saltarte el uso de un video de control: primero genera un video de tamaño muy pequeño, como 320x320, y luego úsalo como entrada de video de control para lograr resultados consistentes. - [ComfyUI-WanVideoWrapper](https://github.com/kijai/ComfyUI-WanVideoWrapper) - [ComfyUI-KJNodes](https://github.com/kijai/ComfyUI-KJNodes) diff --git a/es/tutorials/video/wan/wan-animate-2.mdx b/es/tutorials/video/wan/wan-animate-2.mdx index 07a6b5786a..742c6c9994 100644 --- a/es/tutorials/video/wan/wan-animate-2.mdx +++ b/es/tutorials/video/wan/wan-animate-2.mdx @@ -2,17 +2,19 @@ title: "Wan Animate 2: transferencia de movimiento" description: "Anima un personaje estático con Wan Animate 2 en ComfyUI: transfiere el movimiento desde un video guía directamente, sin extracción de poses ni preprocesamiento de esqueleto." sidebarTitle: "Wan Animate 2" -translationSourceHash: ae4a191b +translationSourceHash: 3eded645 translationFrom: tutorials/video/wan/wan-animate-2.mdx translationBlockHashes: "_intro": 358b6914 "Model Highlights": ab20a214 + "Wan Animate 2 workflow": c684e48e --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -Wan Animate 2 es un framework de animación de personajes de extremo a extremo del equipo de Wan que consume directamente videos guía en un Diffusion Transformer rediseñado. Logra una generación de movimiento de alta fidelidad y una fuerte preservación de la identidad al eliminar los extractores de movimiento intermedios: no se necesita extracción de pose ni preprocesamiento de esqueletos. +Wan Animate 2 es un framework de animación de personajes de extremo a extremo del equipo de Wan que consume directamente videos guía en un Diffusion Transformer rediseñado. Logra una generación de movimiento de alta fidelidad y una fuerte preservación de la identidad al eliminar los extractores de movimiento intermedios: no hace falta extraer poses ni preprocesar esqueletos. -El modelo también añade control de perspectiva impulsado por texto, lo que desacopla la perspectiva de la cámara de salida del video de conducción. Esto te permite animar a un personaje estático usando un video de conducción mientras controlas la cámara de forma independiente, e incluso generar un fondo nuevo a partir de tu prompt de texto. +El modelo también agrega control del punto de vista impulsado por texto, lo que desacopla la perspectiva de la cámara de salida del video guía. Esto te permite animar a un personaje estático con un video guía mientras controlas la cámara de forma independiente, e incluso generar un fondo nuevo a partir de tu prompt de texto. @@ -20,13 +22,13 @@ El modelo también añade control de perspectiva impulsado por texto, lo que des - **Transferencia directa de movimiento**: Anima a un personaje estático a partir de un video guía sin extracción de pose ni preprocesamiento de esqueleto - **Preservación de la identidad**: Mantiene intactas la identidad, la apariencia y los detalles del personaje de referencia -- **Control de cámara por texto**: Desacopla la perspectiva de la cámara de salida respecto del video guía +- **Control de cámara mediante texto**: Desacopla la perspectiva de la cámara de salida con respecto al video guía - **Fondos nuevos**: Genera un fondo nuevo a partir de tu prompt de texto en lugar de copiar el fondo del video guía - **Movimiento de alta fidelidad**: Replica movimientos y expresiones complejas del video guía -## Flujo de trabajo de Wan Animate 2 +## Flujo de trabajo Wan Animate 2 -Anima un personaje estático con un video guía, transfiriendo el movimiento directamente desde los fotogramas del video. La salida conserva la identidad del personaje de referencia y, al mismo tiempo, genera un fondo nuevo y un movimiento de cámara a partir de tu prompt de texto. +Anima un personaje inmóvil con un video de control, transfiriendo el movimiento directamente desde los fotogramas del video. El resultado conserva la identidad del personaje de referencia mientras genera un fondo nuevo y un movimiento de cámara a partir de tu prompt de texto. @@ -35,7 +37,7 @@ Anima un personaje estático con un video guía, transfiriendo el movimiento dir Abrir en Comfy Cloud
- Descarga el JSON o busca "Wan Animate 2" en la Biblioteca de plantillas + Descarga el JSON o busca "Wan Animate 2" en la biblioteca de plantillas
@@ -45,38 +47,38 @@ Sube estos archivos a los nodos correspondientes: - Nodo `LoadImage`: pink_hair_mech_arms_ref.png (el personaje que se va a animar) + Nodo `LoadImage`: pink_hair_mech_arms_ref.png (el personaje que vas a animar) - + Nodo `LoadVideo`: street_dance_drive.mp4 (la fuente del movimiento) -### Descarga de modelos +### Descargas de modelos -Este flujo de trabajo usa el modelo de difusión `wan_animate_2_int8_convrot.safetensors`. El repositorio también incluye variantes BF16 y destiladas; si prefieres usarlas, cambia la selección de modelo en el nodo `UNETLoader`. Todos los archivos están disponibles en el repositorio [Comfy-Org/Wan-Animate-2](https://huggingface.co/Comfy-Org/Wan-Animate-2): +Este flujo de trabajo usa el modelo de difusión `wan_animate_2_int8_convrot.safetensors`. El repositorio también incluye variantes BF16 y destiladas; si prefieres usar esas, cambia la selección de modelo en el nodo `UNETLoader`. Todos los archivos están disponibles en el repositorio [Comfy-Org/Wan-Animate-2](https://huggingface.co/Comfy-Org/Wan-Animate-2): - - wan_animate_2_int8_convrot.safetensors: Modelo de difusión cuantizado INT8 convrot que usa este flujo de trabajo + + wan_animate_2_int8_convrot.safetensors: modelo de difusión cuantizado INT8 convrot que usa este flujo de trabajo - wan_animate_2_bf16.safetensors: Modelo base de precisión completa. Requiere cambiar la selección de modelo en UNETLoader. + wan_animate_2_bf16.safetensors: modelo base de precisión completa. Requiere cambiar la selección de modelo en UNETLoader. - - wan_animate_2_distill_int8_convrot.safetensors: Variante INT8 destilada. Requiere cambiar la selección de modelo en UNETLoader. + + wan_animate_2_distill_int8_convrot.safetensors: variante INT8 destilada. Requiere cambiar la selección de modelo en UNETLoader. - - wan_animate_2_distill_bf16.safetensors: Variante BF16 destilada. Requiere cambiar la selección de modelo en UNETLoader. + + wan_animate_2_distill_bf16.safetensors: variante BF16 destilada. Requiere cambiar la selección de modelo en UNETLoader. lightx2v_I2V_14B_480p_cfg_step_distill_rank64_bf16.safetensors: LoRA de aceleración LightX2V - umt5_xxl_fp8_e4m3fn_scaled.safetensors: Codificador de texto UMT5-XXL FP8 + umt5_xxl_fp8_e4m3fn_scaled.safetensors: codificador de texto UMT5-XXL FP8 - clip_vision_h.safetensors: Codificador CLIP Vision + clip_vision_h.safetensors: codificador CLIP Vision Wan2_1_VAE_bf16.safetensors: VAE de Wan2.1 para codificar y decodificar @@ -105,20 +107,20 @@ Coloca los archivos en los siguientes directorios: ### Instrucciones del flujo de trabajo -1. Asegúrate de que todos los modelos se cargan correctamente +1. Asegúrate de que todos los modelos estén cargados correctamente 2. Sube la imagen de referencia: el personaje de esta imagen es el personaje objetivo que se va a animar -3. Sube el video guía: su movimiento se transfiere al personaje de referencia +3. Sube el video de conducción: su movimiento se transfiere al personaje de referencia 4. Actualiza el prompt para describir la escena, el fondo y el movimiento de cámara que quieres 5. Haz clic en `Run` o usa el atajo `Ctrl(cmd) + Enter` para generar el video ### Extender a videos más largos -Los videos más largos se gestionan dentro del flujo de trabajo: el Subgraph `Motion Transfer (Wan Animate 2)` itera (`StartLoop` / `EndLoop`) y sigue generando hasta cubrir todo el video guía, así que con un solo Subgraph es suficiente. No hay que duplicar ni recablear nada. +Los videos más largos se manejan dentro del flujo de trabajo: el subgrafo `Motion Transfer (Wan Animate 2)` hace un bucle (`StartLoop` / `EndLoop`) y sigue generando hasta cubrir todo el video de conducción, así que con un solo subgrafo es suficiente. No hay que duplicar ni recablear nada. -Cada iteración del bucle genera 81 fotogramas, unos 3.4 segundos a 24 fps. Ese es el valor `Int (fragment_length)` dentro del Subgraph. Puedes aumentarlo, pero debe mantenerse en una longitud válida de Wan: 81, 85, 89, etcétera, es decir, `4n + 1`. +Una iteración del bucle genera 81 fotogramas, unos 3.4 segundos a 24 fps. Ese es el valor de `Int (fragment_length)` dentro del subgrafo. Puedes aumentarlo, pero debe seguir siendo una longitud válida de Wan: 81, 85, 89, etcétera, es decir, `4n + 1`. -El cálculo del bucle lee el número de fotogramas del video guía, determina cuántas continuaciones hacen falta y recorta el final para que la salida tenga exactamente los mismos fotogramas que el video guía. Cada continuación repite el último fotograma del segmento anterior y ese duplicado se elimina, así que cada segmento adicional añade `fragment_length - 1` fotogramas nuevos. +El cálculo del bucle lee el número de fotogramas del video de conducción, determina cuántas continuaciones se necesitan y recorta el final para que la salida tenga exactamente la misma cantidad de fotogramas que el video de conducción. Cada continuación repite el último fotograma del segmento anterior y ese duplicado se elimina, así que cada segmento adicional añade `fragment_length - 1` fotogramas nuevos. -El bucle usa los nodos de bucle del núcleo, así que el flujo de trabajo necesita ComfyUI 0.36.0 o superior. +El bucle usa los nodos de bucle del núcleo, así que el flujo de trabajo necesita ComfyUI 0.36.0 o una versión más reciente. -El Subgraph `Video Stitch` es la vista previa comparativa: coloca el video generado junto al video guía. No forma parte de la ruta de extensión. +El subgrafo `Video Stitch` es la vista previa de comparación: coloca el video generado junto al video de conducción. No forma parte de la ruta de extensión. diff --git a/es/tutorials/video/wan/wan-causal-forcing.mdx b/es/tutorials/video/wan/wan-causal-forcing.mdx index 342ce69dae..80e0e5ac4e 100644 --- a/es/tutorials/video/wan/wan-causal-forcing.mdx +++ b/es/tutorials/video/wan/wan-causal-forcing.mdx @@ -2,17 +2,19 @@ title: "Causal Forcing en ComfyUI: imagen a video con Wan2.1 en 1 a 4 pasos" description: "Genera video temporalmente consistente desde una sola imagen en ComfyUI con Causal Forcing o Causal Forcing++ sobre Wan2.1, usando tan solo 1 a 4 pasos." sidebarTitle: "Causal Forcing I2V" -translationSourceHash: 4cd31faf +translationSourceHash: e94bf5dc translationFrom: tutorials/video/wan/wan-causal-forcing.mdx translationBlockHashes: "_intro": 3da76367 "How it works": a3348b35 "Using the workflow": 5e6245a2 "Steps to run": 3202924b + "Model downloads": c6ce079e --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Causal Forcing** es una técnica de generación de video que aplica **conditioning recurrente** durante la inferencia, en la que cada fotograma generado se devuelve al modelo para predecir el siguiente fotograma. Así se obtienen videos suaves y coherentes en el tiempo a partir de una sola imagen inicial en tan solo **1 a 4 pasos de inferencia**. +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' + +**Causal Forcing** es una técnica de generación de video que aplica **acondicionamiento recurrente** durante la inferencia: cada fotograma generado se retroalimenta al modelo para predecir el siguiente fotograma. Así se obtienen videos suaves y coherentes en el tiempo a partir de una sola imagen inicial con tan solo **1 a 4 pasos de inferencia**. Este flujo de trabajo usa **Wan2.1** y admite tanto el modo **Causal Forcing** (estándar) como **Causal Forcing++** (mejorado). @@ -33,7 +35,7 @@ Este flujo de trabajo usa **Wan2.1** y admite tanto el modo **Causal Forcing** ( - Imagen de entrada para el primer fotograma. Descárgala y úsala, o reemplázala por una tuya. + Imagen de entrada para el primer fotograma. Descarga esta imagen y úsala, o reemplázala con una tuya. @@ -55,8 +57,8 @@ Este enfoque recurrente crea una **fuerte consistencia temporal**: cada fotogram | Modo | Descripción | |---|---| -| **Causal Forcing** | conditioning recurrente estándar. Buena calidad con 2–4 pasos. | -| **Causal Forcing++** | Modo mejorado que aplica conditioning adicional para una mejor coherencia temporal. Funciona bien con solo 1–2 pasos. | +| **Causal Forcing** | Acondicionamiento recurrente estándar. Buena calidad con 2–4 pasos. | +| **Causal Forcing++** | Modo mejorado que aplica acondicionamiento adicional para una mejor coherencia temporal. Funciona bien con solo 1–2 pasos. | ## Usar el flujo de trabajo @@ -67,34 +69,34 @@ El flujo de trabajo acepta una sola imagen de entrada (el primer fotograma) y un | Ajuste | Descripción | |---|---| | **first_frame** (requerido) | La imagen inicial del video. Carga un PNG/JPG con el nodo **LoadImage**. | -| **positive_prompt** (opcional) | Una descripción de texto del contenido de video deseado. Déjalo vacío para no aplicar conditioning. | -| **duration** (opcional) | El número de fotogramas a generar. Predeterminado: el número de fotogramas de la salida esperada del modelo. | +| **positive_prompt** (opcional) | Una descripción de texto del contenido de video deseado. Déjalo vacío para no aplicar acondicionamiento. | +| **duration** (opcional) | El número de fotogramas que se van a generar. Predeterminado: el número de fotogramas de la salida esperada del modelo. | ### Parámetros del subgrafo WAN I2V -Se exponen como controles en el nodo del subgrafo del plano: +Estos aparecen como controles en el nodo del subgrafo del plano: | Parámetro | Predeterminado | Descripción | |---|---|---| | `unet_name` | - | El checkpoint del modelo Wan2.1 I2V que se va a usar | | `clip_name` | - | El modelo CLIP / codificador de texto para el prompt | -| `vae_name` | - | El modelo VAE para codificar/decodificar | +| `vae_name` | - | El modelo VAE para codificar y decodificar | | `width` | - | Ancho del video de salida | | `height` | - | Alto del video de salida | -| `noise_seed` | - | Semilla para la reproducibilidad | +| `noise_seed` | - | Semilla para reproducibilidad | ## Pasos para ejecutar 1. **Carga una imagen**: usa el nodo **LoadImage** para cargar tu fotograma inicial -2. **Escribe un prompt** (opcional): describe el contenido de video que deseas +2. **Escribe un prompt** (opcional): describe el contenido de video deseado 3. **Establece la duración**: cuántos fotogramas generar -4. **Selecciona los modelos**: elige el checkpoint, CLIP y VAE de Wan2.1 I2V -5. **Elige el modo**: Causal Forcing o Causal Forcing++ (configúralo mediante la configuración interna del subgrafo o una entrada específica de Causal Forcing si está disponible) +4. **Selecciona los modelos**: elige el checkpoint Wan2.1 I2V, CLIP y VAE +5. **Elige el modo**: Causal Forcing o Causal Forcing++ (ajústalo con la configuración interna del subgrafo o con una entrada específica de Causal Forcing si está disponible) 6. **Ejecuta**: los fotogramas se generarán de forma secuencial y se guardarán en `ComfyUI/output/` -## Descarga de modelos +## Descargas de modelos -Descarga el modelo Wan2.1 I2V y los archivos necesarios. Colócalos en los subdirectorios correspondientes de `models/`. +Descarga el modelo Wan2.1 I2V y los archivos requeridos. Colócalos en las subcarpetas correspondientes de `models/`. ### Wan2.1 I2V @@ -103,7 +105,7 @@ Descarga el modelo Wan2.1 I2V y los archivos necesarios. Colócalos en los subdi wan2.1_i2v_480p_14B_fp16.safetensors - checkpoint Wan2.1 I2V 14B - wan2.1_t2v_1.3B_fp16.safetensors - checkpoint Wan2.1 1.3B (8 GB de VRAM como mínimo) + wan2.1_t2v_1.3B_fp16.safetensors - checkpoint Wan2.1 1.3B (mínimo 8 GB de VRAM) @@ -118,7 +120,7 @@ Descarga el modelo Wan2.1 I2V y los archivos necesarios. Colócalos en los subdi
-### Ubicación de almacenamiento de modelos +### Ubicación de almacenamiento de los modelos ``` 📂 ComfyUI/ diff --git a/es/tutorials/video/wan/wan-move.mdx b/es/tutorials/video/wan/wan-move.mdx index 205659fc86..80c48e62dc 100644 --- a/es/tutorials/video/wan/wan-move.mdx +++ b/es/tutorials/video/wan/wan-move.mdx @@ -2,28 +2,30 @@ title: "Ejemplo de flujo de trabajo Wan-Move en ComfyUI" description: "Genera video con movimiento controlable usando Wan-Move en ComfyUI: guía el movimiento de objetos con trayectorias de puntos para imagen a video." sidebarTitle: "Wan-Move" -translationSourceHash: 78cfc130 +translationSourceHash: 6e632abd translationFrom: tutorials/video/wan/wan-move.mdx translationBlockHashes: "_intro": 67a26359 "Wan-Move image-to-video workflow": 78aef00b + "Model links": 8e0ef166 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' **Wan-Move** es un framework de generación de video con control de movimiento desarrollado por Tongyi Lab de Alibaba. Permite controlar el movimiento de los objetos en los videos generados especificando trayectorias de puntos sobre la imagen de entrada, lo que hace que la generación de imagen a video sea más precisa y controlable. **Características principales**: - **Control de movimiento en 480p y 5 s de alta calidad**: genera videos de 5 segundos en 480p con una controlabilidad de movimiento de grano fino -- **Orientación por trayectorias latent**: representa las condiciones de movimiento propagando las características del primer fotograma a lo largo de las trayectorias +- **Orientación por trayectorias latentes**: representa las condiciones de movimiento propagando las características del primer fotograma a lo largo de las trayectorias - **Control de grano fino a nivel puntual**: los movimientos de los objetos se representan con trayectorias de puntos densas, lo que permite un control preciso a nivel de región - **Sin cambios en la arquitectura**: se integra sin problemas en Wan-I2V-14B sin módulos de movimiento adicionales **Enlaces relacionados**: - [GitHub](https://github.com/ali-vilab/Wan-Move) - [Hugging Face](https://huggingface.co/Ruihang/Wan-Move-14B-480P) -- [Paper](https://arxiv.org/abs/2512.08765) +- [Artículo](https://arxiv.org/abs/2512.08765) -## Flujo de trabajo de imagen a video Wan-Move +## Flujo de trabajo de imagen a video Wan-Move {#wan-move-image-to-video-workflow} Vista previa del resultado del flujo de trabajo: @@ -63,7 +65,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: Colócalo en ComfyUI/models/loras/ - + Colócalo en ComfyUI/models/text_encoders/ @@ -74,7 +76,7 @@ Sube este archivo al nodo `LoadImage` correspondiente:
-**Ubicación de almacenamiento de modelos** +**Ubicación de almacenamiento de los modelos** ``` 📂 ComfyUI/ diff --git a/es/tutorials/video/wan/wan2-2-fun-control.mdx b/es/tutorials/video/wan/wan2-2-fun-control.mdx index 3947252f37..deacaf9e8d 100644 --- a/es/tutorials/video/wan/wan2-2-fun-control.mdx +++ b/es/tutorials/video/wan/wan2-2-fun-control.mdx @@ -2,27 +2,29 @@ title: "Wan2.2 Fun Control en ComfyUI: generación de video con control" description: "Ejecuta el flujo de trabajo Wan2.2 Fun Control 14B en ComfyUI para generar video guiado por un video de control, con modelos de alto y bajo ruido y LoRAs de 4 pasos." sidebarTitle: "Wan2.2 Fun Control" -translationSourceHash: 5fe96707 +translationSourceHash: 713ec1d8 translationFrom: tutorials/video/wan/wan2-2-fun-control.mdx translationBlockHashes: "_intro": 239e24b6 "ComfyOrg Wan2.2 Fun InP & Control Youtube Live Stream Replay": 22557a2e + "Wan2.2 Fun Control Video Generation Workflow Example": 0a502468 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Wan2.2-Fun-Control** es un modelo de generación y control de video de nueva generación lanzado por el equipo de Alibaba PAI. Mediante un innovador mecanismo de Control Codes combinado con aprendizaje profundo y entradas condicionales multimodales, puede generar videos de alta calidad que cumplen con condiciones de control predefinidas. El modelo se publica bajo la **licencia Apache 2.0** y admite uso comercial. +**Wan2.2-Fun-Control** es un modelo de generación y control de video de nueva generación lanzado por el equipo de Alibaba PAI. Gracias a un innovador mecanismo de Control Codes combinado con aprendizaje profundo y entradas condicionales multimodales, puede generar videos de alta calidad que cumplen con condiciones de control predefinidas. El modelo se publica bajo la **licencia Apache 2.0** y admite uso comercial. **Características principales**: - **Control multimodal**: admite varias condiciones de control, como **Canny (arte lineal)**, **Profundidad**, **OpenPose (pose humana)**, **MLSD (bordes geométricos)** y **control de trayectoria** - **Generación de video de alta calidad**: basado en la arquitectura Wan2.2, produce videos con calidad cinematográfica - **Compatibilidad con varios idiomas**: admite prompts en varios idiomas, incluidos el chino y el inglés -A continuación se muestran los pesos del modelo y los repositorios de código relevantes: +A continuación encontrarás los pesos del modelo y los repositorios de código relevantes: - [🤗Wan2.2-Fun-A14B-Control](https://huggingface.co/alibaba-pai/Wan2.2-Fun-A14B-Control) - Repositorio de código: [VideoX-Fun](https://github.com/aigc-apps/VideoX-Fun) -## Repetición de la transmisión en vivo de Wan2.2 Fun InP y Control de ComfyOrg en YouTube +## Repetición de la transmisión en vivo de ComfyOrg Wan2.2 Fun InP y Control en YouTube -Wan 2.2 es un nuevo modelo generativo multimodal de nueva generación lanzado por WAN AI. Este modelo adopta una innovadora arquitectura MoE (Mixture of Experts), compuesta por modelos expertos de alto ruido y de bajo ruido. Puede dividir los modelos expertos según los pasos de eliminación de ruido (timesteps), generando así contenido de video de mayor calidad. +Wan 2.2 es un modelo generativo multimodal de nueva generación lanzado por WAN AI. Este modelo adopta una innovadora arquitectura MoE (Mixture of Experts), compuesta por modelos expertos de alto ruido y de bajo ruido. Puede dividir los modelos expertos según los pasos de eliminación de ruido (timesteps), generando así contenido de video de mayor calidad. Wan 2.2 tiene tres características principales: control estético de nivel cinematográfico, que integra profundamente los estándares estéticos de la industria del cine profesional y admite control visual multidimensional como iluminación, color y composición; movimiento complejo a gran escala, que recrea con facilidad diversos movimientos complejos y mejora la fluidez y el control del movimiento; y cumplimiento semántico preciso, que destaca en escenas complejas y en la generación de múltiples objetos, reproduciendo mejor las intenciones creativas del usuario. El modelo admite varios modos de generación, como texto a video e imagen a video, y es adecuado para la creación de contenido, la creación artística, la educación y la capacitación, entre otros escenarios de aplicación. @@ -38,13 +40,13 @@ El modelo admite varios modos de generación, como texto a video e imagen a vide - **Cumplimiento semántico preciso**: Comprensión de escenas complejas, generación de múltiples objetos, mejor restauración de las intenciones creativas - **Tecnología de compresión eficiente**: Versión 5B con VAE de alta relación de compresión, optimización de memoria, admite entrenamiento mixto -## Versiones de modelos de código abierto Wan2.2 +## Versiones de los modelos de código abierto Wan2.2 Los modelos de la serie Wan2.2 se basan en la licencia de código abierto Apache 2.0 y admiten el uso comercial. La licencia Apache 2.0 te permite usar, modificar y distribuir estos modelos libremente, incluso con fines comerciales, siempre que conserves el aviso de derechos de autor original y el texto de la licencia. | Tipo de modelo | Nombre del modelo | Parámetros | Función principal | Repositorio del modelo | |------------|------------|------------|---------------|-----------------| -| Modelo híbrido | Wan2.2-TI2V-5B | 5B | Versión híbrida que admite tanto texto a video como imagen a video; un solo modelo cubre dos requisitos centrales de tareas | 🤗 [Wan2.2-TI2V-5B](https://huggingface.co/Wan-AI/Wan2.2-TI2V-5B) | +| Modelo híbrido | Wan2.2-TI2V-5B | 5B | Versión híbrida que admite tanto texto a video como imagen a video; un solo modelo satisface los requisitos de dos tareas centrales | 🤗 [Wan2.2-TI2V-5B](https://huggingface.co/Wan-AI/Wan2.2-TI2V-5B) | | Imagen a video | Wan2.2-I2V-A14B | 14B | Convierte imágenes estáticas en videos dinámicos, manteniendo la consistencia del contenido y un proceso dinámico suave | 🤗 [Wan2.2-I2V-A14B](https://huggingface.co/Wan-AI/Wan2.2-I2V-A14B) | | Texto a video | Wan2.2-T2V-A14B | 14B | Genera videos de alta calidad a partir de descripciones de texto, con control estético de nivel cinematográfico y un cumplimiento semántico preciso | 🤗 [Wan2.2-T2V-A14B](https://huggingface.co/Wan-AI/Wan2.2-T2V-A14B) | @@ -149,24 +151,24 @@ ComfyUI/ 2. Asegúrate de que el nodo `Load CLIP` cargue el modelo `umt5_xxl_fp8_e4m3fn_scaled.safetensors`. 3. Asegúrate de que el nodo `Load VAE` cargue el modelo `wan2.2_vae.safetensors`. 4. (Opcional) Si necesitas generar imagen a video, puedes usar el atajo Ctrl+B para habilitar el nodo `Load image` y subir una imagen. -5. (Opcional) En el nodo `Wan22ImageToVideoLatent`, puedes ajustar las configuraciones de tamaño y el número total de fotogramas del video (`length`). +5. (Opcional) En el nodo `Wan22ImageToVideoLatent` puedes ajustar las configuraciones de tamaño y el número total de fotogramas del video (`length`). 6. (Opcional) Si necesitas modificar los prompts (positivo y negativo), hazlo en el nodo `CLIP Text Encoder` del paso 5. 7. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video. -## Ejemplo de flujo de trabajo de texto a video T2V 14B de Wan2.2 +## Ejemplo de flujo de trabajo de texto a video con Wan2.2 14B T2V -### Wan 2.2 14B de texto a video {#video_wan2_2_14B_t2v} +### Texto a video con Wan 2.2 14B {#video_wan2_2_14B_t2v} -Genera videos de alta calidad a partir de prompts de texto con control estético cinematográfico y generación de movimiento dinámico usando Wan 2.2. +Genera videos de alta calidad a partir de indicaciones de texto con control estético cinematográfico y generación de movimiento dinámico usando Wan 2.2. -Vista previa del flujo de trabajo Wan 2.2 14B de texto a video +Vista previa del flujo de trabajo de texto a video con Wan 2.2 14B Abrir en Comfy Cloud - Descarga el JSON o busca "Wan2.2 14B T2V" en la Biblioteca de plantillas + Descarga el JSON o busca "Wan2.2 14B T2V" en la biblioteca de plantillas @@ -213,18 +215,18 @@ ComfyUI/ │ └── wan_2.1_vae.safetensors ``` -### 3. Sigue los pasos +### 3. Seguir los pasos ![Diagrama de pasos](/images/tutorial/video/wan/wan2_2/wan_2.2_14b_t2v.jpg) 1. Asegúrate de que el primer nodo `Load Diffusion Model` cargue el modelo `wan2.2_t2v_high_noise_14B_fp8_scaled.safetensors`. 2. Asegúrate de que el segundo nodo `Load Diffusion Model` cargue el modelo `wan2.2_t2v_low_noise_14B_fp8_scaled.safetensors`. 3. Asegúrate de que el nodo `Load CLIP` cargue el modelo `umt5_xxl_fp8_e4m3fn_scaled.safetensors`. 4. Asegúrate de que el nodo `Load VAE` cargue el modelo `wan_2.1_vae.safetensors`. -5. (Opcional) En el nodo `EmptyHunyuanLatentVideo`, puedes ajustar las configuraciones de tamaño y el número total de fotogramas del video (`length`). +5. (Opcional) En el nodo `EmptyHunyuanLatentVideo`, puedes ajustar las configuraciones de tamaño y el número total de fotogramas de video (`length`). 6. (Opcional) Si necesitas modificar los prompts (positivo y negativo), hazlo en el nodo `CLIP Text Encoder` del paso 5. -7. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video. +7. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video. -## Ejemplo de flujo de trabajo de imagen a video con Wan2.2 14B I2V +## Ejemplo de flujo de trabajo de imagen a video I2V 14B de Wan2.2 ### Wan 2.2 14B de imagen a video {#video_wan2_2_14B_i2v} @@ -300,7 +302,7 @@ ComfyUI/ │ └───📂 vae/ │ └── wan_2.1_vae.safetensors ``` -### 3. Seguir los pasos +### 3. Sigue los pasos ![Diagrama de pasos](/images/tutorial/video/wan/wan2_2/wan_2.2_14b_i2v.jpg) 1. Asegúrate de que el primer nodo `Load Diffusion Model` cargue el modelo `wan2.2_t2v_high_noise_14B_fp8_scaled.safetensors`. @@ -310,17 +312,17 @@ ComfyUI/ 5. En el nodo `Load Image`, sube la imagen que se usará como fotograma inicial. 6. Si necesitas modificar los prompts (positivo y negativo), hazlo en el nodo `CLIP Text Encoder` del paso 6. 7. (Opcional) En `EmptyHunyuanLatentVideo`, puedes ajustar las configuraciones de tamaño y el número total de fotogramas del video (`length`). -8. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación del video. +8. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video. ## Ejemplo de flujo de trabajo Wan2.2 14B FLF2V -El flujo de trabajo de primer y último fotograma usa las mismas ubicaciones de modelo que la sección I2V. +El flujo de trabajo de primer y último fotograma usa las mismas ubicaciones de modelos que la sección I2V. -### Wan 2.2 14B primer-último fotograma a video {#video_wan2_2_14B_flf2v} +### Wan 2.2 14B de primer y último fotograma a video {#video_wan2_2_14B_flf2v} -Genera transiciones de video suaves definiendo los fotogramas inicial y final. +Genera transiciones de video suaves definiendo los fotogramas de inicio y fin. -Vista previa del flujo de trabajo Wan 2.2 14B primer-último fotograma a video +Vista previa del flujo de trabajo Wan 2.2 14B de primer y último fotograma a video @@ -349,7 +351,7 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: video_wan2_2_14B_flf2v_end_image.png
-### 2. Sigue los pasos +### 2. Seguir los pasos ![Diagrama de pasos](/images/tutorial/video/wan/wan2_2/wan_2.2_14b_flf2v.jpg) @@ -358,8 +360,8 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: 3. Ajusta las configuraciones de tamaño en el nodo `WanFirstLastFrameToVideo`. - De forma predeterminada, se establece un tamaño relativamente pequeño para evitar que los usuarios con poca VRAM consuman demasiados recursos. - Si tienes suficiente VRAM, puedes probar una resolución de alrededor de 720P. -4. Escribe prompts adecuados según tus fotogramas inicial y final. -5. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video. +4. Escribe los prompts adecuados según tus fotogramas de inicio y fin. +5. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación del video. ## Recursos de la comunidad From 3d1012b587517a9ff19386a40c29a695a7f86640 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 3 Nov 2026 11:43:23 +0800 Subject: [PATCH 4/5] i18n: sync es tutorial pages (batch 2) with upstream/main --- .../controlnet/pose-controlnet-2-pass.mdx | 38 ++++----- es/tutorials/flux/flux-1-fill-dev.mdx | 56 ++++++------- es/tutorials/flux/flux-1-kontext-dev.mdx | 29 +++---- es/tutorials/flux/flux-1-uso.mdx | 6 +- es/tutorials/flux/flux-2-dev.mdx | 6 +- es/tutorials/flux/flux-2-klein.mdx | 40 +++++----- es/tutorials/flux/flux-3-klein.mdx | 33 ++++---- es/tutorials/llm/gemma4/gemma4.mdx | 26 ++++--- es/tutorials/llm/qwen/qwen3.mdx | 14 ++-- es/tutorials/llm/qwen/qwen3_5.mdx | 26 ++++--- .../topaz/image-enhance-bloom-2.mdx | 20 ++--- es/tutorials/partner-nodes/topaz/overview.mdx | 8 +- .../video-enhance-starlight-precise-2-5.mdx | 4 +- .../partner-nodes/wavespeed/overview.mdx | 2 +- es/tutorials/video/bytedance/bernini-r.mdx | 47 ++++++----- .../video/minimax/minimax-h3-prompt-guide.mdx | 2 +- es/tutorials/video/wan/fun-camera.mdx | 49 ++++++------ es/tutorials/video/wan/wan2-2-animate.mdx | 78 ++++++++++--------- es/tutorials/video/wan/wan2-2-fun-inp.mdx | 62 ++++++++------- es/tutorials/video/zai/scail2.mdx | 20 ++--- 20 files changed, 294 insertions(+), 272 deletions(-) diff --git a/es/tutorials/controlnet/pose-controlnet-2-pass.mdx b/es/tutorials/controlnet/pose-controlnet-2-pass.mdx index bec3d42158..650e1ed465 100644 --- a/es/tutorials/controlnet/pose-controlnet-2-pass.mdx +++ b/es/tutorials/controlnet/pose-controlnet-2-pass.mdx @@ -2,16 +2,18 @@ title: "Pose ControlNet en ComfyUI: OpenPose y flujos de trabajo de dos pasadas" description: "Usa esqueletos de OpenPose para controlar la postura del personaje y afina el detalle con un flujo de trabajo de dos pasadas para imágenes grandes." sidebarTitle: "Pose ControlNet" -translationSourceHash: 88d83e4a +translationSourceHash: b939c04c translationFrom: tutorials/controlnet/pose-controlnet-2-pass.mdx translationBlockHashes: "Introduction to OpenPose": 3dd3b023 "ComfyUI 2-Pass Pose ControlNet Usage Example": 89bf8647 + "Explanation of the Pose ControlNet 2-Pass Workflow": 8396d044 "Advantages of 2-Pass Image Generation": fba5db79 --- + ## Introducción a OpenPose -[OpenPose](https://github.com/CMU-Perceptual-Computing-Lab/openpose) es un sistema de código abierto para la estimación de pose de varias personas en tiempo real, desarrollado por la Universidad Carnegie Mellon (CMU), que supone un avance significativo en el campo de la visión por computador. El sistema puede detectar simultáneamente a varias personas en una imagen y captura: +[OpenPose](https://github.com/CMU-Perceptual-Computing-Lab/openpose) es un sistema de código abierto para la estimación de pose de varias personas en tiempo real, desarrollado por la Universidad Carnegie Mellon (CMU), que representa un avance significativo en el campo de la visión por computadora. El sistema puede detectar simultáneamente a varias personas en una imagen y captura: - **Esqueleto corporal**: 18 puntos clave, incluidos cabeza, hombros, codos, muñecas, caderas, rodillas y tobillos - **Expresiones faciales**: 70 puntos clave faciales para capturar microexpresiones y contornos faciales @@ -32,8 +34,8 @@ Descarga la imagen del flujo de trabajo que aparece a continuación y arrástral ![Flujo de trabajo de ComfyUI - Pose ControlNet](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/controlnet/pose_controlnet_2_pass.png) -Las imágenes que contienen el JSON del flujo de trabajo en sus metadatos se pueden arrastrar directamente a ComfyUI o cargar con el menú `Workflows` -> `Open (ctrl+o)`. -Esta imagen ya incluye los enlaces de descarga de los modelos correspondientes, y al arrastrarla a ComfyUI se te pedirá automáticamente que descargues los modelos. +Puedes arrastrar directamente a ComfyUI las imágenes que contienen el JSON del flujo de trabajo en sus metadatos, o cargarlas con el menú `Workflows` -> `Open (ctrl+o)`. +Esta imagen ya incluye los enlaces de descarga de los modelos correspondientes, y al arrastrarla a ComfyUI aparecerá automáticamente la solicitud de descarga. Descarga la imagen que aparece a continuación, la cual usaremos como entrada: @@ -76,42 +78,42 @@ Sigue estos pasos según los marcadores numerados de la imagen: 5. Asegúrate de que `Load Checkpoint` pueda cargar **japaneseStyleRealistic_v20.safetensors** 6. Haz clic en el botón `Queue` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de la imagen -## Explicación del flujo de trabajo Pose ControlNet en dos pasadas +## Explicación del flujo de trabajo Pose ControlNet de dos pasadas -Este flujo de trabajo usa un enfoque de generación de imágenes en dos pasadas, que divide el proceso de creación de la imagen en dos fases: +Este flujo de trabajo usa un enfoque de generación de imágenes en dos pasadas, dividiendo el proceso de creación de la imagen en dos fases: -### Primera fase: generación de la imagen básica de la pose +### Primera fase: Generación de la imagen de pose básica -En la primera fase, el modelo **majicmixRealistic_v7** se combina con Pose ControlNet para generar una imagen inicial de la pose del personaje: +En la primera fase, el modelo **majicmixRealistic_v7** se combina con Pose ControlNet para generar una imagen de pose inicial del personaje: 1. Primero, carga el modelo majicmixRealistic_v7 mediante el nodo `Load Checkpoint` 2. Carga el modelo de control de pose a través del nodo `Load ControlNet Model` 3. La imagen de pose de entrada se introduce en el nodo `Apply ControlNet` y se combina con las condiciones de prompt positivo y negativo -4. El primer nodo `KSampler` (normalmente con 20-30 pasos) genera una imagen básica de la pose del personaje +4. El primer nodo `KSampler` (normalmente con 20-30 pasos) genera una imagen de pose básica del personaje 5. La imagen en espacio de píxeles de la primera fase se obtiene mediante `VAE Decode` -Esta fase se centra principalmente en la postura correcta del personaje, la pose y la estructura básica, asegurando que el personaje generado se ajuste a la pose del esqueleto de entrada. +Esta fase se centra principalmente en la postura, la pose y la estructura básica correctas del personaje, asegurando que el personaje generado se ajuste a la pose esquelética de entrada. -### Segunda fase: optimización del estilo y mejora de detalles +### Segunda fase: Optimización de estilo y mejora de detalles -En la segunda fase, la imagen de salida de la primera fase se usa como referencia, y el modelo **japaneseStyleRealistic_v20** realiza la estilización y la mejora de detalles: +En la segunda fase, la imagen de salida de la primera fase se usa como referencia y el modelo **japaneseStyleRealistic_v20** realiza la estilización y la mejora de detalles: -1. La imagen generada en la primera fase crea un espacio latent de mayor resolución mediante el nodo `Upscale latent` +1. La imagen generada en la primera fase crea un espacio latente de mayor resolución mediante el nodo `Upscale latent` 2. El segundo `Load Checkpoint` carga el modelo japaneseStyleRealistic_v20, que se centra en los detalles y el estilo -3. El segundo nodo `KSampler` usa una fuerza de `denoise` más baja (normalmente 0.4-0.6) para el refinado, conservando la estructura básica de la primera fase -4. Por último, se obtiene una imagen de mayor calidad y resolución mediante los segundos nodos `VAE Decode` y `Save Image` +3. El segundo nodo `KSampler` usa una fuerza de `denoise` más baja (normalmente 0.4-0.6) para el refinamiento, preservando la estructura básica de la primera fase +4. Finalmente, se obtiene una imagen de mayor calidad y resolución mediante el segundo `VAE Decode` y los nodos `Save Image` -Esta fase se centra principalmente en la coherencia del estilo, la riqueza de detalles y la mejora de la calidad general de la imagen. +Esta fase se centra principalmente en la coherencia de estilo, la riqueza de detalles y la mejora de la calidad general de la imagen. ## Ventajas de la generación de imágenes en dos pasadas En comparación con la generación en una sola pasada, el método de generación de imágenes en dos pasadas ofrece las siguientes ventajas: 1. **Mayor resolución**: El procesamiento en dos pasadas puede generar imágenes de alta resolución que superan las capacidades de la generación en una sola pasada. -2. **Mezcla de estilos**: Puede combinar las ventajas de diferentes modelos, como usar un modelo realista en la primera fase y un modelo estilizado en la segunda fase. +2. **Mezcla de estilos**: Puede combinar las ventajas de distintos modelos, por ejemplo, usar un modelo realista en la primera fase y un modelo estilizado en la segunda fase. 3. **Mejores detalles**: La segunda fase puede centrarse en optimizar los detalles sin tener que preocuparse por la estructura general. 4. **Control preciso**: Una vez completado el control de pose en la primera fase, la segunda fase puede centrarse en refinar el estilo y los detalles. -5. **Menor carga de la GPU**: Generar en dos pasadas permite obtener imágenes grandes de alta calidad con recursos limitados de GPU. +5. **Menor carga de GPU**: Generar en dos pasadas permite obtener imágenes grandes de alta calidad con recursos de GPU limitados. Para aprender más sobre las técnicas para mezclar varios ControlNet, consulta el tutorial [Mezclar modelos ControlNet](/es/tutorials/controlnet/mixing-controlnets). diff --git a/es/tutorials/flux/flux-1-fill-dev.mdx b/es/tutorials/flux/flux-1-fill-dev.mdx index 5a3759d37e..2f2af6ac89 100644 --- a/es/tutorials/flux/flux-1-fill-dev.mdx +++ b/es/tutorials/flux/flux-1-fill-dev.mdx @@ -2,14 +2,16 @@ title: "Ejemplo de ComfyUI Flux.1 fill dev" description: "Aprende a usar Flux.1 fill dev para crear flujos de trabajo de relleno inteligente y extensión de imagen." sidebarTitle: "Flux.1 fill dev" -translationSourceHash: d44cacbe +translationSourceHash: d4b82038 translationFrom: tutorials/flux/flux-1-fill-dev.mdx translationBlockHashes: "_intro": 73fb6ba4 "Introduction to Flux.1 fill dev Model": 6dfbcfd4 + "Flux.1 Fill dev and related models installation": cf7747cd "Flux.1 Fill dev inpainting workflow": 016cb519 "Flux.1 Fill dev Outpainting Workflow": b0f0715d --- + ![Flux.1 fill dev](/images/tutorial/flux/flux-fill-dev-demo.jpeg) ## Introducción al modelo Flux.1 fill dev @@ -20,21 +22,20 @@ Características principales de Flux.1 fill dev: - Potentes capacidades de inpainting y outpainting de imágenes, con resultados solo superados por la versión comercial FLUX.1 Fill [pro]. - Excelente capacidad para comprender y seguir el prompt, capturando con precisión la intención del usuario y manteniendo una alta consistencia con la imagen original. - Tecnología avanzada de entrenamiento con destilación guiada, que hace el modelo más eficiente sin dejar de producir salidas de alta calidad. -- Términos de licencia flexibles: las salidas generadas se pueden usar para uso personal, científico y comercial. Consulta la [licencia no comercial de FLUX.1 [dev]](https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/main/LICENSE.md) para más detalles. +- Términos de licencia flexibles: puedes usar las salidas generadas para uso personal, científico y comercial. Consulta la [licencia no comercial de FLUX.1 [dev]](https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/main/LICENSE.md) para más detalles. Repositorio de código abierto: [FLUX.1 [dev]](https://huggingface.co/black-forest-labs/FLUX.1-dev) Esta guía mostrará flujos de trabajo de inpainting y outpainting basados en el modelo Flux.1 fill dev. -Si no estás familiarizado con los flujos de trabajo de inpainting y outpainting, puedes consultar el [ejemplo de inpainting de ComfyUI Layout](/es/tutorials/basic/inpaint) y el [ejemplo de extensión de imagen de ComfyUI](/es/tutorials/basic/outpaint) para ver explicaciones relacionadas. +Si no estás familiarizado con los flujos de trabajo de inpainting y outpainting, puedes consultar el [ejemplo de inpainting de ComfyUI Layout](/es/tutorials/basic/inpaint) y el [ejemplo de extensión de imagen de ComfyUI](/es/tutorials/basic/outpaint) para ver algunas explicaciones relacionadas. -## Instalación de Flux.1 Fill dev y de los modelos relacionados +## Instalar Flux.1 Fill dev y los modelos relacionados -Antes de empezar, completemos la instalación de los archivos del modelo Flux.1 Fill dev. Los flujos de trabajo de inpainting y outpainting que vienen a continuación usan exactamente los mismos archivos de modelo. -Si ya has usado antes la versión completa del [flujo de trabajo de texto a imagen de Flux.1](/es/tutorials/flux/flux-1-text-to-image), -en esta sección solo necesitas descargar el archivo de modelo **flux1-fill-dev.safetensors**. +Antes de comenzar, completemos la instalación de los archivos del modelo Flux.1 Fill dev. Los flujos de trabajo de relleno inteligente y de outpainting usarán exactamente los mismos archivos de modelo. +Si ya usaste anteriormente la versión completa del [flujo de trabajo Flux.1 de texto a imagen](/es/tutorials/flux/flux-1-text-to-image), entonces solo necesitas descargar el archivo de modelo **flux1-fill-dev.safetensors** de esta sección. -Sin embargo, como la descarga del modelo correspondiente exige aceptar antes el acuerdo de uso, visita la página [black-forest-labs/FLUX.1-Fill-dev](https://huggingface.co/black-forest-labs/FLUX.1-Fill-dev) y asegúrate de haber aceptado el acuerdo correspondiente, como se muestra en la imagen de abajo. -![Acuerdo de Flux](/images/tutorial/flux/flux1_fill_dev_agreement.jpg) +Sin embargo, como la descarga del modelo correspondiente requiere aceptar el acuerdo de uso correspondiente, visita la página [black-forest-labs/FLUX.1-Fill-dev](https://huggingface.co/black-forest-labs/FLUX.1-Fill-dev) y asegúrate de haber aceptado el acuerdo correspondiente, como se muestra en la imagen siguiente. +![Flux Agreement](/images/tutorial/flux/flux1_fill_dev_agreement.jpg) Lista completa de modelos: |- [clip_l.safetensors](https://huggingface.co/comfyanonymous/flux_text_encoders/blob/main/clip_l.safetensors) @@ -54,21 +55,20 @@ ComfyUI/ │ └── diffusion_models/ │ └── flux1-fill-dev.safetensors ``` - ## Flujo de trabajo de relleno inteligente con Flux.1 Fill dev ### Flux.1 Inpaint {#flux_fill_inpaint_example} Rellena las partes faltantes de las imágenes con Flux.1 Fill Inpainting. -Vista previa del flujo de trabajo Flux.1 Inpaint +Vista previa del flujo de trabajo de relleno inteligente de Flux.1 - + Abrir en Comfy Cloud - - Descarga el JSON o busca "Flux.1 Inpaint" en la biblioteca de plantillas + + Descarga el JSON o busca "Flux.1 Inpaint" en la Biblioteca de plantillas @@ -78,7 +78,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: - `LoadImage`, nodo 17 · `flux_fill_inpaint_example_input_image.png` + Nodo `LoadImage` 17 · `flux_fill_inpaint_example_input_image.png` @@ -90,42 +90,42 @@ Sube este archivo al nodo `LoadImage` correspondiente:
Imagen de entrada - Salida de ejemplo de Flux.1 Inpaint + Salida de ejemplo de relleno inteligente de Flux.1
### 1. Flujo de trabajo de relleno inteligente y recursos -La imagen correspondiente ya contiene un canal alpha, así que no necesitas dibujar una máscara por separado. -Si quieres dibujar tu propia máscara, [haz clic aquí](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/flux/inpaint/flux_fill_inpaint_input_original.png) para obtener la imagen sin máscara y consulta la sección de uso de MaskEditor en el [Ejemplo de relleno inteligente de diseño de ComfyUI](/es/tutorials/basic/inpaint#usar-el-editor-de-máscara) para aprender a dibujar una máscara en el nodo `Load Image`. +La imagen correspondiente ya contiene un canal alfa, así que no necesitas dibujar una máscara por separado. +Si quieres dibujar tu propia máscara, [haz clic aquí](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/flux/inpaint/flux_fill_inpaint_input_original.png) para obtener la imagen sin máscara, y consulta la sección sobre el uso del Editor de máscara en el [ejemplo de relleno inteligente de diseño de ComfyUI](/es/tutorials/basic/inpaint#usar-el-editor-de-máscara) para aprender a dibujar una máscara en el nodo `Load Image`. ### 2. Pasos para ejecutar el flujo de trabajo -![Flujo de trabajo de relleno inteligente con Flux.1 Fill dev de ComfyUI](/images/tutorial/flux/flow_diagram_inpaint.jpg) +![Flujo de trabajo de relleno inteligente con ComfyUI Flux.1 Fill dev](/images/tutorial/flux/flow_diagram_inpaint.jpg) 1. Asegúrate de que el nodo `Load Diffusion Model` tenga cargado `flux1-fill-dev.safetensors`. 2. Asegúrate de que el nodo `DualCLIPLoader` tenga cargados los siguientes modelos: - clip_name1: `t5xxl_fp16.safetensors` - clip_name2: `clip_l.safetensors` 3. Asegúrate de que el nodo `Load VAE` tenga cargado `ae.safetensors`. -4. Sube la imagen de entrada proporcionada en el documento al nodo `Load Image`; si usas la versión sin máscara, recuerda completar el dibujo de la máscara con el editor de máscara -5. Haz clic en el botón `Queue` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo +4. Sube la imagen de entrada incluida en el documento al nodo `Load Image`; si usas la versión sin máscara, recuerda completar el dibujo de la máscara con el editor de máscara +5. Haz clic en el botón `Queue`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo ## Flujo de trabajo de outpainting con Flux.1 Fill dev ### Flux.1 Outpaint {#flux_fill_outpaint_example} -Amplía las imágenes más allá de sus límites con outpainting de Flux.1. +Extiende las imágenes más allá de sus límites con outpainting de Flux.1. -Vista previa del flujo de trabajo de outpainting de Flux.1 +Vista previa del flujo de trabajo de outpainting con Flux.1 Abrir en Comfy Cloud - Descarga el JSON o busca "Flux.1 Outpaint" en la Biblioteca de plantillas + Descarga el JSON o busca "Flux.1 Outpaint" en la biblioteca de plantillas @@ -135,7 +135,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: - Nodo `LoadImage` 17 · `flux_fill_outpaint_example_input_image.png` + `LoadImage`, nodo 17 · `flux_fill_outpaint_example_input_image.png` @@ -143,7 +143,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: flux_fill_outpaint_example_input_image.png
-### 1. Flujo de trabajo y recurso de outpainting +### 1. Flujo de trabajo de outpainting y recursos ### 2. Pasos para ejecutar el flujo de trabajo @@ -154,5 +154,5 @@ Sube este archivo al nodo `LoadImage` correspondiente: - clip_name1: `t5xxl_fp16.safetensors` - clip_name2: `clip_l.safetensors` 3. Asegúrate de que el nodo `Load VAE` tenga cargado `ae.safetensors`. -4. Sube la imagen de entrada incluida en el documento al nodo `Load Image`. -5. Haz clic en el botón `Queue` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo. +4. Sube la imagen de entrada proporcionada en el documento al nodo `Load Image` +5. Haz clic en el botón `Queue` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar el flujo de trabajo diff --git a/es/tutorials/flux/flux-1-kontext-dev.mdx b/es/tutorials/flux/flux-1-kontext-dev.mdx index c196d2edc8..5ae91ac977 100644 --- a/es/tutorials/flux/flux-1-kontext-dev.mdx +++ b/es/tutorials/flux/flux-1-kontext-dev.mdx @@ -2,15 +2,17 @@ title: "FLUX.1 Kontext Dev en ComfyUI: edición de imágenes en local" description: "Edita imágenes en local en ComfyUI con FLUX.1 Kontext Dev, el modelo de 12B de Black Forest Labs para ediciones consistentes, estilo y refinado iterativo." sidebarTitle: "FLUX.1 Kontext Dev" -translationSourceHash: 391031ed +translationSourceHash: 6b87ee9a translationFrom: tutorials/flux/flux-1-kontext-dev.mdx translationBlockHashes: "_intro": 51c48128 "About FLUX.1 Kontext Dev": bb2f00f7 + "Model Download": e6b40970 "FLUX.1 Kontext Dev Workflow": 8408eb0d --- + import PromptTechniques from "/snippets/es/tutorials/flux/prompt-techniques.mdx"; -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' ## Acerca de FLUX.2 -[FLUX.2](https://bfl.ai/blog/flux-2) es un modelo de imágenes de nueva generación de [Black Forest Labs](https://blackforestlabs.ai/), que ofrece resultados fotorrealistas de hasta 4MP con una mejora considerable en iluminación, piel, telas y detalle de las manos. Añade una consistencia fiable con múltiples referencias (hasta 10 imágenes), una precisión de edición mejorada, una mejor comprensión visual y un renderizado de texto de nivel profesional. +[FLUX.2](https://bfl.ai/blog/flux-2) es un modelo de imágenes de nueva generación de [Black Forest Labs](https://blackforestlabs.ai/) que ofrece resultados fotorrealistas de hasta 4MP con una mejora considerable en iluminación, piel, telas y detalle de las manos. Añade una consistencia fiable con múltiples referencias (hasta 10 imágenes), mayor precisión de edición, mejor comprensión visual y renderizado de texto de nivel profesional. **Características principales:** - **Consistencia con múltiples referencias:** Mantiene de forma fiable la identidad, la geometría del producto, las texturas, los materiales, el vestuario y la intención de composición en múltiples salidas diff --git a/es/tutorials/flux/flux-2-klein.mdx b/es/tutorials/flux/flux-2-klein.mdx index 09c3acb227..0a91419a2a 100644 --- a/es/tutorials/flux/flux-2-klein.mdx +++ b/es/tutorials/flux/flux-2-klein.mdx @@ -2,21 +2,24 @@ title: "Guía de ComfyUI FLUX.2 Klein 4B" description: "Introducción rápida a FLUX.2 [klein] 4B y cómo ejecutar flujos de trabajo de texto a imagen y edición de imágenes en ComfyUI." sidebarTitle: "FLUX.2 Klein" -translationSourceHash: c108dbe5 +translationSourceHash: 98542515 translationFrom: tutorials/flux/flux-2-klein.mdx translationBlockHashes: "_intro": 980a68e5 "About FLUX.2 [klein]": 556eac08 "FLUX.2 Klein 4B Workflows": 8095f2bc + "FLUX.2 Klein 4B Model Downloads": f8158c6b "FLUX.2 Klein 9B Workflows": 99d18075 + "FLUX.2 Klein 9B Model Downloads": 0407c874 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" ## Acerca de FLUX.2 [klein] -FLUX.2 [Klein] es el modelo más rápido de la familia FLUX: unifica texto a imagen y edición de imágenes en una sola arquitectura compacta. Está diseñado para flujos de trabajo interactivos, vistas previas inmediatas y aplicaciones donde la latencia es crítica, con variantes destiladas que ofrecen una inferencia de extremo a extremo en torno a un segundo y mantienen una gran calidad en la edición con una o varias referencias. +FLUX.2 [Klein] es el modelo más rápido de la familia FLUX: unifica la generación de texto a imagen y la edición de imágenes en una sola arquitectura compacta. Está diseñado para flujos de trabajo interactivos, vistas previas inmediatas y aplicaciones donde la latencia es crítica, con variantes destiladas que ofrecen una inferencia de extremo a extremo en torno a un segundo y mantienen una gran calidad en la edición con una o varias referencias. **Aspectos destacados del modelo:** - Dos tipos de 4B: Base (sin destilar) para máxima flexibilidad y ajuste fino; Distilled (4 pasos) para despliegues que priorizan la velocidad @@ -81,14 +84,14 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: ### FLUX.2 [Klein] 4B destilado: Edición de imagen {#image_flux2_klein_image_edit_4b_distilled} -Vista previa del flujo de trabajo de edición de imagen destilado de FLUX.2 Klein 4B +Vista previa del flujo de trabajo de edición de imagen destilada de FLUX.2 Klein 4B Ejecuta este flujo de trabajo en Comfy Cloud - Descarga el flujo de trabajo rápido de edición de imagen 4B destilado. + Descarga el flujo de trabajo rápido de edición de imagen 4B destilada. @@ -112,9 +115,9 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: **Salida de ejemplo** -![Ejemplo de edición de imagen destilado de FLUX.2 Klein 4B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux2_klein_image_edit_4b_distilled.png) +![Ejemplo de edición de imagen destilada de FLUX.2 Klein 4B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux2_klein_image_edit_4b_distilled.png) -## Descargas de modelos de FLUX.2 Klein 4B +## Descargas del modelo FLUX.2 Klein 4B @@ -131,7 +134,7 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: -**Ubicación de almacenamiento de los modelos 4B** +**Ubicación de almacenamiento del modelo 4B** ``` 📂 ComfyUI/ @@ -144,19 +147,18 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: │ └── 📂 vae/ │ └── flux2-vae.safetensors ``` - ## Flujos de trabajo de FLUX.2 Klein 9B ### FLUX.2 [Klein] 9B: Texto a imagen {#image_flux2_text_to_image_9b} -Vista previa del flujo de trabajo texto a imagen de FLUX.2 Klein 9B +Vista previa del flujo de trabajo de texto a imagen de FLUX.2 Klein 9B Ejecuta este flujo de trabajo en Comfy Cloud - - Descarga el flujo de trabajo texto a imagen de FLUX.2 Klein 9B. + + Descarga el flujo de trabajo de texto a imagen para FLUX.2 Klein 9B. @@ -166,13 +168,13 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: ### FLUX.2 [Klein] 9B: Edición de imagen {#image_flux2_klein_image_edit_9b_base} -Vista previa del flujo de trabajo base de edición de imagen de FLUX.2 Klein 9B +Vista previa del flujo de trabajo de edición de imagen base de FLUX.2 Klein 9B Ejecuta este flujo de trabajo en Comfy Cloud - + Descarga el flujo de trabajo de edición de imagen con el modelo base 9B. @@ -197,18 +199,18 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: **Salida de ejemplo** -![Ejemplo base de edición de imagen de FLUX.2 Klein 9B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/thumbnail/image_flux2_klein_image_edit_9b_base.png) +![Ejemplo de edición de imagen base de FLUX.2 Klein 9B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/thumbnail/image_flux2_klein_image_edit_9b_base.png) ### FLUX.2 [Klein] 9B destilado: Edición de imagen {#image_flux2_klein_image_edit_9b_distilled} -Vista previa del flujo de trabajo destilado de edición de imagen de FLUX.2 Klein 9B +Vista previa del flujo de trabajo de edición de imagen destilada de FLUX.2 Klein 9B Ejecuta este flujo de trabajo en Comfy Cloud - - Descarga el flujo de trabajo rápido destilado de edición de imagen 9B. + + Descarga el flujo de trabajo rápido de edición de imagen con el modelo 9B destilado. @@ -232,9 +234,9 @@ Sube estos archivos a los nodos `LoadImage` correspondientes: **Salida de ejemplo** -![Ejemplo destilado de edición de imagen de FLUX.2 Klein 9B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux2_klein_image_edit_9b_distilled.png) +![Ejemplo de edición de imagen destilada de FLUX.2 Klein 9B](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux2_klein_image_edit_9b_distilled.png) -## Descargas de modelos de FLUX.2 Klein 9B +## Descargas de modelos FLUX.2 Klein 9B Para los modelos de difusión, visita el repositorio de BFL, acepta el acuerdo y luego descarga los modelos. diff --git a/es/tutorials/flux/flux-3-klein.mdx b/es/tutorials/flux/flux-3-klein.mdx index ff263a9586..88f91bdb20 100644 --- a/es/tutorials/flux/flux-3-klein.mdx +++ b/es/tutorials/flux/flux-3-klein.mdx @@ -2,15 +2,17 @@ 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: 5c435b1b +translationSourceHash: 7cedfbb4 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 Model Downloads": 0170574c "Prompting and reference tips": 43ad4a36 --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' ## Acerca de FLUX.3 [klein] @@ -52,7 +54,7 @@ Genera una imagen solo a partir de un prompt, sin archivos de entrada. El flujo 1. Escribe tu prompt en el widget de prompt positivo del subgrafo 2. Configura `width` y `height`, o elige un formato en `ResolutionSelector` (1:1 cuadrado por defecto) 3. Ajusta `steps` (50 por defecto) y `cfg` (3.5 por defecto) -4. El upsampler de prompt está activado por defecto, así que un prompt corto se expande con el upsampler Qwen3.5 9B antes del muestreo. Desactiva `enable_prompt_upsampler` para generar a partir de tus propias palabras +4. El upsampler de prompt está activado por defecto, por lo que el upsampler Qwen3.5 9B expande un prompt corto antes del muestreo. Desactiva `enable_prompt_upsampler` para generar a partir de tus propias palabras 5. Haz clic en **Queue**. El nodo `SaveImage` guarda la imagen en `ComfyUI/output/` ### FLUX 3 Image Klein Distilled: Texto a imagen {#image_flux3_klein_distilled_t2i} @@ -90,7 +92,7 @@ Edita una foto a partir de un prompt de instrucción, con la imagen original con Abrir en Comfy Cloud
- Descarga el JSON o busca "FLUX 3 Image Klein: Image Edit" en la Biblioteca de plantillas + Descarga el JSON o busca "FLUX 3 Image Klein: Image Edit" en Template Library
@@ -108,7 +110,7 @@ Sube este archivo al nodo `LoadImage` correspondiente: fashion_portrait_blue_silk_gown_vis.png -1. Carga tu imagen fuente en el nodo `LoadImage` +1. Carga tu imagen de origen en el nodo `LoadImage` 2. Conéctala a `Set Reference Multi Latent`. La primera referencia es `` en el prompt, la siguiente es ``, y así sucesivamente 3. Escribe la edición como una descripción completa del resultado. En el ejemplo incluido el prompt es `In , change the dress color to red` 4. Ajusta el lienzo con `Empty Flux 2 Latent` (1024 x 1024 en la plantilla) si quieres un tamaño de salida diferente @@ -155,12 +157,12 @@ Sube este archivo al nodo `LoadImage` correspondiente: 3. Mantén `steps` en el rango de 4 a 16 y deja `cfg` en 1 4. Haz clic en **Queue** y compara la entrada con el resultado en `ImageCompare` -## Descargas de modelos de FLUX 3 Image Klein +## Descargas del modelo FLUX 3 Image Klein -Los pesos de FLUX 3 Klein están en el repositorio con acceso restringido [black-forest-labs/flux-3-image-klein-comfy](https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy). Ábrelo, acepta el acuerdo de licencia y luego descarga los archivos. Las plantillas usan los checkpoints int8 (convrot) de un solo archivo; las versiones bf16 y nvfp4 de esos mismos checkpoints están en el mismo repositorio. +Los pesos de FLUX 3 Klein están en el repositorio con acceso restringido [black-forest-labs/flux-3-image-klein-comfy](https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy). Ábrelo, acepta el acuerdo de licencia y luego descarga los archivos. Las plantillas usan los checkpoints de archivo único int8 (convrot); las versiones bf16 y nvfp4 de esos mismos checkpoints están en el mismo repositorio. -Las plantillas cargan las compilaciones int8 para mantener pequeño el consumo de memoria. Con más de 24 GB de VRAM, cambia a la compilación bf16 del mismo checkpoint (`flux3-image-klein-base-bf16.safetensors`, o `flux3-image-klein-bf16.safetensors` para el checkpoint destilado) y al upsampler de prompt bf16: siguen los prompts largos con más fidelidad. +Las plantillas cargan las compilaciones int8 para mantener pequeño el consumo de memoria. Con más de 24 GB de VRAM, cambia a la compilación bf16 del mismo checkpoint (`flux3-image-klein-base-bf16.safetensors`, o `flux3-image-klein-bf16.safetensors` para el checkpoint destilado) y al upsampler de prompt bf16: siguen los prompts largos con mayor fidelidad. @@ -171,7 +173,7 @@ Las plantillas cargan las compilaciones int8 para mantener pequeño el consumo d Modelo de difusión, checkpoint destilado por pasos para 4 a 16 pasos. - Codificador de texto para ambos checkpoints. Cárgalo con `CLIPLoader` de tipo `flux3`. + Codificador de texto para ambos checkpoints. Cárgalo con `CLIPLoader` tipo `flux3`. Upsampler de prompt que usan las plantillas de texto a imagen. @@ -195,11 +197,10 @@ Las plantillas cargan las compilaciones int8 para mantener pequeño el consumo d │ └── 📂 vae/ │ └── flux2-vae.safetensors ``` +## Consejos de prompting y referencias -## Consejos para prompts y referencias - -- **Escribe el resultado, no el cambio.** Las plantillas de edición de imagen esperan una descripción completa de la imagen finalizada con la edición integrada, por eso los ejemplos describen el nuevo objeto en detalle en lugar de decir «cambia esto». -- **Las referencias se añaden a ambos conditioning.** Conecta imágenes adicionales a `Set Reference Multi Latent` en orden, llámalas ``, `` y así sucesivamente, y añade cada una tanto al prompt positivo como al negativo, igual que hace el pipeline de referencia. -- **El tamaño de la referencia es un control de costo.** Las plantillas redimensionan cada referencia a aproximadamente 1 megapíxel y el latente de salida toma ese tamaño. Mantener las referencias en su tamaño nativo, que es lo que hace el pipeline propio de Black Forest Labs hasta unos 16 megapíxeles, conserva más detalle en la edición a un costo mayor. -- **La cantidad de pasos depende del checkpoint.** El checkpoint completo se ejecuta con 50 pasos en las plantillas, con orientación 3.5 en texto a imagen y 1 en edición de imagen. El checkpoint destilado por pasos se ejecuta con 16 pasos y orientación fija en 1, y es el que debes usar cuando quieras una pasada rápida. -- **Las plantillas incluyen un nodo `Create Bounding Boxes`.** Dibuja cajas sobre la imagen fuente para planificar ediciones regionales, y su lista de cajas se muestra en el nodo `Preview Any` para que puedas integrar las regiones en el prompt. +- **Describe el resultado, no el cambio.** Las plantillas de edición de imagen esperan una descripción completa de la imagen finalizada con la edición integrada, por eso los ejemplos describen el nuevo objeto en detalle en lugar de decir «cambia esto». +- **Las referencias se añaden a ambos condicionamientos.** Conecta imágenes adicionales a `Set Reference Multi Latent` en orden, haz referencia a ellas como ``, `` y así sucesivamente, y añade cada una tanto al prompt positivo como al negativo, tal como lo hace el pipeline de referencia. +- **El tamaño de la referencia es un ajuste de costo.** Las plantillas redimensionan cada referencia a aproximadamente 1 megapíxel y el latente de salida adopta ese tamaño. Mantener las referencias en su tamaño nativo, algo que el pipeline propio de Black Forest Labs hace hasta unos 16 megapíxeles, conserva más detalle en la edición a un costo mayor. +- **El número de pasos depende del checkpoint.** El checkpoint completo se ejecuta con 50 pasos en las plantillas, con orientación 3.5 en texto a imagen y 1 en edición de imagen. El checkpoint destilado por pasos se ejecuta con 16 pasos con la orientación fija en 1, y es el que debes usar cuando quieras una pasada rápida. +- **Las plantillas incluyen un nodo `Create Bounding Boxes`.** Dibuja cajas sobre la imagen fuente para planificar ediciones regionales, y su lista de cajas se muestra en el nodo `Preview Any` para que puedas incorporar las regiones al prompt. diff --git a/es/tutorials/llm/gemma4/gemma4.mdx b/es/tutorials/llm/gemma4/gemma4.mdx index 5ad1c758e2..9a53e6063d 100644 --- a/es/tutorials/llm/gemma4/gemma4.mdx +++ b/es/tutorials/llm/gemma4/gemma4.mdx @@ -2,30 +2,32 @@ title: "Gemma 4 en ComfyUI: LLM multimodal con TextGenerate" description: "Ejecuta Gemma 4 de Google en ComfyUI a través del nodo TextGenerate para generación de texto, comprensión de imágenes y transcripción de audio." sidebarTitle: "Gemma 4" -translationSourceHash: e876070d +translationSourceHash: e17f6d7d translationFrom: tutorials/llm/gemma4/gemma4.mdx translationBlockHashes: "_intro": e283d42e "Available workflow": a5a260f2 + "Model Download": 8eb8dbb8 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" -**Gemma 4** es la última generación de LLM abiertos y ligeros de Google DeepMind, diseñada para la generación de texto, la comprensión de imágenes, el análisis de video, la transcripción de audio y el uso estructurado de herramientas. Es compatible de forma nativa con ComfyUI como el modelo **Text Generation** predeterminado. +**Gemma 4** es la última generación de LLM abiertos y ligeros de Google DeepMind, diseñada para la generación de texto, la comprensión de imágenes, el análisis de video, la transcripción de audio y el uso estructurado de herramientas. Se admite de forma nativa en ComfyUI como el modelo **Text Generation** predeterminado. **Aspectos destacados del modelo**: - **Multimodal por diseño**: acepta entradas de texto, imagen, video y audio de forma simultánea - **Tres tamaños disponibles**: - **E2B (2B)**: rápido y ligero, ideal para GPU de consumo - - **E4B (4B)**: rendimiento equilibrado, opción predeterminada recomendada - - **12B**: mejor calidad, requiere más VRAM -- **Modo de razonamiento**: razonamiento paso a paso integrado antes de generar respuestas + - **E4B (4B)**: rendimiento equilibrado, predeterminado recomendado + - **12B**: la mejor calidad, requiere más VRAM +- **Modo de pensamiento**: razonamiento paso a paso integrado antes de generar las respuestas - **Contexto largo**: hasta 128K tokens (E2B/E4B) y 256K tokens (12B) -- **Multilingüe**: más de 35 idiomas listos para usar, preentrenado con más de 140 +- **Multilingüe**: más de 35 idiomas desde el primer uso, con preentrenamiento en más de 140 - **Llamada a funciones**: soporte nativo para el uso estructurado de herramientas y flujos de trabajo agénticos -- **Nativo en ComfyUI**: se carga y ejecuta mediante los nodos integrados `TextGenerate` y `CLIPLoader` +- **Nativo en ComfyUI**: usa los nodos integrados `TextGenerate` y `CLIPLoader` para cargarlo y ejecutarlo **Enlaces relacionados**: - [Hugging Face (Comfy-Org/gemma-4)](https://huggingface.co/Comfy-Org/gemma-4) @@ -76,7 +78,7 @@ Este flujo de trabajo demuestra las capacidades principales de **generación de **Controles principales**: - **Longitud máxima**: número máximo de tokens a generar (256 por defecto) - **Modo de muestreo**: activa o desactiva el muestreo y ajusta temperatura, top-k, top-p, penalización por repetición y semilla -- **Modo de razonamiento**: activa el razonamiento paso a paso antes de la respuesta final +- **Modo de pensamiento**: activa el razonamiento paso a paso antes de la respuesta final - **Usar plantilla predeterminada**: aplica el prompt de sistema integrado del modelo **Salida**: @@ -88,15 +90,15 @@ Este flujo de trabajo demuestra las capacidades principales de **generación de ## Descarga del modelo -Los modelos Gemma 4 se cargan como codificadores de texto en ComfyUI. Descarga el archivo de modelo correspondiente y colócalo en el directorio correcto: +Los modelos Gemma 4 se cargan como codificadores de texto en ComfyUI. Descarga el archivo del modelo correspondiente y colócalo en el directorio correcto: - Rápido y ligero. Recomendado para GPU de consumo. + Rápido y ligero. RECOMENDADO para GPU de consumo. - Rendimiento equilibrado. El modelo predeterminado del flujo de trabajo. + Rendimiento equilibrado. Es el modelo predeterminado del flujo de trabajo. @@ -104,7 +106,7 @@ Los modelos Gemma 4 se cargan como codificadores de texto en ComfyUI. Descarga e -Coloca el archivo `.safetensors` descargado en: +Coloca el archivo `.safetensors` que descargaste en: ``` 📂 ComfyUI/ diff --git a/es/tutorials/llm/qwen/qwen3.mdx b/es/tutorials/llm/qwen/qwen3.mdx index b4073fd05c..4814879be2 100644 --- a/es/tutorials/llm/qwen/qwen3.mdx +++ b/es/tutorials/llm/qwen/qwen3.mdx @@ -2,13 +2,15 @@ title: "Qwen 3.0 en ComfyUI: generación de texto LLM con TextGenerate" description: "Ejecuta Qwen3 4B Thinking en ComfyUI con TextGenerate para reescritura de prompts, razonamiento con cadena de pensamiento y análisis de texto estructurado." sidebarTitle: "Qwen 3.0" -translationSourceHash: c9e91599 +translationSourceHash: 062180fe translationFrom: tutorials/llm/qwen/qwen3.mdx translationBlockHashes: "_intro": 75e813fe "Use Cases": 72228b63 "Available workflow": 93a0c3e5 + "Model Download": 6a95f95c --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" @@ -19,8 +21,8 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" - **Razonamiento sólido**: Qwen3-4B-Thinking admite razonamiento paso a paso con cadena de pensamiento - **Enfocado en la generación de texto**: optimizado para la salida de texto estructurado, el análisis y las tareas de programación -- **Nativo en ComfyUI**: funciona con el nodo integrado `TextGenerate`, sin necesidad de Nodos personalizados -- **Ligero**: comparte el mismo formato de codificador de texto que Qwen3.5, disponible en variantes de 2B, 4B y 9B para ajustarse a diferentes configuraciones de hardware +- **Nativo en ComfyUI**: funciona con el nodo integrado `TextGenerate`, sin necesidad de nodos personalizados +- **Ligero**: comparte el formato de codificador de texto de Qwen3.5, disponible en variantes de 2B, 4B y 9B para ajustarse a diferentes configuraciones de hardware ## Casos de uso @@ -35,7 +37,7 @@ Qwen 3.0 es adecuado para tareas que requieren generación de texto estructurado ### Qwen3.0: generación de texto {#llm_qwen3_text_gen} -Introduce un prompt de texto para generar respuestas detalladas y razonadas con el modelo Qwen3-4B-Thinking. +Ingresa un prompt de texto para generar respuestas detalladas y razonadas con el modelo Qwen3-4B-Thinking. Vista previa del flujo de trabajo de generación de texto de Qwen 3.0 @@ -68,7 +70,7 @@ Este flujo de trabajo demuestra las capacidades fundamentales de **generación d ## Descarga del modelo -Los modelos Qwen 3.0 se cargan como codificadores de texto en ComfyUI. Los archivos de modelo se comparten con Qwen3.5. Descarga la variante que mejor se adapte a tu hardware: +Los modelos Qwen 3.0 se cargan como codificadores de texto en ComfyUI. Los archivos del modelo se comparten con Qwen3.5. Descarga la variante que mejor se adapte a tu hardware: @@ -76,7 +78,7 @@ Los modelos Qwen 3.0 se cargan como codificadores de texto en ComfyUI. Los archi - Equilibrio entre tamaño y calidad. Recomendado para la mayoría de GPU de consumo. + Tamaño y calidad equilibrados. Recomendado para la mayoría de las GPU de consumo. diff --git a/es/tutorials/llm/qwen/qwen3_5.mdx b/es/tutorials/llm/qwen/qwen3_5.mdx index 4818144e0a..0f5de8b321 100644 --- a/es/tutorials/llm/qwen/qwen3_5.mdx +++ b/es/tutorials/llm/qwen/qwen3_5.mdx @@ -2,13 +2,15 @@ title: "Qwen3.5 en ComfyUI: LLM multimodal para descripción de imágenes" description: "Ejecuta Qwen3.5, el LLM multimodal de Alibaba Cloud, en ComfyUI con el nodo TextGenerate para descripción de imágenes, prompts inversos y preguntas visuales." sidebarTitle: "Qwen3.5" -translationSourceHash: f25a584f +translationSourceHash: 37805a0b translationFrom: tutorials/llm/qwen/qwen3_5.mdx translationBlockHashes: "_intro": cc4cef60 "Use Cases": 01910a1e "Available workflow": 767cf795 + "Model Download": 835bbbd0 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" @@ -18,10 +20,10 @@ import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" **Aspectos destacados del modelo**: - **Multimodal**: acepta entradas de texto e imagen para tareas de comprensión visual -- **Etiquetado de imágenes**: puede describir imágenes y generar leyendas detalladas +- **Etiquetado de imágenes**: puede describir imágenes y generar descripciones detalladas - **Ingeniería inversa de prompts**: extrae prompts y parámetros de generación a partir de imágenes de referencia -- **Nativo en ComfyUI**: funciona con el nodo integrado `TextGenerate`, sin necesidad de Nodos personalizados -- **Ligero**: modelo de 4B parámetros, apto para GPUs de consumo +- **Nativo en ComfyUI**: funciona con el nodo integrado `TextGenerate`, sin necesidad de nodos personalizados +- **Ligero**: modelo de 4B de parámetros, apto para GPUs de consumo ## Casos de uso @@ -37,9 +39,9 @@ Qwen3.5 destaca en escenarios donde combinar la comprensión visual con la gener ### Qwen3.5: Text Generation {#llm_qwen3_5_text_gen} -Usa el modelo Qwen3.5 para analizar una imagen de entrada y generar prompts descriptivos de texto. Este flujo de trabajo realiza captioning de imágenes e ingeniería inversa de prompts. +Usa el modelo Qwen3.5 para analizar una imagen de entrada y generar prompts descriptivos de texto. Este flujo de trabajo realiza descripción automática de imágenes e ingeniería inversa de prompts. -Qwen3.5 text generation workflow preview +Vista previa del flujo de trabajo de generación de texto con Qwen3.5 @@ -61,17 +63,17 @@ Sube este archivo al nodo `LoadImage` correspondiente:
- Input image + Imagen de entrada
Este flujo de trabajo demuestra las capacidades de **generación de texto y comprensión de imágenes** de Qwen3.5. Acepta un prompt de texto y una imagen opcional, y genera texto descriptivo o análisis estructurado a partir de la entrada. **Entradas**: - **Prompt de texto**: tu pregunta, instrucción o descripción de la tarea -- **Imagen** (opcional): para tareas de comprensión visual (captioning de imágenes, ingeniería inversa de prompts, optimización de prompts, etc.) +- **Imagen** (opcional): para tareas de comprensión visual (descripción automática de imágenes, ingeniería inversa de prompts, optimización de prompts, etc.) **Controles clave**: -- **Max length**: número máximo de tokens a generar (256 por defecto) +- **Max length**: número máximo de tokens a generar (256 de forma predeterminada) - **Sampling mode**: activa o desactiva el muestreo y ajusta temperature, top-k, top-p, repetition penalty y seed - **Use default template**: aplica el system prompt integrado del modelo @@ -84,7 +86,7 @@ Este flujo de trabajo demuestra las capacidades de **generación de texto y comp ## Descarga del modelo -Los modelos Qwen3.5 se cargan como codificadores de texto en ComfyUI. Elige la variante que mejor se adapte a tu hardware: +Los modelos Qwen3.5 se cargan como text encoders en ComfyUI. Elige la variante que mejor se adapte a tu hardware: @@ -92,11 +94,11 @@ Los modelos Qwen3.5 se cargan como codificadores de texto en ComfyUI. Elige la v - Equilibrio entre tamaño y calidad. Recomendado para la mayoría de GPU de consumo. + Tamaño y calidad equilibrados. Recomendado para la mayoría de las GPU de consumo. - La variante más grande, ~19 GB. Salida de mayor calidad, requiere más VRAM. + La variante más grande, ~19 GB. Mayor calidad de salida, requiere más VRAM. diff --git a/es/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx b/es/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx index 9b022ecdfc..078ea97203 100644 --- a/es/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx +++ b/es/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx @@ -2,14 +2,16 @@ title: "Topaz Image Enhance Bloom 2: ampliación creativa de imágenes con IA" description: "Amplía y mejora imágenes con Topaz Image Enhance Bloom 2 en ComfyUI: ampliación creativa que añade detalle, textura y elementos visuales" sidebarTitle: "Image Enhance Bloom 2" -translationSourceHash: ea0e893b +translationSourceHash: 243c9f97 translationFrom: tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx translationBlockHashes: "_intro": 1b619937 "What Topaz Image Enhance Bloom 2 is good at": bc0b5457 "Example outputs": 4eb243ba + "Topaz Image Enhance Bloom 2": 8e33b921 "Get started": 9c5c9043 --- + import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; @@ -34,7 +36,7 @@ Ampliación creativa de una imagen generada por IA, con nuevos detalles y textur ## Topaz Image Enhance Bloom 2 -Mejora imágenes generadas por IA con el modelo de ampliación creativa de Bloom 2, que añade nuevo detalle, textura y elementos visuales. El control de Creatividad va de 1, para una mejora contenida, a 9, para una reinterpretación marcada. Si el prompt está vacío, el modelo crea uno automáticamente. +Mejora imágenes generadas por IA con el modelo de ampliación creativa de Bloom 2, que añade nuevos detalles, texturas y elementos visuales. El control Creativity abarca de 1 para una mejora contenida a 9 para una reinterpretación marcada. Si el prompt está vacío, el modelo crea uno automáticamente. Vista previa del flujo de trabajo Topaz Image Enhance Bloom 2 @@ -43,18 +45,18 @@ Mejora imágenes generadas por IA con el modelo de ampliación creativa de Bloom Abrir en Comfy Cloud
- Descarga el JSON o busca "Topaz Image Enhance Bloom 2" en la Biblioteca de plantillas + Descarga el JSON o busca "Topaz Image Enhance Bloom 2" en la Biblioteca de plantillas
Materiales de entrada -Descarga esta imagen de entrada de ejemplo para probar el flujo de trabajo: +Descarga esta imagen de entrada de muestra para probar el flujo de trabajo: - Descargar imagen de entrada de ejemplo + Descargar imagen de entrada de muestra
@@ -66,19 +68,19 @@ Descarga esta imagen de entrada de ejemplo para probar el flujo de trabajo: Este flujo de trabajo usa cuatro nodos: - **LoadImage**: proporciona la imagen de origen -- **TopazImageEnhanceV2**: el nodo principal, configurado con el modelo de ampliación `Bloom 2` +- **TopazImageEnhanceV2**: el nodo principal, configurado con el modelo de mejora `Bloom 2` - **SaveImageAdvanced**: guarda la salida mejorada como PNG -- **ImageCompare**: muestra el resultado mejorado junto al original para compararlos +- **ImageCompare**: muestra el resultado mejorado junto al original para comparar ### Pasos para ejecutar 1. **Carga una imagen**: sube o selecciona tu imagen de entrada en el nodo **LoadImage** 2. **Selecciona el modelo**: mantén `Bloom 2` en el nodo **TopazImageEnhanceV2** -3. **Establece la creatividad**: de 1 para una mejora contenida a 9 para una reinterpretación marcada +3. **Ajusta la creatividad**: de 1 para una mejora contenida a 9 para una reinterpretación marcada 4. **Prompt opcional**: déjalo vacío para que el modelo cree uno automáticamente 5. **Haz clic en Queue**: pulsa `Ctrl+Enter` para generar ## Empezar 1. Actualiza ComfyUI a la última versión -2. Ve a la Biblioteca de plantillas y busca `Topaz Image Enhance Bloom 2` \ No newline at end of file +2. Ve a la Biblioteca de plantillas y busca `Topaz Image Enhance Bloom 2` diff --git a/es/tutorials/partner-nodes/topaz/overview.mdx b/es/tutorials/partner-nodes/topaz/overview.mdx index b54b5643d6..2b495c9055 100644 --- a/es/tutorials/partner-nodes/topaz/overview.mdx +++ b/es/tutorials/partner-nodes/topaz/overview.mdx @@ -2,7 +2,7 @@ title: "Topaz Labs en ComfyUI: mejora de imagen y video" description: "Mejora y amplía imágenes y video en ComfyUI con Topaz Labs: ampliación guiada por prompt con Reimagine, mejora de rostros, Starlight y Apollo." sidebarTitle: "Topaz Labs" -translationSourceHash: 8e0ad9e8 +translationSourceHash: f1695036 translationFrom: tutorials/partner-nodes/topaz/overview.mdx --- @@ -18,8 +18,8 @@ Topaz Labs lleva a ComfyUI la mejora de imágenes y video con IA de nivel empres - **Soporte de salida en 8K**: amplía imágenes y cuadros de video hasta la resolución ultra alta de 8K manteniendo la nitidez y la coherencia visual. - **Ampliador de difusión Starlight**: ampliación basada en difusión optimizada para fotografía de paisajes, que genera detalle realista como follaje, texturas de roca y nubes. - **Interpolación de cuadros Apollo**: genera cuadros intermedios suaves entre los cuadros de video existentes para efectos de cámara lenta o conversión de frecuencia de cuadros. -- **Ampliación optimizada para ilustraciones**: modelo especializado en ilustraciones digitales, line art y obras de colores planos que preserva los bordes definidos y los degradados limpios. -- **Flujo de trabajo de mejora de video**: procesamiento de video completo que incluye reducción de ruido, desentrelazado, estabilización y ampliación inteligente cuadro por cuadro. +- **Ampliación optimizada para ilustraciones**: modelo especializado en obras de colores planos, line art e ilustraciones digitales que preserva los bordes definidos y los degradados limpios. +- **Pipeline de mejora de video**: procesamiento de video completo que incluye reducción de ruido, desentrelazado, estabilización y ampliación inteligente cuadro por cuadro. @@ -33,7 +33,7 @@ Topaz Labs ofrece una suite de modelos de mejora con IA tanto para imágenes com Mejora generativa de imágenes con restauración de detalle y fuerza ajustable.
- Mejora creativa de imágenes con estilo bloom. + Mejora creativa de imágenes al estilo bloom. Mejora y ampliación precisa de video. diff --git a/es/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx b/es/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx index 124e78ab9f..cc8bd0b56f 100644 --- a/es/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx +++ b/es/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx @@ -2,7 +2,7 @@ title: "Topaz Starlight Precise 2.5 - Ampliación de video con IA" description: "Amplía videos con Topaz Starlight Precise 2.5 en ComfyUI: salida 4K más nítida y con menos artefactos para material de acción real." sidebarTitle: "Starlight Precise 2.5" -translationSourceHash: 512ec885 +translationSourceHash: 43c2d2a4 translationFrom: tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx --- import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; @@ -15,7 +15,7 @@ Topaz Starlight Precise 2.5 es un modelo de ampliación de video disponible en C - **Ampliación a 4K**: amplía videos MP4 hasta resolución 4K - **Mayor nitidez**: una salida más nítida con menos artefactos -- **Metraje de acción real**: los pocos artefactos lo hacen ideal para video de acción real +- **Metraje de acción real**: menos artefactos lo hacen ideal para video de acción real - **Opciones de resolución**: salida en FullHD (1080p) o 4K (2160p) ## Salidas de ejemplo diff --git a/es/tutorials/partner-nodes/wavespeed/overview.mdx b/es/tutorials/partner-nodes/wavespeed/overview.mdx index 987ad27644..9c787e8080 100644 --- a/es/tutorials/partner-nodes/wavespeed/overview.mdx +++ b/es/tutorials/partner-nodes/wavespeed/overview.mdx @@ -2,7 +2,7 @@ title: "WaveSpeed en ComfyUI: ampliación de imagen y video" description: "Amplía video y restaura imágenes en ComfyUI con WaveSpeed: ampliación temporal de video FLSH-VSR, restauración de fotos SeedVR2 y ampliación general." sidebarTitle: "WaveSpeed" -translationSourceHash: f7e72a84 +translationSourceHash: 39f7198f translationFrom: tutorials/partner-nodes/wavespeed/overview.mdx --- diff --git a/es/tutorials/video/bytedance/bernini-r.mdx b/es/tutorials/video/bytedance/bernini-r.mdx index 6a796a6bce..69c52b7a58 100644 --- a/es/tutorials/video/bytedance/bernini-r.mdx +++ b/es/tutorials/video/bytedance/bernini-r.mdx @@ -2,25 +2,27 @@ title: "Bernini-R en ComfyUI: edición de imágenes y video en contexto" description: "Edita imágenes y video en ComfyUI con ByteDance Bernini-R, un modelo Wan 2.2 solo de renderizado que usa imágenes o video de referencia sin entrenamiento LoRA." sidebarTitle: "Bernini-R" -translationSourceHash: 28ac25ab +translationSourceHash: d89830ba translationFrom: tutorials/video/bytedance/bernini-r.mdx translationBlockHashes: "_intro": b791048b + "Model Installation": 286fbd69 "Example Workflows": cf2f84c1 "1. Image Editing": a9437ae9 "2. Video Editing": d17ea37c "Community Resources": 9b4a0aaf --- -import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" + +import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' # Introducción a ComfyUI Bernini-R -[Bernini-R](https://github.com/bytedance/Bernini) es el modelo Wan 2.2 **solo de renderizado** de ByteDance para el conditioning de imágenes y video en contexto. Utiliza un conjunto de flujos de conditioning (video fuente, imágenes de referencia, video de referencia) para guiar la generación. No requiere entrenamiento de LoRA ni ajuste fino. +[Bernini-R](https://github.com/bytedance/Bernini) es el modelo Wan 2.2 **solo de renderizado** de ByteDance para el acondicionamiento de imágenes y video en contexto. Utiliza un conjunto de flujos de acondicionamiento (video fuente, imágenes de referencia, video de referencia) para guiar la generación. No requiere entrenamiento de LoRA ni ajuste fino. Capacidades principales: - **Varios tipos de tarea en un solo modelo**: generación de imagen y video, edición, cambio de iluminación, cambio de estilo, inserción de sujetos -- **Acondicionamiento en contexto**: las imágenes y videos de referencia actúan como prompts visuales, inyectados como tokens +- **Acondicionamiento en contexto**: las imágenes y los videos de referencia actúan como prompts visuales, inyectados como tokens - **Ligero**: modelo solo de renderizado. Sin backbone de difusión de texto a video. - **Soporte flexible de entradas**: referencias de una o varias imágenes, video a video, edición guiada por referencia @@ -43,7 +45,7 @@ ComfyUI ahora admite de forma nativa los nodos de Bernini-R. Asegúrate de haber ## Instalación de modelos -Descarga los pesos de modelo necesarios y guárdalos en las carpetas correspondientes de ComfyUI: +Descarga los pesos de modelo requeridos y guárdalos en las carpetas correspondientes de ComfyUI: **text_encoders:** - [umt5_xxl_fp8_e4m3fn_scaled.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/text_encoders/umt5_xxl_fp8_e4m3fn_scaled.safetensors?download=true) @@ -69,23 +71,22 @@ ComfyUI/ │ ├── diffusion_models/ │ │ └── wan2.2_bernini_r_fp16.safetensors ``` - ## Flujos de trabajo de ejemplo --- -## 1. Edición de imagen +## 1. Edición de imágenes -**Qué hace:** genera una imagen editada con iluminación coincidente y consulta una comparación en paralelo de antes y después. Es ideal para cambiar la iluminación de retratos y productos, mantener una iluminación coherente en conjuntos de fotos y para fotografía de catálogo de comercio electrónico. +**Qué hace:** genera una imagen editada con iluminación coincidente y consulta una comparación antes/después en paralelo. Ideal para la reliuminación de retratos y productos, la iluminación coherente en conjuntos de fotos y la fotografía de catálogo de comercio electrónico. -Vista previa del flujo de trabajo de edición de imagen con Bernini-R +Vista previa del flujo de trabajo de edición de imágenes de Bernini-R Abrir en Comfy Cloud - Descarga el JSON o busca "Bernini-R" en la biblioteca de plantillas + Descarga el JSON o busca "Bernini-R" en la Biblioteca de plantillas @@ -103,11 +104,11 @@ ComfyUI/ ### Pasos para ejecutar 1. **Selecciona el tipo de tarea**: elige tu tarea (Image Editing, Subject to Image, etc.) -2. **Conecta las entradas**: carga la imagen de origen y las imágenes de referencia opcionales -3. **Escribe el prompt**: describe la edición que deseas +2. **Conecta las entradas**: carga la imagen fuente y las imágenes de referencia opcionales +3. **Escribe el prompt**: describe la edición deseada 4. **Ejecuta**: haz clic en Queue o usa `Cmd+Enter` -**Entrada de imagen de referencia:** úsala para **Subject to Image** cuando necesites una o más imágenes de referencia (sujeto, vestuario, escena, accesorios). En el prompt, usa `image0`, `image1`, … para hacer referencia a cada imagen. No es necesaria para **Image Editing**: esa tarea usa `source_image` en su lugar. +**Entrada de imagen de referencia:** úsala para **Subject to Image** cuando necesites una o más imágenes de referencia (sujeto, atuendo, escena, accesorios). En el prompt, usa `image0`, `image1`, … para hacer referencia a cada imagen. No se necesita para **Image Editing**: esa tarea usa `source_image` en su lugar. @@ -115,11 +116,9 @@ ComfyUI/ ---- - ## 2. Edición de video -**Qué hace:** Genera un video editado con una nueva iluminación consistente usando Bernini-R. Conecta un video de origen, una o varias imágenes de referencia opcionales o un video de referencia, elige el tipo de tarea, escribe un prompt y ejecuta. +**Qué hace:** Genera un video editado con un cambio de iluminación coherente usando Bernini-R. Conecta un video de origen, una o varias imágenes de referencia opcionales o un video de referencia, elige el tipo de tarea, escribe un prompt y ejecuta. Vista previa del flujo de trabajo de edición de video con Bernini-R @@ -128,7 +127,7 @@ ComfyUI/ Abrir en Comfy Cloud - Descarga el JSON o busca "Bernini-R" en Biblioteca de plantillas + Descarga el JSON o busca "Bernini-R" en la biblioteca de plantillas
@@ -146,16 +145,16 @@ ComfyUI/ ### Pasos para ejecutar 1. **Carga el video de origen**: conecta tu video de entrada -2. **(Opcional) Carga las referencias**: una o varias imágenes de referencia o un video de referencia +2. **(Opcional) Carga las referencias**: una o varias imágenes de referencia, o un video de referencia 3. **Selecciona el tipo de tarea**: v2v, rv2v, r2v o ads2v -4. **Escribe el prompt**: describe la edición que quieres +4. **Escribe el prompt**: describe la edición que deseas 5. **Ejecuta**: haz clic en Queue o usa `Cmd+Enter` -**Entrada de imagen de referencia:** úsala cuando una tarea necesite una o más imágenes de referencia (rv2v, r2v, conjuntos de varias prendas). Cada imagen del lote se convierte en su propio token en contexto. Menciona `image0`, `image1`, … en el prompt si las referencias cumplen funciones distintas. +**Entrada de imagen de referencia:** úsala cuando una tarea necesite una o varias imágenes de referencia (rv2v, r2v, conjuntos de varias prendas). Cada imagen del lote se convierte en su propio token en contexto. Menciona `image0`, `image1`, … en el prompt si las referencias desempeñan roles distintos. - Este flujo de trabajo usa nodos Subgraph para un procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo. + Este flujo de trabajo usa nodos Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y extender el flujo de trabajo. @@ -163,6 +162,6 @@ ComfyUI/ ## Recursos de la comunidad -- [Bernini GitHub (bytedance/Bernini)](https://github.com/bytedance/Bernini): Documentación del artículo de investigación y de las tareas -- [Comfy-Org/Bernini-R](https://huggingface.co/Comfy-Org/Bernini-R): Pesos oficiales del modelo para ComfyUI -- [Bernini: Latent Semantic Planning for Video Diffusion](https://arxiv.org/abs/2605.22344): Artículo de investigación +- [Bernini en GitHub (bytedance/Bernini)](https://github.com/bytedance/Bernini): artículo de investigación y documentación de tareas +- [Comfy-Org/Bernini-R](https://huggingface.co/Comfy-Org/Bernini-R): pesos oficiales del modelo para ComfyUI +- [Bernini: Latent Semantic Planning for Video Diffusion](https://arxiv.org/abs/2605.22344): artículo de investigación diff --git a/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx b/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx index 4ea15c9007..cbaaad36f2 100644 --- a/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx +++ b/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx @@ -22,7 +22,7 @@ H3 espera planos, cámara, diálogo y SFX en un solo prompt multimodal. Esta pá El paquete instalable de [habilidades H3](https://github.com/MiniMax-AI/MiniMax-H3/tree/main/skills) reúne estos contenidos para los agentes. -Aplicado por plantilla: [T2V/I2V](/es/tutorials/video/minimax/minimax-h3-native), [R2V](/es/tutorials/video/minimax/minimax-h3-native#minimax-h3-referencia-a-video-r2v), [Multiframe](/es/tutorials/video/minimax/minimax-h3-multiframe#guía-para-escribir-prompts), [Fun ControlNet](/es/tutorials/video/minimax/minimax-h3-fun-controlnet#consejos-para-los-prompts). +Aplicado por plantilla: [T2V/I2V](/es/tutorials/video/minimax/minimax-h3-native), [R2V](/es/tutorials/video/minimax/minimax-h3-native#minimax-h3-referencia-a-video-r2v), [Multiframe](/es/tutorials/video/minimax/minimax-h3-multiframe#guía-para-escribir-prompts), [Fun ControlNet](/es/tutorials/video/minimax/minimax-h3-fun-controlnet#consejos-para-el-prompt). ## Consejos generales diff --git a/es/tutorials/video/wan/fun-camera.mdx b/es/tutorials/video/wan/fun-camera.mdx index 44669c4aad..7cab5d60fe 100644 --- a/es/tutorials/video/wan/fun-camera.mdx +++ b/es/tutorials/video/wan/fun-camera.mdx @@ -2,15 +2,17 @@ title: "Ejemplos oficiales de ComfyUI Wan2.1 Fun Camera" description: "Esta guía muestra cómo usar Wan2.1 Fun Camera en ComfyUI para generar video" sidebarTitle: "Wan2.1 Fun Camera" -translationSourceHash: 6173f2a1 +translationSourceHash: f2b906a8 translationFrom: tutorials/video/wan/fun-camera.mdx translationBlockHashes: "_intro": 59d5e57d "About Wan2.1 Fun Camera": 98c0ae00 + "Model Installation": 65ab0da5 "ComfyUI Wan2.1 Fun Camera 1.3B Workflow": 4ddf8882 "ComfyUI Wan2.1 Fun Camera 14B Workflow": ea99a5f1 "Performance Reference": 2dc2f8f0 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx" Wan2.1 Fun Camera es un modelo de generación de video con movimiento de cámara del proyecto VideoX-Fun de Alibaba, con soporte nativo en ComfyUI. Genera videos cuyo movimiento de cámara sigue tus condiciones de control, así puedes dirigir cómo se mueve la cámara en el resultado en lugar de describir cada plano en el prompt. @@ -19,9 +21,9 @@ El modelo forma parte de la familia Wan2.1-Fun y se distribuye en dos tamaños: ## Acerca de Wan2.1 Fun Camera -**Wan2.1 Fun Camera** es un proyecto de generación de video lanzado por el equipo de Alibaba, centrado en controlar los efectos de generación de video mediante el movimiento de cámara. +**Wan2.1 Fun Camera** es un proyecto de generación de video lanzado por el equipo de Alibaba, centrado en controlar los efectos de la generación de video mediante el movimiento de cámara. -**Descargar los pesos del modelo**: +**Descarga de los pesos del modelo**: - [Versión 14B](https://huggingface.co/alibaba-pai/Wan2.1-Fun-V1.1-14B-Control-Camera) - [Versión 1.3B](https://huggingface.co/alibaba-pai/Wan2.1-Fun-V1.1-1.3B-Control-Camera) @@ -33,9 +35,9 @@ El modelo forma parte de la familia Wan2.1-Fun y se distribuye en dos tamaños: ## Instalación de modelos -Estos modelos solo hay que instalarlos una vez. Además, la información de descarga de los modelos está incluida en las imágenes de los flujos de trabajo correspondientes, así que puedes elegir la forma de descarga que prefieras. +Estos modelos solo necesitan instalarse una vez. Además, la información de descarga de los modelos se incluye en las imágenes del flujo de trabajo correspondiente, así que puedes elegir la forma que prefieras para descargar los modelos. -Todos los modelos siguientes están disponibles en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged) +Todos los modelos siguientes se encuentran en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged) ### Modelos de difusión @@ -50,7 +52,7 @@ Elige entre 1.3B o 14B: -Si ya has usado modelos de Wan2.1, deberías tener ya los siguientes modelos. Si no es así, descárgalos: +Si ya has usado modelos relacionados con Wan2.1, deberías tener los siguientes modelos. Si no es así, descárgalos: ### Codificadores de texto @@ -61,7 +63,7 @@ Elige uno de los siguientes: Codificador de texto de precisión completa - Codificador de texto cuantizado FP8 (recomendado para menos VRAM) + Codificador de texto cuantizado FP8 (recomendado para VRAM baja) @@ -77,7 +79,7 @@ Elige uno de los siguientes: - Codificador CLIP Vision + Codificador de visión CLIP @@ -96,25 +98,24 @@ Ubicación de almacenamiento de archivos: │ └── 📂 clip_vision/ │ └── clip_vision_h.safetensors ``` - -## Flujo de trabajo ComfyUI Wan2.1 Fun Camera 1.3B +## Flujo de trabajo de ComfyUI Wan2.1 Fun Camera 1.3B ### Wan 2.1 Fun Camera 1.3B {#video_wan2.1_fun_camera_v1.1_1.3B} Genera videos dinámicos con movimientos de cámara cinematográficos usando el modelo Wan 2.1 Fun Camera 1.3B. -Vista previa del flujo de trabajo Wan 2.1 Fun Camera 1.3B +Vista previa del flujo de trabajo de Wan 2.1 Fun Camera 1.3B Abrir en Comfy Cloud - Descarga el JSON o busca "Wan 2.1 Fun Camera 1.3B" en la biblioteca de plantillas + Descarga el JSON o busca "Wan 2.1 Fun Camera 1.3B" en la Biblioteca de plantillas -Descarga el video de abajo y arrástralo a ComfyUI para cargar el flujo de trabajo correspondiente: +Descarga el video a continuación y arrástralo a ComfyUI para cargar el flujo de trabajo correspondiente:
- Versión refinada del prompt, o null en una generación COMPLETED que Bria no refinó. Es nullable porque la clave está PRESENTE con null en lugar de omitirse; se observó en vivo en bria/image-edit-gen-fill. + Versión refinada del prompt, o null en una generación COMPLETED que Bria no refinó. Es nullable porque la clave está PRESENTE con valor null en lugar de omitirse; observado en vivo en bria/image-edit-gen-fill. @@ -229,7 +231,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/bria/image-edi - El prompt estructurado detallado en JSON. + El prompt estructurado JSON detallado. @@ -267,5 +269,4 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/bria/image-edi } ``` - 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 3720641017..73928b1cf3 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: 98890ddf +translationSourceHash: 70ec471f translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 5c27d10f + "Schema": 8c0478c9 "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"; @@ -192,7 +193,7 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + Se ignora. 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 un callback; en su lugar, consulta la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -289,26 +290,24 @@ ID de recurso: Formato asset://\ 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. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). - Rango: `2` a `30` + Valores posibles: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` 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. - - - +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 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 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 aún 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`. + 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. @@ -321,14 +320,14 @@ mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta - 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, 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. 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, 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. Valores posibles: `480p`, `720p`, `1080p`, `4k` @@ -336,14 +335,14 @@ 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. +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 consultando 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. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -356,9 +355,7 @@ 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/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 +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.### 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. @@ -372,6 +369,20 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream 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 que las URL del proveedor dejan de funcionar: la hora de firma más temprana más la vigencia que las propias URL llevan, nunca posterior a la `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, la `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 vigencia de `video_url` / `last_frame_url` realojadas. + + Formato: `date-time` + + + + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a la `last_frame_url` realojada y en los mismos términos que `upstream_video_url`: solo para espacios de trabajo que lo hayan habilitado, solo en Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. + + + + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a la `video_url` realojada. 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 sin alcance 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. @@ -396,16 +407,15 @@ 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 - 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. + El formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: así es donde lo devuelve la consulta de tareas de video de Seedance. Es un campo propio de BytePlus, reenviado sin cambios. @@ -413,7 +423,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - 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ó en la tarea. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. Formato: `int64` @@ -425,7 +435,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 en que la tarea se actualizó por última vez. El valor es una marca de tiempo 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 c12f1d7343..3dd375524e 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: acad6428 +translationSourceHash: 8036f4db translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": a00368da + "Schema": 90b60b2e "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"; @@ -178,7 +179,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + 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 la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -275,26 +276,24 @@ Asset ID: Formato asset://\ 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. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). - Rango: `2` a `30` + Valores posibles: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` 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. - - - +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, 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 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). Una renderización final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en ese caso 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. @@ -329,7 +328,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` @@ -342,24 +341,36 @@ 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 el Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. - -### Salida +Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-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. 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. - 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, 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 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 realizar el realojamiento, 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. 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. + + Fecha y hora RFC 3339 en la que las URL del 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 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á `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes proporciona una hora. No está relacionado con la vida útil de `video_url` / `last_frame_url` realojadas. + + Formato: `date-time` + + + + 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`. + + + + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a `video_url` realojada. Presente SOLO en tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy haya 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 limitada 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 venza, así que trátala como un secreto. Vence en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, de las cuales el propio realojamiento de Router consume una. + + - 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 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 realizar el realojamiento, 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. @@ -412,6 +423,35 @@ 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. +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`: ahí es donde la consulta de 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 que finalizaron correctamente y reenviado sin cambios. + + + + La semilla de generación que realmente se usó en la tarea. Campo propio de BytePlus, devuelto en las tareas de video que finalizaron correctamente 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. 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 8a3c8917e8..698fe2e541 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: 69d38df7 +translationSourceHash: a1d75c67 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 2279819f + "Schema": ebf1fc3a "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"; @@ -178,7 +179,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### Entrada - Dirección de notificación callback para el resultado de esta tarea de generación + 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 la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -250,7 +251,7 @@ 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 +Está configurado muy por encima del tráfico real, de modo que nunca llegue a juzgar un prompt genuino: auméntalo si un cliente necesita más. @@ -275,10 +276,10 @@ Asset ID: formato asset://\ 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. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). - Rango: `2` a `30` + Posibles valores: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` @@ -291,10 +292,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 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. - - - +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 ayuda solo 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 en su lugar recrea el Draft con `false`. + 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. @@ -321,7 +320,7 @@ 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. + Si la respuesta incluye 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. @@ -329,7 +328,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` @@ -339,12 +338,10 @@ 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. - -### Salida +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.### 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. @@ -358,6 +355,20 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream 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 origen dejan de funcionar: el primer momento de firma 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; 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` + + + + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a la `last_frame_url` re-alojada 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 borra, y una credencial de portador hasta `upstream_expires_at`. + + + + 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 en el servidor (no existe ningún parámetro en la solicitud); ausente para todos los demás, incluida una credencial que no se 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 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 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. @@ -382,24 +393,23 @@ 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 - El nombre y la versión del modelo utilizado 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. 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 campo 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`. 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, devuelto en las tareas de video completadas con éxito y reenviado 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 utilizó para la tarea. Es un campo propio de BytePlus, devuelto en las tareas de video completadas con éxito y reenviado sin cambios. Formato: `int64` @@ -411,7 +421,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 de la última actualización de la tarea. El valor es una marca de tiempo UNIX en segundos. 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 293ce4f0fb..ca6bde1d89 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: 9a342bd4 +translationSourceHash: 3606fb83 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0467a987 + "Schema": d2c28a84 "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"; @@ -191,7 +192,7 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + Ignorado. Lo aceptamos por compatibilidad con la estructura de solicitud de BytePlus, pero lo eliminamos antes de enviar la tarea, así que nunca se envía una callback; en su lugar, consulta la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -288,23 +289,22 @@ ID de recurso: Formato asset://\ 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. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático). - Rango: `2` a `30` + Valores posibles: `-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` 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 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`. +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`. @@ -334,7 +334,7 @@ Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 48 - Si se devuelve la imagen del último fotograma del video generado. + 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 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. false: No devuelve la imagen del último fotograma del video generado. @@ -342,7 +342,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` @@ -352,27 +352,39 @@ 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. - -### Salida +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.### 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. - 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 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 caché en memoria 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. - 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 upstream dejan de funcionar: el primer instante de firma más la vigencia 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; de lo contrario, el `updated_at` de la tarea más 24 horas. Solo está presente cuando lo están `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes aporta una hora. No guarda relación con la vigencia de `video_url` / `last_frame_url` re-alojadas. + + Formato: `date-time` + + + + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a la `last_frame_url` re-alojada y en 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 bearer hasta `upstream_expires_at`. + + + + 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 que no esté 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 lo tanto, una credencial bearer: cualquiera que la tenga puede descargar el video hasta que expire, así que trátala como un secreto. Expira 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: 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 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 caché en memoria 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. @@ -395,24 +407,23 @@ 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 - El nombre y la versión del modelo utilizado por la tarea + El nombre y la versión del modelo que usó 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`; ahí es donde la consulta de tarea 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` 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 525db588a0..301f61f311 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,24 +2,26 @@ 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: caf03877 +translationSourceHash: 642f85ab translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d - "Schema": af62a34c + "Quick start": c762675f + "Schema": b57b84de "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"; -Referencia de API para `byteplus/seedance-1-0-pro-250528`, que Comfy Router sirve desde BytePlus. +Referencia de API para `byteplus/seedance-1-0-pro-250528`, servido por Comfy Router desde BytePlus. **Entrada:** Texto, Imagen · **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 directo. +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:** `byteplus/seedance-1-0-pro-250528` @@ -31,8 +33,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr ```python Python from comfy_sdk import Comfy -# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. +# 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-0-pro-250528", @@ -55,8 +57,8 @@ print(result) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// The SDK automatically creates an idempotency key and reuses it for automatic retries. +// 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-0-pro-250528", { content: [ { @@ -81,7 +83,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528 \ ``` - + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/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. @@ -89,8 +91,8 @@ El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/byteplus/seedan import asyncio from comfy_sdk import AsyncComfy -# Reads COMFY_API_KEY from the environment. -# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +# 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( @@ -107,14 +109,14 @@ async def main(): "resolution": "720p", }, ) - print("request_id:", handle.request_id) # with the model ID, all another process needs + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso - # Poll until the request completes, waiting the Retry-After the server names. + # 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) - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. + # 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) @@ -125,8 +127,8 @@ asyncio.run(main()) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +// 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-0-pro-250528", { content: [ { @@ -138,33 +140,33 @@ const handle = await comfy.models.submit("byteplus/seedance-1-0-pro-250528", { ratio: "16:9", resolution: "720p", }); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso -// Poll until the request completes, waiting the Retry-After the server names. +// 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); } -// The same result models.run() returns. A request that failed or was cancelled rejects here. +// 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. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +# 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-0-pro-250528/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. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +# 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-0-pro-250528/requests/$REQUEST_ID/status \ -H "X-API-Key: $COMFY_API_KEY" -# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +# 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/byteplus/seedance-1-0-pro-250528/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` @@ -177,7 +179,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + 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 el estado de la tarea en la ruta de estado. Formato: `uri` @@ -191,15 +193,15 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ - 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://\ +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 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. resolution tiene como valor predeterminado 1080p y solo admite 1080p. @@ -214,7 +216,7 @@ 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,\ -ID de recurso: formato asset://\ +Asset ID: formato asset://\ @@ -229,7 +231,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 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: - --resolution (--rs): 480p, 720p, 1080p (predeterminado: 720p) @@ -242,15 +244,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 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 -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. +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 las pruebas (2026-09-17). Cuenta caracteres, no bytes, así que un prompt multibyte puede ser varias veces de 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 limita todo el documento. Comfy Router (/v2/models/byteplus/\{model}) es la superficie que lo aplica; en una llamada directa v1 /proxy responde el validador propio de BytePlus. Se estableció muy por encima del tráfico real para que nunca juzgue un prompt genuino: auméntalo si algún cliente necesita más. @@ -264,38 +258,37 @@ resultado de un prompt genuino; auméntalo si un cliente necesita más. - 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 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. + Solo Seedance 2.5. Genera un video Draft en 480p; resolution 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. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 1.0 pro y 1.0 pro fast: [2,12]. - Rango: `2` a `30` + Valores posibles: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` - 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 (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 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 silencioso. +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 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 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`. - - -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. + + 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 cualquier otro valor, así como 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}, por lo que un llamador de Router lo omite. @@ -307,29 +300,29 @@ mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta - Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro, predeterminado: 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, predeterminado: 720p. Seedance 1.0 pro y pro-fast, predeterminado: 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 y 1080p. 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 la 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 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. 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` @@ -342,24 +335,36 @@ 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. - -### Salida +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.### 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 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 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 null: 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. - 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 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 de 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 hasta por 24 horas: se firma por 24 horas cuando se emite y se vuelve a servir desde una memoización de 23 horas, así 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 de los dos esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Es más habitual que los modelos Seedance lo devuelvan como un campo hermano de `content` en el nivel superior; 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 vigencia 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; de lo 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 proporciona una hora. No guarda relación con la vida útil de `video_url` / `last_frame_url`, que se vuelven a alojar. + + Formato: `date-time` + + + + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a la `last_frame_url` que se vuelve a alojar, en los mismos términos que `upstream_video_url`: solo para espacios de trabajo que hayan optado por ello, solo para Seedance 2.x, ausente una vez que BytePlus la borra y una credencial de portador hasta `upstream_expires_at`. + + + + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a `video_url`, que se vuelve a alojar. Solo está presente para 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); está 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 limitada 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 nuevo alojamiento que hace el 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, por lo que normalmente es una URL firmada por Comfy válida hasta por 24 horas: se firma por 24 horas cuando se emite y se vuelve a servir desde una memoización de 23 horas, así 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. @@ -367,39 +372,39 @@ 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 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 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 con estado succeeded y se reenvía 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 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 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 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 respuestas de error HTTP 400 y en las 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 - 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 la tarea 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, devuelto en las tareas de video con estado succeeded y reenviado 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, 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. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. Formato: `int64` @@ -411,7 +416,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. 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 19ba643e1b..95d835d08c 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: 600f57b4 +translationSourceHash: 61dd0135 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 1df5b053 + "Schema": dd74b012 "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"; @@ -178,7 +179,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + 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 el resultado en la ruta de estado de la tarea. Formato: `uri` @@ -275,26 +276,26 @@ Asset ID: Formato asset://\ 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. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 1.0 pro y 1.0 pro fast: [2,12]. - Rango: `2` a `30` + Valores posibles: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` 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. +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 silencioso 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 todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en ese caso recrea 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. @@ -321,7 +322,7 @@ 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 frame del video generado. + Indica si devolver 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. @@ -329,7 +330,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` @@ -342,9 +343,7 @@ false: No devuelve la imagen del último frame del video generado. Indica 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. - -### Salida +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.### 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. @@ -355,7 +354,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 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 esté presente. + + + + Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: la hora de firma más temprana más la vigencia que las propias URL incluyen, nunca posterior a la `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, la `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 tiene relación con la vida útil de `video_url` / `last_frame_url` realojadas. + + Formato: `date-time` + + + + 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 para espacios de trabajo que hayan optado por ello, solo para Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. + + + + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a `video_url` realojada. Presente SOLO en tareas de Seedance 2.x consultadas por un espacio de trabajo en 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 se 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. @@ -410,6 +423,35 @@ Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seed 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 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), que la consulta de tarea de video de Seedance devuelve en el NIVEL SUPERIOR, como hermano de `content`. 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 exitosas y se reenvía sin cambios. + + + + La semilla de generación que realmente se utilizó para la tarea. Campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía 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. 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 0b1455dc86..02472b9626 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: 13f3fe20 +translationSourceHash: 2263b4cf translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 6d6d6ec1 + "Schema": f4d67fb6 "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"; @@ -178,7 +179,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ ### Entrada - Dirección de notificación de callback para el resultado de esta tarea de generación + 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; en su lugar, consulta la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -199,7 +200,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. + 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. resolution toma el valor predeterminado 1080p y solo admite 1080p. @@ -251,7 +252,7 @@ este tamaño en el cable. Limita este campo, no la solicitud: 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. +prompt genuino; auméntalo si un cliente necesita más. @@ -275,27 +276,26 @@ ID de recurso: formato asset://\ 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. - - Duración del video en segundos. Seedance 2.5: [4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: [4,15] o -1 (automático). Seedance 1.5 pro: [4,12] o -1. Seedance 1.0: [2,12]. + + Duración del video en segundos. Seedance 1.5 pro: [4,12] o -1 (automático). - Rango: `2` a `30` + 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]. - 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`. +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 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 silencioso si eso ocurre; esto solo ayuda cuando el audio era la modalidad rechazada, que una respuesta síncrona de 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 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. @@ -342,20 +342,32 @@ 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-5-pro-251215/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. - -### Salida +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. + El resultado 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; 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. + 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 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 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 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 upstream dejan de funcionar: el primer instante de firma más la vigencia que las propias URL incluyen, 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 aporta una hora. No tiene relación con la vida útil de las `video_url` / `last_frame_url` re-alojadas. + + Formato: `date-time` + + + + URL de descarga del último fotograma propia de BytePlus, devuelta byte por byte junto a la `last_frame_url` re-alojada, 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 borra, y una credencial de portador hasta `upstream_expires_at`. + + + + URL de descarga del video de salida propia de BytePlus, 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 en el 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 limitada 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 re-alojamiento de Router. @@ -382,24 +394,23 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda 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 que usa la tarea + El nombre y la versión del modelo utilizado por 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. + 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 tarea de video de Seedance. 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` diff --git a/es/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code.mdx b/es/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code.mdx index 04a9767117..2aa6c55094 100644 --- a/es/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code.mdx +++ b/es/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code.mdx @@ -2,13 +2,15 @@ title: "Usa Higgsfield Genjutsu Motion Transfer V1.0 con Comfy Router" description: "Llama a higgsfield/higgsfield-genjutsu-motion-transfer-v1.0 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Higgsfield Genjutsu Motion Transfer V1.0" -translationSourceHash: ddf059b9 +translationSourceHash: 667b4dc4 translationFrom: development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code.mdx translationBlockHashes: "_intro": 2de8a7d4 "Quick start": 9d8041a2 "Schema": 7fd57a19 + "Examples": 20f268ec --- + {/* GENERATED FILE. Generated from router-schemas/higgsfield/higgsfield-genjutsu-motion-transfer-v1.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -72,7 +74,7 @@ curl https://api.comfy.org/v2/models/higgsfield/higgsfield-genjutsu-motion-trans -El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1.0/requests`. Router responde `201` con un `request_id` en cuanto la ejecución es admitida, 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/higgsfield/higgsfield-genjutsu-motion-transfer-v1.0/requests`. Router responde `201` con un `request_id` tan pronto como 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 @@ -144,7 +146,7 @@ REQUEST_ID="" curl -i https://api.comfy.org/v2/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1.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. +# 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/higgsfield/higgsfield-genjutsu-motion-transfer-v1.0/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` @@ -169,7 +171,7 @@ curl https://api.comfy.org/v2/models/higgsfield/higgsfield-genjutsu-motion-trans - URL del video de origen del que se conservan el movimiento, la cámara y la sincronización. Mínimo 4 segundos; los videos más largos se recortan a 30 segundos. + URL del video de origen cuyo movimiento, cámara y sincronización se conservan. Mínimo 4 segundos; los videos más largos se recortan a 30 segundos. Generado a partir del esquema que Router expone en `GET /v2/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1.0/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. @@ -181,7 +183,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/higgsfield/hi
- Detalle del fallo, establecido cuando `status` es `failed`. + Detalle del fallo, presente cuando `status` es `failed`. @@ -235,5 +237,4 @@ Generado a partir del esquema que Router expone en `GET /v2/models/higgsfield/hi } ``` - diff --git a/es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx b/es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx index cdbfe07643..3d12623fc0 100644 --- a/es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx +++ b/es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx @@ -2,13 +2,15 @@ title: "Usa Recraft V4.1 Utility Vector con Comfy Router" description: "Llama a recraft/recraftv4_1_utility_vector con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Recraft V4.1 Utility Vector" -translationSourceHash: b37b6af4 +translationSourceHash: d45af474 translationFrom: development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx translationBlockHashes: "_intro": cb8cd6d6 + "Quick start": 889594eb "Schema": a456e8b0 "Examples": 5c6fff21 --- + {/* GENERATED FILE. Generated from router-schemas/recraft/recraftv4_1_utility_vector.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -19,7 +21,7 @@ Referencia de la API para `recraft/recraftv4_1_utility_vector`, servida por Comf ## 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. +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:** `recraft/recraftv4_1_utility_vector` @@ -31,8 +33,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr ```python Python from comfy_sdk import Comfy -# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. +# 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( "recraft/recraftv4_1_utility_vector", @@ -48,8 +50,8 @@ print(result) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// The SDK automatically creates an idempotency key and reuses it for automatic retries. +// 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("recraft/recraftv4_1_utility_vector", { n: 1, prompt: "A single red maple leaf on a plain white background.", @@ -68,15 +70,15 @@ curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector \ -El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/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. +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/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 -# Reads COMFY_API_KEY from the environment. -# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +# 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( @@ -86,14 +88,14 @@ async def main(): "prompt": "A single red maple leaf on a plain white background.", }, ) - print("request_id:", handle.request_id) # with the model ID, all another process needs + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso - # Poll until the request completes, waiting the Retry-After the server names. + # 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) - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. + # El payload propio 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) @@ -104,39 +106,39 @@ asyncio.run(main()) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +// 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("recraft/recraftv4_1_utility_vector", { n: 1, prompt: "A single red maple leaf on a plain white background.", }); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso -// Poll until the request completes, waiting the Retry-After the server names. +// 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); } -// The same result models.run() returns. A request that failed or was cancelled rejects here. +// 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. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/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. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +# 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/recraft/recraftv4_1_utility_vector/requests/$REQUEST_ID/status \ -H "X-API-Key: $COMFY_API_KEY" -# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +# 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/recraft/recraftv4_1_utility_vector/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` @@ -153,9 +155,9 @@ curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests - Define el tono artístico de tu imagen. En un nivel simple, la persona mira directamente a la cámara con un estilo estático y limpio. Los niveles dinámicos y excéntricos introducen movimiento y creatividad. + Define el tono artístico de tu imagen. En un nivel simple, la persona mira directamente a la cámara con un estilo estático y limpio. Los niveles dinámico y excéntrico introducen movimiento y creatividad. - Rango: `0` a `5` + Alcance: `0` a `5` @@ -179,13 +181,13 @@ curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests - El modelo que se usará para generar (por ejemplo, "recraftv3"). Este campo NO está restringido a una enumeración: el proxy reenvía lo que envíe quien llama. Las grafías que incluye Comfy (el conjunto al que Comfy Router se refiere como `recraft/`) son recraftv2, recraftv3, recraftv4, recraftv4_pro, recraftv4_1, recraftv4_1_utility, recraftv4_1_pro, recraftv4_1_utility_pro, recraftv4_styles, recraftv4_styles_pro, recraftv4_1_vector, recraftv4_1_utility_vector, recraftv4_1_pro_vector, recraftv4_1_utility_pro_vector, recraftv4_styles_vector y recraftv4_styles_pro_vector. Se escriben aquí en lugar de nombrarlas por referencia porque nada referencia con `$ref` al componente RecraftGenerationModel que las declara, y por eso se elimina de la especificación que se sirve en GET /openapi, de modo que un puntero hacia él quedaría huérfano en el documento servido. Las cuatro grafías `recraftv4_styles*` además requieren `style_id`; consulta ese campo. + El modelo a usar para la generación (por ejemplo, "recraftv3"). Este campo NO está restringido a un enum: el proxy reenvía lo que envíe quien llama. Las grafías que Comfy distribuye, el conjunto al que Comfy Router se dirige como `recraft/`, son recraftv2, recraftv3, recraftv4, recraftv4_pro, recraftv4_1, recraftv4_1_utility, recraftv4_1_pro, recraftv4_1_utility_pro, recraftv4_styles, recraftv4_styles_pro, recraftv4_1_vector, recraftv4_1_utility_vector, recraftv4_1_pro_vector, recraftv4_1_utility_pro_vector, recraftv4_styles_vector y recraftv4_styles_pro_vector. Se escriben aquí en lugar de nombrarlas por referencia porque ningún elemento hace `$ref` al componente RecraftGenerationModel que las declara y, por lo tanto, se poda del spec que se sirve en GET /openapi, así que un puntero hacia él quedaría colgado en el documento servido. Las cuatro grafías `recraftv4_styles*` además requieren `style_id`. Consulta ese campo. - La cantidad de imágenes a generar. Recraft acepta de 1 a 6. + El número de imágenes a generar. Recraft acepta de 1 a 6. - Rango: `1` a `6` + Alcance: `1` a `6` @@ -201,14 +203,14 @@ curl https://api.comfy.org/v2/models/recraft/recraftv4_1_utility_vector/requests - El estilo que se aplicará a la imagen generada (por ejemplo, "digital_illustration") + El estilo a aplicar a la imagen generada (por ejemplo, "digital_illustration") - El ID de estilo que se aplicará a la imagen generada (por ejemplo, "123e4567-e89b-12d3-a456-426614174000"). Si se proporciona style_id, no se debería proporcionar style. Es REQUERIDO por los cuatro modelos `recraftv4_styles*`: Recraft los rechaza si no incluyen un style_id o una referencia de estilo. Crea uno con `POST /proxy/recraft/styles`, que este mismo proxy sirve con las mismas credenciales. Nada en esta ruta valida esa combinación: el cuerpo se reenvía a Recraft sin cambios, así que una llamada a `recraftv4_styles*` sin él llega al socio y regresa con un 4xx. + El ID de estilo a aplicar a la imagen generada (por ejemplo, "123e4567-e89b-12d3-a456-426614174000"). Si proporcionas style_id, no deberías proporcionar style. Los cuatro modelos `recraftv4_styles*` lo REQUIEREN: Recraft los rechaza si no llevan un style_id o una referencia de estilo. Genera uno con `POST /proxy/recraft/styles`, que este mismo proxy sirve con las mismas credenciales. Nada en esta ruta hace cumplir ese emparejamiento: el cuerpo se reenvía a Recraft sin cambios, así que una llamada a `recraftv4_styles*` sin él llega al socio y regresa con 4xx. -Generado a partir del esquema que Router sirve en `GET /v2/models/recraft/recraftv4_1_utility_vector/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/recraft/recraftv4_1_utility_vector/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -217,7 +219,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/recraft/recraf - Cantidad de créditos usados para la generación + Número de créditos usados para la generación @@ -225,7 +227,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/recraft/recraf - Datos de imagen codificados en base64 (presentes en lugar de `url` cuando la solicitud estableció `response_format: b64_json`) + Datos de imagen codificados en Base64 (presentes en lugar de `url` cuando la solicitud estableció `response_format: b64_json`) @@ -237,7 +239,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/recraft/recraf - El id de estilo resuelto, que Recraft devuelve cuando se usan referencias de estilo (en particular en los modelos con entrada requerida recraftv4_styles*); se puede reutilizar como `style_id` en solicitudes posteriores. + El id de estilo resuelto, que Recraft devuelve cuando se usan referencias de estilo (enparticular en los modelos con entrada requerida recraftv4_styles*); se puede reutilizar como `style_id` en solicitudes posteriores. ## Ejemplos diff --git a/es/development/comfy-router/models/veed/fabric-1-0/code.mdx b/es/development/comfy-router/models/veed/fabric-1-0/code.mdx index 1415b708da..8ee12afc2f 100644 --- a/es/development/comfy-router/models/veed/fabric-1-0/code.mdx +++ b/es/development/comfy-router/models/veed/fabric-1-0/code.mdx @@ -2,14 +2,15 @@ title: "Usa Fabric 1.0 con Comfy Router" description: "Llama a veed/fabric-1.0 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Fabric 1.0" -translationSourceHash: 8e2360a2 +translationSourceHash: 0d5557e0 translationFrom: development/comfy-router/models/veed/fabric-1-0/code.mdx translationBlockHashes: "_intro": c0f6ceff "Quick start": 2856fd42 - "Schema": 9ea03528 + "Schema": 17071210 "Examples": 952acc85 --- + {/* ARCHIVO GENERADO. Generado desde router-schemas/veed/fabric-1.0.json por `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/veed/fabric-1.0/requests/$REQUEST_ID \ ### Entrada - URL http(s) pública de la pista de voz a la que sincronizar los labios. El video dura lo mismo que el audio. + URL http(s) pública de la pista de voz con la que sincronizar los labios. El video dura lo mismo que el audio. Se rechaza con 400 cuando el audio supera el límite de entrada por llamada. @@ -174,7 +175,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/fabric-1.
- Créditos que VEED cobró por la tarea. Presente cuando la tarea está COMPLETED. + Créditos que VEED cobró por la tarea. Presente una vez que la tarea está COMPLETED. @@ -182,7 +183,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/fabric-1. - Información del fallo. Presente cuando la tarea está FAILED. + Información del fallo. Presente una vez que la tarea está FAILED. @@ -202,7 +203,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/fabric-1. - El contenido multimedia producido. Presente cuando la tarea está COMPLETED. Las rutas de video responden `video`, Clean Audio responde `audio` y Video Background Removal responde `files`. + El contenido multimedia producido. Presente una vez que la tarea está COMPLETED. Las rutas de video responden `video`, Clean Audio responde `audio` y Video Background Removal responde `files`. diff --git a/es/development/comfy-router/models/veed/lipsync-2-0/code.mdx b/es/development/comfy-router/models/veed/lipsync-2-0/code.mdx index 5f6ad5eb38..1ec3d42935 100644 --- a/es/development/comfy-router/models/veed/lipsync-2-0/code.mdx +++ b/es/development/comfy-router/models/veed/lipsync-2-0/code.mdx @@ -2,14 +2,15 @@ title: "Usa Lipsync 2.0 con Comfy Router" description: "Llama a veed/lipsync-2.0 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Lipsync 2.0" -translationSourceHash: 3d623f70 +translationSourceHash: 55607886 translationFrom: development/comfy-router/models/veed/lipsync-2-0/code.mdx translationBlockHashes: "_intro": 1fd676f1 "Quick start": 05550229 - "Schema": a26c8117 + "Schema": 24733e29 "Examples": 01527a02 --- + {/* GENERATED FILE. Generated from router-schemas/veed/lipsync-2.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -150,7 +151,7 @@ curl https://api.comfy.org/v2/models/veed/lipsync-2.0/requests/$REQUEST_ID \ ### Entrada - URL http(s) pública de la nueva pista de audio con la que sincronizar los labios del video. + URL http(s) pública de la nueva pista de audio con la que sincronizar los labios del video. Se rechaza con 400 cuando el audio supera el límite de entrada por llamada. diff --git a/es/development/comfy-router/models/veed/video-background-removal/code.mdx b/es/development/comfy-router/models/veed/video-background-removal/code.mdx index 8113ab8863..ef598f6b32 100644 --- a/es/development/comfy-router/models/veed/video-background-removal/code.mdx +++ b/es/development/comfy-router/models/veed/video-background-removal/code.mdx @@ -2,24 +2,26 @@ title: "Usa Video Background Removal con Comfy Router" description: "Llama a veed/video-background-removal con Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." sidebarTitle: "Video Background Removal" -translationSourceHash: 46f48b9f +translationSourceHash: c172f3a9 translationFrom: development/comfy-router/models/veed/video-background-removal/code.mdx translationBlockHashes: "_intro": c7197af8 + "Quick start": 685e5c3d "Schema": 3663e733 "Examples": d388ec6e --- + {/* GENERATED FILE. Generated from router-schemas/veed/video-background-removal.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; Referencia de API de `veed/video-background-removal`, servida por Comfy Router desde Veed. -**Entrada:** video · **Salida:** video +**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 por HTTP directo. +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:** `veed/video-background-removal` @@ -31,8 +33,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr ```python Python from comfy_sdk import Comfy -# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. +# 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( "veed/video-background-removal", @@ -50,8 +52,8 @@ print(result) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// The SDK automatically creates an idempotency key and reuses it for automatic retries. +// 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("veed/video-background-removal", { output_codec: "vp9", refine_foreground_edges: true, @@ -79,8 +81,8 @@ El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/veed/video-back import asyncio from comfy_sdk import AsyncComfy -# Reads COMFY_API_KEY from the environment. -# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +# 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( @@ -92,14 +94,14 @@ async def main(): "video_url": "https://static-assets.veed.io/api-examples/bg-v2v-input.mp4", }, ) - print("request_id:", handle.request_id) # with the model ID, all another process needs + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que otro proceso necesita - # Poll until the request completes, waiting the Retry-After the server names. + # 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) - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. + # 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) @@ -110,41 +112,41 @@ asyncio.run(main()) ```typescript TypeScript import { comfy } from "@comfyorg/sdk"; -// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +// 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("veed/video-background-removal", { output_codec: "vp9", refine_foreground_edges: true, subject_is_person: true, video_url: "https://static-assets.veed.io/api-examples/bg-v2v-input.mp4", }); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que otro proceso necesita -// Poll until the request completes, waiting the Retry-After the server names. +// 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); } -// The same result models.run() returns. A request that failed or was cancelled rejects here. +// 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. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. curl https://api.comfy.org/v2/models/veed/video-background-removal/requests \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"output_codec\": \"vp9\", \"refine_foreground_edges\": true, \"subject_is_person\": true, \"video_url\": \"https://static-assets.veed.io/api-examples/bg-v2v-input.mp4\"}" -# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +# 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/veed/video-background-removal/requests/$REQUEST_ID/status \ -H "X-API-Key: $COMFY_API_KEY" -# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +# 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/veed/video-background-removal/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` @@ -165,7 +167,7 @@ curl https://api.comfy.org/v2/models/veed/video-background-removal/requests/$REQ - Establécelo en falso cuando el sujeto no sea una persona. + Establece en false cuando el sujeto no sea una persona. @@ -209,7 +211,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veed/video-bac - Los medios producidos. Presente una vez que la tarea está COMPLETED. Las rutas de video responden `video`, Clean Audio responde `audio` y Video Background Removal responde `files`. + El contenido generado. Presente una vez que la tarea está COMPLETED. Las rutas de video responden `video`, Clean Audio responde `audio` y Video Background Removal responde `files`. diff --git a/es/development/comfy-router/queue.mdx b/es/development/comfy-router/queue.mdx index 99dcd34f0a..16c44b7c1a 100644 --- a/es/development/comfy-router/queue.mdx +++ b/es/development/comfy-router/queue.mdx @@ -13,9 +13,10 @@ translationBlockHashes: "Queue error responses": 01118a93 "Next": af716b3d --- -`POST /v2/models/{provider}/{model}` mantiene la conexión abierta hasta que el modelo termina. La entrega en cola usa el mismo ID de modelo y el mismo cuerpo de solicitud nativo, pero responde en cuanto Router ha admitido la ejecución. Recibes un `request_id` de inmediato y recuperas el resultado cuando está listo, desde el mismo proceso o desde otro. -**La ruta síncrona está limitada a 10 minutos.** El plazo predeterminado de Router se puede configurar por implementación. Una llamada síncrona que lo alcanza se corta con `504` / `deadline_exceeded`, sin importar si el proveedor sigue trabajando. Pon en cola una ejecución si puede superar el plazo o si quien llama no puede mantener una conexión abierta tanto tiempo. Consulta [Las llamadas se cortan en el plazo del servidor](/es/development/comfy-router/limitations#las-llamadas-se-cortan-por-un-plazo-límite-del-servidor) para saber qué te dice el plazo sobre la facturación y qué no. +`POST /v2/models/{provider}/{model}` mantiene la conexión abierta hasta que el modelo termina. La entrega en cola usa el mismo ID de modelo y el mismo cuerpo de solicitud nativo, pero responde en cuanto Router admite la ejecución. Recibes un `request_id` de inmediato y recoges el resultado cuando está listo, desde el mismo proceso o desde otro. + +**La ruta síncrona está limitada a 10 minutos.** El plazo predeterminado de Router es configurable en cada implementación. Una llamada síncrona que lo alcanza se corta con `504` / `deadline_exceeded`, sin importar si el proveedor sigue trabajando. Pon en cola una ejecución si puede superar el plazo o si quien llama no puede mantener una conexión abierta tanto tiempo. Consulta [Las llamadas se cortan en el plazo del servidor](/es/development/comfy-router/limitations#las-llamadas-se-cortan-por-un-plazo-límite-del-servidor) para saber qué te dice y qué no te dice el plazo sobre la facturación. Usa la cola cuando una generación pueda durar más que la conexión que puedes mantener, cuando una solicitud web tenga que responder de inmediato, cuando envíes en un proceso y recojas en otro, o cuando quieras muchas generaciones en curso a la vez. El orden, la admisión, los reintentos, los tiempos de espera, la facturación y la caducidad se deciden en el servidor. Los SDK solo añaden sondeo y comodidad de uso, nada más. @@ -53,29 +54,29 @@ Los dos IDs hacen falta en todas partes porque ambos direccionan la solicitud: l No hay eventos de progreso, webhooks ni niveles de prioridad: la ruta de estado es la forma de seguir una solicitud. La [referencia de la API](/es/development/comfy-router/reference#endpoints) contiene el contrato completo de cada ruta. -## Enviar y recoger una solicitud +## Submit and collect a request -Esto encola la misma solicitud que envía el [inicio rápido](/es/development/comfy-router/quickstart) y recoge la imagen. Primero exporta tu clave como `COMFY_API_KEY`. +This queues the same request the [quickstart](/development/comfy-router/quickstart) sends and collects the image. Export your key as `COMFY_API_KEY` first. ```python Python from comfy_sdk import Comfy -# Lee COMFY_API_KEY del entorno. -# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +# Reads COMFY_API_KEY from the environment. +# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. with Comfy() as client: handle = client.models.submit( "bfl/flux-2-pro", {"prompt": "a red teapot on a windowsill, morning light"}, ) - print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + print("request_id:", handle.request_id) # with the model ID, all another process needs - # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + # Poll until the request completes, waiting the Retry-After the server names. 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. + # The provider's own payload, the same value models.run() returns. + # A request that failed or was cancelled raises the typed Router error here. result = handle.get() print("image:", result["result"]["sample"]) @@ -84,20 +85,20 @@ print("image:", result["result"]["sample"]) ```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. +// Reads COMFY_API_KEY from the environment. +// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. type FluxResult = { result: { sample: string } }; const handle = await comfy.models.submit("bfl/flux-2-pro", { prompt: "a red teapot on a windowsill, morning light", }); -console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso +console.log("requestId:", handle.requestId); // with the model ID, all another process needs -// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +// Poll until the request completes, waiting the Retry-After the server names. 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í. +// The same result models.run() returns. A request that failed or was cancelled rejects here. const result = await handle.get(); if (result.kind !== "json") throw new Error("expected a JSON result"); @@ -107,30 +108,30 @@ console.log("image:", result.data.result.sample); ```bash cURL BASE="https://api.comfy.org/v2/models/bfl/flux-2-pro" -# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. curl "$BASE/requests" \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{"prompt": "a red teapot on a windowsill, morning light"}' -# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. REQUEST_ID="" curl -i "$BASE/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 ejecutándose. +# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. curl "$BASE/requests/$REQUEST_ID" -H "X-API-Key: $COMFY_API_KEY" -# 4. Cancela una solicitud que no ha terminado. Una petición, no una garantía. +# 4. Cancel a request that has not finished. A request, not a guarantee. curl -X PUT "$BASE/requests/$REQUEST_ID/cancel" -H "X-API-Key: $COMFY_API_KEY" ``` -Cada [página de modelo](/es/development/comfy-router/models) incluye esta forma para su propio modelo en **Poner en cola y recoger después**, junto al fragmento síncrono. +Every [model page](/development/comfy-router/models) carries this shape for its own model under **Queue and collect later**, beside the synchronous snippet. -### Seguir el progreso y recoger en una sola llamada +### Follow progress and collect in one call -Cuando sí quieres esperar pero también quieres mostrar el progreso, `subscribe` combina envío, consulta y recogida en una sola llamada: +When you do want to wait but also want to show progress, `subscribe` folds submit, poll and collect into one call: ```python Python @@ -157,11 +158,11 @@ const result = await comfy.models.subscribe( ``` -El tiempo de espera es un límite del lado del cliente, sin significado en el servidor. Cuando se agota, `subscribe` hace un intento de cancelación de mejor esfuerzo antes de lanzar. Una cancelación solo surte efecto en una solicitud que aún no ha empezado a ejecutarse: una generación que ya está en curso en el socio se completa y se cobra, la recoja alguien o no. Usa `submit` cuando la solicitud deba sobrevivir a quien la llama. +The timeout is a client-side bound with no server-side meaning. When it runs out, `subscribe` makes one best-effort cancel before raising. A cancel only takes effect on a request that has not started running: a generation already in flight at the partner completes and is charged whether or not anyone collects it. Use `submit` when the request should outlive the caller. -### Recoger desde otro proceso +### Collect from another process -Guarda el `request_id` junto al ID del modelo. Ambos son necesarios para reconstruir un handle, y no se hace ninguna llamada hasta que lo uses. +Store the `request_id` next to the model ID. Both are needed to rebuild a handle, and no call is made until you use it. ```python Python @@ -175,9 +176,9 @@ const result = await handle.get(); ``` -### Consultar el estado o cancelar +### Check status or cancel -`status()` es una sola consulta y devuelve el estado actual. `cancel()` pide al servidor que detenga una solicitud que no ha terminado. Es una petición, no una garantía: una ejecución que ya está en marcha en el socio puede completarse de todos modos, y el siguiente `status()` es lo que es cierto. +`status()` is one poll and returns the current state. `cancel()` asks the server to stop a request that has not finished. It is a request, not a guarantee: a run already on the wire at the partner may complete anyway, and the next `status()` is what is true. ```python Python @@ -195,9 +196,9 @@ await handle.cancel(); ``` -### Python asíncrono +### Async Python -`AsyncComfy` replica cada nombre, argumento y orden de argumentos. No existe `submit_async`, por la misma razón por la que no existe `run_async`. +`AsyncComfy` mirrors every name, argument and argument order. There is no `submit_async`, for the same reason there is no `run_async`. ```python from comfy_sdk import AsyncComfy @@ -212,13 +213,13 @@ async with AsyncComfy() as client: result = await handle.get() ``` -### Errores que lanzan los SDK +### Errors the SDKs raise -Una solicitud que terminó sin éxito se reporta como `COMPLETED` con un `error_type`. `get()` y `subscribe()` lo convierten en el error tipado de Router que corresponde al grupo: las clases de `comfy_sdk.router_exceptions` en Python, y `routerErrors.*` en TypeScript. El iterador de eventos no lanza en ese caso, porque es una vista del progreso de la cola: una finalización que lleva un `error_type` se entrega como la última observación, y es `get()` el que recoge. Un `403` `not_enabled` en el envío llega como `NotEnabled` y es terminal, así que los SDK no lo reintentan. +A request that finished without succeeding is reported as `COMPLETED` with an `error_type`. `get()` and `subscribe()` turn that into the typed Router error for the bucket: the classes in `comfy_sdk.router_exceptions` in Python, and `routerErrors.*` in TypeScript. The event iterator does not raise for that case, because it is a view of the queue's progress: a completion carrying an `error_type` is yielded as the last observation, and `get()` is what collects. A `403` `not_enabled` on submit arrives as `NotEnabled` and is terminal, so the SDKs do not retry it. ## Formas de respuesta de la cola -**Enviar, `201`.** En este punto, `status` siempre es `IN_QUEUE`. Las tres URL son absolutas y usan la misma clave que el envío para autenticarse. +**Enviar, `201`.** En este punto, `status` siempre es `IN_QUEUE`. Las tres URL son absolutas y se autentican con la misma clave que el envío. ```json { @@ -231,9 +232,9 @@ Una solicitud que terminó sin éxito se reporta como `COMPLETED` con un `error_ } ``` -`request_id` también es el valor del encabezado `X-Comfy-Request-Id` del envío. Mantén el ID del modelo junto a él: la solicitud se identifica por ambos. +`request_id` también es el valor del encabezado `X-Comfy-Request-Id` del envío. Guarda junto a él el ID del modelo: la solicitud se direcciona con ambos. -**Estado, `200`.** La misma forma, con el estado actual. `queue_position` cuenta las solicitudes que tienes por delante y llega a `0` cuando la ejecución está al frente. `Retry-After` en esta respuesta es la estimación de Router de cuándo merece la pena volver a consultar. Es una indicación, no un límite, y a una solicitud al final de la cola se le indica que espere más que a una que ya se está ejecutando. Consultar más rápido no permite enterarte antes de nada y consume tu propio margen de límite de velocidad. +**Estado, `200`.** La misma forma, con el estado actual. `queue_position` cuenta las solicitudes que tienes por delante y llega a `0` cuando la ejecución está al frente. El `Retry-After` de esta respuesta es la estimación de Router sobre cuándo merece la pena el viaje de ida y vuelta de volver a consultar. Es una pista, no un límite, y a una solicitud al final de la cola se le indica que espere más que a una que ya se está ejecutando. Consultar más rápido no te adelanta nada y consume tu propio cupo de límite de velocidad. ```json { @@ -246,7 +247,7 @@ Una solicitud que terminó sin éxito se reporta como `COMPLETED` con un `error_ } ``` -Una solicitud que finalizó sin éxito es `COMPLETED` con un `error_type`, que lleva la misma categoría general que la lectura del resultado asigna a `X-Comfy-Error-Type`. El campo está ausente en caso de éxito en lugar de ser `null`. +Una solicitud que terminó sin éxito es `COMPLETED` con un `error_type`, y lleva el mismo grupo genérico que la lectura del resultado pone en `X-Comfy-Error-Type`. En caso de éxito, el campo está ausente en lugar de ser `null`. ```json { @@ -259,34 +260,34 @@ Una solicitud que finalizó sin éxito es `COMPLETED` con un `error_type`, que l } ``` -**Resultado.** `200` contiene la salida nativa propia del modelo, byte por byte lo que la ruta síncrona devuelve para el mismo modelo y entrada, bajo el `Content-Type` propio del proveedor. Mientras la solicitud no ha finalizado, la lectura responde `202` con el cuerpo de estado anterior, de modo que un cliente que solo consulta la URL del resultado analiza un único tipo. Una solicitud fallida vuelve como una respuesta de error con `X-Comfy-Error-Type` establecido, las mismas categorías que la ruta síncrona. +**Resultado.** `200` lleva la salida nativa propia del modelo, byte por byte lo que devuelve la ruta síncrona para el mismo modelo y la misma entrada, con el `Content-Type` propio del proveedor. Mientras la solicitud no ha terminado, la lectura responde `202` con el cuerpo de estado anterior, de modo que un cliente que solo consulta la URL del resultado analiza un único tipo. Una solicitud que falló vuelve como una respuesta de error con `X-Comfy-Error-Type` establecido, con los mismos grupos que la ruta síncrona. -**Cancelar.** `202` con `CANCELLATION_REQUESTED` significa que la solicitud se aceptó, no que la ejecución se haya detenido. Una ejecución que ya está en curso en el socio puede completarse de todos modos, y una generación del socio que se completa se cobra tanto si alguien la recoge como si no. Consulta el estado después: una cancelación que surtió efecto aparece como `COMPLETED` con `error_type: cancelled`. Una solicitud que caducó antes de poder ejecutarse muestra `queue_timeout` de la misma manera. Una solicitud que ya había finalizado responde `409` con `ALREADY_COMPLETED`. +**Cancelar.** `202` con `CANCELLATION_REQUESTED` significa que la petición se aceptó, no que la ejecución se haya detenido. Una ejecución que ya está en curso en el socio puede completarse de todos modos, y una generación del socio que se completa se cobra, la recoja alguien o no. Lee el estado después: una cancelación que surtió efecto aparece como `COMPLETED` con `error_type: cancelled`. Una solicitud que caducó antes de poder ejecutarse muestra `queue_timeout` de la misma forma. Una solicitud que ya había terminado responde `409` con `ALREADY_COMPLETED`. ## Idempotencia y facturación -- **El mismo cargo que en la ruta síncrona.** Se te factura cuando el proveedor factura a Comfy. El tiempo de espera en la cola no se cobra. -- **Una `Idempotency-Key` por envío.** El SDK genera una clave nueva por cada llamada a `submit`, así que dos envíos deliberados de la misma entrada son dos solicitudes. Un reintento de la misma llamada con la misma clave no encola una segunda ejecución: devuelve el handle original con `Idempotent-Replayed: true`. Pasa tu propia clave cuando una respuesta perdida podría haberte costado el `request_id`. Consulta [Encabezados](/es/development/comfy-router/headers). -- **Los resultados caducan.** Una solicitud finalizada permanece disponible durante 24 horas después de completarse. Después de eso, las lecturas de estado y resultado responden `410` y el resultado desaparece. Recoge el resultado de inmediato y descarga las URL de recursos que incluya la salida. -- **Las consultas de sondeo también son solicitudes.** Las lecturas de estado y resultado cuentan para la [tasa de solicitudes por solicitante](/es/development/comfy-router/limitations#límite-de-tasa-de-solicitudes-por-solicitante). Respeta `Retry-After` en lugar de sondear a un intervalo corto fijo. +- **El mismo cargo que la ruta síncrona.** Se te factura cuando el proveedor factura a Comfy. El tiempo de espera en la cola no genera ningún cargo. +- **Una `Idempotency-Key` por envío.** El SDK genera una clave nueva por cada llamada a `submit`, así que dos envíos deliberados de la misma entrada son dos solicitudes. Un reintento de la misma llamada con la misma clave no encola una segunda ejecución: devuelve el identificador original con `Idempotent-Replayed: true`. Pasa tu propia clave cuando una respuesta perdida podría haberte costado el `request_id`. Consulta [Encabezados](/es/development/comfy-router/headers). +- **Los resultados caducan.** Una solicitud finalizada se conserva 24 horas después de completarse. Después de eso, las lecturas de estado y de resultado responden `410` y el resultado ya no existe. Recógelo pronto y descarga las URL de los recursos que incluya la salida. +- **Las consultas de sondeo también son solicitudes.** Las lecturas de estado y de resultado cuentan para el [límite de solicitudes por solicitante](/es/development/comfy-router/limitations#límite-de-tasa-de-solicitudes-por-solicitante). Respeta `Retry-After` en lugar de sondear con un intervalo corto fijo. ## Respuestas de error de la cola | Estado | `X-Comfy-Error-Type` | Significado | | --- | --- | --- | -| `402` | `insufficient_credits` | El espacio de trabajo no puede financiar la ejecución. No se encola ni se cobra nada, y puedes reenviar la misma `Idempotency-Key` una vez que se haya financiado. | -| `403` | `not_enabled` | Este solicitante no puede usar la cola: una clave sin un espacio de trabajo detrás (claves clásicas anteriores a los espacios de trabajo), una solicitud de bring-your-own-key, o un modelo que la cola no puede ejecutar. Es terminal para esa solicitud, no reintentes. | +| `402` | `insufficient_credits` | El espacio de trabajo no puede financiar la ejecución. No se encola ni se cobra nada, y puedes volver a enviar la misma `Idempotency-Key` una vez que tenga fondos. | +| `403` | `not_enabled` | Este solicitante no puede usar la cola: una clave sin un espacio de trabajo detrás (claves clásicas anteriores a los espacios de trabajo), una solicitud con tu propia clave (bring-your-own-key) o un modelo que la cola no puede ejecutar. Es terminal para esa solicitud, no reintentes. | | `404` | `model_not_found` | El ID `{provider}/{model}` no corresponde a ningún modelo de Router. | | `404` | `request_not_found` | No existe ninguna solicitud con ese ID para este solicitante y modelo. | -| `409` | `concurrency_limit_exceeded` | La misma `Idempotency-Key` todavía se está admitiendo. Espera el `Retry-After` y reenvía la misma clave para obtener el identificador original. | -| `409` | `invalid_input` | La `Idempotency-Key` está retenida para una solicitud diferente. Envía esta con una clave nueva. | +| `409` | `concurrency_limit_exceeded` | La misma `Idempotency-Key` todavía se está admitiendo. Espera el `Retry-After` y vuelve a enviar la misma clave para obtener el handle original. | +| `409` | `invalid_input` | La `Idempotency-Key` está reservada para una solicitud diferente. Envía esta con una clave nueva. | | `409` | `ALREADY_COMPLETED` en el cuerpo | Solo en la ruta de cancelación: la solicitud ya había finalizado, así que no había nada que cancelar. | -| `410` | | La solicitud existía y está fuera de su ventana de retención, 24 horas después de que se completó. Es permanente para ese ID. | +| `410` | | La solicitud existió y está fuera de su ventana de retención, 24 horas después de completarse. Es permanente para ese ID. | | `422` | `invalid_input` | El modelo rechazó la entrada. El cuerpo incluye el detalle por campo, exactamente como en la ruta síncrona. | -Cada respuesta de error incluye `X-Comfy-Request-Id`. Cítalo cuando contactes con soporte. +Todas las respuestas de error incluyen `X-Comfy-Request-Id`. Cítalo cuando contactes a soporte. -## Próximos pasos +## Siguiente -- [Errores y reintentos](/es/development/comfy-router/errors): consulta las respuestas de error y reintenta sin un segundo cargo. +- [Errores y reintentos](/es/development/comfy-router/errors): consulta las respuestas de error y reintenta sin un segundo cobro. - [Referencia de la API](/es/development/comfy-router/reference#endpoints): el contrato completo de cada ruta de la cola. diff --git a/es/development/comfy-router/reference.mdx b/es/development/comfy-router/reference.mdx index 970a45c97b..bbc44c6be0 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: 1b971d1c +translationSourceHash: aee933a1 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": fbcaaf0e - "Error buckets": 36170340 + "Endpoints": e0879d3c + "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 3ecabac6 - "Result assets": 65fc939b + "Pre-flight cost estimates": f0ba96a1 + "Result assets": 5936427c "Per-model input and output schemas": 61c6bde8 - "Schemas": 77cfa4db + "Schemas": c1245cc9 --- + {/* ARCHIVO GENERADO -- NO EDITAR A MANO. @@ -45,29 +46,29 @@ Consulta los IDs de modelo disponibles y los datos de facturación. Usa `next_cu Cursor de paginación opaco. - 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 - Cantidad de modelos que se devuelven en una página. + Cantidad de modelos a devolver en una página. - Hasta 100, Predeterminado: 20 + Hasta 100, valor predeterminado: 20 - El `ETag` que el solicitante conserva de un `200` anterior. + El `ETag` que el cliente conserva de una respuesta `200` anterior. **Respuestas** - OK: una página del catálogo de modelos. + OK - una página del catálogo de modelos. Cuerpo: [`RouterModelListResponse`](#routermodellistresponse) -- Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - 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,39 +86,37 @@ 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 o modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 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` - - -### `GET /v2/models/{provider}/{model}` +
### `GET /v2/models/{provider}/{model}` **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}`. + Parte 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, por ejemplo `anthropic`, hasta 64 caracteres - Parte del modelo en el ID de modelo canónico `{provider}/{model}`. + Parte 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, por ejemplo `claude-opus-4-6`, hasta 128 caracteres - El `ETag` que un llamador conserva de un `200` anterior. + El `ETag` que conserva quien llama de una respuesta `200` anterior. **Respuestas** @@ -125,67 +124,65 @@ 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 quien llama 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 quien llama ni para 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 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 está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - - -### `POST /v2/models/{provider}/{model}` + 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 mediante 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 de proveedor del 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, p. ej. `anthropic`, hasta 64 caracteres - Parte del modelo en el ID canónico `{provider}/{model}` del modelo. + Porción de modelo del 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, 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 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 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 `detail` que empieza por "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: un tramo cuyo traductor sí admite los medios continúa con normalidad; luego, cualquier proveedor alternativo en una solicitud que resolvió una credencial bring-your-own-key se rechaza con `409` con `detail` que empieza por `this request resolved a BYOK credential` (consulta esa respuesta), tanto si ese proveedor sirve este modelo como si no; luego, la compuerta propia del proveedor nombrado, que rechaza con `403` con `error_type: not_enabled` cuando ese proveedor no está habilitado para ti y con `503` con `error_type: service_unavailable` cuando la compuerta no se puede evaluar; y solo después de las cuatro se rechaza con `400` con `error_type: invalid_input` un proveedor real sin tramo para este modelo, la misma respuesta que 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`. @@ -195,11 +192,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 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 permanece activo; `false` lo desactiva. Una respuesta de fallback exitosa incluye `X-Comfy-Router-Fallback-Provider`. En una solicitud que resolvió una credencial 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: 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 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 un tramo 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,12 +205,10 @@ 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. - -**Respuestas** +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 con exactitud se descarta y se revela 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 campos del propio 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 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 seleccionan referencia a video). En el despacho nativo, la facturación de Seedance sigue los tipos de medios de `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 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. - - 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. +**Respuestas** + 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, lo que se registra en el log y nunca es silencioso), 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 con el `Content-Type` propio del socio en lugar de `application/json`; ramifica según el `Content-Type` de la respuesta y no supongas que hay 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` @@ -221,7 +216,7 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec 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` @@ -231,7 +226,7 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec - 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ó. + Una falla 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` @@ -249,9 +244,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 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 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: se rechaza `model_provider` cuando nombra un proveedor alternativo si 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 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 ocurre `concurrency_limit_exceeded`) @@ -261,53 +256,51 @@ 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 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 a que se abra la ventana de cupo. + Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa reducir las llamadas en curso; `rate_limited` significa esperar la ventana de cuota. 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` - 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` - Router no está disponible temporalmente. Reintenta con retroceso exponencial. + Router no está disponible temporalmente. Reintenta con retroceso. - 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 los 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`, `X-Comfy-Upstream-Status`, `Retry-After` - - -### `POST /v2/models/{provider}/{model}/estimate` +### `POST /v2/models/{provider}/{model}/estimate` **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. 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`. +Devuelve una estimación previa, en dólares estadounidenses, de lo que costará ejecutar este body en este modelo, con el precio de la misma tarifa contra la que se factura la ejecución (un modelo que se factura por el costo que reporta su proveedor se estima a partir de la lista de precios publicada por el 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. Primero se valida el body contra el esquema de entrada del modelo, tal como lo valida una ejecución predeterminada (sin `strict_mode` ni `reject_unknown_fields`), así que un body 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 cotiza 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á implementando gradualmente, 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. **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}`, es decir, el socio cuyo modelo se ejecuta. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, por ejemplo `anthropic`, de 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}`, es decir, 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, por ejemplo `claude-opus-4-6`, de hasta 128 caracteres @@ -318,92 +311,90 @@ 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 body 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) determinan qué se cotiza. **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 body de la estimación se rechazó contra el esquema del modelo, o nombraba un modelo distinto del de la ruta. - Cuerpo: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 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) - + Router no está disponible temporalmente. Reintenta con retroceso exponencial. -### `GET /v2/models/{provider}/{model}/openapi.json` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo en rechazos por capacidad) +### `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}`. + Parte 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}`. + Parte 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 solicitante 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 solicitante envió en `If-None-Match`. Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` @@ -411,55 +402,53 @@ 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 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 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` 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}/requests` + 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 regresa 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 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 abajo. **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 - 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 que se ejecuta dentro de ese proveedor. Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, por ejemplo `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. @@ -471,11 +460,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 declara, en lugar de aceptarlo; los campos anidados no se comprueban, y no se rechaza nada en un modelo cuyo esquema permite campos no declarados o que no tiene esquema definido, ni en un envío en cola hecho con `strict_mode=true`. Predeterminado: False @@ -484,81 +473,80 @@ 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`). +La entrada JSON nativa del modelo del socio, 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 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 a su propia tarifa; una imagen de primer fotograma de Seedance selecciona imagen a video y una imagen o un 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, 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 a 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 después; un cuerpo no estricto de proveedor alternativo además 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`). **Respuestas** Created: la ejecución se admitió en la cola. - Cuerpo: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- Encabezados: `X-Comfy-Request-Id`, `Idempotent-Replayed` + Body: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- Headers: `X-Comfy-Request-Id`, `Idempotent-Replayed` 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` 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` 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` - 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` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `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 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 síncrona. - 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` - 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. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando es `concurrency_limit_exceeded`) +Inspecciona `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original aún se está ejecutando, 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 los resuelve: `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 BYOK para el proveedor en la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Elimina `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`) - 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 envía de nuevo una vez que una de ellas termine; `rate_limited` significa que esperes la ventana de límite. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 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 para rechazos por capacidad) - + Router no está disponible temporalmente. Reintenta con retroceso exponencial. -### `GET /v2/models/{provider}/{model}/requests/{request_id}` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo rechazos por capacidad) +### `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 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 recolección. En una solicitud que ha finalizado correctamente, devuelve la salida nativa propia del modelo socio, byte por byte lo que el `200` de la ruta síncrona entrega 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 parser. **Parámetros** @@ -569,13 +557,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 a la que se dirige: 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 @@ -583,13 +571,13 @@ El endpoint de recogida. Sobre una solicitud que ha finalizado correctamente, de **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 para una solicitud que produjo uno, ya sea 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, y recurriendo a la respuesta sin procesar del proveedor alternativo si falla la traducción, lo que se registra en el log y nunca ocurre en silencio), la forma es la salida nativa propia 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 bajo el `Content-Type` propio del socio en lugar de `application/json`; ramifica según el `Content-Type` de la respuesta y no supongas 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-Credits-Used` - Aceptado: la solicitud aún no ha finalizado. + Aceptado: la solicitud no ha finalizado. Cuerpo: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Encabezados: `X-Comfy-Request-Id`, `Retry-After` @@ -601,71 +589,69 @@ 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 ni para este 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 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` - Router no está disponible temporalmente. Reintenta con un retroceso progresivo. + 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 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` - +### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` -### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` +**Solicita la cancelación de una solicitud enviada.** -**Solicitar 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 la petición se aceptó, 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 necesite 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, por ejemplo `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, por ejemplo `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 a la que se dirige la acción: 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 +681,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` @@ -707,88 +693,86 @@ Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una solicitud - 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` +### `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í 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 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. + 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 - La solicitud en cola que se quiere consultar: el `request_id` que devolvió el envío en su cuerpo. + La solicitud en cola que se va a consultar: el `request_id` que la entrega 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 en 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 llamador 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` - 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` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router no está disponible temporalmente. Reintenta con retroceso progresivo. + 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` - 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` + 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 [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 @@ -796,16 +780,16 @@ Categoría de error del Router legible por máquina, que también se envía en e ### Categorías a nivel de solicitud -Se generan para una solicitud que el Router aceptó y luego no pudo completar. +Se generan cuando el Router aceptó una solicitud y después no pudo completarla. | `error_type` | Significado | | --- | --- | -| `invalid_input` | La solicitud se rechazó antes de llegar al modelo: un cuerpo mal formado, un cursor de paginación mal formado o vencido, una entrada que el propio esquema del modelo no acepta, o un `Idempotency-Key` que no puede servir a esta solicitud (ya usado para una solicitud diferente, porque el método, la ruta y los parámetros de consulta, o el cuerpo difieren, o ya consumido por una llamada cuya respuesta no se puede reproducir). | +| `invalid_input` | La solicitud se rechazó antes de llegar al modelo: un cuerpo mal formado, un cursor de paginación mal formado o vencido, una entrada que el propio esquema del modelo no acepta, o un `Idempotency-Key` que no puede servir a esta solicitud (ya usado para una solicitud diferente, porque difieren el método, la ruta y la consulta, o el cuerpo; o ya consumido por una llamada cuya respuesta no se puede reproducir). | | `content_policy_violation` | El proveedor rechazó la solicitud por motivos de política de contenido. | | `provider_error` | El proveedor socio informó un fallo propio, o devolvió una respuesta que Router no pudo interpretar como resultado. | | `provider_timeout` | El proveedor socio no respondió dentro de su plazo. | | `insufficient_credits` | El espacio de trabajo que llama no tiene créditos suficientes para ejecutar el modelo. | -| `model_not_found` | El ID `{provider}/{model}` no nombra ningún modelo que Router pueda ejecutar: un proveedor desconocido, un id no enrolado, uno que el catálogo ya retiró después de su fecha de retiro, o un ID catalogado que el proveedor no sirve actualmente para Comfy. | +| `model_not_found` | El ID `{provider}/{model}` no identifica ningún modelo que Router pueda ejecutar: un proveedor desconocido, un id no inscrito, uno que el catálogo ya retiró después de su fecha de retiro, o un ID catalogado que el proveedor no sirve actualmente para Comfy. | ### Categorías a nivel de transporte @@ -819,13 +803,14 @@ Las genera el propio Router, antes de la llamada al modelo o en torno a ella. | `client_disconnected` | Quien llama cerró la conexión antes de que Router pudiera devolver un resultado. | | `internal_error` | El propio Router falló. | | `deadline_exceeded` | Comfy dejó de mantener la conexión en su propio límite configurado antes de que llegara una respuesta. | -| `not_enabled` | Comfy Router aún no está habilitado para quien llama. | +| `not_enabled` | Comfy Router aún no está activado para quien llama. | | `service_unavailable` | Un servicio del que depende Comfy Router no está disponible temporalmente y quien llama no hizo nada mal. | | `rate_limited` | Quien llama agotó un cupo medido sobre una ventana y debe esperar a que esa ventana avance. | | `cancelled` | Una solicitud en cola se retiró (mediante la ruta de cancelación o por un operador) antes de producir un resultado; es terminal y no constituye por sí misma una declaración sobre el cobro. | | `queue_timeout` | Una solicitud en cola esperó más allá de su tiempo de espera en cola sin llegar a ser admitida. | | `request_not_found` | El `request_id` no identifica ninguna solicitud de quien llama con este modelo. | | `queue_backlog_full` | Quien llama ya tiene demasiadas solicitudes en cola esperando ejecutarse, por lo que este envío se rechazó. | +| `result_expired` | La solicitud existió y finalizó, pero su resultado ya no se almacena, así que la operación de recogida no tiene nada que devolver. | ## Encabezados de respuesta @@ -955,14 +940,15 @@ Las genera el propio Router, antes de la llamada al modelo o en torno a ella. ## 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. 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 con la tarjeta de tarifas contra la que Comfy factura la ejecución, excepto un modelo que se factura por el costo que reporta su proveedor, que se calcula como `estimated` a partir de la lista de precios publicada por el proveedor. Toda 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 hecha 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. -Lee `source` antes de cualquier cantidad. Que falte una cifra nunca significa que sea gratis. +Lee `source` antes de cualquier cantidad. Una cifra faltante nunca significa que sea gratis. | `source` | Contiene | Cómo leerlo | | --- | --- | --- | | `exact` | `amount`, `amount_cents`, `credits` | Una estimación igual al cargo de este cuerpo con las tarifas de `pricing_as_of`; el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. | -| `estimated` | `min_amount`, `max_amount` y sus formas `_cents`, sin `amount` | Una estimación cuyo cargo depende de una cantidad que el proveedor reporta de vuelta y que el cuerpo acota; se espera que el cargo esté entre los límites, y el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. | +| `estimated` | `min_amount`, `max_amount` y sus formas `_cents`, sin `amount` | Una estimación cuyo cargo depende de una cantidad que el proveedor reporta de vuelta y que el cuerpo acota; se espera que el cargo esté entre esos límites, y el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. | +| `free` | `amount` "0", `amount_cents` y `credits` `0` | La tarjeta de tarifas valora esta solicitud en cero, así que la estimación es `0`; el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. Solo una cotización `free` se lee como `0`. | | `unknown` | `reason`, sin cifra | No se pudo dar un precio antes de la ejecución. Trata cualquier otro valor de `source` como `unknown`. | El `reason` de una estimación `unknown` es uno de los siguientes: @@ -982,12 +968,11 @@ 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. -- `pricing_as_of` indica cuándo se obtuvo la tarjeta de tarifas (o, cuando no se leyó ninguna, 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` 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 calcula el precio de 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 facturada 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 la tarjeta ni un calendario, es el momento en que 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`. -- 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. +- `/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 muestran 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; cuando eso importe, presupuesta con `amount` o `amount_cents`, no con `credits`. Ese encabezado sigue siendo la cifra posterior a una ejecución; los saldos están en la plataforma de Comfy. ## Recursos del resultado @@ -1000,7 +985,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. 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 llamada repetida pueden tener menos tiempo restante; repetirlas 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 de esas URL, un reintento con la misma clave recibe `409 invalid_input` en lugar de la respuesta grabada; una respuesta que ya estaba tan cerca de expirar cuando se sirvió sigue siendo repetible 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. @@ -1008,7 +993,9 @@ 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. -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. +**URL originales de BytePlus (Seedance 2.x, opcional).** Para un espacio de trabajo en el que Comfy haya habilitado esta opción en el 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 está habilitado por defecto. Estas URL expiran 24 horas después de la generación y desaparecen una vez que BytePlus las borra; en Seedance 2.5, BytePlus limita cada una a 100 descargas, y la copia propia del Router consume una. Cada una es una credencial al portador para su objeto: cualquiera que la tenga puede descargar el recurso hasta que expire. + +La copia se realiza 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. 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. @@ -1018,22 +1005,36 @@ 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 -### RouterChargesOnPolicyRejection +### RouterBilledWorkspace -Indica si un rechazo por política de contenido se cobra en este modelo. Trata un valor desconocido como potencialmente cobrado. +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`. -Tipo: `string` +**Campos** -### RouterCostEstimate + + El id del espacio de trabajo de Cloud. No aparece en la vía Clásica. + -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. 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`; `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`. + + `personal` o `team`. Es una cadena abierta: trata cualquier otro valor como `personal`. + + + + `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. No aparece en el caso de un espacio de trabajo de Cloud. +### RouterChargesOnPolicyRejection + +Indica si se cobra por un rechazo por política de contenido en este modelo. Trata un valor desconocido como potencialmente cobrado. + +Tipo: `string`### RouterCostEstimate + +Una estimación previa de lo que costará esta llamada, en dólares estadounidenses, calculada antes del despacho a partir de la misma tarjeta de tarifas con la que se factura la ejecución (o, en el caso de un modelo que se factura según el costo que reporta su proveedor, estimada a partir de la lista de precios publicada por el proveedor). No es el cargo final: el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es lo que pagas. `X-Comfy-Credits-Used`, que se reporta después de la ejecución, es una cifra redondeada calculada a posteriori, no un recibo. `source` indica cuánto puedes confiar en la cifra: `exact` incluye `amount`; `free` incluye `amount` "0" (la tarjeta de tarifas fija el precio de esta solicitud en cero); `estimated` incluye `min_amount` y `max_amount`, y ningún `amount`; `unknown` no incluye ninguno de los dos, sino un `reason`. Nunca interpretes un `amount` ausente como gratis. No es un bloqueo de precio: consulta `pricing_as_of`. **Campos** - `exact` | `estimated` | `unknown`; interpreta cualquier otro valor como `unknown`. Tanto `exact` como `estimated` etiquetan una estimación; ninguno es el cargo final. `unknown` no incluye ninguna cifra. + `exact` | `estimated` | `free` | `unknown`; interpreta cualquier otro valor como `unknown`. `exact` y `estimated` identifican una estimación; ninguno es el cargo final. `free` significa que la tarjeta de tarifas fija el precio de esta solicitud en cero, por lo que `amount` es "0". `unknown` no incluye ninguna cifra. @@ -1041,37 +1042,37 @@ 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". Presente solo cuando `source` es `exact`. 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 una cadena decimal, p. ej., "0.04", con hasta 8 decimales y sin exponente. Un precio facturable inferior a un centavo nunca aparece como "0"; solo una cotización `free` se lee como "0". Solo está presente cuando `source` es `exact` o `free`. No es el cargo final: el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. - 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 una cadena decimal. Es una estimación, no un mínimo garantizado: una llamada puede generar un cargo menor, por ejemplo, cuando el proveedor devuelve menos de lo solicitado (como ninguna imagen), cuando la estimación es un precio típico aprendido de llamadas anteriores o cuando el precio no aumenta de forma constante con la cantidad solicitada. Solo está presente 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 una cadena decimal. Es una estimación, no un máximo garantizado: una llamada puede generar un cargo mayor, por ejemplo, cuando el proveedor devuelve más de lo solicitado (como más imágenes de las pedidas), cuando la estimación proviene de un aprendizaje de llamadas anteriores o cuando el precio no aumenta de forma constante con la cantidad solicitada. Solo está presente 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 USD, sin redondear, para cálculos aritméticos. Está presente junto con `amount`. double - `min_amount` en centavos de dólar, sin redondear. Presente junto con `min_amount`. + `min_amount` en centavos de USD, sin redondear. Está presente junto con `min_amount`. double - `max_amount` en centavos de dólar. Presente junto con `max_amount`. + `max_amount` en centavos de USD. Está 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 `X-Comfy-Credits-Used` contenga 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. double @@ -1081,72 +1082,76 @@ Una estimación previa de cuánto costará esta llamada, en dólares estadounide - 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 pueda interpolarlo en esa ruta sin volver a derivarlo de nada. Su `pattern` está formado por `RouterProviderSegment` y `RouterModelSegment` unidos por una sola `/`, 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 + Tipo: [`RouterModelId`](#routermodelid): ID de modelo, p. ej. `anthropic/claude-opus-4-6`, hasta 193 caracteres - Cuándo se obtuvo la tabla 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 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 calculó el precio de esta cotizació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 según el costo que reporta su proveedor) lleva en su lugar la fecha en que se leyó esa lista. Una cotización cuya cantidad facturada se predice a partir de un calendario publicado por el proveedor y luego se tarifica 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 según 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 pueda tarificar con ninguna tarjeta), este valor es el momento en que 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`. - - -### RouterErrorResponse + Solo está presente 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 reporte el proveedor, o el cuerpo no acota una cantidad facturable), `unpriced_model` (la tarjeta de tarifas no asigna un 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 tarjeta de tarifas cuando se admitió la solicitud; esto es transitorio y la ejecución se sigue cobrando como de costumbre). Interpreta cualquier otro valor como `not_quotable`. +### RouterErrorResponse -Cuerpo de error para fallos de autenticación, acceso, búsqueda de modelos, cuota y transporte del proveedor. +Cuerpo de error para fallos de autenticación, acceso, búsqueda de modelo, cuota y transporte del proveedor. **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, apta para mostrarse a un usuario final. No está pensada para análisis automático: ramifica según `error_type` en su lugar. 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í es siempre un ID de catálogo activo al que se puede redirigir la llamada. Un modelo cuya fecha de fin de soporte aún 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 retirada 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 la categoría `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 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 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 diecinueve 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` y `queue_backlog_full`. «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 gruesa y 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 es cerrado y tiene 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 sea cerrado describe el conjunto tal como está documentado 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 ramificar de forma exhaustiva sobre la lista anterior y romperse con la siguiente 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; solo está presente cuando `error_type` es `invalid_input` y `X-Comfy-Upstream-Status` es un `4xx` o un `2xx` del proveedor, es decir, cuando el proveedor rechazó la solicitud por malformada y explicó por qué. Normalmente ese estado es un `4xx`; es un `2xx` en un proveedor que informa de una generación rechazada dentro de un sobre de éxito (una consulta de tarea fallida de BytePlus es HTTP `200` con el motivo en el 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 emita sobre sí mismo. Replica el encabezado `X-Comfy-Upstream-Detail`. - 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`. + Sobre qué entrada o salida versaba 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 nombró una modalidad. Solo está presente cuando `error_type` es `content_policy_violation` y el proveedor nombró el sujeto rechazado con un código legible por máquina; en caso contrario, está ausente. Nunca es texto del proveedor. Hoy se nombra en los rechazos de BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI y Wan, y en los rechazos de Gemini de los tramos 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`. -### RouterErrorType + + La rama de política de facturación para una denegación de gasto en un nodo socio: `no_funds` cuando la cartera facturada está vacía, `unspecified` cuando la llamada se rechazó sin una lectura de fondos que lo indique. Solo está presente cuando `error_type` es `insufficient_credits` y el despliegue informa de datos de la cartera; en caso contrario, está ausente. Es un código legible por máquina, no texto para mostrar: muestra `detail` y ramifica según este campo. + -Categoría de error del Router legible por máquina, que también se envía en el encabezado `X-Comfy-Error-Type`. + + La cartera que habría cobrado una llamada rechazada, en `RouterErrorResponse.billed_workspace`. Responde a la pregunta ¿qué cartera 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 cartera personal incluso mientras hay un equipo con fondos abierto. Solo está presente junto con `denied_reason`. -Tipo: `string` + Tipo: [`RouterBilledWorkspace`](#routerbilledworkspace) + -### RouterModelBilling + + Cómo se autenticó la solicitud rechazada: `personal_api_key`, `team_api_key`, `personal_session` o `team_session`. Responde a la pregunta ¿a qué credencial cambio para cobrar a la otra cartera?. No es un permiso y no concede nada. Solo está presente 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`. + +Tipo: `string`### RouterModelBilling Comportamiento de facturación que debes revisar 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. + 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. Por eso 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 incluye cuando el proveedor rechazó la salida generada del modelo y Comfy registró uso para esa generación rechazada, e incluye 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 incluyen; un rechazo sin el encabezado no se reporta, lo que 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. +### RouterModelDetail -Combina [`RouterModelListEntry`](#routermodellistentry) y [`RouterModelDetailFields`](#routermodeldetailfields). +Detalle por modelo de un modelo de Comfy Router: todo lo que informa el listado del catálogo para ese modelo, más los campos por modelo que solo incluye la ruta de modelo único. -Tipo: `object` +Compone [`RouterModelListEntry`](#routermodellistentry), [`RouterModelDetailFields`](#routermodeldetailfields). -### RouterModelDetailFields +Tipo: `object`### RouterModelDetailFields Campos opcionales que devuelve el endpoint de detalles del modelo. @@ -1155,64 +1160,54 @@ 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 - - -### RouterModelId - -El ID del modelo que se usa en `POST /v2/models/{provider}/{model}`. + URL HTTPS, p. ej. `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`, hasta 2048 caracteres +### RouterModelId -Tipo: `string`. ID del modelo, p. ej. `anthropic/claude-opus-4-6`. Hasta 193 caracteres. +El ID de modelo que se usa en `POST /v2/models/{provider}/{model}`. -### RouterModelInput +Tipo: `string`. ID de modelo, por ejemplo `anthropic/claude-opus-4-6`. Hasta 193 caracteres.### RouterModelInput El objeto de entrada del modelo. Consulta el documento OpenAPI del modelo seleccionado para ver los campos y la validación. -Tipo: `object` - -### RouterModelInputSchemaDocument +Tipo: `object`### RouterModelInputSchemaDocument Un documento OpenAPI independiente para la entrada y la salida de un modelo. -Tipo: `object` - -### RouterModelListEntry +Tipo: `object`### RouterModelListEntry 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 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 una sola `/`, y `maxLength` es la suma de ambos 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 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 del catálogo hacen referencia a este mismo esquema, y eso es lo que evita que los ID listados y los ID aceptados se desalineen. 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 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 del catálogo, por la misma razón de evitar desalineaciones que en `RouterProviderSegment`. Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - Datos de facturación por modelo que quien llama necesita antes de invocar, no precios. Las cifras de uso y de costo nunca aparecen aquí. + Datos de facturación por modelo que quien llama necesita antes de invocar; no son precios. Las cifras de uso y costo nunca aparecen aquí. Tipo: [`RouterModelBilling`](#routermodelbilling) - 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. - - -### RouterModelListResponse + 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** @@ -1223,101 +1218,81 @@ Una página del catálogo de modelos del Router. - 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 más allá de esta. Sigue avanzando mientras esto sea verdadero; no infieras 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 hacia una lista de Router. Lo produce el servidor y solo se usa de ida y vuelta: no es un offset, no es un ID de modelo, no está ordenado y no es estable entre reconstrucciones del catálogo, por lo que analizarlo, incrementarlo o persistirlo más allá del recorrido del que proviene quedan 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 eliminan entradas a mitad del recorrido, y quien llama no puede saber 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 por encima del máximo se ajusta al máximo en lugar de rechazarse, por lo que este puede ser menor que el valor solicitado: pagina con este número, no con el que enviaste, o asumirás filas que nunca recibiste. 1–100 - - -### RouterModelOutput +### RouterModelOutput El objeto de resultado del modelo. Consulta el esquema de salida del modelo seleccionado para conocer su forma exacta. -Tipo: `object` - -### RouterModelSegment +Tipo: `object`### RouterModelSegment -La parte del modelo de un ID de modelo `{provider}/{model}`. +La parte correspondiente al modelo en un ID de modelo `{provider}/{model}`. -Tipo: `string`. Slug alfanumérico, p. ej. `claude-opus-4-6`, de hasta 128 caracteres +Tipo: `string`. Slug alfanumérico, p. ej. `claude-opus-4-6`, de hasta 128 caracteres### RouterPageCursor -### RouterPageCursor +Un cursor opaco de catálogo. Devuélvelo sin cambios como `cursor`. -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### RouterProviderSegment -Tipo: `string`. Cursor opaco devuelto como `next_cursor`, de 1 a 512 caracteres. +La parte de proveedor de un ID de modelo `{provider}/{model}`. -### RouterProviderSegment +Tipo: `string` -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres### RouterQueueCancelResponse -La parte del proveedor de un ID de modelo `{provider}/{model}`. - -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 pregunta 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 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 separació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 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 - 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 pregunta 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. - -Tipo: `string` - -### RouterQueuePosition +### RouterQueueCancelStatus -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. +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, por lo que un cliente puede ramificar según cualquiera de los dos. -Tipo: `integer` -- Al menos 0 +Tipo: `string`### RouterQueuePosition -### RouterQueueRequestId +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. -Identificador de una solicitud de Router en cola: el identificador que usa quien llama para consultar, cancelar y recoger un resultado. +Tipo: `integer`. Al menos 0### RouterQueueRequestId -Tipo: `string` -- `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 +Identificador de una solicitud de Router en cola: el identificador con el que quien llama consulta, cancela y recoge un resultado. -### RouterQueueStatus +Tipo: `string` -- `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### 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 Router en cola. 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 dura una categoría no reconocida fallaría con más fuerza 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, se declare como enum o no. Por eso se declara como uno y la restricción se indica donde un cliente pueda verla. -Tipo: `string` +Tipo: `string`### RouterQueueStatusFields -### 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, la categoría 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 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 - 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 de Router en cola. 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 rígida una categoría no reconocida 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 todo bucle de sondeo escrito contra él, se declare como enum o no, así que se declara como uno, y la restricción se enuncia donde un cliente pueda verla. Tipo: [`RouterQueueStatus`](#routerqueuestatus) @@ -1329,20 +1304,16 @@ 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 lleva la misma categoría 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 aparte para ninguna de las dos), y está ausente en caso de éxito en lugar de ser null, así que ramifica según su presencia. Tipo: [`RouterErrorType`](#routererrortype) - - -### RouterQueueStatusResponse +### RouterQueueStatusResponse Estado actual de una solicitud en cola, compuesto con las mismas tres URL que devolvió el envío. Compone [`RouterQueueUrls`](#routerqueueurls), [`RouterQueueStatusFields`](#routerqueuestatusfields). -Tipo: `object` - -### RouterQueueSubmitFields +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. @@ -1351,11 +1322,11 @@ La mitad de `RouterQueueSubmitResponse` que no es el bloque de URL: la identidad Identificador de una solicitud de Router en cola: el identificador con el que un llamador 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 dura un grupo no reconocido fallaría con más fuerza justo cuando algo ya había ido mal. Este es un ciclo de vida, y añadir un cuarto estado más adelante a un ciclo de vida es un cambio incompatible para cada bucle de consulta escrito contra él, tanto si está declarado como enum como si no, así que se declara como uno y la restricción se indica donde un cliente puede verla. Tipo: [`RouterQueueStatus`](#routerqueuestatus) @@ -1367,91 +1338,79 @@ La mitad de `RouterQueueSubmitResponse` que no es el bloque de URL: la identidad - 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 al envío 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 ninguna 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 el definitivo. Tipo: [`RouterCostEstimate`](#routercostestimate) - - -### RouterQueueSubmitResponse +### 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 que se devuelve cuando una ejecución se admite en la cola: 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). +Compone [`RouterQueueUrls`](#routerqueueurls), [`RouterQueueSubmitFields`](#routerqueuesubmitfields). -Tipo: `object` +Tipo: `object`### RouterQueueUrls -### 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 dan acceso al 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. **Campos** - URL absoluta de la lectura de estado de esta solicitud. + URL absoluta para consultar el 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 - URL absoluta en la que se solicita una cancelación. + URL absoluta a la que se envía la solicitud de cancelación. URI - +### RouterValidationErrorContext -### RouterValidationErrorContext +Detalles proporcionados por el proveedor acerca de la regla de validación que falló. -Detalles proporcionados por el proveedor sobre la regla de validación que falló. +Tipo: `object`### RouterValidationErrorDetail -Tipo: `object` - -### RouterValidationErrorDetail - -Un fallo de validación a nivel de campo. +Un error 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 que provocó el error, con el segmento más externo primero; por ejemplo `["body", "image_url"]`, o `["body", "images", 0]`, donde un entero actúa como índice dentro de un arreglo. - Descripción legible para humanos de este fallo individual. + Descripción legible por humanos de este error individual. - 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áquinas de este error, transmitido desde el proveedor sin cambios. Este es el valor que una jerarquía de excepciones tipada del SDK usa para ramificar; `error_type` en el encabezado 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`, transportado tal cual desde el 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 es deliberadamente un objeto abierto: restringirlo a una lista fija de campos, o fusionarlo con la cadena `msg`, es exactamente 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 incluye 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 que provocó el error, devuelto tal cual para que quien llama pueda ver qué se rechazó sin volver a deducirlo a partir de `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 restringirlo a un objeto. No está presente cuando el proveedor no devuelve la entrada. Tipo: [`RouterValidationErrorInput`](#routervalidationerrorinput) - - -### RouterValidationErrorInput - -El valor de entrada rechazado, cuando el proveedor lo incluye. +### RouterValidationErrorInput -### RouterValidationErrorResponse +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. **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 cada campo con problemas. Tipo: array de [`RouterValidationErrorDetail`](#routervalidationerrordetail) diff --git a/es/development/comfyui-server/api-examples.mdx b/es/development/comfyui-server/api-examples.mdx index f99d134548..9445ccbc87 100644 --- a/es/development/comfyui-server/api-examples.mdx +++ b/es/development/comfyui-server/api-examples.mdx @@ -1,14 +1,16 @@ --- title: "Ejemplos de API" description: "Tres patrones comunes para llamar a la API de ComfyUI Server" -translationSourceHash: d728bf1f +translationSourceHash: 7cb0120b translationFrom: development/comfyui-server/api-examples.mdx translationBlockHashes: "_intro": 84518317 "Method 1: Submit and Forget (HTTP only)": 040a0a2d "Method 2: WebSocket + History (Monitor Completion)": ce4e5a84 + "Method 3: WebSocket with SaveImageWebsocket (Real-time Images)": e0bafb7d "Which Method Should I Use?": 95cec253 --- + Esta página muestra tres formas de interactuar con la API del servidor de ComfyUI, desde un envío HTTP simple hasta una integración completa con WebSocket y salida de imágenes en tiempo real. Todos los ejemplos usan el [flujo de trabajo predeterminado de SD1.5](https://github.com/Comfy-Org/ComfyUI/blob/master/script_examples) a modo de ilustración. Antes de usar la API, debes exportar tu flujo de trabajo en [formato API](/es/development/api-development/workflow-api-format). @@ -23,7 +25,7 @@ Todos los ejemplos usan el [flujo de trabajo predeterminado de SD1.5](https://gi Fuente: [`basic_api_example.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/script_examples/basic_api_example.py) -El enfoque más sencillo: envía un flujo de trabajo y no esperes los resultados. Es útil para tareas en las que envías y te olvidas, y revisas las salidas más tarde. +El enfoque más sencillo: envía un flujo de trabajo y no esperes los resultados. Es útil para tareas de tipo enviar y olvidar, en las que revisas las salidas más tarde. ```python """basic_api_example.py: envía un flujo de trabajo solo por HTTP.""" @@ -100,14 +102,14 @@ if __name__ == "__main__": --- -## Método 2: WebSocket + historial (monitorizar la finalización) +## Método 2: WebSocket + historial (supervisar la finalización) Fuente: [`websockets_api_example.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/script_examples/websockets_api_example.py) Usa WebSocket para esperar a que finalice la ejecución y luego obtén las salidas a través del endpoint `/history`. Este es el patrón recomendado para la mayoría de los casos de uso. ```python -"""websockets_api_example.py: monitorea la ejecución por WebSocket y descarga mediante /history.""" +"""websockets_api_example.py: supervisa la ejecución por WebSocket y descarga mediante /history.""" import websocket # pip install websocket-client import uuid @@ -158,7 +160,7 @@ def get_images(ws, prompt): if message["type"] == "executing": data = message["data"] if data["node"] is None and data["prompt_id"] == prompt_id: - break # Ejecución terminada + break # Ejecución finalizada # Los frames binarios son imágenes de vista previa, omítelos aquí continue @@ -213,10 +215,10 @@ if __name__ == "__main__": Fuente: [`websockets_api_example_ws_images.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/script_examples/websockets_api_example_ws_images.py) -Para los casos en los que no quieres que las imágenes se guarden en disco, usa el nodo `SaveImageWebsocket`. Las imágenes se entregan directamente mediante mensajes binarios del WebSocket. +Para escenarios en los que no quieras guardar las imágenes en disco, usa el nodo `SaveImageWebsocket`. Las imágenes llegan directamente mediante tramas binarias de WebSocket. ```python -"""websockets_api_example_ws_images.py — Receive images directly via WebSocket.""" +"""websockets_api_example_ws_images.py: Recibe imágenes directamente por WebSocket.""" import websocket # pip install websocket-client import uuid @@ -250,13 +252,13 @@ def get_images(ws, prompt): data = message["data"] if data["prompt_id"] == prompt_id: if data["node"] is None: - break # Execution done + break # Ejecución completada current_node = data["node"] else: - # Binary frame — image data from SaveImageWebsocket + # Trama binaria: datos de imagen de SaveImageWebsocket if current_node == "save_image_websocket_node": images_output = output_images.get(current_node, []) - # The first 8 bytes are type/meta, rest is image data + # Los primeros 8 bytes son tipo/meta, el resto son datos de imagen images_output.append(out[8:]) output_images[current_node] = images_output @@ -282,7 +284,7 @@ if __name__ == "__main__": print(f"Received {len(images)} image(s) via WebSocket.") - # Display (requires Pillow): + # Mostrar (requiere Pillow): # for image_data in images.get("save_image_websocket_node", []): # from PIL import Image # import io @@ -299,15 +301,15 @@ if __name__ == "__main__": ## ¿Qué método debería usar? - - **Envía y olvida.** Úsalo cuando no necesites resultados inmediatos o cuando puedas recuperar los resultados más tarde. + + **Envía y olvídate.** Úsalo cuando no necesites la salida de inmediato o cuando sea aceptable obtener los resultados más tarde. - - **RECOMENDADO.** Espera a que termine y luego descarga las salidas. El mejor equilibrio entre simplicidad y fiabilidad. + + **RECOMENDADO.** Espera a que termine y luego descarga las salidas. La mejor combinación de simplicidad y fiabilidad. - - **Imágenes en tiempo real.** Lo mejor para aplicaciones interactivas en las que quieres recibir imágenes sin escribir en disco. + + **Imágenes en tiempo real.** Ideal para aplicaciones interactivas en las que quieres recibir las imágenes sin escribir en disco. -Para ver la referencia completa de la API (endpoints, formatos de payload, manejo de errores), consulta las páginas [Server Routes](/es/development/comfyui-server/comms_routes) y [Server Messages](/es/development/comfyui-server/comms_messages). +Para consultar la referencia completa de la API (endpoints, formatos de payload y manejo de errores), revisa las páginas [Server Routes](/es/development/comfyui-server/comms_routes) y [Server Messages](/es/development/comfyui-server/comms_messages). diff --git a/es/development/comfyui-server/api-key-integration.mdx b/es/development/comfyui-server/api-key-integration.mdx index bea65d01b8..6e910a9ba0 100644 --- a/es/development/comfyui-server/api-key-integration.mdx +++ b/es/development/comfyui-server/api-key-integration.mdx @@ -10,6 +10,7 @@ translationBlockHashes: "Prerequisites": a15cafa5 "Related Documentation": 3596104a --- + A partir de [PR #8041](https://github.com/Comfy-Org/ComfyUI/pull/8041), ComfyUI permite usar directamente los Nodos asociados de pago integrados mediante la Clave API de tu cuenta de ComfyUI, sin necesidad de una interfaz de frontend específica (incluso puedes ejecutarlo sin frontend). Esto significa que puedes crear flujos de trabajo que combinen: @@ -36,12 +37,12 @@ Para usar tu Clave API de la cuenta de ComfyUI y llamar a los Nodos asociados de Debes asegurarte de que tu cuenta de ComfyUI tenga créditos suficientes para probar las funciones correspondientes. -Consulta la sección Créditos para aprender a Comprar créditos para tu cuenta +Consulta la sección Créditos para obtener información sobre cómo comprar créditos para tu cuenta. -## Ejemplo en Python +## Python Example -Aquí tienes un ejemplo de cómo enviar un flujo de trabajo que contiene Nodos asociados a la API de ComfyUI usando código Python: +Here is an example of how to send a workflow containing Partner Nodes to the ComfyUI API using Python code: ```python """Using Partner Nodes when running ComfyUI headless or with alternative frontend @@ -123,6 +124,6 @@ request.urlopen(req) ## Documentación relacionada -- [Descripción general de los Nodos asociados](https://docs.comfy.org/tutorials/partner-nodes/overview) +- [Descripción general de Nodos asociados](https://docs.comfy.org/tutorials/partner-nodes/overview) - [Gestión de la cuenta](https://docs.comfy.org/interface/user) - [Créditos](https://docs.comfy.org/interface/credits) diff --git a/es/development/comfyui-server/startup-flags.mdx b/es/development/comfyui-server/startup-flags.mdx index b2775ec68a..b913d3d558 100644 --- a/es/development/comfyui-server/startup-flags.mdx +++ b/es/development/comfyui-server/startup-flags.mdx @@ -18,13 +18,14 @@ translationBlockHashes: "Logging & Misc": 4d81c96d --- -ComfyUI acepta argumentos de línea de comandos cuando se inicia con `python main.py`. Esta página documenta todos los flags definidos en [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py). + +ComfyUI accepts command-line arguments when started with `python main.py`. This page documents every flag defined in [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py). - Los usuarios de **Windows Portable** pueden añadir flags a los archivos `.bat` de inicio (por ejemplo, `run_nvidia_gpu.bat`). Consulta la [guía de Windows Portable](/es/installation/comfyui_portable_windows) para ver los detalles. + **Windows Portable** users can add flags to the `.bat` launch files (for example, `run_nvidia_gpu.bat`). See the [Windows Portable guide](/installation/comfyui_portable_windows) for details. -Ejecuta `python main.py --help` en tu directorio de ComfyUI para ver el texto de ayuda integrado. Combina varios flags según necesites: +Run `python main.py --help` in your ComfyUI directory for the built-in help text. Combine multiple flags as needed: ```bash python main.py --listen 0.0.0.0 --port 8288 --disable-auto-launch --lowvram @@ -34,13 +35,13 @@ python main.py --listen 0.0.0.0 --port 8288 --disable-auto-launch --lowvram | Flag | Predeterminado | Descripción | |------|---------|-------------| -| `--listen` `[IP]` | `127.0.0.1` | Dirección IP en la que escuchar. Se admite una lista separada por comas (p. ej. `127.2.2.2,127.3.3.3`). Si se indica sin valor, toma `0.0.0.0,::` por defecto (todas las interfaces IPv4 e IPv6). | +| `--listen` `[IP]` | `127.0.0.1` | Dirección IP en la que escuchar. Se admite una lista separada por comas (por ejemplo, `127.2.2.2,127.3.3.3`). Si se indica sin valor, el predeterminado es `0.0.0.0,::` (todas las interfaces IPv4 e IPv6). | | `--port` | `8188` | Puerto en el que escuchar. | -| `--tls-keyfile` `PATH` | Ninguno | Ruta al archivo de clave TLS (SSL). Habilita HTTPS. Requiere `--tls-certfile`. | -| `--tls-certfile` `PATH` | Ninguno | Ruta al archivo de certificado TLS (SSL). Habilita HTTPS. Requiere `--tls-keyfile`. | -| `--enable-cors-header` `[ORIGIN]` | deshabilitado | Habilita CORS. Origen opcional, o `*` para todos los orígenes cuando no se indica un valor. | +| `--tls-keyfile` `PATH` | — | Ruta al archivo de clave TLS (SSL). Habilita HTTPS. Requiere `--tls-certfile`. | +| `--tls-certfile` `PATH` | — | Ruta al archivo de certificado TLS (SSL). Habilita HTTPS. Requiere `--tls-keyfile`. | +| `--enable-cors-header` `[ORIGIN]` | disabled | Habilita CORS. Origen opcional, o `*` para todos los orígenes cuando no se indica ningún valor. | | `--max-upload-size` | `100` | Tamaño máximo de subida en MB. | -| `--enable-compress-response-body` | deshabilitado | Habilita la compresión del cuerpo de la respuesta HTTP. | +| `--enable-compress-response-body` | disabled | Habilita la compresión del cuerpo de la respuesta HTTP. | ```bash @@ -57,26 +58,26 @@ python main.py --port 8443 --tls-keyfile key.pem --tls-certfile cert.pem ## Directorios -| Opción | Predeterminado | Descripción | +| Flag | Predeterminado | Descripción | |------|---------|-------------| -| `--base-directory` `PATH` | Raíz de ComfyUI | Directorio base para los directorios de modelos, custom_nodes, entrada, salida, temp y usuario. | -| `--models-directory` `PATH` | Raíz de ComfyUI/models | Directorio de modelos. Anula la carpeta de modelos en `--base-directory`. | +| `--base-directory` `PATH` | Raíz de ComfyUI | Directorio base para las carpetas models, custom_nodes, input, output, temp y user. | +| `--models-directory` `PATH` | ComfyUI root/models | Directorio de modelos. Reemplaza la carpeta models de `--base-directory`. | | `--extra-model-paths-config` `PATH` | — | Carga uno o más archivos `extra_model_paths.yaml`. Se puede especificar varias veces. | -| `--output-directory` `PATH` | — | Directorio de salida. Anula `--base-directory`. | -| `--temp-directory` `PATH` | — | Directorio temporal. Anula `--base-directory`. | -| `--input-directory` `PATH` | — | Directorio de entrada. Anula `--base-directory`. | -| `--user-directory` `PATH` | — | Directorio de usuario (ruta absoluta). Anula `--base-directory`. La ruta debe existir y ser legible. | +| `--output-directory` `PATH` | — | Directorio de salida. Reemplaza `--base-directory`. | +| `--temp-directory` `PATH` | — | Directorio temporal. Reemplaza `--base-directory`. | +| `--input-directory` `PATH` | — | Directorio de entrada. Reemplaza `--base-directory`. | +| `--user-directory` `PATH` | — | Directorio de usuario (ruta absoluta). Reemplaza `--base-directory`. La ruta debe existir y ser legible. | -## Inicio y navegador +## Launch & Browser -| Flag | Predeterminado | Descripción | +| Flag | Default | Description | |------|---------|-------------| -| `--auto-launch` | deshabilitado | Abre ComfyUI automáticamente en el navegador predeterminado al iniciar. | -| `--disable-auto-launch` | deshabilitado | Deshabilita la apertura automática del navegador. | -| `--windows-standalone-build` | deshabilitado | Modo de comodidad de la compilación portable de Windows. Habilita la apertura automática al iniciar (equivale a `--auto-launch`) y activa el sistema de recursos. | +| `--auto-launch` | disabled | Automatically open ComfyUI in the default browser on startup. | +| `--disable-auto-launch` | disabled | Disable auto-launching the browser. | +| `--windows-standalone-build` | disabled | Windows portable build convenience mode. Enables auto-launch on startup (equivalent to `--auto-launch`) and turns on the assets system. | - `--windows-standalone-build` establece `auto_launch` en `true` y habilita el sistema de recursos. `--disable-auto-launch` anula la apertura del navegador y `--disable-assets` anula el sistema de recursos. Para ejecutar como servidor sin abrir un navegador, usa `--disable-auto-launch`. + `--windows-standalone-build` sets `auto_launch` to `true` and enables the assets system. `--disable-auto-launch` overrides the browser launch and `--disable-assets` overrides the assets system. To run as a server without opening a browser, use `--disable-auto-launch`. ```bash @@ -86,14 +87,14 @@ python main.py --disable-auto-launch ## Dispositivos y CUDA -| Flag | Predeterminado | Descripción | +| Opción | Predeterminado | Descripción | |------|---------|-------------| -| `--cuda-device` `DEVICE_ID` | Ninguno | IDs de dispositivo CUDA que se usarán, separados por comas (p. ej. `0` o `0,1`), o `all` para conservar todos los dispositivos visibles en ese momento. Los demás dispositivos quedan ocultos. | -| `--default-device` `ID` | Ninguno | ID del dispositivo predeterminado. Todos los demás dispositivos permanecen visibles. | -| `--cuda-malloc` | automático (torch 2.0+) | Habilita cudaMallocAsync. Es mutuamente excluyente con `--disable-cuda-malloc`. | -| `--disable-cuda-malloc` | Ninguno | Deshabilita cudaMallocAsync. Es mutuamente excluyente con `--cuda-malloc`. | -| `--directml` `[DEVICE]` | Ninguno | Usa torch-directml. Índice de dispositivo opcional; si no se indica un valor, se usa `-1` de forma predeterminada. | -| `--oneapi-device-selector` `STRING` | Ninguno | Cadena selectora de dispositivo oneAPI para dispositivos Intel. | +| `--cuda-device` `DEVICE_ID` | — | IDs de dispositivos CUDA que se deben usar, separados por comas (p. ej. `0` o `0,1`), o `all` para mantener visibles todos los dispositivos visibles actualmente. Los demás dispositivos quedan ocultos. | +| `--default-device` `ID` | — | ID del dispositivo predeterminado. Todos los demás dispositivos permanecen visibles. | +| `--cuda-malloc` | Automático (torch 2.0+) | Activa cudaMallocAsync. Es mutuamente excluyente con `--disable-cuda-malloc`. | +| `--disable-cuda-malloc` | — | Desactiva cudaMallocAsync. Es mutuamente excluyente con `--cuda-malloc`. | +| `--directml` `[DEVICE]` | — | Usa torch-directml. Índice de dispositivo opcional; toma el valor `-1` cuando no se especifica ninguno. | +| `--oneapi-device-selector` `STRING` | — | Cadena selectora de dispositivo oneAPI para dispositivos Intel. | En Windows, ComfyUI usa solo la GPU 0 de forma predeterminada. Para restaurar todas las GPU, pasa `--cuda-device all`. @@ -102,7 +103,7 @@ python main.py --disable-auto-launch ## Precisión e inferencia - Los flags de los grupos **Global**, **UNET**, **VAE** y **Text Encoder** que aparecen a continuación son mutuamente excluyentes dentro de cada grupo. Solo puedes usar un flag por grupo a la vez. + Los flags de los grupos **Global**, **UNET**, **VAE** y **Text Encoder** que aparecen a continuación son mutuamente excluyentes dentro de cada grupo. Solo se puede usar un flag por grupo a la vez. ### Punto flotante global @@ -116,18 +117,18 @@ python main.py --disable-auto-launch | Flag | Descripción | |------|-------------| -| `--fp32-unet` | Ejecuta el modelo de difusión en fp32. | -| `--fp64-unet` | Ejecuta el modelo de difusión en fp64. | -| `--bf16-unet` | Ejecuta el modelo de difusión en bf16. | -| `--fp16-unet` | Ejecuta el modelo de difusión en fp16. | -| `--fp8_e4m3fn-unet` | Almacena los pesos de UNET en fp8 (e4m3fn). | -| `--fp8_e5m2-unet` | Almacena los pesos de UNET en fp8 (e5m2). | -| `--fp8_e8m0fnu-unet` | Almacena los pesos de UNET en fp8 (e8m0fnu). | - -Cada sufijo de flag de FP8 indica un formato de coma flotante de 8 bits de la especificación FP8 de la industria (ONNX / OCP): +| `--fp32-unet` | Ejecuta el modelo de diffusion en fp32. | +| `--fp64-unet` | Ejecuta el modelo de diffusion en fp64. | +| `--bf16-unet` | Ejecuta el modelo de diffusion en bf16. | +| `--fp16-unet` | Ejecuta el modelo de diffusion en fp16. | +| `--fp8_e4m3fn-unet` | Almacena los pesos de la UNet en fp8 (e4m3fn). | +| `--fp8_e5m2-unet` | Almacena los pesos de la UNet en fp8 (e5m2). | +| `--fp8_e8m0fnu-unet` | Almacena los pesos de la UNet en fp8 (e8m0fnu). | + +Cada sufijo de flag FP8 nombra un formato de punto flotante de 8 bits de la especificación FP8 de la industria (ONNX / OCP): - **e4m3fn**: 4 bits de exponente, 3 bits de mantisa. Buen equilibrio entre precisión y alcance para los pesos del modelo en GPU NVIDIA Ada Lovelace y posteriores. - **e5m2**: 5 bits de exponente, 2 bits de mantisa. Mayor rango dinámico pero menor precisión que e4m3fn. Útil cuando las magnitudes de los pesos varían mucho. -- **e8m0fnu**: 8 bits de exponente, 0 bits de mantisa. Máximo rango dinámico sin precisión fraccionaria. Normalmente se usa como factor de escala por bloques (solo potencias de dos). +- **e8m0fnu**: 8 bits de exponente, 0 bits de mantisa. Rango dinámico máximo sin precisión fraccionaria. Suele usarse como factor de escala de bloque (solo potencias de dos). ### Precisión de VAE @@ -155,7 +156,7 @@ Consulta la sección [Precisión de UNET](#precisión-de-unet) para ver la expli | Flag | Predeterminado | Descripción | |------|---------|-------------| | `--fp16-intermediates` | deshabilitado | Experimental: usa fp16 para los tensores intermedios entre nodos en lugar de fp32. | -| `--force-channels-last` | deshabilitado | Fuerza el formato de memoria de canales al final durante la inferencia. | +| `--force-channels-last` | deshabilitado | Forzar el formato de memoria de los canales al final durante la inferencia. | | `--supports-fp8-compute` | deshabilitado | Actúa como si el dispositivo admitiera cómputo fp8. | | `--enable-triton-backend` | deshabilitado | Habilita el backend Triton en comfy-kitchen. Deshabilitado de forma predeterminada al iniciar. | | `--disable-triton-backend` | deshabilitado | Fuerza la deshabilitación del backend Triton de comfy-kitchen, anulando `--enable-triton-backend`. | @@ -164,7 +165,7 @@ Consulta la sección [Precisión de UNET](#precisión-de-unet) para ver la expli | Flag | Predeterminado | Descripción | |------|---------|-------------| -| `--preview-method` | `none` | Método de vista previa para nodos sampler. Opciones: `none`, `auto`, `latent2rgb`, `taesd`. | +| `--preview-method` | `none` | Método de vista previa para los nodos sampler. Opciones: `none`, `auto`, `latent2rgb`, `taesd`. | | `--preview-size` | `512` | Tamaño máximo de la vista previa de imagen en píxeles. | ## Caché @@ -175,37 +176,37 @@ Consulta la sección [Precisión de UNET](#precisión-de-unet) para ver la expli | Flag | Predeterminado | Descripción | |------|---------|-------------| -| `--cache-ram` `[GB] [GB]` | habilitado (modo predeterminado) | Caché por presión de RAM. Primer valor: umbral de caché activa en GB. Segundo valor opcional: umbral de caché inactiva/anclaje en GB. Si no se dan valores: activa = 10 % de la RAM del sistema (mín. 2 GB, máx. 10 GB); inactiva = 100 % de la RAM del sistema (máx. 128 GB). Acepta como máximo dos valores. | -| `--cache-classic` | — | Usa el antiguo estilo de caché agresiva. | +| `--cache-ram` `[GB] [GB]` | habilitado (modo predeterminado) | Caché por presión de RAM. Primer valor: umbral de la caché activa en GB. Segundo valor opcional: umbral de la caché inactiva/anclaje en GB. Cuando no se indican valores: activa = 10 % de la RAM del sistema (mín. 2 GB, máx. 10 GB); inactiva = 100 % de la RAM del sistema (máx. 128 GB). Acepta como máximo dos valores. | +| `--cache-classic` | - | Usa el antiguo estilo de caché agresivo. | | `--high-ram` | deshabilitado | Puede mejorar ligeramente el rendimiento en sistemas con abundante RAM o donde se prefiere usar el archivo de paginación antes que recargar modelos. También habilita la caché clásica. | -| `--cache-lru` `N` | `0` (deshabilitado) | Caché LRU con un máximo de N resultados de nodo en caché. Sin límite superior estricto; está acotada por la RAM/VRAM disponible. Puede usar más RAM/VRAM. | -| `--cache-none` | — | Menor uso de RAM/VRAM; vuelve a ejecutar cada nodo en cada ejecución. | +| `--cache-lru` `N` | `0` (deshabilitado) | Caché LRU con un máximo de N resultados de nodos en caché. Sin límite superior estricto; está limitada por la RAM/VRAM disponible. Puede usar más RAM/VRAM. | +| `--cache-none` | - | Menor uso de RAM/VRAM; vuelve a ejecutar cada nodo en cada ejecución. | - ComfyUI reutiliza los resultados de nodo en caché entre ejecuciones de la misma sesión, y eso es lo que hace más rápidas las ejecuciones repetidas. Usa `--cache-none` cuando prefieras que cada ejecución comience con una caché limpia, por ejemplo mientras depuras un flujo de trabajo o descartas la reutilización de la caché entre ejecuciones. Cada nodo se vuelve a ejecutar, así que las generaciones tardan más. Es un flag de inicio, por lo que debes reiniciar ComfyUI para que tenga efecto. + ComfyUI reutiliza los resultados de nodos en caché entre ejecuciones de la misma sesión, y eso es lo que hace más rápidas las ejecuciones repetidas. Usa `--cache-none` cuando prefieras que cada ejecución comience con una caché limpia, por ejemplo, mientras depuras un flujo de trabajo o descartas la reutilización de la caché entre ejecuciones. Cada nodo se vuelve a ejecutar, así que las generaciones tardan más. Es un flag de inicio, así que reinicia ComfyUI para que surta efecto. ## Atención - Las flags de método de atención cruzada son mutuamente excluyentes. La atención dividida y la atención quad se ignoran cuando se usa xformers. + Los flags de método de atención cruzada son mutuamente excluyentes. Las atenciones split y quad se ignoran cuando se usa xformers. | Flag | Descripción | |------|-------------| -| `--use-split-cross-attention` | Usar la optimización de atención cruzada dividida. | +| `--use-split-cross-attention` | Usar la optimización de atención cruzada split. | | `--use-quad-cross-attention` | Usar la optimización de atención cruzada subcuadrática. | | `--use-pytorch-cross-attention` | Usar la atención cruzada de PyTorch 2.0. | -| `--use-sage-attention` | Usar la atención Sage. | +| `--use-sage-attention` | Usar Sage attention. | | `--use-flash-attention` | Usar FlashAttention. | | `--use-ck-attention` | Usar la atención de Comfy Kitchen. Requiere soporte de hardware para sus kernels INT8. | -| `--disable-xformers` | Desactivar xformers. | -| `--force-upcast-attention` | Forzar el upcasting de atención. Reporta si esto soluciona las imágenes negras. Es mutuamente excluyente con `--dont-upcast-attention`. | -| `--dont-upcast-attention` | Desactivar todo el upcasting de atención. Solo para depuración. | +| `--disable-xformers` | Deshabilitar xformers. | +| `--force-upcast-attention` | Forzar el upcasting de atención. Reportar si esto soluciona las imágenes negras. Mutuamente excluyente con `--dont-upcast-attention`. | +| `--dont-upcast-attention` | Deshabilitar todo el upcasting de atención. Solo para depuración. | ## VRAM y memoria -La descarga asíncrona de pesos está activada por defecto en GPU Nvidia y AMD, y la VRAM dinámica se habilita automáticamente donde es compatible. Los flags siguientes anulan esos valores predeterminados. +La descarga asíncrona de pesos está habilitada de forma predeterminada en GPUs Nvidia y AMD, y el VRAM dinámico se habilita automáticamente donde es compatible. Los flags siguientes anulan esos valores predeterminados. Los flags de modo de VRAM (`--gpu-only`, `--highvram`, `--lowvram`, `--novram`, `--cpu`) son mutuamente excluyentes. @@ -215,35 +216,35 @@ La descarga asíncrona de pesos está activada por defecto en GPU Nvidia y AMD, |------|---------|-------------| | `--gpu-only` | — | Almacena y ejecuta todo en la GPU (codificadores de texto, CLIP, etc.). | | `--highvram` | — | Mantiene los modelos en la memoria de la GPU en lugar de descargarlos a la CPU después de usarlos. | -| `--lowvram` | — | No tiene efecto cuando la VRAM dinámica está habilitada. De lo contrario, ejecuta los codificadores de texto en la CPU. | +| `--lowvram` | — | No tiene efecto cuando el VRAM dinámico está habilitado. De lo contrario, ejecuta los codificadores de texto en la CPU. | | `--novram` | — | Uso mínimo de VRAM cuando `--lowvram` no es suficiente. | | `--cpu` | — | Usa la CPU para todo (lento). | -| `--reserve-vram` `GB` | Depende del sistema operativo | VRAM en GB que se reserva para el sistema operativo y otro software. | -| `--vram-headroom` `GB` | `0` | VRAM adicional en GB que la VRAM dinámica mantiene libre por encima del margen predeterminado. ComfyUI intenta mantener esa cantidad de VRAM completamente libre y sin usar, incluso contando la VRAM que usan otras aplicaciones. | -| `--disable-nvml-pressure` | deshabilitado | Usa CUDA en lugar de NVML para reportar la presión de memoria de la VRAM dinámica. | -| `--async-offload` `[NUM_STREAMS]` | habilitado en Nvidia y AMD | Descarga asíncrona de pesos. Cantidad de streams opcional (predeterminado: 2). | +| `--reserve-vram` `GB` | Depende del SO | VRAM en GB que se reserva para el SO y otro software. | +| `--vram-headroom` `GB` | `0` | VRAM extra en GB que el VRAM dinámico mantiene libre por encima del margen predeterminado. ComfyUI intenta mantener esa cantidad de VRAM totalmente libre y sin usar, incluso contando la VRAM que usan otras aplicaciones. | +| `--disable-nvml-pressure` | deshabilitado | Usa CUDA en lugar de NVML para reportar la presión de memoria del VRAM dinámico. | +| `--async-offload` `[NUM_STREAMS]` | habilitado en Nvidia y AMD | Descarga asíncrona de pesos. Cantidad opcional de streams (predeterminado: 2). | | `--disable-async-offload` | — | Deshabilita la descarga asíncrona de pesos. | -| `--disable-dynamic-vram` | — | Deshabilita la VRAM dinámica; usa la carga de modelos basada en estimaciones. | -| `--enable-dynamic-vram` | automático en Nvidia, ROCm 7.14+ | Habilita la VRAM dinámica en sistemas donde no está habilitada por defecto. | -| `--fast-disk` | falso | Fuerza la carga y descarga dinámicas respaldadas por disco en lugar de la RAM no fijada. Útil con NVMe rápido. Cuando no se establece ni este flag ni `--disable-fast-disk`, la carga y descarga respaldadas por disco se habilitan automáticamente si todos los archivos de modelos están en almacenamiento detectado como rápido. | -| `--disable-fast-disk` | deshabilitado | Deshabilita la carga y descarga dinámicas respaldadas por disco, de modo que se usa la RAM no fijada en su lugar. Anula `--fast-disk` y la detección automática. | +| `--disable-dynamic-vram` | — | Deshabilita el VRAM dinámico; usa carga de modelos basada en estimaciones. | +| `--enable-dynamic-vram` | automático en Nvidia, ROCm 7.14+ | Habilita el VRAM dinámico en sistemas donde no está habilitado de forma predeterminada. | +| `--fast-disk` | falso | Fuerza la carga dinámica y la descarga respaldadas por disco en lugar de usar RAM no fijada. Útil con NVMe rápido. Cuando no se define este flag ni `--disable-fast-disk`, la carga y la descarga respaldadas por disco se habilitan automáticamente si todos los archivos de modelo están en un almacenamiento detectado como rápido. | +| `--disable-fast-disk` | deshabilitado | Deshabilita la carga dinámica y la descarga respaldadas por disco, de modo que se usa RAM no fijada en su lugar. Anula `--fast-disk` y la detección automática. | | `--disable-cuda-graphs` | deshabilitado | Deshabilita los CUDA graphs. | | `--disable-comfy-compiler` | deshabilitado | Deshabilita el compilador de modelos de Comfy, incluida su subfunción de CUDA graphs. | -| `--assert-graph-breaks` | deshabilitado | Falla cuando el compilador de modelos de Comfy produce interrupciones del gráfico. | +| `--assert-graph-breaks` | deshabilitado | Hace fallar la ejecución ante cortes de gráfico del compilador de modelos de Comfy. | | `--force-non-blocking` | deshabilitado | Fuerza operaciones de tensor no bloqueantes. Puede ayudar en sistemas que no son Nvidia; puede romper algunos flujos de trabajo. | | `--disable-smart-memory` | deshabilitado | Descarga de forma agresiva a la RAM en lugar de mantener los modelos en la VRAM. | | `--disable-pinned-memory` | deshabilitado | Deshabilita el uso de memoria fijada. | | `--mmap-torch-files` | deshabilitado | Usa mmap al cargar archivos ckpt/pt. | | `--disable-mmap` | deshabilitado | No usa mmap al cargar safetensors. | -## Rendimiento y depuración +## Performance & Debugging -| Flag | Predeterminado | Descripción | +| Flag | Default | Description | |------|---------|-------------| -| `--fast` `[OPT...]` | deshabilitado | Habilita optimizaciones experimentales que pueden afectar a la calidad o a la estabilidad. `--fast` por sí solo las habilita todas. Opciones específicas: `fp16_accumulation`, `fp8_matrix_mult`, `cublas_ops`, `autotune`. | -| `--deterministic` | deshabilitado | Usa algoritmos deterministas de PyTorch, más lentos, cuando es posible. No garantiza imágenes idénticas en todos los casos. | -| `--default-hashing-function` | `sha256` | Función hash para comparar nombres y contenidos de archivos duplicados. Opciones: `md5`, `sha1`, `sha256`, `sha512`. | -| `--debug-hang` | deshabilitado | Habilita el volcado de trazas de pila con Ctrl-C para depurar bloqueos. | +| `--fast` `[OPT...]` | disabled | Enable experimental optimizations that may affect quality or stability. `--fast` alone enables all. Specific options: `fp16_accumulation`, `fp8_matrix_mult`, `cublas_ops`, `autotune`. | +| `--deterministic` | disabled | Use slower deterministic PyTorch algorithms where possible. Does not guarantee identical images in all cases. | +| `--default-hashing-function` | `sha256` | Hash function for duplicate filename/content comparison. Choices: `md5`, `sha1`, `sha256`, `sha512`. | +| `--debug-hang` | disabled | Enable stack trace dumps on Ctrl-C for debugging hangs. | ```bash # Enable all fast optimizations (experimental) @@ -255,28 +256,28 @@ python main.py --fast fp16_accumulation cublas_ops ## ComfyUI Manager -Consulta [ComfyUI-Manager Installation](/es/manager/install) para ver las instrucciones de configuración. +Consulta [Instalación de ComfyUI-Manager](/es/manager/install) para ver las instrucciones de configuración. -| Opción | Descripción | +| Flag | Descripción | |------|-------------| -| `--enable-manager` | Habilita ComfyUI-Manager. | -| `--disable-manager-ui` | Deshabilita solo la UI y los endpoints ComfyUI Manager. Las tareas en segundo plano (instalaciones programadas, etc.) continúan. Requiere `--enable-manager`. | -| `--enable-manager-legacy-ui` | Usa la UI clásica ComfyUI Manager. Implica `--enable-manager`. Es mutuamente excluyente con `--disable-manager-ui`. | +| `--enable-manager` | Habilitar ComfyUI-Manager. | +| `--disable-manager-ui` | Desactivar solo la interfaz y los endpoints del Administrador. Las tareas en segundo plano (instalaciones programadas, etc.) continúan. Requiere `--enable-manager`. | +| `--enable-manager-legacy-ui` | Usar la interfaz clásica del Administrador. Implica `--enable-manager`. Es mutuamente excluyente con `--disable-manager-ui`. | -## Nodos personalizados y nodos de API +## Custom Nodes & API Nodes -| Flag | Predeterminado | Descripción | +| Flag | Default | Description | |------|---------|-------------| -| `--disable-all-custom-nodes` | deshabilitado | Deshabilita la carga de todos los nodos personalizados. | -| `--whitelist-custom-nodes` `FOLDER...` | — | Carpetas de nodos personalizados que se cargan incluso cuando `--disable-all-custom-nodes` está establecido. | -| `--disabled-nodes-config` `PATH` | — | Ruta a un archivo YAML que enumera los IDs de nodo a deshabilitar. El archivo debe contener una lista `disabled_nodes` con cadenas de IDs de nodo. | -| `--disable-partner-nodes` | deshabilitado | Deshabilita la carga de Nodos asociados (los nodos de API de pago). El frontend conserva su acceso a internet. | -| `--offline` | deshabilitado | Impide que el frontend se comunique con internet añadiendo una Content-Security-Policy restrictiva. También deshabilita los Nodos asociados. | -| `--disable-api-nodes` | deshabilitado | Alias obsoleto de `--offline`. Usa `--offline`, o `--disable-partner-nodes` para deshabilitar solo los Nodos asociados. | -| `--disable-metadata` | deshabilitado | Deshabilita el guardado de los metadatos del prompt en los archivos de salida. | +| `--disable-all-custom-nodes` | disabled | Disable loading all custom nodes. | +| `--whitelist-custom-nodes` `FOLDER...` | — | Custom node folders to load even when `--disable-all-custom-nodes` is set. | +| `--disabled-nodes-config` `PATH` | — | Path to a YAML file that lists node IDs to disable. The file must contain a `disabled_nodes` list of node ID strings. | +| `--disable-partner-nodes` | disabled | Disable loading Partner Nodes (the paid API nodes). The frontend keeps its internet access. | +| `--offline` | disabled | Prevent the frontend from communicating with the internet by adding a restrictive Content-Security-Policy. Also disables Partner Nodes. | +| `--disable-api-nodes` | disabled | Deprecated alias for `--offline`. Use `--offline`, or `--disable-partner-nodes` to only disable Partner Nodes. | +| `--disable-metadata` | disabled | Disable saving prompt metadata in output files. | - `--offline` también cambia lo que el navegador puede cargar. El flag añade una Content-Security-Policy que mantiene la página en recursos servidos por el propio ComfyUI, así que las imágenes, fuentes, medios, fotogramas y solicitudes de red de otros orígenes quedan bloqueados, y los Nodos asociados (nodos de API) no se registran en absoluto. Si una vista previa o una miniatura que normalmente se carga desaparece después de un reinicio, revisa los argumentos de inicio en busca de este flag antes de depurar el nodo. `--disable-partner-nodes` solo impide que se carguen los Nodos asociados y deja intacto el resto del acceso a internet del frontend. + `--offline` also changes what the browser is allowed to load. The flag adds a Content-Security-Policy that keeps the page on resources served by ComfyUI itself, so images, fonts, media, frames, and network requests from other origins are blocked, and Partner Nodes (API nodes) are not registered at all. If a preview or a thumbnail that normally loads goes missing after a restart, check the launch arguments for this flag before troubleshooting the node. `--disable-partner-nodes` only stops Partner Nodes from loading and leaves the rest of the frontend's internet access intact. ```bash @@ -287,19 +288,19 @@ python main.py --disable-all-custom-nodes python main.py --disable-all-custom-nodes --whitelist-custom-nodes ComfyUI-Manager ``` -## Frontend y API +## Frontend & API -| Flag | Predeterminado | Descripción | +| Flag | Default | Description | |------|---------|-------------| -| `--front-end-version` | `comfyanonymous/ComfyUI@latest` | Versión del frontend con el formato `[owner]/[repo]@[version]`. Requiere internet para descargarla desde las releases de GitHub. La versión puede ser `latest` o una versión semver (p. ej. `1.0.0`). | -| `--front-end-root` `PATH` | — | Ruta del sistema de archivos local al directorio del frontend. Anula `--front-end-version`. | -| `--comfy-api-base` | `https://api.comfy.org` | URL base de la API de ComfyUI. | -| `--database-url` | `sqlite:////user/comfyui.db` | URL de la base de datos. Usa `sqlite:///:memory:` para usar la memoria. | -| `--enable-assets` | deshabilitado | Habilita el sistema de recursos (rutas de API, sincronización con la base de datos, escaneo en segundo plano). | -| `--disable-assets` | deshabilitado | Deshabilita el sistema de recursos, incluso cuando `--enable-assets` o `--windows-standalone-build` están activados. | -| `--enable-asset-hashing` | deshabilitado | Calcula hashes de contenido blake3 al escanear recursos. Habilita futuras funciones de portabilidad de recursos, como la deduplicación y la resolución de modelos entre máquinas, a costa del tiempo de inicio y del hashing en cada salida con directorios de modelos grandes. Desactivado de forma predeterminada; requiere el sistema de recursos (`--enable-assets` o `--windows-standalone-build`). | -| `--feature-flag` `KEY[=VALUE]` | — | Establece un feature flag del servidor. `KEY` por sí solo establece verdadero. Se puede repetir. Los booleanos y los números se convierten automáticamente. | -| `--list-feature-flags` | — | Imprime como JSON los feature flags conocidos que se pueden establecer desde la CLI y sale. | +| `--front-end-version` | `comfyanonymous/ComfyUI@latest` | Frontend version in `[owner]/[repo]@[version]` format. Requires internet to download from GitHub releases. Version can be `latest` or a semver (e.g. `1.0.0`). | +| `--front-end-root` `PATH` | — | Local filesystem path to the frontend directory. Overrides `--front-end-version`. | +| `--comfy-api-base` | `https://api.comfy.org` | Base URL for the ComfyUI API. | +| `--database-url` | `sqlite:////user/comfyui.db` | Database URL. Use `sqlite:///:memory:` for in-memory. | +| `--enable-assets` | disabled | Enable the assets system (API routes, database sync, background scanning). | +| `--disable-assets` | disabled | Disable the assets system, even when `--enable-assets` or `--windows-standalone-build` is turned on. | +| `--enable-asset-hashing` | disabled | Compute blake3 content hashes when scanning assets. Enables future asset portability features such as deduplication and cross-machine model resolution, at the cost of startup time and per-output hashing on large model directories. Off by default; requires the assets system (`--enable-assets` or `--windows-standalone-build`). | +| `--feature-flag` `KEY[=VALUE]` | — | Set a server feature flag. Bare `KEY` sets true. Can be repeated. Booleans and numbers are auto-converted. | +| `--list-feature-flags` | — | Print known CLI-settable feature flags as JSON and exit. | ```bash # List available feature flags @@ -316,12 +317,12 @@ python main.py --feature-flag show_signin_button=true | `--verbose` `[LEVEL] [FILE]` | `INFO` | Nivel de registro. Opciones: `DEBUG`, `DETAIL`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`. `--verbose` por sí solo establece `DEBUG`. Agrega un nivel seguido de una ruta de archivo para escribir ese nivel también en un archivo; el flag se puede repetir para configurar juntas las salidas de consola y de archivo. | | `--log-stdout` | deshabilitado | Envía la salida normal del proceso a stdout en lugar de stderr. | | `--dont-print-server` | deshabilitado | No imprime la salida del servidor en la consola. | -| `--disable-product-tips` | deshabilitado | Oculta los consejos de la consola acerca de los productos comerciales y los despliegues de Comfy-Org. Equivale a establecer `COMFYUI_DISABLE_PRODUCT_TIPS=1`. Los consejos también se omiten con `CI`, `--dont-print-server` o `--windows-standalone-build`. | +| `--disable-product-tips` | deshabilitado | Oculta los consejos de la consola acerca de los productos comerciales y las implementaciones de Comfy-Org. Equivale a establecer `COMFYUI_DISABLE_PRODUCT_TIPS=1`. Los consejos también se omiten con `CI`, `--dont-print-server` o `--windows-standalone-build`. | | `--multi-user` | deshabilitado | Habilita el almacenamiento por usuario. | -| `--quick-test-for-ci` | deshabilitado | Prueba de inicio rápida para CI. Sale inmediatamente después de la inicialización. | +| `--quick-test-for-ci` | deshabilitado | Prueba rápida de inicio para CI. Finaliza inmediatamente después de la inicialización. | --- - Esta referencia se basa en ComfyUI [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py). Al actualizar ComfyUI, ejecuta `python main.py --help` o compara tu [`cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py) local con esta página para comprobar si hay flags nuevos o modificados. + Esta referencia se basa en el archivo [`comfy/cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py) de ComfyUI. Al actualizar ComfyUI, ejecuta `python main.py --help` o compara tu [`cli_args.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/cli_args.py) local con esta página para comprobar si hay flags nuevos o modificados. diff --git a/es/development/deploy/cloud-usage.mdx b/es/development/deploy/cloud-usage.mdx index 2c386e6f7e..5f5030d2bb 100644 --- a/es/development/deploy/cloud-usage.mdx +++ b/es/development/deploy/cloud-usage.mdx @@ -3,7 +3,7 @@ title: "Uso y límites" sidebarTitle: "Uso y límites" description: "Conoce los créditos de Comfy Cloud, las tareas simultáneas y los límites al ejecutar flujos de trabajo desde el SDK." icon: "gauge" -translationSourceHash: 4bda5429 +translationSourceHash: 811a6c4e translationFrom: development/deploy/cloud-usage.mdx --- @@ -11,11 +11,11 @@ Los flujos de trabajo enviados a través de la API de Comfy Cloud usan los mismo ## Créditos y uso -Las solicitudes a la API consumen la misma asignación mensual de créditos que la interfaz web de Comfy Cloud. No hay un grupo de créditos independiente para la API. Los créditos incluidos en cada plan, las opciones de recarga y los límites de tiempo de ejecución por flujo de trabajo se aplican a las tareas de la API igual que a las tareas de la interfaz. +Las solicitudes a la API toman de la misma asignación mensual de créditos que la interfaz web de Comfy Cloud. No hay un grupo de créditos independiente para la API. Los créditos incluidos en cada plan, las opciones de recarga y los límites de tiempo de ejecución por flujo de trabajo se aplican a las tareas de la API igual que a las tareas de la interfaz. Consulta la [página de precios](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api) para ver los importes mensuales de créditos y las opciones de recarga. Puedes comprar recargas desde el panel de tu cuenta. -## Tareas simultáneas +## Límites de simultaneidad Puedes enviar varios flujos de trabajo sin esperar a que terminen las tareas anteriores. Las tareas se ejecutan en paralelo hasta el límite de tu plan de suscripción: @@ -25,19 +25,19 @@ Puedes enviar varios flujos de trabajo sin esperar a que terminen las tareas ant | Creator | 3 | | Pro | 5 | -Los planes de equipo ejecutan más flujos de trabajo simultáneos por miembro que Pro. Consulta [platform.comfy.org](https://platform.comfy.org) para ver la simultaneidad de tu cuenta. Las tareas adicionales quedan en cola y se ejecutan a medida que se liberan espacios. +Los planes de equipo ejecutan más flujos de trabajo simultáneos por miembro que Pro. Consulta [platform.comfy.org](https://platform.comfy.org) para ver la simultaneidad de tu cuenta. Las tareas adicionales quedan en cola y se ejecutan a medida que se liberan ranuras. -Si la cola está llena, los SDK reintentan dentro de un presupuesto limitado antes de generar el error `QueueFull`. +Si la cola está llena, los SDK reintentan dentro de un presupuesto acotado antes de lanzar `QueueFull`. -En los planes Team y Enterprise, la simultaneidad es por miembro: cada persona del espacio de trabajo tiene su propio límite de simultaneidad, así que las tareas en ejecución de un miembro nunca bloquean las de otro. +En los planes de equipo y empresa, la simultaneidad es por miembro: cada persona del espacio de trabajo tiene su propio límite de simultaneidad, así que las tareas en ejecución de un miembro nunca bloquean las de otro. - La ejecución de más de una tarea a la vez solo se admite a través de la API. La interfaz de Comfy Cloud ejecuta un flujo de trabajo a la vez por persona, y los flujos de trabajo en cola en el editor se ejecutan en orden. Consulta los [planes de precios](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api) para ver los detalles de la suscripción. + Solo puedes ejecutar más de una tarea a la vez a través de la API. La interfaz de Comfy Cloud ejecuta un flujo de trabajo a la vez por persona, y los flujos de trabajo en cola en el editor se ejecutan en orden. Consulta los [planes de precios](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api) para ver los detalles de la suscripción. ## Límites de ejecución y de cola -Cada flujo de trabajo de Cloud tiene un tiempo máximo de ejecución. Una tarea que supera ese límite se cancela automáticamente: +Cada flujo de trabajo de Cloud tiene un tiempo máximo de ejecución. Una tarea que se ejecuta más allá de ese límite se cancela automáticamente: | Plan | Tiempo máximo de ejecución | | :------- | :------------------------- | diff --git a/es/development/serverless/overview.mdx b/es/development/serverless/overview.mdx index f7c49310c2..bdf1db4ab5 100644 --- a/es/development/serverless/overview.mdx +++ b/es/development/serverless/overview.mdx @@ -15,7 +15,8 @@ translationBlockHashes: "FAQ": 54896279 "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. + +Comfy API permite que tu aplicación ejecute flujos de trabajo de ComfyUI mediante 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 @@ -34,32 +35,32 @@ Los flujos de trabajo compatibles con [Comfy Cloud](/es/development/deploy/cloud Para las instantáneas de Desktop y las importaciones de flujos de trabajo en JSON, consulta [Orígenes de Build](/es/development/serverless/build-sources). -## El archivo Build +## The Build file -`comfy-build.yaml` guarda la definición del Build y el último estado remoto conocido. La CLI usa ese estado para detectar cuándo ha cambiado el Build remoto. Mantén el archivo junto al proyecto. Describe el entorno, pero no contiene archivos de modelos. +`comfy-build.yaml` stores the Build definition and last known remote state. The CLI uses that state to detect when the remote Build has changed. Keep the file with the project. It describes the environment but does not contain model files. -Comprueba cómo se compara el Build local con la instalación y con la versión remota antes de publicar cambios: +Check how the local Build compares with the install and remote version before pushing changes: ```bash comfy build status ``` -## Actualizar y publicar +## Update and release -Después de cambiar la instalación local, actualiza la definición del Build: +After changing the local install, refresh the Build definition: ```bash comfy build update --yes ``` -Para crear otra versión a partir de un Build existente, consulta los destinos admitidos y selecciona uno: +To create another release from an existing Build, check the supported targets and select one: ```bash comfy build refs build-targets comfy build release create --target linux/nvidia --watch ``` -Sigue el registro de compilación de una versión con: +Follow one release's build log with: ```bash comfy build release logs rel_123456 --target linux/nvidia --follow @@ -67,31 +68,31 @@ 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 al elegir un objetivo de implementación. Filtra los resultados con `--region `: +La capacidad de las regiones cambia, así que consulta el catálogo de la plataforma al elegir un destino de despliegue. Filtra los resultados con `--region `: ```bash comfy deploy refs compute --region ``` -El catálogo es la fuente de verdad sobre qué clases de GPU están disponibles en cada región al momento de la implementación. +El catálogo es la fuente de referencia sobre qué clases de GPU están disponibles en cada región en el momento del despliegue. ## Límites del espacio de trabajo -Consulta [Limits](https://platform.comfy.org/profile/limits) para ver el uso y los límites de tu plan de tu espacio de trabajo. Mantén `--max` dentro del límite de workers por despliegue. +Consulta [Limits](https://platform.comfy.org/profile/limits) para ver el uso y los límites de tu plan de espacio de trabajo. Mantén `--max` dentro del límite de workers por despliegue. -## Supervisar y llamar a un despliegue +## Monitorear y llamar a una implementación -Las opciones `--min` y `--max` establecen los límites de workers. Ejecuta `comfy deploy status --watch` para seguir el estado del despliegue, la vigencia de las versiones y la actividad de servicio. +Las opciones `--min` y `--max` establecen los límites de workers. Ejecuta `comfy deploy status --watch` para seguir el estado de la implementación, la vigencia de las versiones publicadas y la actividad de servicio. -También puedes llamar al endpoint con los [SDK de Comfy](/es/development/api-development/sdks). Establece `COMFY_BASE_URL` en la URL del despliegue y proporciona una clave API. Consulta [Elegir una URL base](/es/development/api-development/sdks#elegir-una-url-base). +También puedes llamar al endpoint con los [SDK de Comfy](/es/development/api-development/sdks). Establece `COMFY_BASE_URL` con la URL de la implementación y proporciona una clave API. Consulta [Elegir una URL base](/es/development/api-development/sdks#elegir-una-url-base). -## Operar un despliegue +## Operate a deployment ```bash -# Cambiar los límites de workers +# Change the worker bounds comfy deploy scale --deployment dep_123456 --min 2 --max 5 -# Pausar o reanudar conservando el registro del despliegue +# Pause or resume while retaining the deployment record comfy deploy stop --deployment dep_123456 comfy deploy start --deployment dep_123456 ``` @@ -99,7 +100,7 @@ comfy deploy start --deployment dep_123456 ## Inspeccionar y limpiar ```bash -# Estado del build +# Estado de la compilación comfy build ls comfy build show --id bld_123456 comfy build release ls @@ -118,39 +119,39 @@ comfy deploy events --deployment dep_123456 ## Preguntas frecuentes - + Sí. En el Builder, sube uno o más flujos de trabajo para preseleccionar sus modelos y nodos personalizados. Incluye las dependencias que necesitan todos los flujos de trabajo que planeas ejecutar y luego envía cada flujo de trabajo en formato API al endpoint desplegado. - Cada despliegue usa un solo tipo de GPU. Para ejecutar flujos de trabajo en distintos tipos de GPU, crea despliegues separados del mismo Build. + Cada despliegue usa un tipo de GPU. Para ejecutar flujos de trabajo en distintos tipos de GPU, crea despliegues separados del mismo Build. - - No. Los Builds y sus releases se guardan en tu cuenta sin costo. No se te factura el espacio de almacenamiento de un Build hasta que lo despliegas. + + No. Los Builds y sus versiones se almacenan en tu cuenta sin cargo. No se te cobra por el espacio de almacenamiento de un Build hasta que lo despliegas. - La facturación de almacenamiento comienza con un despliegue: + El cobro por almacenamiento comienza con un despliegue: - - Cuando despliegas un release, sus modelos se preparan en almacenamiento de red compartido por los workers del despliegue. El 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`. - - 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 de red preparado se limpia poco después de que se elimine el último despliegue que lo usa en esa región, y su facturación termina. + - Cuando despliegas una versión, sus modelos se preparan en un almacenamiento de red compartido por los workers del despliegue. El almacenamiento es de solo lectura después del despliegue y se cobra por GB-mes mientras exista cualquier despliegue del Build en esa región, incluso cuando un despliegue está en pausa con `comfy deploy stop`. + - Cada worker también tiene un disco de contenedor fijo de 50 GB. Es efímero y solo se cobra 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 de red preparado se limpia poco después de eliminar el último despliegue que lo usa en esa región, y su cobro finaliza. - Para conocer las tarifas de almacenamiento vigentes, 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 aplican a un despliegue. + 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. - - `--min` define la cantidad de **workers activos**: workers que permanecen en ejecución todo el tiempo para que las solicitudes nunca esperen un inicio en frío. Un worker activo se factura por segundo durante todo el tiempo que está en ejecución, procese tareas o no. + + `--min` establece el número de **workers activos**: workers que permanecen en ejecución en todo momento para que las solicitudes nunca esperen un inicio en frío. Un worker activo se cobra por segundo durante todo el tiempo que está en ejecución, procese o no tareas. - Los workers por encima de `--min`, hasta `--max`, son **workers flexibles**. Un worker flexible se factura por segundo desde el momento en que inicia (incluido el arranque y la carga de modelos), durante el procesamiento de tareas, más una breve ventana de inactividad (actualmente 30 segundos) antes de reducirse. Cuando los workers flexibles se reducen, no cuestan nada. Con `--min 0`, todo el despliegue se reduce a cero y no factura cómputo mientras está inactivo, a cambio de un inicio en frío en la primera solicitud. + Los workers por encima de `--min`, hasta `--max`, son **workers flexibles**. Un worker flexible se cobra por segundo desde el momento en que se inicia (incluidos el arranque y la carga de modelos), durante el procesamiento de tareas, más una breve ventana de inactividad (actualmente 30 segundos) antes de reducirse. Cuando los workers flexibles se reducen, no cuestan nada. Con `--min 0`, todo el despliegue se reduce a cero y no cobra cómputo mientras está inactivo, a cambio de un inicio en frío en la primera solicitud. La facturación mide el uso real por segundo de los workers, multiplicado por la cantidad de workers en ejecución. Si tu espacio de trabajo se queda sin créditos, los despliegues se detienen automáticamente. - Para conocer las tarifas vigentes por worker de GPU, consulta la [página de precios de Comfy](https://www.comfy.org/pricing). Las tarifas se expresan por hora de worker y se facturan por segundo. La disponibilidad de GPU por región proviene del catálogo de cómputo: ejecuta `comfy deploy refs compute` para ver la lista actual. + Para conocer las tarifas actuales de GPU por worker, consulta la [página de precios de Comfy](https://www.comfy.org/pricing). Las tarifas se cotizan por hora de worker y se cobran por segundo. La disponibilidad de GPU por región proviene del catálogo de cómputo: ejecuta `comfy deploy refs compute` para obtener la lista actual. - Un despliegue distribuye automáticamente las solicitudes entre sus workers y escala dentro de los límites configurados de `--min` y `--max`. Las solicitudes que no pueden ejecutarse de inmediato quedan en cola y se procesan a medida que haya capacidad de workers disponible. + Un despliegue distribuye automáticamente las solicitudes entre sus workers y escala dentro de los límites configurados de `--min` y `--max`. Las solicitudes que no pueden ejecutarse de inmediato se ponen en cola y se procesan a medida que hay capacidad de workers disponible. - + Sigue el estado del despliegue y luego revisa sus registros y eventos para encontrar la causa: ```bash @@ -159,11 +160,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 ID 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 un par de región y GPU disponible. Incluye los IDs del Build, la versión y el 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 que elimines el último despliegue que usa ese Build en una región, el almacenamiento de 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 versiones. Después de eliminar el último despliegue que usa ese Build en una región, su almacenamiento de red preparado se limpia y el cobro por almacenamiento finaliza poco después. Eliminar el Build es una operación aparte: `comfy build delete --id --yes`. @@ -172,16 +173,16 @@ comfy deploy events --deployment dep_123456 ## Próximos pasos - + Úsalos desde una aplicación de Python o TypeScript para enviar flujos de trabajo y gestionar entradas, progreso y salidas. - Úsala desde cualquier lenguaje cuando llames directamente a la API HTTP o quieras consultar sus formatos de solicitud y respuesta. + Úsala desde cualquier lenguaje cuando llames directamente a la API HTTP o revises sus formatos de solicitud y respuesta. - Úsalo cuando prepares un JSON de flujo de trabajo para una solicitud a la API o para solucionar problemas con sus entradas y salidas. + Úsalo cuando prepares un JSON de flujo de trabajo para una solicitud de API o para solucionar problemas con sus entradas y salidas. - Úsala para automatizar los comandos de compilación, publicación, despliegue y flujos de trabajo desde una terminal. + Úsala para automatizar los comandos de compilación, publicación, despliegue y flujo de trabajo desde una terminal.