diff --git a/ja/development/api-development/sdks.mdx b/ja/development/api-development/sdks.mdx index 299df75116..20d37ef2db 100644 --- a/ja/development/api-development/sdks.mdx +++ b/ja/development/api-development/sdks.mdx @@ -3,13 +3,13 @@ title: "Comfy SDK：ComfyUI 向け Python・TypeScript クライアント" description: "Comfy Cloud、デプロイ環境、または自前の ComfyUI に対して Python または TypeScript から ComfyUI ワークフローを実行し、アセット、ジョブ、ライブイベント、冪等なリトライを扱います。" sidebarTitle: "SDK" icon: "code" -translationSourceHash: dbb2e0a8 +translationSourceHash: fd912955 translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 "Quickstart": 02297586 - "Choosing a base URL": 2265e6f6 + "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f "Watching a job run": 34d74bcc "Tracing an output back to its workflow": b01886a3 @@ -21,6 +21,7 @@ translationBlockHashes: + import SdkSurfaces from "/snippets/ja/sdk/surfaces.mdx"; import SdkVersions from "/snippets/ja/sdk/versions.mdx"; @@ -136,7 +137,7 @@ const client = new Comfy({ apiKey: "comfyui-..." }); - 初期ビルドからアップグレードしますか? `Comfy("", "")`は、`COMFY_BASE_URL`を設定した`Comfy(api_key="")`になりました。`api_key`はキーワード専用引数なので、以前の位置引数での呼び出しは、URLをキーとして静かに読み取るのではなく、`TypeError`を発生させます。 + 初期ビルドからアップグレードしますか？ `Comfy("", "")`は、`COMFY_BASE_URL`を設定した`Comfy(api_key="")`になりました。`api_key`はキーワード専用引数なので、以前の位置引数での呼び出しは、URLをキーとして静かに読み取るのではなく、`TypeError`を発生させます。 ### Comfy Cloud diff --git a/ja/development/cloud/api-reference.mdx b/ja/development/cloud/api-reference.mdx index 581b1859e6..c1517a0d18 100644 --- a/ja/development/cloud/api-reference.mdx +++ b/ja/development/cloud/api-reference.mdx @@ -2,14 +2,14 @@ title: "Cloud API リファレンス" description: "Comfy Cloud の完全な API リファレンスとコード例" icon: "book-open" -translationSourceHash: 9dfb0617 +translationSourceHash: e15f0e0e translationFrom: development/cloud/api-reference.mdx translationBlockHashes: "_intro": 1729f5d3 "Setup": 311034bb "Object Info": 7b62a397 "Uploading Inputs": 92df17f8 - "Running Workflows": d6ddd0b4 + "Running Workflows": 2c6519c7 "Checking Job Status": d74b4922 "WebSocket for Real-Time Progress": 02c49b4a "Downloading Outputs": 5e1d63d3 @@ -19,6 +19,7 @@ translationBlockHashes: --- + import PollJobCompletion from '/snippets/ja/cloud/poll-job-completion.mdx' import WebSocketProgress from '/snippets/ja/cloud/websocket-progress.mdx' import DownloadOutputs from '/snippets/ja/cloud/download-outputs.mdx' @@ -272,7 +273,7 @@ def upload_mask(file_path: str, original_ref: dict) -> dict: ## ワークフローの実行 -実行するワークフローを送信します。 +ワークフローを送信して実行します。 **同時送信に対応:** サブスクリプションティアに応じて、前のジョブの完了を待たずに複数のワークフローを送信できます。ジョブはティアの上限まで並列で実行されます。それを超えるジョブは自動的にキューに入ります。詳細については[同時実行の制限](/ja/development/deploy/cloud-usage#同時実行の制限)をご覧ください。 diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index 08f0099f7c..8015a8f322 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: b40af72c +translationSourceHash: 450771dd translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -13,9 +13,9 @@ translationBlockHashes: "Request bodies are capped": 675b77c8 "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d - "Comfy charges and usage": ed49ddec - "Models without a pre-flight estimate": 7373adf0 - "Router does not cover every partner operation": 97d31362 + "Comfy charges and usage": 7f5ccda7 + "Models without a pre-flight estimate": 0e7f595d + "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- @@ -27,6 +27,7 @@ translationBlockHashes: + Router はパートナーモデルを、1回の同期 HTTP 呼び出し、または送信して後で結果を取得するキュー中のリクエストを通じて実行します。アプリケーションが完了した結果を待つことができ、あるいは後で結果を取得でき、さらにモデル自身の入力フィールドと出力フィールドを処理できる場合に使用します。 ## Router がサポートするもの @@ -102,9 +103,9 @@ Router は最終レスポンスのみを返し、ストリーミングされる レスポンスにはプロバイダーの使用量またはコストのフィールドが含まれる場合があります。これらは Comfy の一律の課金を表すものではありません。`X-Comfy-Credits-Used` はオプションです。ヘッダーが不足している場合は、コストが報告されなかったことを意味し、実行が無料だったことを意味するものではありません。リプレイされたレスポンス（`Idempotent-Replayed: true`）に対して再度課金されることはありませんが、元の実行の金額が再掲される場合があるため、1 つの `Idempotency-Key` のリトライをまたいでこのヘッダーを合算しないでください。残高、使用量、請求書については Comfy プラットフォームを使用してください。 -カタログは価格ではなく、`billing.charges_on_policy_rejection` を含む請求に関する事実を提供します。`yes`、`no`、`unknown` を明示的に処理してください。詳細は [billing](/ja/development/comfy-router/billing#モデル課金に関する事実) を参照してください。 +カタログは価格ではなく、`billing.charges_on_policy_rejection` を含む請求に関する事実を提供します。`yes`、`no`、`unknown` を明示的に処理してください。これが `yes` の場合、同期的な `content_policy_violation` エラーが `X-Comfy-Credits-Used` を含むことがあります。プロバイダーがモデルの生成済み出力を拒否し、Comfy がその拒否された生成に対して使用量を記録した場合にこれを含み、その量が記載されます。入力側の拒否および同一キーのリプレイでは含まれません。ヘッダーのない拒否は報告されていないのであり、無料ではありません。詳細は [billing](/ja/development/comfy-router/billing#モデル課金に関する事実) を参照してください。 -実行前に価格を確認するには、`POST /v2/models/{provider}/{model}/estimate` を呼び出すか、キュー中の送信の `201` にある `estimate` オブジェクトを読み取ってください。estimate の展開中は、このルートは `error_type: not_enabled` とともに `403` を返し、送信には `estimate` が含まれません。それぞれは Comfy がその実行に対して請求するレートカードに基づいて価格が決まりますが、その金額は見積もりであり最終的な請求額ではなく、ワークスペースの使用量と請求の記録に確定した請求額が最終となります。また、価格を固定するものでもありません。独自のプロバイダーキーでの実行は、`/estimate` がその実行の金額を返したとしても Comfy からは請求されません。また、`unknown` の estimate には金額が含まれておらず、それは無料を意味するものではありません。`X-Comfy-Credits-Used` は、実行に対する事後的な丸められた数値のままですが、領収書ではありません。`exact`、`estimated`、`unknown` の読み取り方については、[実行前のコスト見積もり](/ja/development/comfy-router/reference#事前のコスト見積もり) を参照してください。実行前に価格を算出できないモデルは、[事前見積もりがないモデル](#事前見積もりのないモデル) に一覧されています。 +実行前に価格を確認するには、`POST /v2/models/{provider}/{model}/estimate` を呼び出すか、キュー中の送信の `201` にある `estimate` オブジェクトを読み取ってください。estimate の展開中は、このルートは `error_type: not_enabled` とともに `403` を返し、送信には `estimate` が含まれません。それぞれは Comfy がその実行に対して請求するレートカードに基づいて価格が決まります（ベンダーが報告するコストで請求されるモデルは、代わりにベンダーの公開価格表から見積もられます）が、その金額は見積もりであり最終的な請求額ではなく、ワークスペースの使用量と請求の記録に確定した請求額が最終となります。また、価格を固定するものでもありません。独自のプロバイダーキーでの実行は、`/estimate` がその実行の金額を返したとしても Comfy からは請求されません。また、`unknown` の estimate には金額が含まれておらず、それは無料を意味するものではありません。`X-Comfy-Credits-Used` は、実行に対する事後的な丸められた数値のままですが、領収書ではありません。`exact`、`estimated`、`unknown` の読み取り方については、[実行前のコスト見積もり](/ja/development/comfy-router/reference#事前のコスト見積もり) を参照してください。実行前に価格を算出できないモデルは、[事前見積もりがないモデル](#事前見積もりのないモデル) に一覧されています。 ## 事前見積もりのないモデル @@ -114,9 +115,8 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} -- **bfl**: `bfl/erase-v1`, `bfl/flux-2-max`, `bfl/flux-2-pro`, `bfl/flux-3-image`, `bfl/flux-3-video`, `bfl/flux-kontext-max`, `bfl/flux-kontext-pro`, `bfl/flux-pro-1.0-expand`, `bfl/flux-pro-1.0-fill`, `bfl/flux-pro-1.1`, `bfl/flux-pro-1.1-ultra`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` +- **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` -- **elevenlabs**: `elevenlabs/eleven_sfx_v2` - **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` - **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` @@ -125,25 +125,30 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 - **luma**: `luma/photon-1`, `luma/photon-flash-1`, `luma/ray-2`, `luma/ray-flash-2` - **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` - **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` -- **recraft**: `recraft/recraftv2`, `recraft/recraftv3`, `recraft/recraftv4`, `recraft/recraftv4_1`, `recraft/recraftv4_1_pro`, `recraft/recraftv4_1_pro_vector`, `recraft/recraftv4_1_utility`, `recraft/recraftv4_1_utility_pro`, `recraft/recraftv4_1_utility_pro_vector`, `recraft/recraftv4_1_utility_vector`, `recraft/recraftv4_1_vector`, `recraft/recraftv4_pro`, `recraft/recraftv4_styles`, `recraft/recraftv4_styles_pro`, `recraft/recraftv4_styles_pro_vector`, `recraft/recraftv4_styles_vector` - **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` -- **runway**: `runway/gen4_image` - **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/flashvsr`, `wavespeed/seedvr2`, `wavespeed/ultimate-image-upscaler`, `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` -- **xai**: `xai/grok-imagine-image`, `xai/grok-imagine-image-2.0`, `xai/grok-imagine-image-pro`, `xai/grok-imagine-image-quality`, `xai/grok-imagine-video`, `xai/grok-imagine-video-1.5`, `xai/grok-imagine-video-1.5-lite`, `xai/grok-imagine-video-1.5-preview` +- **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} +`openai/gpt-image-2`、`openai/gpt-image-2.5-flare`、`openai/gpt-image-2.5-sunburst` の編集も事前見積もりの対象外です。これらのモデルへの編集呼び出し、または入力画像を伴う生成呼び出しは `source: unknown` を返します。テキストのみの生成呼び出しは見積もりが行われるため、これらのモデルは上記のリストに含まれていません。 + ## Routerはすべてのパートナー操作をカバーしていない Routerはモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、`/proxy/…` 配下のパートナープロキシルートが必要になる場合があります。これらはRouterの外部にあり、そのコントラクトには記述されていません。Router自体のサーフェスは [Comfy Router specification](/router-openapi.yaml) です。サポートはプロバイダーによって異なります。 -### Krea 3の参照画像は先にアップロードする必要があります +### Krea 3の参照画像：先にアップロードするか、公開https URLを使用する + +`krea/krea-3` の `image_urls` では、`POST /proxy/krea/assets` が返す `image_url`（`https://app-uploads.krea.ai/...` 形式のURL）は常に受け付けられます。他のリンクが受け付けられるかどうかは環境によって異なります。api.comfy.org では現在受け付けられています。 + +- **他のリンクが受け付けられる場合**、任意の公開 `https` 画像URLが使用できます。Routerはモデルの実行前に各画像のサイズを読み取ります。ホストが公開されて到達可能でないか存在しないリンク、`408` または `429` 以外の `4xx` を返すリンク、または画像でないリンクは、そのホスト名を示す `400` `invalid_input` で拒否されます。一時的なDNS、TLS、接続の失敗、タイムアウト、またはオリジンからの `408` または `429` は `502` エラーになります。実際のアップロードではない `app-uploads.krea.ai` リンクは、他の到達不能な参照と同様に `400` で拒否されます。サーバーの起動直後、どのルールが適用されるかを学習する前は、`app-uploads.krea.ai` リンクではない公開 `https` URLは、安全に再試行できる `503` で失敗することがあります。 +- **他のリンクが受け付けられない場合**、すべてのエントリはアップロードの `image_url` である必要があります。Routerは、リンクが `https` URLとしてパースでき、ホストが厳密に `app-uploads.krea.ai` であること（他のホストや明示的なポートは不可）だけをチェックします。それ以外のリンクは、自分でホストしている公開 `https` URLであっても、モデルの実行前に `400` `invalid_input` で拒否されます。このチェックを通過しても実際のアップロードではないリンク（期限切れ、削除済み、入力ミス）はそのまま通ってしまい、Routerは画像のサイズを読み取れずに `400` ではなく `5xx` エラーを返します。 -`krea/krea-3` は任意の画像リンクを受け付けません。`image_urls` の各エントリは、`POST /proxy/krea/assets` が返す `image_url`（`https://app-uploads.krea.ai/...` 形式のURL）である必要があります。Routerがチェックするのは、リンクが `https` URLとしてパースでき、ホストが厳密に `app-uploads.krea.ai` であること（他のホストや明示的なポートは不可）だけです。それ以外のリンクは、自分でホストしている公開 `https` URLであっても、モデルの実行前に `400` `invalid_input` で拒否されます。このチェックを通過しても実際のアップロードではないリンク（期限切れ、削除済み、入力ミス）はそのまま通ってしまい、Routerは画像のサイズを読み取れずに `400` ではなく `5xx` エラーを返します。そのため、`image_url` は必ずアップロードが返したとおりに渡してください。 +アップロードはどの環境でも機能するため、移植性のある選択肢です。`image_url` は必ずアップロードが返したとおりに渡してください。 1. 各参照画像を `multipart/form-data` としてアップロードし、画像はフォームフィールド `file` に入れます（JPEG、PNG、WebP、最大75 MB）。認証はRouterの場合と同じく、`X-API-Key` または `Authorization: Bearer` を使用します。 diff --git a/ja/development/comfy-router/litellm.mdx b/ja/development/comfy-router/litellm.mdx index 543301c2ef..ba1b08ce4d 100644 --- a/ja/development/comfy-router/litellm.mdx +++ b/ja/development/comfy-router/litellm.mdx @@ -2,16 +2,17 @@ title: "LiteLLMでComfy Routerを使用する" sidebarTitle: "LiteLLM" description: "Comfy RouterをパススルーエンドポイントとしてLiteLLM Proxyの背後に配置し、x-litellm-response-costヘッダーから各実行の正確なUSDコストを記録します。料金表を維持する必要はありません。" -translationSourceHash: e35cd883 +translationSourceHash: 8183ff58 translationFrom: development/comfy-router/litellm.mdx translationBlockHashes: "_intro": 1ddb0d0a "Configure the pass-through": 380c3ae3 - "How spend is recorded": f852c18c + "How spend is recorded": 699ed64b "Queued delivery": 46044c93 "Notes": 50e3cf6b --- + すでに [LiteLLM Proxy](https://docs.litellm.ai/docs/proxy/pass_through) で支出を追跡している場合は、Comfy Router をさらにもう 1 つのパススルーエンドポイントとして追加できます。呼び出し元は LiteLLM のキーを使い続け、Comfy APIキーはプロキシ上に保持されます。 Router は、実行ごとに Comfy クレジット価格を報告するモデルについて、実行にかかったコストを米ドルで `x-litellm-response-cost` レスポンスヘッダーに報告します（同期実行の場合は実行レスポンスに、[キュー中](#キュー配信)の実行の場合は結果のコレクションに付与されます）。詳細は[コストを報告しない実行](#コストを報告しない実行)を参照してください。LiteLLM はすべてのパススルーレスポンスでこのヘッダーを読み取り、リクエストの支出として記録するため、それらのモデル用の価格表を自分で管理する必要はありません。 @@ -81,7 +82,7 @@ Router は、実行ごとに Comfy クレジット価格を報告するモデル -## 支出がどのように記録されるか +## 支出がどのように記録されるか {#how-spend-is-recorded} コストを報告する実行には、次のレスポンスヘッダーが付きます。同期実行では実行のレスポンスに、キュー中の実行では結果のコレクションに付きます： @@ -102,11 +103,11 @@ X-Litellm-Total-Tokens: 0 - Comfy クレジットではなく、自分のプロバイダーキーに請求される実行 - Router の、実行ごとのクレジット価格を報告するモデルのリストにまだ載っていないモデル。そのリストは保守的で、一部のプロバイダーはまったく載っていません - Comfy の請求に到達しなかった課金 -- エラーレスポンス +- エラーレスポンス。`billing.charges_on_policy_rejection` が `yes` であるモデルからの同期的な `content_policy_violation` は、拒否された生成の価格とともに `X-Comfy-Credits-Used` を持つことがあります。エラーは LiteLLM が記録すべき結果ではないため、`x-litellm-response-cost` を持つことは決してありません また、Router が同じ `Idempotency-Key`（プロキシ経由では `x-pass-Idempotency-Key` として送信）を使ったリトライのために保存済みの結果を再生する場合にも存在しません。そのリトライは再度課金されないため、再生はその実行の正確なコストを二度目に報告しません。同じ理由で、キュー中の実行では、その実行の価格が記録された後の最初の結果コレクションだけがこのヘッダーを持ちます。同じ結果をもう一度収集しても `X-Comfy-Credits-Used` は返りますが、`x-litellm-response-cost` は返りません。 -ヘッダーが存在しない場合、LiteLLM はエンドポイントの `cost_per_request` にフォールバックします。これは上記のすべてのケースに当てはまります。したがって、エラーレスポンス、自分のプロバイダーキーに請求される実行、冪等な再生は、Comfy がそれらのクレジットを請求していなくても、あなたの見積もり額で記録されます。典型的な実行の妥当な見積もりを `0` ではなく設定してください。そうすれば、コストを報告しない実行が支出レポートで無料として表示されません。また、それらの行によって LiteLLM の合計が Comfy の請求額を上回ることを想定してください。価格が付けられ、本当にコストがかからなかった実行は `x-litellm-response-cost: 0` を報告し、LiteLLM はこれをゼロとして記録します。 +ヘッダーが存在しない場合、LiteLLM はエンドポイントの `cost_per_request` にフォールバックします。これは上記のすべてのケースに当てはまります。したがって、エラーレスポンス、自分のプロバイダーキーに請求される実行、冪等な再生は、あなたの見積もり額で記録されます。それらのほとんどはクレジットに請求されていませんが、すべてではありません。`X-Comfy-Credits-Used` を伴うコンテンツポリシーによる拒否には価格が付けられているため、そのコストはこのヘッダーから読み取ってください。また、Router が返却できなかった生成など、他の一部の失敗は、コストを報告せずに請求されることがあります。照合はワークスペースの使用記録に対して行ってください。`0` ではなく、典型的な実行の妥当な見積もりを設定してください。そうすれば、コストを報告しない実行が支出レポートで無料として表示されません。また、それらの行によって LiteLLM の合計が Comfy の請求額を上回ることを想定してください。価格が付けられ、本当にコストがかからなかった実行は `x-litellm-response-cost: 0` を報告し、LiteLLM はこれをゼロとして記録します。 ## キュー配信 diff --git a/ja/development/comfy-router/models.mdx b/ja/development/comfy-router/models.mdx index 4baac8dd47..52151c1a94 100644 --- a/ja/development/comfy-router/models.mdx +++ b/ja/development/comfy-router/models.mdx @@ -2,11 +2,11 @@ title: "Comfy Router モデル" sidebarTitle: "すべてのモデル" description: "Comfy Router で利用できるすべてのモデルを、各モデルの入力と出力のモダリティとあわせて、プロバイダー別にまとめています。" -translationSourceHash: f12be9e4 +translationSourceHash: e183e69a translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 78e86d68 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -25,10 +25,10 @@ translationBlockHashes: "LTX": 32595bf9 "Luma": 37a12a19 "Luma 2": 585eb637 - "Meshy": 9292a0a8 + "Meshy": 67e26a17 "MiniMax": 87560ab7 "Moonvalley": 9e63fb77 - "OpenAI": c5c4af80 + "OpenAI": a5c1e692 "Openrouter": a4f6806b "Pika": f2b1d797 "Pruna": 903d76ee @@ -44,6 +44,7 @@ translationBlockHashes: "xAI": e1706271 --- + {/* 生成済みファイル。Router カタログから `pnpm code-pages:gen` によって生成されます。 */} 以下に挙げるすべてのモデルは、同じルート `POST /v2/models/{provider}/{model}` で提供され、それぞれのモデル固有の JSON ボディを使用します。各ページには、Python、TypeScript、cURL で動作するリクエスト例を掲載しています。ディスカバリー、スキーマ、エラー、リトライ、課金については、[Comfy Router API の使用](/ja/development/comfy-router/api) を参照してください。 @@ -135,7 +136,7 @@ translationBlockHashes: - [Grok Imagine Video](/ja/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/ja/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/ja/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -198,7 +199,6 @@ translationBlockHashes: - [Photon 1](/ja/development/comfy-router/models/luma/photon-1/code): `luma/photon-1` - [Photon Flash 1](/ja/development/comfy-router/models/luma/photon-flash-1/code): `luma/photon-flash-1` - [GPT Image 1.5](/ja/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` -- [GPT Image 1](/ja/development/comfy-router/models/openai/gpt-image-1/code): `openai/gpt-image-1` - [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` - [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` @@ -276,7 +276,7 @@ translationBlockHashes: - [Wan 3.0 Video](/ja/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` - + - [Animations](/ja/development/comfy-router/models/meshy/animations/code): `meshy/animations` - [Meshy 6](/ja/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` @@ -290,7 +290,7 @@ translationBlockHashes: - [Hunyuan 3D Uv](/ja/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/ja/development/comfy-router/models/anthropic/claude-fable-5-1/code): `anthropic/claude-fable-5-1` - [Claude Fable 5](/ja/development/comfy-router/models/anthropic/claude-fable-5/code): `anthropic/claude-fable-5` @@ -319,7 +319,6 @@ translationBlockHashes: - [Nano Banana 2](/ja/development/comfy-router/models/google/nano-banana-2/code): `vertexai/gemini-3.1-flash-image` - [Nano Banana Pro](/ja/development/comfy-router/models/google/nano-banana-pro/code): `vertexai/gemini-3-pro-image` - [GPT 4.1 Mini](/ja/development/comfy-router/models/openai/gpt-4-1-mini/code): `openai/gpt-4.1-mini` -- [GPT 4.1 Nano](/ja/development/comfy-router/models/openai/gpt-4-1-nano/code): `openai/gpt-4.1-nano` - [GPT 4.1](/ja/development/comfy-router/models/openai/gpt-4-1/code): `openai/gpt-4.1` - [GPT 4o](/ja/development/comfy-router/models/openai/gpt-4o/code): `openai/gpt-4o` - [GPT 5.5 Pro](/ja/development/comfy-router/models/openai/gpt-5-5-pro/code): `openai/gpt-5.5-pro` @@ -333,10 +332,7 @@ translationBlockHashes: - [GPT 6 Astra](/ja/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/ja/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` - [GPT 6 Sol](/ja/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` -- [o1-pro](/ja/development/comfy-router/models/openai/o1-pro/code): `openai/o1-pro` -- [o1](/ja/development/comfy-router/models/openai/o1/code): `openai/o1` - [o3](/ja/development/comfy-router/models/openai/o3/code): `openai/o3` -- [o4-mini](/ja/development/comfy-router/models/openai/o4-mini/code): `openai/o4-mini` - [Chat Completions](/ja/development/comfy-router/models/openrouter/chat-completions/code): `openrouter/chat-completions` @@ -584,7 +580,6 @@ translationBlockHashes: | モデル | ID | 入力 | 出力 | | --- | --- | --- | --- | | [GPT 4.1 Mini](/ja/development/comfy-router/models/openai/gpt-4-1-mini/code) | `openai/gpt-4.1-mini` | テキスト, 画像 | テキスト | -| [GPT 4.1 Nano](/ja/development/comfy-router/models/openai/gpt-4-1-nano/code) | `openai/gpt-4.1-nano` | テキスト, 画像 | テキスト | | [GPT 4.1](/ja/development/comfy-router/models/openai/gpt-4-1/code) | `openai/gpt-4.1` | テキスト, 画像 | テキスト | | [GPT 4o](/ja/development/comfy-router/models/openai/gpt-4o/code) | `openai/gpt-4o` | テキスト, 画像 | テキスト | | [GPT 5.5 Pro](/ja/development/comfy-router/models/openai/gpt-5-5-pro/code) | `openai/gpt-5.5-pro` | テキスト, 画像 | テキスト | @@ -599,14 +594,10 @@ translationBlockHashes: | [GPT 6 Luna](/ja/development/comfy-router/models/openai/gpt-6-luna/code) | `openai/gpt-6-luna` | テキスト, 画像 | テキスト | | [GPT 6 Sol](/ja/development/comfy-router/models/openai/gpt-6-sol/code) | `openai/gpt-6-sol` | テキスト, 画像 | テキスト | | [GPT Image 1.5](/ja/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | テキスト, 画像 | 画像 | -| [GPT Image 1](/ja/development/comfy-router/models/openai/gpt-image-1/code) | `openai/gpt-image-1` | テキスト, 画像 | 画像 | | [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | テキスト, 画像 | 画像 | | [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | テキスト, 画像 | 画像 | | [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | テキスト, 画像 | 画像 | -| [o1-pro](/ja/development/comfy-router/models/openai/o1-pro/code) | `openai/o1-pro` | テキスト, 画像 | テキスト | -| [o1](/ja/development/comfy-router/models/openai/o1/code) | `openai/o1` | テキスト, 画像 | テキスト | | [o3](/ja/development/comfy-router/models/openai/o3/code) | `openai/o3` | テキスト, 画像 | テキスト | -| [o4-mini](/ja/development/comfy-router/models/openai/o4-mini/code) | `openai/o4-mini` | テキスト, 画像 | テキスト | ## Openrouter diff --git a/ja/development/comfy-router/models/bria/image-edit-relight/code.mdx b/ja/development/comfy-router/models/bria/image-edit-relight/code.mdx index eb8f4553bd..3de5490c88 100644 --- a/ja/development/comfy-router/models/bria/image-edit-relight/code.mdx +++ b/ja/development/comfy-router/models/bria/image-edit-relight/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Image Edit Relight を使う" description: "Comfy Router 経由で bria/image-edit-relight を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Image Edit Relight" -translationSourceHash: 63b5bcef +translationSourceHash: 620fcec7 translationFrom: development/comfy-router/models/bria/image-edit-relight/code.mdx translationBlockHashes: "_intro": cc88af3e "Quick start": 4329dd4b - "Schema": fb8fdff1 + "Schema": 8f45e738 "Examples": f04b0762 --- + {/* 生成済みファイル。`router-schemas/bria/image-edit-relight.json` から `pnpm code-pages:gen` によって生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -160,7 +161,7 @@ curl https://api.comfy.org/v2/models/bria/image-edit-relight/requests/$REQUEST_I 編集する画像。対応する入力タイプは、Base64 エンコードされた文字列、または公開アクセス可能な画像ファイルを指す URL です。対応フォーマットは JPEG、JPG、PNG、WEBP です。 - + ライトの方向。"front"、"side"、"bottom"、"top-down" のいずれか。 diff --git a/ja/development/comfy-router/models/krea/krea-3/code.mdx b/ja/development/comfy-router/models/krea/krea-3/code.mdx index 2c0d396cd2..e9edc9b170 100644 --- a/ja/development/comfy-router/models/krea/krea-3/code.mdx +++ b/ja/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,15 +2,16 @@ title: "Comfy Router で Krea 3 を使用する" description: "Comfy Router 経由で krea/krea-3 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Krea 3" -translationSourceHash: a539ac5a +translationSourceHash: bf8b60e8 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": 9c44fce0 + "Schema": 672a9195 "Examples": 276619d9 --- + {/* 生成済みファイル。router-schemas/krea/krea-3.json から `pnpm code-pages:gen` で生成済み。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -155,7 +156,7 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 入力画像の URL。最大8件。各 URL は、画像を POST /proxy/krea/assets にアップロードして返される image_url である必要があります（multipart フォームのフィールド `file`）。ホスト app-uploads.krea.ai 上の https URL ではないリンクは、自身の https URL であっても 400 で拒否され、app-uploads.krea.ai のリンクでも実際のアップロードではない場合は 5xx エラーで失敗します。テキストから画像への生成では省略します。 + 入力画像の URL。最大8件。画像を POST /proxy/krea/assets にアップロードして返される image_url（multipart フォームのフィールド `file`）は常に受け入れられます。他のパブリック https URL が受け入れられるかどうかは環境によって異なります。受け入れられない環境では、ホスト app-uploads.krea.ai 上の https URL ではないリンクは 400 で拒否されます。受け入れられる環境では、任意のパブリック https 画像 URL が受け入れられ、不正な形式の URL や https ではない URL は 400 で拒否されます。その場合、形式が正しい https URL については、呼び出し元が修正できる参照は、そのホスト名を示して 400 で拒否されます。具体的には、フェッチ前のチェックでホストが解決できない、または公開されて到達できない場合、許可された回数を超えてリダイレクトする場合、https ではない URL や公開されて到達できないホストへリダイレクトする場合、408 または 429 以外の 4xx を返す場合、画像ではない場合、読み取れない形式の画像である場合、画像サイズヘッダーが最初の 2 MiB 以内にない場合、または宣言された長さがない、もしくは chunked エンコーディングのレスポンスが画像サイズヘッダーより前に終了する場合です。それ以外の取得時の失敗は、POST /proxy/krea で 502 エラーになります（Comfy Router はこれを 500 internal_error で返します）。具体的には、一時的な DNS、TLS、接続の失敗、タイムアウト、オリジン側の 408、429、5xx その他の非 200 ステータス、またはチェックには合格したものの、フェッチの接続時に解決できない、もしくは公開されて到達できないホストの場合です。他の URL が受け入れられない環境では、実際のアップロードではない app-uploads.krea.ai のリンクは 5xx エラーで失敗します。受け入れられる環境では、他の到達できない参照と同様に 400 で拒否されます。サーバーがどちらに該当するかをまだ認識していない間は、app-uploads.krea.ai のリンクではないホストを持つ https URL は、公開されているかどうかに関係なく、再試行しても安全な 503 エラーで失敗します。テキストから画像への生成では省略します。 diff --git a/ja/development/comfy-router/models/luma_2/ray-3-2/code.mdx b/ja/development/comfy-router/models/luma_2/ray-3-2/code.mdx index dcc8b66bca..99a92024b1 100644 --- a/ja/development/comfy-router/models/luma_2/ray-3-2/code.mdx +++ b/ja/development/comfy-router/models/luma_2/ray-3-2/code.mdx @@ -2,14 +2,15 @@ title: "Ray 3.2 を Comfy Router で使用する" description: "Comfy Router 経由で luma_2/ray-3.2 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Ray 3.2" -translationSourceHash: a796913b +translationSourceHash: 86ca3c26 translationFrom: development/comfy-router/models/luma_2/ray-3-2/code.mdx translationBlockHashes: "_intro": 3348ca65 "Quick start": ad992b88 - "Schema": 50c63e36 + "Schema": 0c4fe0bc "Examples": fdb0ab6e --- + {/* 生成済みファイル。router-schemas/luma_2/ray-3.2.json から `pnpm code-pages:gen` によって生成されています。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -166,17 +167,17 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ ### 入力 - 出力のアスペクト比。ray-3.2 ビデオモデルは 9:16、3:4、1:1、4:3、16:9、21:9 のサブセットをサポートします。 + 出力のアスペクト比。ray-3.2 のビデオモデルは 9:16、3:4、1:1、4:3、16:9、21:9 のサブセットをサポートします。 - 指定可能な値: `3:1`, `2:1`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3` + 指定可能な値: `3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` - スタイル/コンテンツのガイダンス用の参照画像。type 'image' では最大 9 枚、type 'image_edit' では最大 8 枚です。 + スタイルやコンテンツのガイダンス用の参照画像。type 'image' では最大 9 枚、type 'image_edit' では最大 8 枚です。 - Base64 でエンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオのデータ @@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - MIME タイプ。data と一緒に必須です（ビデオソースの場合は url も必須。例: video_edit / video_reframe では video/mp4）。 + MIME タイプ。data と併せて必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4）。 @@ -192,13 +193,13 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオの生成、編集、リフレーミングには ray-3.2 を使用します。 + 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオの生成・編集・リフレームには ray-3.2 を使用します。 - 出力画像形式 + 出力画像の形式 - 指定可能な値: `png`, `jpeg` + 指定可能な値: `png`、`jpeg` @@ -206,11 +207,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうち 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、ビデオ編集／ビデオリフレームのソース、ガイドキーフレームに使用します。generation_id、url、data のいずれか 1 つだけを指定してください。 - Base64 でエンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオのデータ @@ -218,7 +219,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - MIME タイプ。data と一緒に必須です（ビデオソースの場合は url も必須。例: video_edit / video_reframe では video/mp4）。 + MIME タイプ。data と併せて必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4）。 @@ -228,31 +229,31 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ スタイルプリセット - 指定可能な値: `auto`, `manga` + 指定可能な値: `auto`、`manga` - 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 + 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルで生成され、video/video_edit/video_reframe は ray-3.2 モデルで生成されます。 - 指定可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` + 指定可能な値: `image`、`image_edit`、`video`、`video_edit`、`video_reframe` - ray-3.2 のビデオ出力設定。ここでは検証と課金に影響するフィールドのみをモデル化しています。追加のフィールド（編集コントロール、source_position）は Luma にそのまま転送されます。 + ray-3.2 のビデオ出力設定。ここでは検証と課金に関わるフィールドのみをモデル化しています。その他のフィールド（編集制御、source_position）はそのまま Luma に転送されます。 - ray-3.2 の video / video_edit のクリップ再生時間。デフォルトは 5s です。HDR 生成（type video）は 5s に制限されます。 + ray-3.2 の video / video_edit におけるクリップの再生時間。デフォルトは 5s です。HDR 生成（type video）は 5s に制限されています。 - 指定可能な値: `5s`, `10s` + 指定可能な値: `5s`、`10s` - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうち 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、ビデオ編集／ビデオリフレームのソース、ガイドキーフレームに使用します。generation_id、url、data のいずれか 1 つだけを指定してください。 - Base64 でエンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオのデータ @@ -260,7 +261,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - MIME タイプ。data と一緒に必須です（ビデオソースの場合は url も必須。例: video_edit / video_reframe では video/mp4）。 + MIME タイプ。data と併せて必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4）。 @@ -268,7 +269,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - まだ利用できません：Luma が EXR 配信を提供するまで、`exr_export=true` のリクエストは 400 で拒否されます。将来は MP4 と一緒に EXR ファイルをエクスポートします（hdr が true である必要があります）。video_reframe では拒否されます。 + 利用不可: Luma が EXR 配信を開始するまで、exr_export=true のリクエストは 400 で拒否されます。MP4 と併せて EXR ファイルをエクスポートします（hdr を true にする必要があります）。video_reframe では拒否されます。 @@ -276,15 +277,15 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - `keyframes` の出力フレーム位置。同じ長さで指定します。5s では 0–120、10s では 0–240 です。そのまま転送されます。 + `keyframes` に対応する出力フレームの位置。同じ長さで指定します。5s では 0～120、10s では 0～240 です。そのまま転送されます。 - ガイドフレーム画像（1–64）。start_frame/end_frame とは同時に使用できません。指定した再生時間で課金されます。keyframes リクエストが単一キーフレームの延長として扱われることはありません。 + ガイドフレーム画像（1～64 枚）。start_frame/end_frame とは排他的に使用します。課金は指定した再生時間に基づき、keyframes リクエストが単一キーフレームの延長として扱われることはありません。 - Base64 でエンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオのデータ @@ -292,7 +293,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - MIME タイプ。data と一緒に必須です（ビデオソースの場合は url も必須。例: video_edit / video_reframe では video/mp4）。 + MIME タイプ。data と併せて必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4）。 @@ -300,21 +301,21 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 生成されたクリップをループします。作成時のみ（type video）。 + 生成したクリップをループします。作成時のみ（type video）。 - ray-3.2 ビデオの出力解像度。デフォルトは 720p です。360p はドラフトティアです。HDR には 720p または 1080p が必要です。 + ray-3.2 の video における出力解像度。デフォルトは 720p です。360p はドラフト階層です。HDR には 720p または 1080p が必要です。 - 指定可能な値: `360p`, `540p`, `720p`, `1080p` + 指定可能な値: `360p`、`540p`、`720p`、`1080p` - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうち 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、ビデオ編集／ビデオリフレームのソース、ガイドキーフレームに使用します。generation_id、url、data のいずれか 1 つだけを指定してください。 - Base64 でエンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオデータ @@ -322,7 +323,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - MIME タイプ。data と併用する場合は必須です（ビデオソースの場合は url とも併用します。例えば video_edit / video_reframe では video/mp4）。 + MIME タイプ。data と併せて必須です（ビデオソースの場合は url とも併せて必須です。例: video_edit / video_reframe での video/mp4）。 @@ -330,10 +331,10 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - ウェブ検索グラウンディングを有効にします + Web 検索のグラウンディングを有効にします -`GET /v2/models/luma_2/ray-3.2/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +`GET /v2/models/luma_2/ray-3.2/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 @@ -344,15 +345,15 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ プログラムで処理するための機械可読な失敗コード - 指定可能な値: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` + 取りうる値: `content_moderated`、`generation_failed`、`budget_exhausted`、`output_not_found` - 人間が読める失敗の説明。失敗した生成時のみ設定されます。成功時は `null` です。 + 人間が読める形式の失敗の説明。FAILED の生成時のみ設定されます。成功時は `null` です。 - 生成 ID + 生成の識別子 @@ -374,13 +375,13 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ 生成の現在の状態 - 指定可能な値: `queued`, `processing`, `completed`, `failed` + 取りうる値: `queued`、`processing`、`completed`、`failed` 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 - 指定可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` + 取りうる値: `image`、`image_edit`、`video`、`video_edit`、`video_reframe` ## 例 diff --git a/ja/development/comfy-router/models/luma_2/uni-1-max/code.mdx b/ja/development/comfy-router/models/luma_2/uni-1-max/code.mdx index 50ec416839..a5faeb377f 100644 --- a/ja/development/comfy-router/models/luma_2/uni-1-max/code.mdx +++ b/ja/development/comfy-router/models/luma_2/uni-1-max/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Uni 1 Max を使う" description: "Comfy Router 経由で luma_2/uni-1-max を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Uni 1 Max" -translationSourceHash: 90d7c51e +translationSourceHash: e88275ff translationFrom: development/comfy-router/models/luma_2/uni-1-max/code.mdx translationBlockHashes: "_intro": 86e0cfe7 "Quick start": dfff1d3d - "Schema": 4916d345 + "Schema": d7d29898 "Examples": f813a867 --- + {/* GENERATED FILE. Generated from router-schemas/luma_2/uni-1-max.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -155,15 +156,15 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ 出力のアスペクト比。ray-3.2 ビデオモデルは 9:16、3:4、1:1、4:3、16:9、21:9 のサブセットをサポートします。 - 取り得る値: `3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` + 指定可能な値: `3:1`, `2:1`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3` - スタイルやコンテンツのガイダンス用の参照画像。type 'image' では最大 9 枚、type 'image_edit' では最大 8 枚です。 + スタイル/コンテンツのガイダンス用の参照画像。type 'image' の場合は最大 9 枚、type 'image_edit' の場合は最大 8 枚です。 - Base64 エンコードされた画像またはビデオのデータ + Base64 エンコードされた画像またはビデオデータ @@ -171,7 +172,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MIME タイプ。data と併せて必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4）。 + MIME タイプ。data と一緒に必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe では video/mp4）。 @@ -179,13 +180,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオ生成、編集、リフレームには ray-3.2 を使用します。 + 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオの生成、編集、リフレーミングには ray-3.2 を使用します。 - 出力画像フォーマット + 出力画像形式 - 取り得る値: `png`、`jpeg` + 指定可能な値: `png`, `jpeg` @@ -193,11 +194,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうちちょうど 1 つを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つを指定してください。 - Base64 エンコードされた画像またはビデオのデータ + Base64 エンコードされた画像またはビデオデータ @@ -205,7 +206,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MIME タイプ。data と併せて必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4）。 + MIME タイプ。data と一緒に必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe では video/mp4）。 @@ -215,31 +216,31 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ スタイルプリセット - 取り得る値: `auto`、`manga` + 指定可能な値: `auto`, `manga` 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 - 取り得る値: `image`、`image_edit`、`video`、`video_edit`、`video_reframe` + 指定可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` - ray-3.2 のビデオ出力設定。ここでは検証と課金に影響するフィールドのみをモデル化しています。その他のフィールド（編集コントロール、source_position）は Luma にそのまま転送されます。 + ray-3.2 のビデオ出力設定。ここでは検証と課金に影響するフィールドのみをモデル化しています。その他のフィールド（編集コントロール、source_position）はそのまま Luma に転送されます。 - ray-3.2 の video / video_edit におけるクリップの再生時間。デフォルトは 5s です。HDR 生成（type video）は 5s に制限されています。 + ray-3.2 の video / video_edit におけるクリップの再生時間。デフォルトは 5s です。HDR 生成（type video）は 5s に制限されます。 - 取り得る値: `5s`、`10s` + 指定可能な値: `5s`, `10s` - 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうちちょうど 1 つを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つを指定してください。 - Base64 エンコードされた画像またはビデオのデータ + Base64 エンコードされた画像またはビデオデータ @@ -247,7 +248,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MIME タイプ。data と併せて必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4）。 + MIME タイプ。data と一緒に必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe では video/mp4）。 @@ -255,7 +256,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MP4 と併せて EXR ファイルをエクスポートします。hdr が true である必要があります。video_reframe では拒否されます。 + まだ利用できません: exr_export=true を指定したリクエストは、Luma が EXR 配信を提供開始するまで 400 で拒否されます。MP4 と一緒に EXR ファイルをエクスポートします（hdr が true である必要があります）。video_reframe では拒否されます。 @@ -263,15 +264,15 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - `keyframes` に対する出力フレーム位置。同じ長さである必要があります。5s では 0〜120、10s では 0〜240 です。そのまま転送されます。 + `keyframes` の出力フレーム位置。同じ長さで、5s では 0–120、10s では 0–240 です。そのまま転送されます。 - ガイドフレーム画像（1〜64 枚）。start_frame/end_frame とは同時に使用できません。請求はリクエストした再生時間に基づきます。keyframes のリクエストが単一キーフレームの延長として扱われることはありません。 + ガイドフレーム画像（1–64）。start_frame/end_frame とは排他的です。請求は指定した再生時間に基づいて行われます。keyframes リクエストが単一キーフレームの延長として扱われることはありません。 - Base64 エンコードされた画像またはビデオのデータ + Base64 エンコードされた画像またはビデオデータ @@ -279,7 +280,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MIME タイプ。data と併せて必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4）。 + MIME タイプ。data と一緒に必須です（ビデオソースの場合は url とも併用します。例: video_edit / video_reframe では video/mp4）。 @@ -293,23 +294,23 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ ray-3.2 ビデオの出力解像度。デフォルトは 720p です。360p はドラフト階層です。HDR には 720p または 1080p が必要です。 - 取り得る値: `360p`、`540p`、`720p`、`1080p` + 指定可能な値: `360p`, `540p`, `720p`, `1080p` - 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうちちょうど 1 つを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つを指定してください。 - Base64 エンコードされた画像またはビデオのデータ + Base64 でエンコードされた画像またはビデオデータ - ソースとして再利用する、以前に完了した生成の UUID です。ray-3.2 の video_edit / video_reframe で使用されます。 + ソースとして再利用する、以前に完了した生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と一緒に必須です（ビデオソースの場合は url と一緒にも必須です。例: video_edit / video_reframe では video/mp4）。 + MIME タイプ。data との併用が必須です（ビデオソースでは url との併用も必須。例: video_edit / video_reframe における video/mp4）。 @@ -317,10 +318,10 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - Web検索のグラウンディングを有効にします + Google／検索によるグラウンディングを有効にします -`GET /v2/models/luma_2/uni-1-max/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同じドキュメントです。 +`GET /v2/models/luma_2/uni-1-max/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する対象となる同じドキュメントです。 ### 出力 @@ -331,7 +332,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ プログラムで処理するための機械可読な失敗コード - 指定可能な値: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` + 可能な値: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` @@ -347,7 +348,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 生成済み出力のエントリ + 生成済みの出力エントリ @@ -355,19 +356,19 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 署名付き URL（有効期限 1 時間） + Presigned URL（有効期限1時間） 生成の現在の状態 - 指定可能な値: `queued`, `processing`, `completed`, `failed` + 可能な値: `queued`, `processing`, `completed`, `failed` 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 - 指定可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` + 可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` ## 例 diff --git a/ja/development/comfy-router/models/luma_2/uni-1/code.mdx b/ja/development/comfy-router/models/luma_2/uni-1/code.mdx index 09cb926f29..eb93eeb4a5 100644 --- a/ja/development/comfy-router/models/luma_2/uni-1/code.mdx +++ b/ja/development/comfy-router/models/luma_2/uni-1/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Uni 1 を使用する" description: "Comfy Router 経由で luma_2/uni-1 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Uni 1" -translationSourceHash: 5f33116a +translationSourceHash: 897d09ee translationFrom: development/comfy-router/models/luma_2/uni-1/code.mdx translationBlockHashes: "_intro": a9aaf4ab "Quick start": 9d667b90 - "Schema": 6ccb738a + "Schema": fe7e100f "Examples": f993c215 --- + {/* GENERATED FILE. Generated from router-schemas/luma_2/uni-1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -153,17 +154,17 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ ### 入力 - 出力のアスペクト比。ray-3.2 のビデオモデルは 9:16、3:4、1:1、4:3、16:9、21:9 のサブセットをサポートします。 + 出力アスペクト比。ray-3.2 ビデオモデルは 9:16、3:4、1:1、4:3、16:9、21:9 のサブセットをサポートします。 - 指定可能な値: `3:1`, `2:1`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3` + 指定可能な値: `3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` - スタイル/コンテンツのガイダンス用の参照画像。type が 'image' の場合は最大 9 枚、type が 'image_edit' の場合は最大 8 枚です。 + スタイル/コンテンツのガイダンス用の参照画像。type 'image' の場合は最大 9 枚、type 'image_edit' の場合は最大 8 枚です。 - Base64 エンコードされた画像またはビデオデータ + Base64 でエンコードされた画像またはビデオデータ @@ -171,21 +172,21 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME タイプ。data と併用する場合は必須です（ビデオソースの場合は url と併用する場合も必須。例: video_edit / video_reframe での video/mp4）。 + MIME タイプ。data と併用する場合は必須です（ビデオソースの場合は url も必須です。例: video_edit / video_reframe の video/mp4）。 - 一般に公開されている画像またはビデオの URL + 公開アクセス可能な画像またはビデオの URL - 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオの生成、編集、リフレーミングには ray-3.2 を使用します。 + 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオ生成、編集、リフレーミングには ray-3.2 を使用します。 - 出力画像のフォーマット + 出力画像フォーマット - 指定可能な値: `png`, `jpeg` + 指定可能な値: `png`、`jpeg` @@ -193,11 +194,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つを指定してください。 - Base64 エンコードされた画像またはビデオデータ + Base64 でエンコードされた画像またはビデオデータ @@ -205,41 +206,41 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME タイプ。data と併用する場合は必須です（ビデオソースの場合は url と併用する場合も必須。例: video_edit / video_reframe での video/mp4）。 + MIME タイプ。data と併用する場合は必須です（ビデオソースの場合は url も必須です。例: video_edit / video_reframe の video/mp4）。 - 一般に公開されている画像またはビデオの URL + 公開アクセス可能な画像またはビデオの URL スタイルプリセット - 指定可能な値: `auto`, `manga` + 指定可能な値: `auto`、`manga` - 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルで生成され、video/video_edit/video_reframe は ray-3.2 モデルで生成されます。 + 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 - 指定可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` + 指定可能な値: `image`、`image_edit`、`video`、`video_edit`、`video_reframe` - ray-3.2 のビデオ出力設定。ここでは検証と課金に影響するフィールドのみをモデル化しています。その他のフィールド（編集コントロール、source_position）はそのまま Luma に転送されます。 + ray-3.2 のビデオ出力設定。ここでは検証と課金に影響するフィールドのみをモデル化しています。追加のフィールド（編集コントロール、source_position）は変更されずに Luma に転送されます。 - ray-3.2 の video / video_edit におけるクリップの再生時間。デフォルトは 5s です。HDR 生成（type が video）は 5s に制限されています。 + ray-3.2 の video / video_edit におけるクリップの再生時間。デフォルトは 5s です。HDR 生成（type video）は 5s に制限されます。 - 指定可能な値: `5s`, `10s` + 指定可能な値: `5s`、`10s` - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つを指定してください。 - Base64 エンコードされた画像またはビデオデータ + Base64 でエンコードされた画像またはビデオデータ @@ -247,15 +248,15 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME タイプ。data と併用する場合は必須です（ビデオソースの場合は url と併用する場合も必須。例: video_edit / video_reframe での video/mp4）。 + MIME タイプ。data と併用する場合は必須です（ビデオソースの場合は url も必須です。例: video_edit / video_reframe の video/mp4）。 - 一般に公開されている画像またはビデオの URL + 公開アクセス可能な画像またはビデオの URL - MP4 と併せて EXR ファイルをエクスポートします。hdr が true である必要があります。video_reframe では拒否されます。 + 利用不可: Luma が EXR 配信をリリースするまで、exr_export=true のリクエストは 400 で拒否されます。MP4 と一緒に EXR ファイルをエクスポートします（hdr true が必要）。video_reframe では拒否されます。 @@ -263,15 +264,15 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - `keyframes` の出力フレーム位置。同じ長さである必要があります。5s の場合は 0–120、10s の場合は 0–240 です。そのまま転送されます。 + `keyframes` の出力フレーム位置。同じ長さである必要があります。5s の場合は 0〜120、10s の場合は 0〜240 です。変更されずに転送されます。 - ガイドフレーム画像（1–64）。start_frame/end_frame とは同時に指定できません。課金は指定した再生時間に基づきます。keyframes のリクエストが単一キーフレームの延長として扱われることはありません。 + ガイドフレーム画像（1〜64）。start_frame/end_frame とは同時に使用できません。請求はリクエストされた再生時間に基づいて行われます。keyframes リクエストが単一キーフレームの拡張として扱われることはありません。 - Base64 エンコードされた画像またはビデオデータ + Base64 でエンコードされた画像またはビデオデータ @@ -279,48 +280,48 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME タイプ。data と併用する場合は必須です（ビデオソースの場合は url と併用する場合も必須。例: video_edit / video_reframe での video/mp4）。 + MIME タイプ。data と併用する場合は必須です（ビデオソースの場合は url も必須です。例: video_edit / video_reframe の video/mp4）。 - 一般に公開されている画像またはビデオの URL + 公開アクセス可能な画像またはビデオの URL - 生成されたクリップをループします。作成時のみ（type が video）。 + 生成されたクリップをループします。作成時のみ（type video）。 - ray-3.2 のビデオの出力解像度。デフォルトは 720p です。360p はドラフト用のティアです。HDR には 720p または 1080p が必要です。 + ray-3.2 ビデオの出力解像度。デフォルトは 720p です。360p はドラフトティアです。HDR には 720p または 1080p が必要です。 - 指定可能な値: `360p`, `540p`, `720p`, `1080p` + 指定可能な値: `360p`、`540p`、`720p`、`1080p` - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つを指定してください。 - Base64 エンコードされた画像またはビデオデータ + Base64 でエンコードされた画像またはビデオデータ - ソースとして再利用する、以前に完了した生成の UUID です。ray-3.2 の video_edit / video_reframe で使用されます。 + ソースとして再利用する、以前に完了した生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と併せて必須です（ビデオソースでは url も必要です。例: video_edit / video_reframe における video/mp4）。 + MIME タイプ。data と一緒に指定する場合は必須です（ビデオソースの場合は url も必須です。例: video_edit / video_reframe では video/mp4）。 - 一般公開されている画像またはビデオの URL + 公開アクセス可能な画像またはビデオの URL - Web 検索のグラウンディングを有効にします + Web 検索によるグラウンディングを有効にする -Router が `GET /v2/models/luma_2/uni-1/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するドキュメントと同じものです。 +`GET /v2/models/luma_2/uni-1/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同じドキュメントです。 ### 出力 @@ -331,11 +332,11 @@ Router が `GET /v2/models/luma_2/uni-1/openapi.json` で提供するスキー プログラムで処理するための機械可読な失敗コード - 指定可能な値: `content_moderated`、`generation_failed`、`budget_exhausted`、`output_not_found` + 取り得る値: `content_moderated`、`generation_failed`、`budget_exhausted`、`output_not_found` - 人間が読める形式の失敗の説明。FAILED の生成時のみ設定されます。成功した生成では `null` になります。 + 人間が読める形式の失敗の説明。失敗した生成の場合にのみ設定されます。成功した生成では `null` です。 @@ -355,19 +356,19 @@ Router が `GET /v2/models/luma_2/uni-1/openapi.json` で提供するスキー - 署名付き URL（有効期限 1 時間） + 署名付き URL（有効期限1時間） 生成の現在の状態 - 指定可能な値: `queued`、`processing`、`completed`、`failed` + 取り得る値: `queued`、`processing`、`completed`、`failed` - 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 + 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルで生成され、video/video_edit/video_reframe は ray-3.2 モデルで生成されます。 - 指定可能な値: `image`、`image_edit`、`video`、`video_edit`、`video_reframe` + 取り得る値: `image`、`image_edit`、`video`、`video_edit`、`video_reframe` ## 例 diff --git a/ja/development/comfy-router/models/veed/fabric-1-0/code.mdx b/ja/development/comfy-router/models/veed/fabric-1-0/code.mdx index 6d0141b497..e368939f0d 100644 --- a/ja/development/comfy-router/models/veed/fabric-1-0/code.mdx +++ b/ja/development/comfy-router/models/veed/fabric-1-0/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router で Fabric 1.0 を使用する" description: "Comfy Router 経由で veed/fabric-1.0 を呼び出します: エンドポイント、リクエストの形状、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 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/veed/fabric-1.0.json から生成されています。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -154,7 +155,7 @@ curl https://api.comfy.org/v2/models/veed/fabric-1.0/requests/$REQUEST_ID \ ### 入力 - リップシンクの対象となる音声トラックの公開 http(s) URL。ビデオの長さはオーディオと同じになります。 + リップシンクの対象となる音声トラックの公開 http(s) URL。ビデオの長さはオーディオと同じになります。オーディオが呼び出しごとの入力上限を超える場合は 400 で拒否されます。 diff --git a/ja/development/comfy-router/models/veed/lipsync-2-0/code.mdx b/ja/development/comfy-router/models/veed/lipsync-2-0/code.mdx index 286679a13e..5947441836 100644 --- a/ja/development/comfy-router/models/veed/lipsync-2-0/code.mdx +++ b/ja/development/comfy-router/models/veed/lipsync-2-0/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router で Lipsync 2.0 を使用する" description: "Comfy Router 経由で veed/lipsync-2.0 を呼び出します。エンドポイント、リクエストの形状、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 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/veed/lipsync-2.0.json から生成されます。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -150,7 +151,7 @@ curl https://api.comfy.org/v2/models/veed/lipsync-2.0/requests/$REQUEST_ID \ ### 入力 - ビデオにリップシンクさせる新しいオーディオトラックの公開 http(s) URL。 + ビデオにリップシンクさせる新しいオーディオトラックの公開 http(s) URL。オーディオが1回の呼び出しあたりの入力上限を超える場合は 400 で拒否されます。 diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index f5eb2d8754..6ab202222d 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: 1b971d1c +translationSourceHash: 7bdc66a2 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": fbcaaf0e - "Error buckets": 36170340 + "Endpoints": 222fd740 + "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 3ecabac6 + "Pre-flight cost estimates": 862a49f8 "Result assets": 65fc939b "Per-model input and output schemas": 61c6bde8 - "Schemas": 77cfa4db + "Schemas": 0c65163b --- @@ -234,7 +234,7 @@ Comfy API キーは Bearer トークンとして送信することもできま 無効なリクエストです。エラータイプとリクエストボディを確認してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `Idempotent-Replayed` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `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` @@ -840,6 +840,7 @@ Router が受け付けたものの、完了できなかったリクエストに | `queue_timeout` | キュー中のリクエストが、一度も受け入れられることなくキュータイムアウトを超えて待機し続けました。 | | `request_not_found` | `request_id` が、このモデルにおける呼び出し元のどのリクエストも指していません。 | | `queue_backlog_full` | 呼び出し元が既に実行待ちのキュー中リクエストを抱えすぎているため、この送信は拒否されました。 | +| `result_expired` | リクエストは存在し完了していましたが、その結果はもう保存されていないため、収集時に返せるものがありません。 | ## レスポンスヘッダー @@ -1034,6 +1035,24 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 ## スキーマ +### RouterBilledWorkspace + +拒否された呼び出しで課金されるはずだったウォレットです（`RouterErrorResponse.billed_workspace`）。「どのウォレットが空なのか」に答えるものであり、呼び出し元の UI が現在選択しているワークスペースとは限りません。残高のあるチームを開いていても、チームメンバーの個人認証情報はここではその個人ウォレットを示します。`denied_reason` と同時にのみ存在します。 + +**フィールド** + + + Cloud ワークスペースの id。レガシーレールでは存在しません。 + + + + `personal` または `team`。オープンな文字列であり、それ以外の値は personal として扱ってください。 + + + + 呼び出しが Cloud ワークスペースではなく、呼び出し元のワークスペース導入前の Metronome 顧客に課金される場合は `legacy`。その顧客にはワークスペース id がありません。Cloud ワークスペースでは存在しません。 + + ### RouterChargesOnPolicyRejection このモデルでコンテンツポリシーによる拒否が課金されるかどうか。不明な値は課金される可能性があるものとして扱ってください。 @@ -1101,7 +1120,7 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 - この見積もりの価格算出に使用したレートカードを取得した日時。実行は、評価された時点で有効な料率で課金され、この瞬間の料率で課金されるわけではありません。レートカードが読まれなかった場合（`reason: pricing_unavailable`、`byok`、またはどのカードからも価格を算出できない `not_quotable` の呼び出し）は、見積もりが返された日時を示します。 + この見積もりの価格算出に使用したレートカードを取得した日時。実行は、評価された時点で有効な料率で課金され、この瞬間の料率で課金されるわけではありません。ベンダーが公開している価格リストから取得した `estimated` 見積もり（ベンダーが報告するコストで課金されるモデル）は、代わりにそのリストを読んだ日付を持ちます。課金数量をそのリストから予測し、それをレートカードで価格付けする見積もり（ベンダーが報告するクレジットで課金されるモデル）は、二つのうち古い方の日付を持ちます。レートカードが読まれなかった場合（`reason: pricing_unavailable`、`byok`、またはどのカードからも価格を算出できない `not_quotable` の呼び出し）は、見積もりが返された日時を示します。 date-time @@ -1121,7 +1140,7 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 - Router の失敗を表す粗い機械可読なバケットで、`X-Comfy-Error-Type` レスポンスヘッダーにも反映されるため、呼び出し元はボディをパースせずに分岐できます。この集合は 19 個の値で閉じています。6 つのリクエストレベルのバケット `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits`、`model_not_found` に加えて、トランスポートレベルの `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full` です。「閉じている」とは今日文書化されている集合を指すのであり、永久に保たれる上限ではありません。集合は増えることが想定されているため、これは意図的に `enum` ではなくプレーンな文字列になっています。したがってクライアントは、上記のリストを網羅的に switch して次の追加のたびに壊れるのではなく、認識できない値を `internal_error` として扱わなければなりません。 + Router の失敗を表す粗い機械可読なバケットで、`X-Comfy-Error-Type` レスポンスヘッダーにも反映されるため、呼び出し元はボディをパースせずに分岐できます。この集合は 20 個の値で閉じています。6 つのリクエストレベルのバケット `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits`、`model_not_found` に加えて、トランスポートレベルの `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full`、`result_expired` です。「閉じている」とは今日文書化されている集合を指すのであり、永久に保たれる上限ではありません。集合は増えることが想定されているため、これは意図的に `enum` ではなくプレーンな文字列になっています。したがってクライアントは、上記のリストを網羅的に switch して次の追加のたびに壊れるのではなく、認識できない値を `internal_error` として扱わなければなりません。 型: [`RouterErrorType`](#routererrortype) @@ -1134,6 +1153,20 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 コンテンツポリシーによる拒否がどの入力または出力に関するものかを、Router レベルの閉じた語彙として示します。`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio` です。プロバイダーがモダリティを特定しなかった場合、単なる `input` / `output` の値がどちら側かを示します。`error_type` が `content_policy_violation` で、プロバイダーが拒否された対象を機械可読なコードで示した場合にのみ存在し、それ以外では存在しません。プロバイダーのテキストが入ることはありません。現在は BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI、Wan の拒否に対して、また MiniMax Router の Nano Banana レッグにおける Gemini の拒否に対しても付与されます。拒否がどちら側に関するものかを示さないプロバイダーでは存在しません。`X-Comfy-Refusal-Subject` ヘッダーに反映されます。 + + パートナーノードの支出拒否に対する課金側のポリシー分岐です。`no_funds` は課金対象ウォレットが空であること、`unspecified` は資金の読み取りを伴わずに拒否されたことを示します。`error_type` が `insufficient_credits` で、デプロイがウォレットの事実を報告する場合にのみ存在します。それ以外では存在しません。表示用テキストではなく機械可読なコードです。表示には `detail` を使い、分岐にはこの値を使います。 + + + + 拒否された呼び出しで課金されるはずだったウォレットです（`RouterErrorResponse.billed_workspace`）。「どのウォレットが空なのか」に答えるものであり、呼び出し元の UI が現在選択しているワークスペースとは限りません。残高のあるチームを開いていても、チームメンバーの個人認証情報はここではその個人ウォレットを示します。`denied_reason` と同時にのみ存在します。 + + 型: [`RouterBilledWorkspace`](#routerbilledworkspace) + + + + 拒否されたリクエストがどの方法で認証されたかを示します。`personal_api_key`、`team_api_key`、`personal_session`、`team_session` のいずれかです。「もう一方のウォレットに課金するにはどの認証情報に切り替えればよいか」に答えるものです。権限ではなく、何も付与しません。`denied_reason` と同時にのみ存在します。 + + ### RouterErrorType 機械可読な Router エラーカテゴリ。`X-Comfy-Error-Type` ヘッダーでも送信されます。 @@ -1147,7 +1180,7 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 **フィールド** - コンテンツポリシーを理由にこのモデルが拒否した呼び出しでも、呼び出し元に課金されるかどうか。プロバイダーによって異なり、その違いは呼び出し時には見えず、同じ呼び出しでエラーと課金の両方を見たユーザーには知りようがありません。そのため、プロバイダーごとの伝聞に任せるのではなく、モデルごとに、呼び出しの前に明示されます。 + コンテンツポリシーを理由にこのモデルが拒否した呼び出しでも、呼び出し元に課金されるかどうか。プロバイダーによって異なり、その違いは呼び出し時には見えず、同じ呼び出しでエラーと課金の両方を見たユーザーには知りようがありません。そのため、プロバイダーごとの伝聞に任せるのではなく、モデルごとに、呼び出しの前に明示されます。`yes` の場合、同期ルートの `content_policy_violation` エラーに `X-Comfy-Credits-Used` が付くことがあります。プロバイダーがモデルの生成出力を拒否し、Comfy がその拒否された生成の使用量を記録した場合に付き、その金額を持ちます。入力側の拒否と同じキーのリプレイ（`Idempotent-Replayed: true`）には付きません。ヘッダーのない拒否は報告されていないだけで、無料であった証明ではありません。 型: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) diff --git a/ko/development/api-development/sdks.mdx b/ko/development/api-development/sdks.mdx index 8beead1205..d3fbca2d89 100644 --- a/ko/development/api-development/sdks.mdx +++ b/ko/development/api-development/sdks.mdx @@ -3,13 +3,13 @@ title: "Comfy SDK: ComfyUI용 Python 및 TypeScript 클라이언트" description: "Python 또는 TypeScript로 Comfy Cloud, 자체 배포 또는 자체 ComfyUI를 대상으로 ComfyUI 워크플로를 실행하고, 에셋, 작업, 라이브 이벤트, 멱등 재시도를 다룹니다." sidebarTitle: "SDK" icon: "code" -translationSourceHash: dbb2e0a8 +translationSourceHash: fd912955 translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 "Quickstart": 02297586 - "Choosing a base URL": 2265e6f6 + "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f "Watching a job run": 34d74bcc "Tracing an output back to its workflow": b01886a3 @@ -21,6 +21,7 @@ translationBlockHashes: + import SdkSurfaces from "/snippets/ko/sdk/surfaces.mdx"; import SdkVersions from "/snippets/ko/sdk/versions.mdx"; @@ -116,7 +117,7 @@ await job.getOutputs("9")[0].toFile("out.png"); | **Comfy API 배포** | `https://.run.comfy.app` | 필수 | | **자체 ComfyUI** | `http://127.0.0.1:8189` (로컬 프록시) | 기본적으로 없음. 선택적 정적 Bearer 토큰 | -기본 URL은 생성자 인자가 아닌 `COMFY_BASE_URL` 환경 변수에서 가져옵니다: +기본 URL은 생성자 인자가 아니라 `COMFY_BASE_URL` 환경 변수에서 가져옵니다: ```bash export COMFY_BASE_URL="https://.run.comfy.app" # Comfy API 배포 @@ -157,7 +158,7 @@ Comfy API 배포는 Build에 포함된 모델과 커스텀 노드를 사용하 ### 자체 ComfyUI -자체 호스팅 ComfyUI에서는 함께 실행되는 작은 오픈소스 서비스인 [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy)가 v2 API를 제공합니다. 설치하고 실행한 다음 `COMFY_BASE_URL="http://127.0.0.1:8189"`를 설정하세요: +자체 호스팅 ComfyUI에서 v2 API는 ComfyUI와 함께 실행되는 작은 오픈소스 서비스인 [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy)가 제공합니다. 설치하고 실행한 다음 `COMFY_BASE_URL="http://127.0.0.1:8189"`를 설정하세요: ```bash pip install comfy-api-proxy @@ -165,7 +166,7 @@ comfy-api-proxy export COMFY_BASE_URL="http://127.0.0.1:8189" ``` -설정과 인증은 [자체 호스팅 ComfyUI용 API 프록시](/ko/development/comfyui-server/api-proxy)를 참고하세요. +설정과 인증에 대한 세부 정보는 [자체 호스팅 ComfyUI용 API 프록시](/ko/development/comfyui-server/api-proxy)를 참고하세요. ## 제출 재시도: 멱등성 키 diff --git a/ko/development/cloud/api-reference.mdx b/ko/development/cloud/api-reference.mdx index 6fd6da2bcf..47fa3b5ea4 100644 --- a/ko/development/cloud/api-reference.mdx +++ b/ko/development/cloud/api-reference.mdx @@ -2,14 +2,14 @@ title: "클라우드 API 참조" description: "Comfy Cloud의 코드 예제와 함께 제공되는 완벽한 API 참조" icon: "book-open" -translationSourceHash: 9dfb0617 +translationSourceHash: e15f0e0e translationFrom: development/cloud/api-reference.mdx translationBlockHashes: "_intro": 1729f5d3 "Setup": 311034bb "Object Info": 7b62a397 "Uploading Inputs": 92df17f8 - "Running Workflows": d6ddd0b4 + "Running Workflows": 2c6519c7 "Checking Job Status": d74b4922 "WebSocket for Real-Time Progress": 02c49b4a "Downloading Outputs": 5e1d63d3 @@ -19,6 +19,7 @@ translationBlockHashes: --- + import PollJobCompletion from "/snippets/ko/cloud/poll-job-completion.mdx" import WebSocketProgress from "/snippets/ko/cloud/websocket-progress.mdx" import DownloadOutputs from "/snippets/ko/cloud/download-outputs.mdx" @@ -343,7 +344,7 @@ print(f"Submitted job: {prompt_id}") ### 파트너 노드 사용 -워크플로에 [파트너 노드](/ko/tutorials/partner-nodes/overview) (FLUX Pro, Ideogram 등 외부 AI 서비스를 호출하는 노드)가 포함된 경우, 요청 페이로드의 `extra_data` 필드에 [Comfy API 키](/ko/development/api-development/getting-an-api-key)를 포함해야 합니다. +워크플로에 [파트너 노드](/ko/tutorials/partner-nodes/overview)(FLUX Pro, Ideogram 등 외부 AI 서비스를 호출하는 노드)가 포함된 경우, 요청 페이로드의 `extra_data` 필드에 [Comfy API 키](/ko/development/api-development/getting-an-api-key)를 포함해야 합니다. ComfyUI 프론트엔드는 브라우저에서 워크플로를 실행할 때 자동으로 API 키를 `extra_data`에 패키징합니다. 이 섹션은 API를 직접 호출할 때만 관련이 있습니다. diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index c1344131f1..b3684251ec 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: b40af72c +translationSourceHash: 450771dd translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -13,9 +13,9 @@ translationBlockHashes: "Request bodies are capped": 675b77c8 "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d - "Comfy charges and usage": ed49ddec - "Models without a pre-flight estimate": 7373adf0 - "Router does not cover every partner operation": 97d31362 + "Comfy charges and usage": 7f5ccda7 + "Models without a pre-flight estimate": 0e7f595d + "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- @@ -27,6 +27,7 @@ translationBlockHashes: + Router는 파트너 모델을 하나의 동기식 HTTP 호출로 실행하거나, 제출한 뒤 나중에 수집하는 대기 중 요청을 통해 실행합니다. 애플리케이션이 완료된 결과를 기다리거나 나중에 결과를 수집할 수 있고, 모델 자체의 입력 및 출력 필드를 처리할 수 있는 경우에 사용하십시오. ## Router가 지원하는 기능 @@ -102,21 +103,20 @@ Router는 최종 응답만 반환하며, 스트리밍되는 토큰, 서버 전 응답에는 공급자 사용량 또는 비용 필드가 포함될 수 있습니다. 이는 보편적인 Comfy 요금을 나타내지 않습니다. `X-Comfy-Credits-Used`는 선택 사항입니다. 헤더가 누락되었다는 것은 비용이 보고되지 않았음을 뜻할 뿐, 실행이 무료였다는 뜻은 아닙니다. 재생된 응답(`Idempotent-Replayed: true`)에는 다시 요금이 부과되지 않지만 원본 실행의 수치를 다시 기재할 수 있으므로, 하나의 `Idempotency-Key`에 대한 재시도 전체에 걸쳐 이 헤더를 합산해서는 안 됩니다. 잔액, 사용량, 청구서는 Comfy 플랫폼을 사용하세요. -카탈로그는 가격이 아니라 `billing.charges_on_policy_rejection`을 포함한 청구 관련 사실 정보를 제공합니다. `yes`, `no`, `unknown`을 명시적으로 처리하세요. 자세한 내용은 [billing](/ko/development/comfy-router/billing#모델-청구-정보)을 참조하세요. +카탈로그는 가격이 아니라 `billing.charges_on_policy_rejection`을 포함한 청구 관련 사실 정보를 제공합니다. `yes`, `no`, `unknown`을 명시적으로 처리하세요. 값이 `yes`인 경우, 동기 `content_policy_violation` 오류가 `X-Comfy-Credits-Used`를 포함할 수 있습니다. 공급자가 모델의 생성됨 출력을 거부했고 Comfy가 그 거부된 생성에 대한 사용량을 기록한 경우에는 이 헤더가 포함되며 해당 수량을 담습니다. 입력 측 거부와 동일 키 재생에는 이 헤더가 포함되지 않습니다. 헤더가 없는 거부는 보고되지 않은 것이지 무료라는 뜻이 아닙니다. 자세한 내용은 [billing](/ko/development/comfy-router/billing#모델-청구-정보)을 참조하세요. -실행 전에 가격을 확인하려면 `POST /v2/models/{provider}/{model}/estimate`를 호출하거나, 대기 중인 제출의 `201` 응답에서 `estimate` 객체를 읽으세요. 추정 기능이 단계적으로 출시되는 동안 이 경로는 `error_type: not_enabled`와 함께 `403`을 반환하고, 제출 응답에서는 `estimate`가 생략됩니다. 각 추정치는 Comfy가 해당 실행에 청구하는 요율표를 기준으로 산정되지만, 그 수치는 추정치일 뿐 최종 청구 금액이 아니며, 워크스페이스의 사용량 및 청구 기록에 정산된 금액이 최종입니다. 이는 가격 고정도 아닙니다. 자체 공급자 키로 실행한 경우에는 `/estimate`가 그 실행의 수치를 반환하더라도 Comfy가 요금을 청구하지 않으며, `unknown` 추정치에는 수치가 없는데 이는 무료라는 뜻이 아닙니다. `X-Comfy-Credits-Used`는 실행에 대한 반올림된 사후 수치일 뿐 영수증이 아닙니다. `exact`, `estimated`, `unknown`을 읽는 방법은 [실행 전 비용 추정](/ko/development/comfy-router/reference#실행-전-비용-추정)을 참조하세요. 실행 전에 가격을 산정할 수 없는 모델은 [사전 추정치가 없는 모델](#사전-견적이-없는-모델)에 나열되어 있습니다. +실행 전에 가격을 확인하려면 `POST /v2/models/{provider}/{model}/estimate`를 호출하거나, 대기 중인 제출의 `201` 응답에서 `estimate` 객체를 읽으세요. 추정 기능이 단계적으로 출시되는 동안 이 경로는 `error_type: not_enabled`와 함께 `403`을 반환하고, 제출 응답에서는 `estimate`가 생략됩니다. 각 추정치는 Comfy가 해당 실행에 청구하는 요율표를 기준으로 산정되지만(공급자가 보고한 비용으로 청구되는 모델은 대신 공급자의 공개 가격표를 기준으로 추정됩니다), 그 수치는 추정치일 뿐 최종 청구 금액이 아니며, 워크스페이스의 사용량 및 청구 기록에 정산된 금액이 최종입니다. 이는 가격 고정도 아닙니다. 자체 공급자 키로 실행한 경우에는 `/estimate`가 그 실행의 수치를 반환하더라도 Comfy가 요금을 청구하지 않으며, `unknown` 추정치에는 수치가 없는데 이는 무료라는 뜻이 아닙니다. `X-Comfy-Credits-Used`는 실행에 대한 반올림된 사후 수치일 뿐 영수증이 아닙니다. `exact`, `estimated`, `unknown`을 읽는 방법은 [실행 전 비용 추정](/ko/development/comfy-router/reference#실행-전-비용-추정)을 참조하세요. 실행 전에 가격을 산정할 수 없는 모델은 [사전 추정치가 없는 모델](#사전-견적이-없는-모델)에 나열되어 있습니다. ## 사전 견적이 없는 모델 Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정적으로 산정할 수 없으므로, 이들 모델에 대해서는 `/estimate`와 대기 중인 제출의 `estimate`가 `source: unknown`으로 응답할 것으로 예상해야 합니다. 다만 특정 요청 본문에 대해서는 값을 반환할 수도 있습니다. `unknown`은 실행이 무료라는 뜻이 아니라, 값이 제시되지 않았다는 뜻입니다. [Comfy 요금 및 사용량](#comfy-요금-및-사용량) 규칙은 여전히 적용됩니다. 자체 공급자 키로 실행한 경우 Comfy에서 과금하지 않으며, `X-Comfy-Credits-Used`는 선택 사항이므로 헤더가 누락되었다면 비용이 보고되지 않았다는 뜻입니다. 여기에 나열되지 않은 모델도 특정 요청 본문에 대해 `unknown`으로 응답할 수 있으므로, 모든 견적에서 `source`를 확인하세요. -이 목록은 견적 적용 범위가 늘어나면 줄어듭니다. 이 목록은 Router 자체의 가격 책정 코드에서 생성되며, 공개적으로 사용할 수 없는 모델은 나열되지 않습니다. +이 목록은 견적 적용 범위가 늘어나면 줄어듭니다. Router 자체의 가격 책정 코드에서 생성되며, 공개적으로 사용할 수 없는 모델은 나열되지 않습니다. {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} -- **bfl**: `bfl/erase-v1`, `bfl/flux-2-max`, `bfl/flux-2-pro`, `bfl/flux-3-image`, `bfl/flux-3-video`, `bfl/flux-kontext-max`, `bfl/flux-kontext-pro`, `bfl/flux-pro-1.0-expand`, `bfl/flux-pro-1.0-fill`, `bfl/flux-pro-1.1`, `bfl/flux-pro-1.1-ultra`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` +- **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` -- **elevenlabs**: `elevenlabs/eleven_sfx_v2` - **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` - **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` @@ -125,25 +125,30 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 - **luma**: `luma/photon-1`, `luma/photon-flash-1`, `luma/ray-2`, `luma/ray-flash-2` - **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` - **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` -- **recraft**: `recraft/recraftv2`, `recraft/recraftv3`, `recraft/recraftv4`, `recraft/recraftv4_1`, `recraft/recraftv4_1_pro`, `recraft/recraftv4_1_pro_vector`, `recraft/recraftv4_1_utility`, `recraft/recraftv4_1_utility_pro`, `recraft/recraftv4_1_utility_pro_vector`, `recraft/recraftv4_1_utility_vector`, `recraft/recraftv4_1_vector`, `recraft/recraftv4_pro`, `recraft/recraftv4_styles`, `recraft/recraftv4_styles_pro`, `recraft/recraftv4_styles_pro_vector`, `recraft/recraftv4_styles_vector` - **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` -- **runway**: `runway/gen4_image` - **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/flashvsr`, `wavespeed/seedvr2`, `wavespeed/ultimate-image-upscaler`, `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` -- **xai**: `xai/grok-imagine-image`, `xai/grok-imagine-image-2.0`, `xai/grok-imagine-image-pro`, `xai/grok-imagine-image-quality`, `xai/grok-imagine-video`, `xai/grok-imagine-video-1.5`, `xai/grok-imagine-video-1.5-lite`, `xai/grok-imagine-video-1.5-preview` +- **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} +`openai/gpt-image-2`, `openai/gpt-image-2.5-flare`, `openai/gpt-image-2.5-sunburst`에 대한 편집 작업에도 사전 견적이 없습니다. 이 모델 중 하나에 대한 편집 호출 또는 입력 이미지를 함께 전달하는 생성 호출은 `source: unknown`으로 응답합니다. 이들 모델에 대한 텍스트 전용 생성 호출은 견적이 산정되므로 위 목록에 포함되지 않습니다. + ## Router는 모든 파트너 작업을 다루지 않습니다 -Router는 모델을 실행합니다. 파일 업로드, 계정 읽기, 에셋 관리, 스트리밍, 공급자 작업 제어에는 Router 외부에 있고 그 계약에서 설명되지 않는 `/proxy/…` 아래의 파트너 프록시 라우트가 필요할 수 있습니다. Router 자체의 표면은 [Comfy Router 명세](/router-openapi.yaml)입니다. 지원 여부는 공급자마다 다릅니다. +Router는 모델을 실행합니다. 파일 업로드, 계정 조회, 에셋 관리, 스트리밍, 공급자 작업 제어에는 Router 외부에 있고 그 계약에서 설명되지 않는 `/proxy/…` 아래의 파트너 프록시 라우트가 필요할 수 있습니다. Router 자체의 표면은 [Comfy Router 명세](/router-openapi.yaml)입니다. 지원 여부는 공급자마다 다릅니다. + +### Krea 3 참조 이미지: 먼저 업로드하거나 공개 https URL 사용 + +`krea/krea-3`의 `image_urls`에서 `POST /proxy/krea/assets`가 반환한 `image_url`(`https://app-uploads.krea.ai/...` URL)은 항상 허용됩니다. 다른 링크가 허용되는지는 환경에 따라 다릅니다. api.comfy.org에서는 현재 허용됩니다. -### Krea 3 참조 이미지는 먼저 업로드해야 합니다 +- **다른 링크가 허용되는 경우**, 공개 `https` 이미지 URL이면 무엇이든 작동합니다. Router는 모델이 실행되기 전에 각 이미지의 크기를 읽습니다. 호스트가 공개적으로 접근할 수 없거나 존재하지 않는 링크, `408` 또는 `429` 이외의 `4xx`로 응답하는 링크, 또는 이미지가 아닌 링크는 해당 호스트 이름을 명시하는 `400` `invalid_input`으로 거부됩니다. 일시적인 DNS, TLS 또는 연결 실패, 시간 초과, 또는 오리진의 `408` 또는 `429`는 `502` 오류로 실패합니다. 실제 업로드가 아닌 `app-uploads.krea.ai` 링크는 다른 접근할 수 없는 참조와 마찬가지로 `400`으로 거부됩니다. 서버가 시작된 직후, 어떤 규칙이 적용되는지 아직 파악하지 못한 시점에는 `app-uploads.krea.ai` 링크가 아닌 공개 `https` URL이 `503`으로 실패할 수 있으며, 이 경우 재시도해도 안전합니다. +- **다른 링크가 허용되지 않는 경우**, 모든 항목은 업로드의 `image_url`이어야 합니다. Router는 링크가 호스트가 정확히 `app-uploads.krea.ai`인 `https` URL로 파싱되는지만 확인합니다(다른 호스트도, 명시적 포트도 허용되지 않음). 직접 호스팅한 공개 `https` URL을 포함해 그 밖의 링크는 모델이 실행되기 전에 `400` `invalid_input`으로 거부됩니다. 이 검사를 통과했지만 실제 업로드가 아닌 링크(만료됨, 삭제됨 또는 잘못 입력됨)는 여전히 통과하며, 그러면 Router가 이미지 크기를 읽지 못해 `400`이 아닌 `5xx` 오류로 응답합니다. -`krea/krea-3`는 임의의 이미지 링크를 허용하지 않습니다. `image_urls`의 모든 항목은 `POST /proxy/krea/assets`가 반환한 `image_url`이어야 하며, 이는 `https://app-uploads.krea.ai/...` URL입니다. Router는 링크가 호스트가 정확히 `app-uploads.krea.ai`인 `https` URL로 파싱되는지만 확인합니다(다른 호스트도, 명시적 포트도 허용되지 않음). 직접 호스팅한 공개 `https` URL을 포함해 그 밖의 링크는 모델이 실행되기 전에 `400` `invalid_input`으로 거부됩니다. 이 검사를 통과했지만 실제 업로드가 아닌 링크(만료됨, 삭제됨 또는 잘못 입력됨)는 여전히 통과하며, 그러면 Router가 이미지 크기를 읽지 못해 `400`이 아닌 `5xx` 오류로 응답합니다. 따라서 항상 업로드가 반환한 그대로의 `image_url`을 전달하세요. +업로드는 모든 환경에서 작동하므로 이식 가능한 선택입니다. 항상 업로드가 반환한 그대로의 `image_url`을 전달하세요. 1. 각 참조 이미지를 `multipart/form-data`로 업로드하고, 이미지는 폼 필드 `file`에 담습니다(JPEG, PNG 또는 WebP, 최대 75 MB). Router와 동일한 방식으로 `X-API-Key` 또는 `Authorization: Bearer`를 사용해 인증합니다. diff --git a/ko/development/comfy-router/litellm.mdx b/ko/development/comfy-router/litellm.mdx index 1849017000..11bc33c62e 100644 --- a/ko/development/comfy-router/litellm.mdx +++ b/ko/development/comfy-router/litellm.mdx @@ -2,16 +2,17 @@ title: "LiteLLM과 함께 Comfy Router 사용하기" sidebarTitle: "LiteLLM" description: "Comfy Router를 패스스루 엔드포인트로 LiteLLM Proxy 뒤에 두고, x-litellm-response-cost 헤더에서 각 실행의 정확한 USD 비용을 기록합니다. 유지 관리할 가격표가 필요 없습니다." -translationSourceHash: e35cd883 +translationSourceHash: 8183ff58 translationFrom: development/comfy-router/litellm.mdx translationBlockHashes: "_intro": 1ddb0d0a "Configure the pass-through": 380c3ae3 - "How spend is recorded": f852c18c + "How spend is recorded": 699ed64b "Queued delivery": 46044c93 "Notes": 50e3cf6b --- + 이미 [LiteLLM Proxy](https://docs.litellm.ai/docs/proxy/pass_through)로 지출을 추적하고 있다면, Comfy Router를 pass-through 엔드포인트 하나 더 추가할 수 있습니다. 호출자는 LiteLLM 키를 그대로 사용하고, Comfy API 키는 프록시에 남아 있습니다. Router는 실행당 Comfy 크레딧 가격을 보고하는 모델의 경우, 실행 비용을 미국 달러로 `x-litellm-response-cost` 응답 헤더에 보고합니다. 동기 실행에서는 실행 응답에, [대기 중](#대기-중-전달) 실행에서는 결과 수집 응답에 해당합니다([비용을 보고하지 않는 실행](#비용을-보고하지-않는-실행) 참조). LiteLLM은 모든 pass-through 응답에서 이 헤더를 읽어 요청의 지출로 기록하므로, 해당 모델에 대한 가격표를 유지할 필요가 없습니다. @@ -102,11 +103,11 @@ X-Litellm-Total-Tokens: 0 - Comfy 크레딧이 아니라 자신의 공급자 키로 청구되는 실행 - 아직 Router의 실행별 크레딧 가격을 보고하는 모델 목록에 없는 모델. 이 목록은 보수적이며, 일부 공급자는 아예 포함되지 않습니다 - Comfy 청구에 도달하지 못한 청구 -- 오류 응답 +- 오류 응답. `billing.charges_on_policy_rejection`이 `yes`인 모델에서 발생한 동기 `content_policy_violation`은 거부된 생성의 가격과 함께 `X-Comfy-Credits-Used`를 포함할 수 있습니다. 그러나 `x-litellm-response-cost`는 절대 포함하지 않습니다. 오류는 LiteLLM이 기록할 결과가 아니기 때문입니다 또한 Router가 동일한 `Idempotency-Key`(프록시를 통해 `x-pass-Idempotency-Key`로 전송됨)로 재시도할 때 저장된 결과를 재생하는 경우에도 존재하지 않습니다. 해당 재시도에는 다시 요금이 부과되지 않으므로, 재생은 실행의 정확한 비용을 두 번째로 보고하지 않습니다. 같은 이유로, 대기 중인 실행의 결과 수집 중에서는 실행 가격이 기록된 이후의 첫 번째 수집만 이 헤더를 포함합니다. 동일한 결과를 다시 수집해도 여전히 `X-Comfy-Credits-Used`는 반환되지만 `x-litellm-response-cost`는 반환되지 않습니다. -헤더가 없으면 LiteLLM은 엔드포인트의 `cost_per_request`로 대체합니다. 이는 위의 모든 경우에 적용됩니다. 따라서 오류 응답, 자신의 공급자 키로 청구되는 실행, 멱등 재생은 Comfy가 해당 실행에 크레딧을 청구하지 않았음에도 여러분의 추정치로 기록됩니다. 비용을 보고하지 않는 실행이 지출 보고서에서 무료로 보이지 않도록 이 값을 `0` 대신 일반적인 실행에 대한 합리적인 추정치로 설정하고, 해당 행들이 LiteLLM의 합계를 Comfy 청구서보다 높게 밀어 올릴 수 있음을 예상하세요. 가격이 책정되었지만 실제로 비용이 전혀 발생하지 않은 실행은 `x-litellm-response-cost: 0`을 보고하며, LiteLLM은 이를 0으로 기록합니다. +헤더가 없으면 LiteLLM은 엔드포인트의 `cost_per_request`로 대체합니다. 이는 위의 모든 경우에 적용됩니다. 따라서 오류 응답, 자신의 공급자 키로 청구되는 실행, 멱등 재생은 여러분의 추정치로 기록됩니다. 그중 대부분은 크레딧이 청구되지 않았지만 전부는 아닙니다. `X-Comfy-Credits-Used`를 포함하는 콘텐츠 정책 거부는 가격이 책정된 것이므로 해당 헤더에서 비용을 읽어야 하며, Router가 여러분에게 돌려주지 못한 생성과 같은 몇몇 다른 실패는 비용을 보고하지 않은 채 청구될 수 있습니다. 워크스페이스의 사용 기록과 대조해 확인하세요. 비용을 보고하지 않는 실행이 지출 보고서에서 무료로 보이지 않도록 이 값을 `0` 대신 일반적인 실행에 대한 합리적인 추정치로 설정하고, 해당 행들이 LiteLLM의 합계를 Comfy 청구서보다 높게 밀어 올릴 수 있음을 예상하세요. 가격이 책정되었지만 실제로 비용이 전혀 발생하지 않은 실행은 `x-litellm-response-cost: 0`을 보고하며, LiteLLM은 이를 0으로 기록합니다. ## 대기 중 전달 diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index 472b20d1f4..737e6d229d 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -2,11 +2,11 @@ title: "Comfy Router 모델" sidebarTitle: "모든 모델" description: "Comfy Router에서 사용할 수 있는 모든 모델을 제공자별로 정리하고, 각 모델의 입력 및 출력 모달리티를 함께 표시합니다." -translationSourceHash: f12be9e4 +translationSourceHash: e183e69a translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 78e86d68 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -25,10 +25,10 @@ translationBlockHashes: "LTX": 32595bf9 "Luma": 37a12a19 "Luma 2": 585eb637 - "Meshy": 9292a0a8 + "Meshy": 67e26a17 "MiniMax": 87560ab7 "Moonvalley": 9e63fb77 - "OpenAI": c5c4af80 + "OpenAI": a5c1e692 "Openrouter": a4f6806b "Pika": f2b1d797 "Pruna": 903d76ee @@ -44,6 +44,7 @@ translationBlockHashes: "xAI": e1706271 --- + {/* GENERATED FILE. Generated from the Router catalog by `pnpm code-pages:gen`. */} 아래의 모든 모델은 동일한 라우트인 `POST /v2/models/{provider}/{model}`를 통해 제공되며, 각 모델 고유의 JSON 본문을 사용합니다. 각 페이지에는 Python, TypeScript, cURL로 작성된 실제 동작하는 요청 예시가 있습니다. 검색, 스키마, 오류, 재시도, 청구에 대해서는 [Comfy Router API 사용하기](/ko/development/comfy-router/api)를 참고하세요. @@ -106,6 +107,8 @@ translationBlockHashes: - [Lipsync 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ko/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/ko/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` + + - [Video Background Removal](/ko/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` - [Veo 3.1 Fast Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` @@ -135,7 +138,7 @@ translationBlockHashes: - [Grok Imagine Video](/ko/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/ko/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/ko/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -198,7 +201,6 @@ translationBlockHashes: - [Photon 1](/ko/development/comfy-router/models/luma/photon-1/code): `luma/photon-1` - [Photon Flash 1](/ko/development/comfy-router/models/luma/photon-flash-1/code): `luma/photon-flash-1` - [GPT Image 1.5](/ko/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` -- [GPT Image 1](/ko/development/comfy-router/models/openai/gpt-image-1/code): `openai/gpt-image-1` - [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` - [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` @@ -276,7 +278,7 @@ translationBlockHashes: - [Wan 3.0 Video](/ko/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` - + - [Animations](/ko/development/comfy-router/models/meshy/animations/code): `meshy/animations` - [Meshy 6](/ko/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` @@ -290,7 +292,7 @@ translationBlockHashes: - [Hunyuan 3D Uv](/ko/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/ko/development/comfy-router/models/anthropic/claude-fable-5-1/code): `anthropic/claude-fable-5-1` - [Claude Fable 5](/ko/development/comfy-router/models/anthropic/claude-fable-5/code): `anthropic/claude-fable-5` @@ -319,7 +321,6 @@ translationBlockHashes: - [Nano Banana 2](/ko/development/comfy-router/models/google/nano-banana-2/code): `vertexai/gemini-3.1-flash-image` - [Nano Banana Pro](/ko/development/comfy-router/models/google/nano-banana-pro/code): `vertexai/gemini-3-pro-image` - [GPT 4.1 Mini](/ko/development/comfy-router/models/openai/gpt-4-1-mini/code): `openai/gpt-4.1-mini` -- [GPT 4.1 Nano](/ko/development/comfy-router/models/openai/gpt-4-1-nano/code): `openai/gpt-4.1-nano` - [GPT 4.1](/ko/development/comfy-router/models/openai/gpt-4-1/code): `openai/gpt-4.1` - [GPT 4o](/ko/development/comfy-router/models/openai/gpt-4o/code): `openai/gpt-4o` - [GPT 5.5 Pro](/ko/development/comfy-router/models/openai/gpt-5-5-pro/code): `openai/gpt-5.5-pro` @@ -333,10 +334,7 @@ translationBlockHashes: - [GPT 6 Astra](/ko/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/ko/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` - [GPT 6 Sol](/ko/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` -- [o1-pro](/ko/development/comfy-router/models/openai/o1-pro/code): `openai/o1-pro` -- [o1](/ko/development/comfy-router/models/openai/o1/code): `openai/o1` - [o3](/ko/development/comfy-router/models/openai/o3/code): `openai/o3` -- [o4-mini](/ko/development/comfy-router/models/openai/o4-mini/code): `openai/o4-mini` - [Chat Completions](/ko/development/comfy-router/models/openrouter/chat-completions/code): `openrouter/chat-completions` @@ -584,7 +582,6 @@ translationBlockHashes: | 모델 | ID | 입력 | 출력 | | --- | --- | --- | --- | | [GPT 4.1 Mini](/ko/development/comfy-router/models/openai/gpt-4-1-mini/code) | `openai/gpt-4.1-mini` | 텍스트, 이미지 | 텍스트 | -| [GPT 4.1 Nano](/ko/development/comfy-router/models/openai/gpt-4-1-nano/code) | `openai/gpt-4.1-nano` | 텍스트, 이미지 | 텍스트 | | [GPT 4.1](/ko/development/comfy-router/models/openai/gpt-4-1/code) | `openai/gpt-4.1` | 텍스트, 이미지 | 텍스트 | | [GPT 4o](/ko/development/comfy-router/models/openai/gpt-4o/code) | `openai/gpt-4o` | 텍스트, 이미지 | 텍스트 | | [GPT 5.5 Pro](/ko/development/comfy-router/models/openai/gpt-5-5-pro/code) | `openai/gpt-5.5-pro` | 텍스트, 이미지 | 텍스트 | @@ -599,14 +596,10 @@ translationBlockHashes: | [GPT 6 Luna](/ko/development/comfy-router/models/openai/gpt-6-luna/code) | `openai/gpt-6-luna` | 텍스트, 이미지 | 텍스트 | | [GPT 6 Sol](/ko/development/comfy-router/models/openai/gpt-6-sol/code) | `openai/gpt-6-sol` | 텍스트, 이미지 | 텍스트 | | [GPT Image 1.5](/ko/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | 텍스트, 이미지 | 이미지 | -| [GPT Image 1](/ko/development/comfy-router/models/openai/gpt-image-1/code) | `openai/gpt-image-1` | 텍스트, 이미지 | 이미지 | | [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | 텍스트, 이미지 | 이미지 | | [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | 텍스트, 이미지 | 이미지 | | [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | 텍스트, 이미지 | 이미지 | -| [o1-pro](/ko/development/comfy-router/models/openai/o1-pro/code) | `openai/o1-pro` | 텍스트, 이미지 | 텍스트 | -| [o1](/ko/development/comfy-router/models/openai/o1/code) | `openai/o1` | 텍스트, 이미지 | 텍스트 | | [o3](/ko/development/comfy-router/models/openai/o3/code) | `openai/o3` | 텍스트, 이미지 | 텍스트 | -| [o4-mini](/ko/development/comfy-router/models/openai/o4-mini/code) | `openai/o4-mini` | 텍스트, 이미지 | 텍스트 | ## Openrouter diff --git a/ko/development/comfy-router/models/bria/image-edit-relight/code.mdx b/ko/development/comfy-router/models/bria/image-edit-relight/code.mdx index fdc900317c..db753eb214 100644 --- a/ko/development/comfy-router/models/bria/image-edit-relight/code.mdx +++ b/ko/development/comfy-router/models/bria/image-edit-relight/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Image Edit Relight 사용하기" description: "Comfy Router를 통해 bria/image-edit-relight 호출하기: 엔드포인트, 요청 형태 그리고 Router가 반환하는 응답." sidebarTitle: "Image Edit Relight" -translationSourceHash: 63b5bcef +translationSourceHash: 620fcec7 translationFrom: development/comfy-router/models/bria/image-edit-relight/code.mdx translationBlockHashes: "_intro": cc88af3e "Quick start": 4329dd4b - "Schema": fb8fdff1 + "Schema": 8f45e738 "Examples": f04b0762 --- + {/* 생성된 파일입니다. `pnpm code-pages:gen`으로 router-schemas/bria/image-edit-relight.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -160,8 +161,8 @@ curl https://api.comfy.org/v2/models/bria/image-edit-relight/requests/$REQUEST_I 편집할 이미지입니다. 지원되는 입력 유형은 Base64로 인코딩된 문자열 또는 공개적으로 접근 가능한 이미지 파일을 가리키는 URL입니다. 허용 형식: JPEG, JPG, PNG, WEBP. - - 라이트 방향으로, "front", "side", "bottom", "top-down" 중 하나입니다. + + 라이트 방향이며, "front", "side", "bottom", "top-down" 중 하나입니다. @@ -205,7 +206,7 @@ Router가 `GET /v2/models/bria/image-edit-relight/openapi.json`에서 제공하 - 프롬프트의 정제된 버전이며, Bria가 정제하지 않은 COMPLETED 생성에서는 null입니다. 이 키는 생략되지 않고 null을 담은 채 PRESENT이기 때문에 nullable입니다. bria/image-edit-gen-fill에서 실제로 관찰되었습니다. + 프롬프트의 정제된 버전이며, Bria가 정제하지 않은 COMPLETED 생성에서는 null입니다. 이 키는 생략되지 않고 null을 담은 채 PRESENT 상태이기 때문에 nullable입니다. bria/image-edit-gen-fill에서 실제로 관찰되었습니다. diff --git a/ko/development/comfy-router/models/krea/krea-3/code.mdx b/ko/development/comfy-router/models/krea/krea-3/code.mdx index b455b3e707..ff36fb00d2 100644 --- a/ko/development/comfy-router/models/krea/krea-3/code.mdx +++ b/ko/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,15 +2,16 @@ title: "Comfy Router로 Krea 3 사용하기" description: "Comfy Router를 통해 krea/krea-3를 호출하는 방법: 엔드포인트, 요청 형태 및 Router가 반환하는 응답입니다." sidebarTitle: "Krea 3" -translationSourceHash: a539ac5a +translationSourceHash: bf8b60e8 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": 9c44fce0 + "Schema": 672a9195 "Examples": 276619d9 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-3.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -155,7 +156,7 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 입력 이미지 URL이며 최대 8개입니다. 각 URL은 이미지를 POST /proxy/krea/assets에 업로드하여 반환된 image_url이어야 합니다(multipart form 필드 `file`). 호스트 app-uploads.krea.ai의 https URL이 아닌 링크는 자체 https URL을 포함하여 400으로 거부되며, 실제 업로드가 아닌 app-uploads.krea.ai 링크는 5xx 오류로 실패합니다. 텍스트 기반 이미지 생성 시에는 생략합니다. + 입력 이미지 URL이며 최대 8개입니다. 이미지를 POST /proxy/krea/assets에 업로드(multipart form 필드 `file`)하여 반환된 image_url은 항상 허용됩니다. 다른 공개 https URL이 허용되는지는 환경에 따라 다릅니다. 허용되지 않는 환경에서는 호스트 app-uploads.krea.ai의 https URL이 아닌 모든 링크가 400으로 거부됩니다. 허용되는 환경에서는 공개 https 이미지 URL이면 무엇이든 허용되며, 형식이 잘못되었거나 https가 아닌 URL은 400으로 거부됩니다. 이 경우 형식이 올바른 https URL에 대해 호출자가 수정할 수 있는 참조는 해당 호스트를 명시하며 400으로 거부됩니다. 가져오기 전에 확인했을 때 호스트가 확인되지 않거나 공개적으로 접근할 수 없는 경우, 허용된 횟수보다 많이 리디렉션되는 경우, https가 아닌 URL로 리디렉션되는 경우, 공개적으로 접근할 수 없는 호스트로 리디렉션되는 경우, 408 또는 429가 아닌 4xx를 반환하는 경우, 이미지가 아닌 경우, 읽을 수 없는 형식의 이미지인 경우, 이미지 크기 헤더가 처음 2 MiB 안에 없는 경우, 또는 선언된 길이나 청크 인코딩이 없는 응답이 이미지 크기 헤더 전에 끝나는 경우입니다. 그 밖의 가져오기 실패는 POST /proxy/krea에서 502 오류로 실패합니다(Comfy Router는 이를 500 internal_error로 응답합니다). 일시적인 DNS, TLS 또는 연결 실패, 타임아웃, 원본의 408, 429, 5xx 또는 기타 200이 아닌 상태, 또는 해당 확인을 통과했지만 가져오기가 연결될 때 확인되지 않거나 공개적으로 접근할 수 없는 호스트가 여기에 해당합니다. 다른 URL이 허용되지 않는 환경에서 실제 업로드가 아닌 app-uploads.krea.ai 링크는 5xx 오류로 실패합니다. 허용되는 환경에서는 다른 접근 불가능한 참조와 마찬가지로 400으로 거부됩니다. 서버가 어느 쪽이 적용되는지 아직 파악하지 못한 동안에는 app-uploads.krea.ai 링크가 아닌 호스트를 가진 모든 https URL이 공개 여부와 관계없이 재시도해도 안전한 503 오류로 실패합니다. 텍스트 기반 이미지 생성 시에는 생략합니다. @@ -171,7 +172,7 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 이미지의 나머지 부분을 유지하는 국소 편집을 수행하려면 true로 설정합니다. model berry와 image_urls의 이미지 최소 한 개가 필요합니다. + 이미지의 나머지 부분을 유지하는 국소 편집을 수행하려면 참으로 설정합니다. model berry와 image_urls의 이미지가 최소 한 개 필요합니다. diff --git a/ko/development/comfy-router/models/luma_2/ray-3-2/code.mdx b/ko/development/comfy-router/models/luma_2/ray-3-2/code.mdx index c7e96144fd..c5ee09c0be 100644 --- a/ko/development/comfy-router/models/luma_2/ray-3-2/code.mdx +++ b/ko/development/comfy-router/models/luma_2/ray-3-2/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router로 Ray 3.2 사용하기" description: "Comfy Router를 통해 luma_2/ray-3.2를 호출합니다: 엔드포인트, 요청 형태 및 Router가 반환하는 응답." sidebarTitle: "Ray 3.2" -translationSourceHash: a796913b +translationSourceHash: 86ca3c26 translationFrom: development/comfy-router/models/luma_2/ray-3-2/code.mdx translationBlockHashes: "_intro": 3348ca65 "Quick start": ad992b88 - "Schema": 50c63e36 + "Schema": 0c4fe0bc "Examples": fdb0ab6e --- + {/* 생성된 파일입니다. `pnpm code-pages:gen`으로 router-schemas/luma_2/ray-3.2.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -166,13 +167,13 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ ### 입력 - 출력 가로세로 비율입니다. ray-3.2 비디오 모델은 9:16, 3:4, 1:1, 4:3, 16:9, 21:9 하위 집합을 지원합니다. + 출력 가로세로 비율입니다. ray-3.2 비디오 모델은 9:16, 3:4, 1:1, 4:3, 16:9, 21:9의 하위 집합을 지원합니다. 가능한 값: `3:1`, `2:1`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3` - 스타일/콘텐츠 가이드를 위한 참조 이미지입니다. type이 'image'인 경우 최대 9개, 'image_edit'인 경우 최대 8개입니다. + 스타일/콘텐츠 가이드용 참조 이미지입니다. type 'image'의 경우 최대 9개, type 'image_edit'의 경우 최대 8개입니다. @@ -180,19 +181,19 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전에 완료된 생성 작업의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe의 video/mp4). - 공개적으로 접근 가능한 이미지 또는 비디오 URL + 공개적으로 액세스 가능한 이미지 또는 비디오 URL - 사용할 모델입니다. 이미지 생성에는 uni-1 / uni-1-max, 비디오 생성, 편집 및 리프레이밍에는 ray-3.2를 사용합니다. + 사용할 모델입니다. 이미지 생성에는 uni-1 / uni-1-max를, 비디오 생성, 편집 및 리프레이밍에는 ray-3.2를 사용합니다. @@ -206,7 +207,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url 또는 data 중 정확히 하나를 제공하세요. @@ -214,15 +215,15 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전에 완료된 생성 작업의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe의 video/mp4). - 공개적으로 접근 가능한 이미지 또는 비디오 URL + 공개적으로 액세스 가능한 이미지 또는 비디오 URL @@ -232,13 +233,13 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 수행할 생성 유형입니다. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되며, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. + 수행할 생성 유형입니다. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되고, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` - ray-3.2의 비디오 출력 설정입니다. 여기에서는 검증 및 과금에 영향을 주는 필드만 모델링됩니다. 추가 필드(편집 제어, source_position)는 수정 없이 Luma로 전달됩니다. + ray-3.2의 비디오 출력 설정입니다. 여기서는 검증과 과금에 영향을 주는 필드만 모델링되며, 추가 필드(편집 컨트롤, source_position)는 수정 없이 Luma로 전달됩니다. @@ -248,7 +249,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url 또는 data 중 정확히 하나를 제공하세요. @@ -256,19 +257,19 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전에 완료된 생성 작업의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe의 video/mp4). - 공개적으로 접근 가능한 이미지 또는 비디오 URL + 공개적으로 액세스 가능한 이미지 또는 비디오 URL - 아직 사용할 수 없습니다: Luma가 EXR 제공을 시작할 때까지 `exr_export=true` 요청은 400으로 거부됩니다. 향후 MP4와 함께 EXR 파일을 내보냅니다(hdr가 true여야 함). video_reframe에서는 거부됩니다. + 아직 사용 불가: exr_export=true인 요청은 Luma가 EXR 전송을 출시할 때까지 400으로 거부됩니다. MP4와 함께 EXR 파일을 내보냅니다(hdr true 필요). video_reframe에서는 거부됩니다. @@ -276,11 +277,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - `keyframes`의 출력 프레임 위치이며 길이가 같아야 합니다. 5s의 경우 0–120, 10s의 경우 0–240입니다. 수정 없이 전달됩니다. + `keyframes`의 출력 프레임 위치이며, 길이는 `keyframes`와 같아야 합니다. 5s의 경우 0–120, 10s의 경우 0–240입니다. 그대로 전달됩니다. - 가이드 프레임 이미지(1–64)이며 start_frame/end_frame과 상호 배타적입니다. 요청된 재생 시간을 기준으로 과금되며, keyframes 요청은 단일 키프레임 연장이 아닙니다. + 가이드 프레임 이미지(1–64)이며 start_frame/end_frame과 상호 배타적입니다. 요청된 재생 시간을 기준으로 과금되며, keyframes 요청은 절대 단일 키프레임 확장이 아닙니다. @@ -288,19 +289,19 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전에 완료된 생성 작업의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe의 video/mp4). - 공개적으로 접근 가능한 이미지 또는 비디오 URL + 공개적으로 액세스 가능한 이미지 또는 비디오 URL - 생성된 클립을 반복합니다. 생성 시에만 가능합니다(type video). + 생성된 클립을 반복 재생합니다. 생성 전용(type video)입니다. @@ -310,7 +311,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url 또는 data 중 정확히 하나를 제공하세요. @@ -322,7 +323,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - MIME 유형. data와 함께 필수입니다 (비디오 소스의 경우 url과도 함께, 예: video_edit / video_reframe에서 video/mp4). + MIME 유형입니다. data와 함께 필수이며(비디오 소스의 경우 url과도 함께 필수입니다. 예: video_edit / video_reframe에서 video/mp4), @@ -333,7 +334,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ 웹 검색 그라운딩 활성화 -Router가 `GET /v2/models/luma_2/ray-3.2/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 동일한 문서입니다. +Router가 `GET /v2/models/luma_2/ray-3.2/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 @@ -342,13 +343,13 @@ Router가 `GET /v2/models/luma_2/ray-3.2/openapi.json`에서 제공하는 스키 - 프로그래밍 방식으로 처리할 수 있는 기계 판독 가능 실패 코드 + 프로그래밍 방식으로 처리할 수 있는 기계 판독용 실패 코드 가능한 값: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` - 사람이 읽을 수 있는 실패 설명으로, FAILED 상태의 생성에서만 채워집니다. 성공한 생성에서는 `null`입니다. + 사람이 읽을 수 있는 실패 설명이며, FAILED 상태의 생성에서만 채워집니다. 성공한 경우에는 `null`입니다. @@ -364,11 +365,11 @@ Router가 `GET /v2/models/luma_2/ray-3.2/openapi.json`에서 제공하는 스키 - 미디어 유형 (예: 이미지) + 미디어 유형 (예: image) - 미리 서명된 URL (1시간 후 만료) + Presigned URL (1시간 후 만료) @@ -378,7 +379,7 @@ Router가 `GET /v2/models/luma_2/ray-3.2/openapi.json`에서 제공하는 스키 - 수행할 생성의 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델에서, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. + 수행할 생성의 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델이 생성하며, video/video_edit/video_reframe은 ray-3.2 모델이 생성합니다. 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` diff --git a/ko/development/comfy-router/models/luma_2/uni-1-max/code.mdx b/ko/development/comfy-router/models/luma_2/uni-1-max/code.mdx index b7ee5fd49e..b0c77a29af 100644 --- a/ko/development/comfy-router/models/luma_2/uni-1-max/code.mdx +++ b/ko/development/comfy-router/models/luma_2/uni-1-max/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Uni 1 Max 사용하기" description: "Comfy Router를 통해 luma_2/uni-1-max를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Uni 1 Max" -translationSourceHash: 90d7c51e +translationSourceHash: e88275ff translationFrom: development/comfy-router/models/luma_2/uni-1-max/code.mdx translationBlockHashes: "_intro": 86e0cfe7 "Quick start": dfff1d3d - "Schema": 4916d345 + "Schema": d7d29898 "Examples": f813a867 --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/luma_2/uni-1-max.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -153,13 +154,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ ### 입력 - 출력 가로세로 비율. ray-3.2 비디오 모델은 9:16, 3:4, 1:1, 4:3, 16:9, 21:9 하위 집합을 지원합니다. + 출력 가로세로 비율입니다. ray-3.2 비디오 모델은 9:16, 3:4, 1:1, 4:3, 16:9, 21:9 하위 집합을 지원합니다. 가능한 값: `3:1`, `2:1`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3` - 스타일/콘텐츠 가이드를 위한 참조 이미지. type 'image'인 경우 최대 9개, type 'image_edit'인 경우 최대 8개입니다. + 스타일/콘텐츠 가이드용 참조 이미지입니다. type 'image'의 경우 최대 9개, type 'image_edit'의 경우 최대 8개입니다. @@ -167,11 +168,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수입니다 (비디오 소스의 경우 url과도 함께 사용하며, 예: video_edit / video_reframe에서 video/mp4). @@ -179,7 +180,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 사용할 모델. 이미지 생성에는 uni-1 / uni-1-max, 비디오 생성, 편집, 리프레이밍에는 ray-3.2를 사용합니다. + 사용할 모델입니다. 이미지 생성에는 uni-1 / uni-1-max, 비디오 생성, 편집, 리프레이밍에는 ray-3.2입니다. @@ -201,11 +202,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수입니다 (비디오 소스의 경우 url과도 함께 사용하며, 예: video_edit / video_reframe에서 video/mp4). @@ -219,17 +220,17 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 수행할 생성의 종류. image/image_edit는 uni-1 / uni-1-max 모델이 생성하고, video/video_edit/video_reframe은 ray-3.2 모델이 생성합니다. + 수행할 생성의 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델이 생성하며, video/video_edit/video_reframe은 ray-3.2 모델이 생성합니다. 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` - ray-3.2의 비디오 출력 설정입니다. 여기에는 검증과 과금에 영향을 주는 필드만 모델링되어 있으며, 추가 필드(편집 제어, source_position)는 수정 없이 Luma로 전달됩니다. + ray-3.2의 비디오 출력 설정입니다. 검증과 과금에 영향을 주는 필드만 여기에서 모델링되며, 추가 필드(편집 컨트롤, source_position)는 수정 없이 Luma로 전달됩니다. - ray-3.2 video / video_edit의 클립 재생 시간. 기본값은 5s입니다. HDR 생성(type video)은 5s로 제한됩니다. + ray-3.2 video / video_edit의 클립 재생 시간입니다. 기본값은 5s입니다. HDR 생성(type video)은 5s로 제한됩니다. 가능한 값: `5s`, `10s` @@ -243,11 +244,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수입니다 (비디오 소스의 경우 url과도 함께 사용하며, 예: video_edit / video_reframe에서 video/mp4). @@ -255,7 +256,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MP4와 함께 EXR 파일을 내보냅니다. hdr이 참이어야 합니다. video_reframe에서는 거부됩니다. + 아직 사용 불가: Luma가 EXR 전달을 출시할 때까지 exr_export=true인 요청은 400으로 거부됩니다. MP4와 함께 EXR 파일을 내보냅니다 (hdr true 필요). video_reframe에서는 거부됩니다. @@ -263,11 +264,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - `keyframes`에 대한 출력 프레임 위치이며 길이가 같아야 합니다. 5s의 경우 0–120, 10s의 경우 0–240입니다. 수정 없이 전달됩니다. + `keyframes`에 대한 출력 프레임 위치이며, 길이가 같아야 합니다. 5s의 경우 0–120, 10s의 경우 0–240입니다. 수정 없이 전달됩니다. - 가이드 프레임 이미지(1–64개)로, start_frame/end_frame과 함께 사용할 수 없습니다. 요청된 재생 시간 기준으로 과금되며, keyframes 요청은 단일 키프레임 확장이 아닙니다. + 가이드 프레임 이미지(1–64)이며, start_frame/end_frame과 상호 배타적입니다. 요청된 재생 시간을 기준으로 과금되며, keyframes 요청은 단일 키프레임 연장이 아닙니다. @@ -275,11 +276,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수입니다 (비디오 소스의 경우 url과도 함께 사용하며, 예: video_edit / video_reframe에서 video/mp4). @@ -287,11 +288,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 생성된 클립을 반복합니다. 생성 시에만 사용 가능합니다(type video). + 생성된 클립을 반복 재생합니다. 생성 시에만 사용 가능(type video). - ray-3.2 video의 출력 해상도. 기본값은 720p입니다. 360p는 초안 등급입니다. HDR은 720p 또는 1080p가 필요합니다. + ray-3.2 비디오의 출력 해상도입니다. 기본값은 720p입니다. 360p는 초안 등급입니다. HDR에는 720p 또는 1080p가 필요합니다. 가능한 값: `360p`, `540p`, `720p`, `1080p` @@ -305,11 +306,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 소스로 재사용할, 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수입니다 (비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe의 video/mp4). @@ -317,10 +318,10 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 검색 그라운딩 활성화 + 웹 검색 그라운딩 활성화 -Router가 `GET /v2/models/luma_2/uni-1-max/openapi.json`에서 제공하는 스키마에서 생성되며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/luma_2/uni-1-max/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 동일한 문서입니다. ### 출력 @@ -329,13 +330,13 @@ Router가 `GET /v2/models/luma_2/uni-1-max/openapi.json`에서 제공하는 스 - 프로그래밍 방식으로 처리할 수 있는 기계 판독 가능한 실패 코드 + 프로그래밍 방식 처리를 위한 기계 판독 가능 실패 코드 가능한 값: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` - 사람이 읽을 수 있는 실패 설명. FAILED 상태의 생성에서만 채워지며, 성공한 생성에서는 `null`입니다. + 사람이 읽을 수 있는 실패 설명으로, FAILED 생성에서만 채워집니다. 성공한 경우 `null`입니다. @@ -351,11 +352,11 @@ Router가 `GET /v2/models/luma_2/uni-1-max/openapi.json`에서 제공하는 스 - 미디어 유형 (예: 이미지) + 미디어 유형(예: 이미지) - 미리 서명된 URL (1시간 후 만료) + Presigned URL(1시간 후 만료) @@ -365,7 +366,7 @@ Router가 `GET /v2/models/luma_2/uni-1-max/openapi.json`에서 제공하는 스 - 수행할 생성의 종류. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되며, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. + 수행할 생성 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되며, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` diff --git a/ko/development/comfy-router/models/luma_2/uni-1/code.mdx b/ko/development/comfy-router/models/luma_2/uni-1/code.mdx index a298b97d18..08accb9a42 100644 --- a/ko/development/comfy-router/models/luma_2/uni-1/code.mdx +++ b/ko/development/comfy-router/models/luma_2/uni-1/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router에서 Uni 1 사용하기" description: "Comfy Router를 통해 luma_2/uni-1 호출하기: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Uni 1" -translationSourceHash: 5f33116a +translationSourceHash: 897d09ee translationFrom: development/comfy-router/models/luma_2/uni-1/code.mdx translationBlockHashes: "_intro": a9aaf4ab "Quick start": 9d667b90 - "Schema": 6ccb738a + "Schema": fe7e100f "Examples": f993c215 --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/luma_2/uni-1.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -155,7 +156,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ 출력 화면 비율입니다. ray-3.2 비디오 모델은 9:16, 3:4, 1:1, 4:3, 16:9, 21:9 하위 집합을 지원합니다. - 가능한 값: `3:1`, `2:1`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3` + Possible values: `3:1`, `2:1`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3` @@ -171,7 +172,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과 함께 사용, 예: video_edit / video_reframe의 video/mp4). + MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe의 video/mp4). @@ -185,7 +186,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ 출력 이미지 형식 - 가능한 값: `png`, `jpeg` + Possible values: `png`, `jpeg` @@ -193,7 +194,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나만 제공하세요. @@ -205,7 +206,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과 함께 사용, 예: video_edit / video_reframe의 video/mp4). + MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe의 video/mp4). @@ -215,27 +216,27 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ 스타일 프리셋 - 가능한 값: `auto`, `manga` + Possible values: `auto`, `manga` - 수행할 생성의 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델이 생성하며, video/video_edit/video_reframe은 ray-3.2 모델이 생성합니다. + 수행할 생성 유형입니다. image/image_edit는 uni-1 / uni-1-max 모델이 생성하며, video/video_edit/video_reframe은 ray-3.2 모델이 생성합니다. - 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` + Possible values: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` - ray-3.2의 비디오 출력 설정입니다. 검증과 과금에 영향을 주는 필드만 여기에서 모델링되며, 추가 필드(편집 컨트롤, source_position)는 수정 없이 Luma로 전달됩니다. + ray-3.2의 비디오 출력 설정입니다. 여기에는 검증과 과금에 영향을 주는 필드만 모델링되어 있으며, 추가 필드(편집 제어, source_position)는 그대로 Luma로 전달됩니다. ray-3.2 video / video_edit의 클립 재생 시간입니다. 기본값은 5s입니다. HDR 생성(type video)은 5s로 제한됩니다. - 가능한 값: `5s`, `10s` + Possible values: `5s`, `10s` - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나만 제공하세요. @@ -247,7 +248,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과 함께 사용, 예: video_edit / video_reframe의 video/mp4). + MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe의 video/mp4). @@ -255,7 +256,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MP4와 함께 EXR 파일을 내보냅니다. hdr가 true여야 합니다. video_reframe에서는 거부됩니다. + 아직 사용 불가: Luma가 EXR 전달을 출시할 때까지 exr_export=true인 요청은 400으로 거부됩니다. MP4와 함께 EXR 파일을 내보냅니다(hdr true 필요). video_reframe에서는 거부됩니다. @@ -263,11 +264,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - `keyframes`에 대한 출력 프레임 위치이며 길이가 같습니다. 5s는 0–120, 10s는 0–240입니다. 수정 없이 전달됩니다. + `keyframes`의 출력 프레임 위치이며 길이가 같아야 합니다. 5s의 경우 0–120, 10s의 경우 0–240입니다. 그대로 전달됩니다. - 가이드 프레임 이미지(1–64)이며 start_frame/end_frame과 상호 배타적입니다. 요청된 재생 시간을 기준으로 과금되며, keyframes 요청은 단일 키프레임 연장이 아닙니다. + 가이드 프레임 이미지(1–64)이며 start_frame/end_frame과 함께 사용할 수 없습니다. 요청한 재생 시간 기준으로 과금되며, keyframes 요청은 단일 키프레임 확장이 아닙니다. @@ -279,7 +280,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과 함께 사용, 예: video_edit / video_reframe의 video/mp4). + MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe의 video/mp4). @@ -287,17 +288,17 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 생성된 클립을 반복 재생합니다. 생성 전용(type video)입니다. + 생성된 클립을 반복 재생합니다. 생성 시에만 사용 가능(type video). ray-3.2 비디오의 출력 해상도입니다. 기본값은 720p입니다. 360p는 초안 등급입니다. HDR은 720p 또는 1080p가 필요합니다. - 가능한 값: `360p`, `540p`, `720p`, `1080p` + Possible values: `360p`, `540p`, `720p`, `1080p` - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나만 제공하세요. @@ -305,11 +306,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 소스로 재사용할, 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께, 예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe에서 video/mp4). @@ -320,7 +321,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ 검색 그라운딩 활성화 -Router가 `GET /v2/models/luma_2/uni-1/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 대상과 동일한 문서입니다. +Router가 `GET /v2/models/luma_2/uni-1/openapi.json`에서 제공하는 스키마에서 생성되었습니다. 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 문서와 동일합니다. ### 출력 @@ -329,13 +330,13 @@ Router가 `GET /v2/models/luma_2/uni-1/openapi.json`에서 제공하는 스키 - 프로그래밍 방식 처리를 위한 기계 판독 가능한 실패 코드 + 프로그래밍 방식으로 처리할 수 있는 기계 판독 가능한 실패 코드 가능한 값: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` - 사람이 읽을 수 있는 실패 설명으로, FAILED 생성에서만 채워집니다. 성공한 경우 `null`입니다. + 사람이 읽을 수 있는 실패 설명이며, FAILED 상태의 생성에서만 채워집니다. 성공한 경우에는 `null`입니다. @@ -351,11 +352,11 @@ Router가 `GET /v2/models/luma_2/uni-1/openapi.json`에서 제공하는 스키 - 미디어 유형(예: 이미지) + 미디어 유형(예: image) - 사전 서명된 URL (1시간 후 만료) + 미리 서명된 URL(1시간 만료) @@ -365,7 +366,7 @@ Router가 `GET /v2/models/luma_2/uni-1/openapi.json`에서 제공하는 스키 - 수행할 생성 유형입니다. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되며, video/video_edit/video_reframe는 ray-3.2 모델에서 생성됩니다. + 수행할 생성의 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델이 생성하고, video/video_edit/video_reframe은 ray-3.2 모델이 생성합니다. 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` diff --git a/ko/development/comfy-router/models/veed/fabric-1-0/code.mdx b/ko/development/comfy-router/models/veed/fabric-1-0/code.mdx index d4c41003b9..340c4584d2 100644 --- a/ko/development/comfy-router/models/veed/fabric-1-0/code.mdx +++ b/ko/development/comfy-router/models/veed/fabric-1-0/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router에서 Fabric 1.0 사용하기" description: "Comfy Router를 통해 veed/fabric-1.0을 호출하는 방법: 엔드포인트, 요청 형태, 그리고 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 --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/veed/fabric-1.0.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -154,7 +155,7 @@ curl https://api.comfy.org/v2/models/veed/fabric-1.0/requests/$REQUEST_ID \ ### 입력 - 립싱크 대상 음성 트랙의 공개 http(s) URL입니다. 비디오 길이는 오디오 길이와 같습니다. + 립싱크 대상 음성 트랙의 공개 http(s) URL입니다. 비디오 길이는 오디오 길이와 같습니다. 오디오가 호출당 입력 한도를 초과하면 400으로 거부됩니다. diff --git a/ko/development/comfy-router/models/veed/lipsync-2-0/code.mdx b/ko/development/comfy-router/models/veed/lipsync-2-0/code.mdx index a21ffdcd56..c6f7a8f9e9 100644 --- a/ko/development/comfy-router/models/veed/lipsync-2-0/code.mdx +++ b/ko/development/comfy-router/models/veed/lipsync-2-0/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router로 Lipsync 2.0 사용하기" description: "Comfy Router를 통해 veed/lipsync-2.0을 호출합니다. 엔드포인트, 요청 형태, 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/ko/comfy-router/model-code-footer.mdx"; @@ -150,7 +151,7 @@ curl https://api.comfy.org/v2/models/veed/lipsync-2.0/requests/$REQUEST_ID \ ### 입력 - 비디오에 립싱크할 새 오디오 트랙의 공개 http(s) URL입니다. + 비디오에 립싱크할 새 오디오 트랙의 공개 http(s) URL입니다. 오디오가 호출당 입력 상한보다 길면 400으로 거부됩니다. diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index 0f7bb35a2d..8691bbb746 100644 --- a/ko/development/comfy-router/reference.mdx +++ b/ko/development/comfy-router/reference.mdx @@ -2,17 +2,17 @@ title: "Comfy Router API 레퍼런스" description: "Comfy API 계약에서 생성된 모든 Comfy Router 엔드포인트, 매개변수, 응답 본문 및 오류 버킷." sidebarTitle: "API 레퍼런스" -translationSourceHash: 1b971d1c +translationSourceHash: 7bdc66a2 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": fbcaaf0e - "Error buckets": 36170340 + "Endpoints": 222fd740 + "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 3ecabac6 + "Pre-flight cost estimates": 862a49f8 "Result assets": 65fc939b "Per-model input and output schemas": 61c6bde8 - "Schemas": 77cfa4db + "Schemas": 0c65163b --- @@ -234,7 +234,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 잘못된 요청입니다. 오류 유형과 요청 본문을 확인하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `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` @@ -840,6 +840,7 @@ Router가 요청을 접수한 뒤 완료하지 못한 경우 발생합니다. | `queue_timeout` | 대기 중인 요청이 실행 대기열 타임아웃을 넘겨 대기했지만 결국 승인되지 않았습니다. | | `request_not_found` | `request_id`가 이 모델에서 호출자의 요청 중 어느 것도 가리키지 않습니다. | | `queue_backlog_full` | 호출자에게 이미 실행을 기다리는 대기 중 요청이 너무 많아 이 제출이 거부되었습니다. | +| `result_expired` | 요청은 존재했고 완료되었지만 그 결과가 더 이상 저장되어 있지 않아 수집 시 반환할 것이 없습니다. | ## 응답 헤더 @@ -1034,6 +1035,24 @@ Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 ## 스키마 +### RouterBilledWorkspace + +거부된 호출에 청구되었을 지갑으로, `RouterErrorResponse.billed_workspace`에 있습니다. "어느 지갑이 비어 있는가?"에 답하며, 호출자의 UI가 현재 선택한 워크스페이스와 반드시 같지는 않습니다. 자금이 있는 팀을 열어 둔 상태에서도 팀 구성원의 개인 자격 증명은 여기에 개인 지갑을 표시합니다. `denied_reason`과 함께일 때만 존재합니다. + +**필드** + + + Cloud 워크스페이스 id입니다. 레거시 레일에서는 없습니다. + + + + `personal` 또는 `team`입니다. 열린 문자열이므로 그 밖의 값은 personal로 처리하세요. + + + + 호출이 Cloud 워크스페이스가 아니라 호출자의 워크스페이스 이전 Metronome 고객에게 청구될 때 `legacy`입니다. 그 고객에게는 워크스페이스 id가 없습니다. Cloud 워크스페이스에서는 없습니다. + + ### RouterChargesOnPolicyRejection 이 모델에 대해 콘텐츠 정책 거부가 청구되는지 여부입니다. 알 수 없는 값은 청구될 수 있는 것으로 간주하세요. @@ -1100,7 +1119,7 @@ Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 - 이 견적을 산정할 때 사용한 요율표를 가져온 시각입니다. 이 견적은 가격 고정이 아닙니다. 실행은 이 시점이 아니라 요금이 산정되는 시점에 유효한 요율로 청구됩니다. 요율표를 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 요율표로도 산정할 수 없는 `not_quotable` 호출)에는 이 값이 견적이 응답된 시각입니다. + 이 견적을 산정할 때 사용한 요율표를 가져온 시각입니다. 이 견적은 가격 고정이 아닙니다. 실행은 이 시점이 아니라 요금이 산정되는 시점에 유효한 요율로 청구됩니다. 공급자가 공개한 가격 목록에서 가져온 `estimated` 견적(공급자가 보고하는 비용으로 청구되는 모델)은 대신 그 목록을 읽은 날짜를 가집니다. 청구 수량을 그 목록에서 예측한 뒤 요율표로 가격을 매기는 견적(공급자가 보고하는 크레딧으로 청구되는 모델)은 두 날짜 중 이른 날짜를 가집니다.요율표를 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 요율표로도 산정할 수 없는 `not_quotable` 호출)에는 이 값이 견적이 응답된 시각입니다. date-time @@ -1120,7 +1139,7 @@ Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 - Router 실패에 대한 거칠게 분류된 기계 판독 가능 버킷으로, 호출자가 본문을 파싱하지 않고 분기할 수 있도록 `X-Comfy-Error-Type` 응답 헤더에 반영됩니다. 이 집합은 열아홉 개 값으로 닫혀 있습니다: 여섯 개의 요청 수준 버킷 `invalid_input`, `content_policy_violation`, `provider_error`, `provider_timeout`, `insufficient_credits`, `model_not_found`와 전송 수준의 `unauthorized`, `forbidden`, `concurrency_limit_exceeded`, `client_disconnected`, `internal_error`, `deadline_exceeded`, `not_enabled`, `service_unavailable`, `rate_limited`, `cancelled`, `queue_timeout`, `request_not_found`, `queue_backlog_full`입니다. 닫혀 있다는 것은 오늘 문서화된 대로의 집합을 설명하는 것이지 영원히 유지되는 한계가 아닙니다. 집합은 늘어날 것으로 예상되며, 그래서 이것은 의도적으로 `enum`이 아닌 일반 문자열입니다. 따라서 클라이언트는 위 목록을 전수 분기하여 다음 추가에서 깨지는 대신, 인식할 수 없는 값을 `internal_error`로 처리해야 합니다. + Router 실패에 대한 거칠게 분류된 기계 판독 가능 버킷으로, 호출자가 본문을 파싱하지 않고 분기할 수 있도록 `X-Comfy-Error-Type` 응답 헤더에 반영됩니다. 이 집합은 스무 개 값으로 닫혀 있습니다: 여섯 개의 요청 수준 버킷 `invalid_input`, `content_policy_violation`, `provider_error`, `provider_timeout`, `insufficient_credits`, `model_not_found`와 전송 수준의 `unauthorized`, `forbidden`, `concurrency_limit_exceeded`, `client_disconnected`, `internal_error`, `deadline_exceeded`, `not_enabled`, `service_unavailable`, `rate_limited`, `cancelled`, `queue_timeout`, `request_not_found`, `queue_backlog_full`, `result_expired`입니다. 닫혀 있다는 것은 오늘 문서화된 대로의 집합을 설명하는 것이지 영원히 유지되는 한계가 아닙니다. 집합은 늘어날 것으로 예상되며, 그래서 이것은 의도적으로 `enum`이 아닌 일반 문자열입니다. 따라서 클라이언트는 위 목록을 전수 분기하여 다음 추가에서 깨지는 대신, 인식할 수 없는 값을 `internal_error`로 처리해야 합니다. 유형: [`RouterErrorType`](#routererrortype) @@ -1133,6 +1152,20 @@ Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 콘텐츠 정책 거부가 어떤 입력 또는 출력에 관한 것이었는지를 Router 수준의 닫힌 어휘로 나타냅니다: `input`, `output`, `input_text`, `input_image`, `input_video`, `input_audio`, `output_text`, `output_image`, `output_video`, `output_audio`. 공급자가 모달리티를 명시하지 않은 경우에는 단독 `input` / `output` 값이 어느 쪽인지를 나타냅니다. `error_type`이 `content_policy_violation`이고 공급자가 거부된 대상을 기계 판독 가능한 코드로 명시한 경우에만 존재하며, 그렇지 않으면 없습니다. 공급자 텍스트는 절대 아닙니다. 현재 BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI, Wan의 거부와 MiniMax Router의 Nano Banana 레그에서 발생한 Gemini 거부에 대해 명시됩니다. 거부가 어느 쪽에 관한 것인지 밝히지 않는 공급자의 경우 이 필드는 없습니다. 이는 `X-Comfy-Refusal-Subject` 헤더를 반영합니다. + + 파트너 노드 지출 거부에 대한 청구 측 정책 분기입니다. `no_funds`는 청구 대상 지갑이 비어 있음을, `unspecified`는 자금 조회 없이 거부되었음을 뜻합니다. `error_type`이 `insufficient_credits`이고 배포가 지갑 정보를 보고할 때만 존재하며, 그 밖의 경우에는 없습니다. 표시용 텍스트가 아니라 기계 판독 가능한 코드이므로, 표시에는 `detail`을 쓰고 분기에는 이 값을 쓰세요. + + + + 거부된 호출에 청구되었을 지갑으로, `RouterErrorResponse.billed_workspace`에 있습니다. "어느 지갑이 비어 있는가?"에 답하며, 호출자의 UI가 현재 선택한 워크스페이스와 반드시 같지는 않습니다. 자금이 있는 팀을 열어 둔 상태에서도 팀 구성원의 개인 자격 증명은 여기에 개인 지갑을 표시합니다. `denied_reason`과 함께일 때만 존재합니다. + + 유형: [`RouterBilledWorkspace`](#routerbilledworkspace) + + + + 거부된 요청이 어떤 방식으로 인증되었는지 나타냅니다. `personal_api_key`, `team_api_key`, `personal_session`, `team_session` 중 하나입니다. "다른 지갑에 청구하려면 어떤 자격 증명으로 바꿔야 하는가?"에 답하는 값입니다. 권한이 아니며 아무것도 부여하지 않습니다. `denied_reason`과 함께일 때만 존재합니다. + + ### RouterErrorType 기계가 읽을 수 있는 Router 오류 카테고리로, `X-Comfy-Error-Type` 헤더에도 전송됩니다. @@ -1146,7 +1179,7 @@ Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 **필드** - 이 모델이 콘텐츠 정책을 이유로 거부한 호출이 그럼에도 호출자에게 과금되는지 여부입니다. 공급자마다 다르고, 그 차이는 호출 시점에는 드러나지 않으며, 같은 호출에 대해 오류와 과금을 함께 보게 된 사용자는 미리 알 방법이 없었습니다. 그래서 공급자마다의 통설에 맡기는 대신, 모델별로 호출 전에 명시합니다. + 이 모델이 콘텐츠 정책을 이유로 거부한 호출이 그럼에도 호출자에게 과금되는지 여부입니다. 공급자마다 다르고, 그 차이는 호출 시점에는 드러나지 않으며, 같은 호출에 대해 오류와 과금을 함께 보게 된 사용자는 미리 알 방법이 없었습니다. 그래서 공급자마다의 통설에 맡기는 대신, 모델별로 호출 전에 명시합니다.값이 `yes`이면 동기 라우트의 `content_policy_violation` 오류에 `X-Comfy-Credits-Used`가 붙을 수 있습니다. 공급자가 모델의 생성 출력을 거부했고 Comfy가 그 거부된 생성의 사용량을 기록했을 때 붙으며 그 금액을 담습니다. 입력 측 거부와 같은 키 재생(`Idempotent-Replayed: true`)에는 붙지 않습니다. 헤더가 없는 거부는 보고되지 않았을 뿐 무료였다는 증거는 아닙니다. 타입: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) diff --git a/zh/development/api-development/sdks.mdx b/zh/development/api-development/sdks.mdx index dffa890068..5f7e7a8167 100644 --- a/zh/development/api-development/sdks.mdx +++ b/zh/development/api-development/sdks.mdx @@ -3,13 +3,13 @@ title: "Comfy SDK：ComfyUI 的 Python 与 TypeScript 客户端" description: "用 Python 或 TypeScript 对 Comfy Cloud、自建部署或自有 ComfyUI 运行 ComfyUI 工作流，并处理资产、任务、实时事件和幂等重试。" sidebarTitle: "SDK" icon: "code" -translationSourceHash: dbb2e0a8 +translationSourceHash: fd912955 translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 "Quickstart": 02297586 - "Choosing a base URL": 2265e6f6 + "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f "Watching a job run": 34d74bcc "Tracing an output back to its workflow": b01886a3 @@ -21,6 +21,7 @@ translationBlockHashes: + import SdkSurfaces from "/snippets/zh/sdk/surfaces.mdx"; import SdkVersions from "/snippets/zh/sdk/versions.mdx"; diff --git a/zh/development/cloud/api-reference.mdx b/zh/development/cloud/api-reference.mdx index c2908985e9..3a71263052 100644 --- a/zh/development/cloud/api-reference.mdx +++ b/zh/development/cloud/api-reference.mdx @@ -2,14 +2,14 @@ title: "Cloud API 参考" description: "Comfy Cloud 的完整 API 参考及代码示例" icon: "book-open" -translationSourceHash: 9dfb0617 +translationSourceHash: e15f0e0e translationFrom: development/cloud/api-reference.mdx translationBlockHashes: "_intro": 1729f5d3 "Setup": 311034bb "Object Info": 7b62a397 "Uploading Inputs": 92df17f8 - "Running Workflows": d6ddd0b4 + "Running Workflows": 2c6519c7 "Checking Job Status": d74b4922 "WebSocket for Real-Time Progress": 02c49b4a "Downloading Outputs": 5e1d63d3 @@ -19,6 +19,7 @@ translationBlockHashes: --- + import PollJobCompletion from '/snippets/zh/cloud/poll-job-completion.mdx' import WebSocketProgress from '/snippets/zh/cloud/websocket-progress.mdx' import DownloadOutputs from '/snippets/zh/cloud/download-outputs.mdx' @@ -343,7 +344,7 @@ print(f"Submitted job: {prompt_id}") ### 使用合作节点 -如果您的工作流包含[合作节点](/zh/tutorials/partner-nodes/overview)（调用外部 AI 服务的节点，如 Flux Pro、Ideogram 等），您必须在请求负载的 `extra_data` 字段中包含您的 [Comfy API 密钥](/zh/development/api-development/getting-an-api-key)。 +如果您的工作流包含[合作节点](/zh/tutorials/partner-nodes/overview)（调用 Flux Pro、Ideogram 等外部 AI 服务的节点），您必须在请求负载的 `extra_data` 字段中包含您的 [Comfy API 密钥](/zh/development/api-development/getting-an-api-key)。 在浏览器中运行工作流时，ComfyUI 前端会自动将您的 API 密钥打包到 `extra_data` 中。本节仅适用于直接调用 API 的情况。 @@ -392,7 +393,7 @@ def submit_workflow_with_partner_nodes(workflow: dict, api_key: str) -> str: Args: workflow: API 格式的 ComfyUI 工作流 - api_key: 您来自 platform.comfy.org 的 API 密钥 + api_key: 您在 platform.comfy.org 的 API 密钥 Returns: 用于跟踪任务的 prompt_id diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index ba749ba687..05d30548bc 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: b40af72c +translationSourceHash: 450771dd translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -13,9 +13,9 @@ translationBlockHashes: "Request bodies are capped": 675b77c8 "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d - "Comfy charges and usage": ed49ddec - "Models without a pre-flight estimate": 7373adf0 - "Router does not cover every partner operation": 97d31362 + "Comfy charges and usage": 7f5ccda7 + "Models without a pre-flight estimate": 0e7f595d + "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- @@ -27,6 +27,7 @@ translationBlockHashes: + Router 通过一次同步 HTTP 调用运行合作伙伴模型，或通过一个已排队的请求运行：你提交请求，稍后再收集结果。当你的应用能够等待一个已完成的结果，或稍后收集结果，并且能够处理模型自身的输入和输出字段时，就使用它。 ## Router 支持的功能 @@ -100,11 +101,11 @@ Router 只返回最终响应，不提供流式 token、服务器发送事件、 ## Comfy 费用与用量 -响应中可能包含提供商的用量或成本字段，但它们并不代表通用的 Comfy 收费。`X-Comfy-Credits-Used` 是可选响应头：缺失该响应头意味着成本未被报告，而不是该次运行免费。重放的响应（`Idempotent-Replayed: true`）不会再次计费，但可能重复给出原始运行的数字，因此不要将同一个 `Idempotency-Key` 的多次重试中的该响应头累加。请使用 Comfy 平台查询余额、用量和发票。 +响应中可能包含提供商的用量或成本字段。它们并不代表通用的 Comfy 收费。`X-Comfy-Credits-Used` 是可选响应头：缺失该响应头意味着成本未被报告，而不是该次运行免费。重放的响应（`Idempotent-Replayed: true`）不会再次计费，但可能重复给出原始运行的数值，因此不要将同一个 `Idempotency-Key` 的多次重试中的该响应头累加。请使用 Comfy 平台查询余额、用量和发票。 -模型目录提供计费事实，包括 `billing.charges_on_policy_rejection`，但不提供价格。请显式处理 `yes`、`no` 和 `unknown`。参见[计费](/zh/development/comfy-router/billing#模型计费事实)。 +模型目录提供计费事实，包括 `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#预检费用预估)。无法在运行前定价的模型列在[没有预检估算的模型](#无法预先估算的模型)中。 ## 无法预先估算的模型 @@ -114,9 +115,8 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价， {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} -- **bfl**: `bfl/erase-v1`, `bfl/flux-2-max`, `bfl/flux-2-pro`, `bfl/flux-3-image`, `bfl/flux-3-video`, `bfl/flux-kontext-max`, `bfl/flux-kontext-pro`, `bfl/flux-pro-1.0-expand`, `bfl/flux-pro-1.0-fill`, `bfl/flux-pro-1.1`, `bfl/flux-pro-1.1-ultra`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` +- **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` -- **elevenlabs**: `elevenlabs/eleven_sfx_v2` - **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` - **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` @@ -125,25 +125,30 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价， - **luma**: `luma/photon-1`, `luma/photon-flash-1`, `luma/ray-2`, `luma/ray-flash-2` - **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` - **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` -- **recraft**: `recraft/recraftv2`, `recraft/recraftv3`, `recraft/recraftv4`, `recraft/recraftv4_1`, `recraft/recraftv4_1_pro`, `recraft/recraftv4_1_pro_vector`, `recraft/recraftv4_1_utility`, `recraft/recraftv4_1_utility_pro`, `recraft/recraftv4_1_utility_pro_vector`, `recraft/recraftv4_1_utility_vector`, `recraft/recraftv4_1_vector`, `recraft/recraftv4_pro`, `recraft/recraftv4_styles`, `recraft/recraftv4_styles_pro`, `recraft/recraftv4_styles_pro_vector`, `recraft/recraftv4_styles_vector` - **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` -- **runway**: `runway/gen4_image` - **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/flashvsr`, `wavespeed/seedvr2`, `wavespeed/ultimate-image-upscaler`, `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` -- **xai**: `xai/grok-imagine-image`, `xai/grok-imagine-image-2.0`, `xai/grok-imagine-image-pro`, `xai/grok-imagine-image-quality`, `xai/grok-imagine-video`, `xai/grok-imagine-video-1.5`, `xai/grok-imagine-video-1.5-lite`, `xai/grok-imagine-video-1.5-preview` +- **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} +对 `openai/gpt-image-2`、`openai/gpt-image-2.5-flare` 和 `openai/gpt-image-2.5-sunburst` 的编辑操作同样没有预先估算。对其中任一模型的编辑调用，或携带输入图像的生成调用，都会返回 `source: unknown`。对这些模型的纯文本生成调用则会进行估算，这正是它们未出现在上方列表中的原因。 + ## Router 并不覆盖每个合作伙伴操作 Router 运行模型。文件上传、账户读取、资产管理、流式传输以及提供商任务控制可能需要位于 `/proxy/…` 下的合作伙伴代理路由，这些路由处在 Router 之外，Router 的契约也不涵盖它们。Router 自身对外提供的接口以 [Comfy Router 规范](/router-openapi.yaml) 为准；支持情况因提供商而异。 -### Krea 3 的参考图像必须先上传 +### Krea 3 参考图像：先上传，或使用公共 https URL + +在 `krea/krea-3` 的 `image_urls` 中，由 `POST /proxy/krea/assets` 返回的 `image_url`（即 `https://app-uploads.krea.ai/...` URL）始终会被接受。其他链接是否会被接受取决于环境；在 api.comfy.org 上目前会被接受。 + +- **在其他链接会被接受的情况下**，任何公共 `https` 图像网址都可以使用。Router 会在模型运行前读取每张图像的尺寸：如果链接的主机无法公开访问或不存在、返回 `408` 或 `429` 之外的 `4xx`，或者不是图像，则会以 `400` `invalid_input` 拒绝，并指明其主机。暂时性的 DNS、TLS 或连接故障、超时，或源站返回 `408` 或 `429`，都会以 `502` 错误失败。不是有效上传的 `app-uploads.krea.ai` 链接会像任何其他无法访问的引用一样，以 `400` 拒绝。服务器刚启动后，在它获知适用哪条规则之前，不是 `app-uploads.krea.ai` 链接的公共 `https` URL 可能会失败并返回 `503`，这种错误可以安全重试。 +- **在其他链接不会被接受的情况下**，每一项都必须是某次上传的 `image_url`。Router 只检查该链接能否解析为 `https` URL，且其主机名恰好是 `app-uploads.krea.ai`（不能是其他主机，也不能带显式端口）：任何其他链接，包括你自己托管的公共 `https` URL，都会在模型运行前被拒绝，并返回 `400` `invalid_input`。通过了该检查但并非仍然有效的上传链接（已过期、已删除或输入有误）仍会通过，随后 Router 无法读取图像尺寸，并返回 `5xx` 错误而不是 `400`。 -`krea/krea-3` 不接受任意图像链接。`image_urls` 中的每一项都必须是 `POST /proxy/krea/assets` 返回的 `image_url`，也就是一个 `https://app-uploads.krea.ai/...` URL。Router 只检查该链接能否解析为 `https` URL，并且其主机名恰好是 `app-uploads.krea.ai`（不能是其他主机，也不能带显式端口）：任何其他链接，包括你自己托管的公共 `https` URL，都会在模型运行前被拒绝，并返回 `400` `invalid_input`。通过了该检查但并非仍然有效的上传链接（已过期、已删除或输入有误）仍会通过，随后 Router 无法读取图像尺寸，并返回 `5xx` 错误而不是 `400`，因此请始终原样传入上传返回的 `image_url`。 +上传在每个环境中都可用，因此是可移植的选择；请始终原样传入上传返回的 `image_url`。 1. 将每张参考图像以 `multipart/form-data` 上传，图像放在表单字段 `file` 中（JPEG、PNG 或 WebP，最大 75 MB）。使用与 Router 相同的方式进行身份验证，即使用 `X-API-Key` 或 `Authorization: Bearer`。 diff --git a/zh/development/comfy-router/litellm.mdx b/zh/development/comfy-router/litellm.mdx index 5cc2509c46..0afb2e4206 100644 --- a/zh/development/comfy-router/litellm.mdx +++ b/zh/development/comfy-router/litellm.mdx @@ -2,16 +2,17 @@ title: "将 Comfy Router 与 LiteLLM 配合使用" sidebarTitle: "LiteLLM" description: "将 Comfy Router 置于 LiteLLM Proxy 之后作为直通端点，并从 x-litellm-response-cost 响应头中记录每次运行的确切美元成本，无需维护价格表。" -translationSourceHash: e35cd883 +translationSourceHash: 8183ff58 translationFrom: development/comfy-router/litellm.mdx translationBlockHashes: "_intro": 1ddb0d0a "Configure the pass-through": 380c3ae3 - "How spend is recorded": f852c18c + "How spend is recorded": 699ed64b "Queued delivery": 46044c93 "Notes": 50e3cf6b --- + 如果你已经使用 [LiteLLM Proxy](https://docs.litellm.ai/docs/proxy/pass_through) 跟踪支出，就可以把 Comfy Router 作为又一个透传端点添加进来。调用方继续使用自己的 LiteLLM 密钥，而你的 Comfy API 密钥则保留在代理上。 对于会反馈每次运行 Comfy 点数价格的模型（参见[不反馈成本的运行](#不报告成本的运行)），Router 会在 `x-litellm-response-cost` 响应头中以美元为单位反馈一次运行的成本：同步运行体现在运行响应上，[已排队](#队列投递)的运行则体现在结果收集响应上。LiteLLM 会在每个透传响应中读取该响应头，并将其记录为该请求的支出，因此你无需为这些模型维护价格表。 @@ -83,7 +84,7 @@ translationBlockHashes: ## 支出如何记录 -报告成本的运行会携带以下响应头：对于同步运行，它们出现在运行响应中；对于排队运行，它们出现在结果收集响应中： +一次报告成本的运行会携带以下响应头：对于同步运行，它们出现在运行响应中；对于排队运行，它们出现在结果收集响应中： ```http X-Comfy-Credits-Used: 12.5 @@ -99,14 +100,14 @@ X-Litellm-Total-Tokens: 0 有些运行不会携带 `x-litellm-response-cost`。它与 `X-Comfy-Credits-Used` 在相同的情况下缺失： -- 使用你自己的提供商密钥计费、而不是计入你的 Comfy 积分的运行 +- 计入你自己的提供商密钥、而不是计入你的 Comfy 积分的运行 - 尚未列入 Router 会报告每次运行积分价格的模型列表中的模型。该列表较为保守，有些提供商完全不在其中 - 未进入 Comfy 计费环节的扣费 -- 错误响应 +- 错误响应。来自 `billing.charges_on_policy_rejection` 为 `yes` 的模型的同步 `content_policy_violation`，可以携带 `X-Comfy-Credits-Used`，其值为被拒绝那次生成的价格；它永远不会携带 `x-litellm-response-cost`，因为错误不是 LiteLLM 应当记账的结果 当 Router 针对使用相同 `Idempotency-Key` 的重试（通过代理发送时为 `x-pass-Idempotency-Key`）重放已存储的结果时，该响应头也会缺失。该重试不会再次计费，因此这次重放不会第二次报告该次运行的确切成本。出于同样的原因，排队运行的结果收集中只有一次会携带该响应头，即该次运行的价格被记录后的第一次收集；再次收集同一结果仍会返回 `X-Comfy-Credits-Used`，但不会返回 `x-litellm-response-cost`。 -当该响应头缺失时，LiteLLM 会回退到端点的 `cost_per_request`。这适用于上述所有情况。因此，错误响应、使用你自己的提供商密钥计费的运行以及幂等重放，都会按你设置的估值记录，即使 Comfy 并未为此扣除你的积分。请将 `cost_per_request` 设置为对典型运行的合理估值，而不是 `0`，这样不报告成本的运行就不会在你的支出报告中显示为免费，同时也要预期这些记录会使 LiteLLM 的合计高于你的 Comfy 账单。一次已被定价且确实没有任何花费的运行会报告 `x-litellm-response-cost: 0`，LiteLLM 会将其记录为零。 +当该响应头缺失时，LiteLLM 会回退到端点的 `cost_per_request`。这适用于上述所有情况。因此，错误响应、计入你自己的提供商密钥的运行以及幂等重放，都会按你的估值记录。这些运行大多并未从你的积分中扣除费用，但并非全部如此：一次携带 `X-Comfy-Credits-Used` 的内容政策拒绝已经定过价，所以应从该响应头读取其成本；另外少数其他失败情况，例如 Router 无法将生成结果交还给你的情况，也可能被计费却不报告成本。请以工作区的用量记录为准核对。请将 `cost_per_request` 设置为对典型运行的合理估值，而不是 `0`，这样不报告成本的运行就不会在你的支出报告中显示为免费，同时也要预期这些记录会使 LiteLLM 的合计高于你的 Comfy 账单。一次已定价且确实没有任何花费的运行会报告 `x-litellm-response-cost: 0`，LiteLLM 会将其记录为零。 ## 队列投递 diff --git a/zh/development/comfy-router/models.mdx b/zh/development/comfy-router/models.mdx index 614ecfce4c..098e7dbc0f 100644 --- a/zh/development/comfy-router/models.mdx +++ b/zh/development/comfy-router/models.mdx @@ -2,11 +2,11 @@ title: "Comfy Router 模型" sidebarTitle: "所有模型" description: "Comfy Router 提供的全部模型，按提供方分组，并列出每个模型的输入和输出模态。" -translationSourceHash: f12be9e4 +translationSourceHash: e183e69a translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 78e86d68 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -25,10 +25,10 @@ translationBlockHashes: "LTX": 32595bf9 "Luma": 37a12a19 "Luma 2": 585eb637 - "Meshy": 9292a0a8 + "Meshy": 67e26a17 "MiniMax": 87560ab7 "Moonvalley": 9e63fb77 - "OpenAI": c5c4af80 + "OpenAI": a5c1e692 "Openrouter": a4f6806b "Pika": f2b1d797 "Pruna": 903d76ee @@ -44,6 +44,7 @@ translationBlockHashes: "xAI": e1706271 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 Router 目录生成。 */} 以下每个模型都由同一条路由提供服务：`POST /v2/models/{provider}/{model}`，并使用该模型自身的 JSON 请求体。每个页面都会展示在 Python、TypeScript 和 cURL 中可用的请求示例。关于模型发现、schema、错误、重试和计费，请参阅[使用 Comfy Router API](/zh/development/comfy-router/api)。 @@ -106,7 +107,8 @@ translationBlockHashes: - [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code)：`veed/lipsync-2.0` - [Video Background Removal Fast](/zh/development/comfy-router/models/veed/video-background-removal-fast/code)：`veed/video-background-removal-fast` - [Video Background Removal Green Screen](/zh/development/comfy-router/models/veed/video-background-removal-green-screen/code)：`veed/video-background-removal-green-screen` -- [Video Background Removal](/zh/development/comfy-router/models/veed/video-background-removal/code)：`veed/video-background-removal` + +- [视频背景移除](/zh/development/comfy-router/models/veed/video-background-removal/code)：`veed/video-background-removal` - [Veo 3.1 Fast Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code)：`veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-generate-001/code)：`veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code)：`veo/veo-3.1-lite-generate-001` @@ -135,7 +137,7 @@ translationBlockHashes: - [Grok Imagine Video](/zh/development/comfy-router/models/xai/grok-imagine-video/code)：`xai/grok-imagine-video` - + - [SwitchX](/zh/development/comfy-router/models/beeble/switchx/code)：`beeble/switchx` - [Erase V1](/zh/development/comfy-router/models/black-forest-labs/erase-v1/code)：`bfl/erase-v1` @@ -163,7 +165,7 @@ translationBlockHashes: - [图像编辑：替换背景](/zh/development/comfy-router/models/bria/image-edit-replace-background/code)：`bria/image-edit-replace-background` - [图像编辑：按文本替换对象](/zh/development/comfy-router/models/bria/image-edit-replace-object-by-text/code)：`bria/image-edit-replace-object-by-text` - [图像编辑：Reseason](/zh/development/comfy-router/models/bria/image-edit-reseason/code)：`bria/image-edit-reseason` -- [图像编辑：修复](/zh/development/comfy-router/models/bria/image-edit-restore/code)：`bria/image-edit-restore` +- [图像编辑：恢复](/zh/development/comfy-router/models/bria/image-edit-restore/code)：`bria/image-edit-restore` - [图像](/zh/development/comfy-router/models/bria/image/code)：`bria/image` - [Seedream 4.0 250828](/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code)：`byteplus/seedream-4-0-250828` - [Seedream 4.5 251128](/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code)：`byteplus/seedream-4-5-251128` @@ -198,7 +200,6 @@ translationBlockHashes: - [Photon 1](/zh/development/comfy-router/models/luma/photon-1/code)：`luma/photon-1` - [Photon Flash 1](/zh/development/comfy-router/models/luma/photon-flash-1/code)：`luma/photon-flash-1` - [GPT Image 1.5](/zh/development/comfy-router/models/openai/gpt-image-1-5/code)：`openai/gpt-image-1.5` -- [GPT Image 1](/zh/development/comfy-router/models/openai/gpt-image-1/code)：`openai/gpt-image-1` - [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code)：`openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code)：`openai/gpt-image-2.5-sunburst` - [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code)：`openai/gpt-image-2` @@ -276,7 +277,7 @@ translationBlockHashes: - [Wan 3.0 Video](/zh/development/comfy-router/models/wan/wan3-0-video/code)：`wan/wan3.0-video` - + - [Animations](/zh/development/comfy-router/models/meshy/animations/code)：`meshy/animations` - [Meshy 6](/zh/development/comfy-router/models/meshy/meshy-6/code)：`meshy/meshy-6` @@ -290,7 +291,7 @@ translationBlockHashes: - [Hunyuan 3D Uv](/zh/development/comfy-router/models/tencent/hunyuan-3d-uv/code)：`tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/zh/development/comfy-router/models/anthropic/claude-fable-5-1/code)：`anthropic/claude-fable-5-1` - [Claude Fable 5](/zh/development/comfy-router/models/anthropic/claude-fable-5/code)：`anthropic/claude-fable-5` @@ -319,7 +320,6 @@ translationBlockHashes: - [Nano Banana 2](/zh/development/comfy-router/models/google/nano-banana-2/code)：`vertexai/gemini-3.1-flash-image` - [Nano Banana Pro](/zh/development/comfy-router/models/google/nano-banana-pro/code)：`vertexai/gemini-3-pro-image` - [GPT 4.1 Mini](/zh/development/comfy-router/models/openai/gpt-4-1-mini/code)：`openai/gpt-4.1-mini` -- [GPT 4.1 Nano](/zh/development/comfy-router/models/openai/gpt-4-1-nano/code)：`openai/gpt-4.1-nano` - [GPT 4.1](/zh/development/comfy-router/models/openai/gpt-4-1/code)：`openai/gpt-4.1` - [GPT 4o](/zh/development/comfy-router/models/openai/gpt-4o/code)：`openai/gpt-4o` - [GPT 5.5 Pro](/zh/development/comfy-router/models/openai/gpt-5-5-pro/code)：`openai/gpt-5.5-pro` @@ -333,10 +333,7 @@ translationBlockHashes: - [GPT 6 Astra](/zh/development/comfy-router/models/openai/gpt-6-astra/code)：`openai/gpt-6-astra` - [GPT 6 Luna](/zh/development/comfy-router/models/openai/gpt-6-luna/code)：`openai/gpt-6-luna` - [GPT 6 Sol](/zh/development/comfy-router/models/openai/gpt-6-sol/code)：`openai/gpt-6-sol` -- [o1-pro](/zh/development/comfy-router/models/openai/o1-pro/code)：`openai/o1-pro` -- [o1](/zh/development/comfy-router/models/openai/o1/code)：`openai/o1` - [o3](/zh/development/comfy-router/models/openai/o3/code)：`openai/o3` -- [o4-mini](/zh/development/comfy-router/models/openai/o4-mini/code)：`openai/o4-mini` - [Chat Completions](/zh/development/comfy-router/models/openrouter/chat-completions/code)：`openrouter/chat-completions` @@ -583,30 +580,25 @@ translationBlockHashes: | 模型 | ID | 输入 | 输出 | | --- | --- | --- | --- | -| [GPT 4.1 Mini](/zh/development/comfy-router/models/openai/gpt-4-1-mini/code) | `openai/gpt-4.1-mini` | 文本, 图像 | 文本 | -| [GPT 4.1 Nano](/zh/development/comfy-router/models/openai/gpt-4-1-nano/code) | `openai/gpt-4.1-nano` | 文本, 图像 | 文本 | -| [GPT 4.1](/zh/development/comfy-router/models/openai/gpt-4-1/code) | `openai/gpt-4.1` | 文本, 图像 | 文本 | -| [GPT 4o](/zh/development/comfy-router/models/openai/gpt-4o/code) | `openai/gpt-4o` | 文本, 图像 | 文本 | -| [GPT 5.5 Pro](/zh/development/comfy-router/models/openai/gpt-5-5-pro/code) | `openai/gpt-5.5-pro` | 文本, 图像 | 文本 | -| [GPT 5.5](/zh/development/comfy-router/models/openai/gpt-5-5/code) | `openai/gpt-5.5` | 文本, 图像 | 文本 | -| [GPT 5.6 Luna](/zh/development/comfy-router/models/openai/gpt-5-6-luna/code) | `openai/gpt-5.6-luna` | 文本, 图像 | 文本 | -| [GPT 5.6 Sol](/zh/development/comfy-router/models/openai/gpt-5-6-sol/code) | `openai/gpt-5.6-sol` | 文本, 图像 | 文本 | -| [GPT 5.6 Terra](/zh/development/comfy-router/models/openai/gpt-5-6-terra/code) | `openai/gpt-5.6-terra` | 文本, 图像 | 文本 | -| [GPT 5 Mini](/zh/development/comfy-router/models/openai/gpt-5-mini/code) | `openai/gpt-5-mini` | 文本, 图像 | 文本 | -| [GPT 5 Nano](/zh/development/comfy-router/models/openai/gpt-5-nano/code) | `openai/gpt-5-nano` | 文本, 图像 | 文本 | -| [GPT 5](/zh/development/comfy-router/models/openai/gpt-5/code) | `openai/gpt-5` | 文本, 图像 | 文本 | -| [GPT 6 Astra](/zh/development/comfy-router/models/openai/gpt-6-astra/code) | `openai/gpt-6-astra` | 文本, 图像 | 文本 | -| [GPT 6 Luna](/zh/development/comfy-router/models/openai/gpt-6-luna/code) | `openai/gpt-6-luna` | 文本, 图像 | 文本 | -| [GPT 6 Sol](/zh/development/comfy-router/models/openai/gpt-6-sol/code) | `openai/gpt-6-sol` | 文本, 图像 | 文本 | -| [GPT Image 1.5](/zh/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | 文本, 图像 | 图像 | -| [GPT Image 1](/zh/development/comfy-router/models/openai/gpt-image-1/code) | `openai/gpt-image-1` | 文本, 图像 | 图像 | -| [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | 文本, 图像 | 图像 | -| [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | 文本, 图像 | 图像 | -| [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | 文本, 图像 | 图像 | -| [o1-pro](/zh/development/comfy-router/models/openai/o1-pro/code) | `openai/o1-pro` | 文本, 图像 | 文本 | -| [o1](/zh/development/comfy-router/models/openai/o1/code) | `openai/o1` | 文本, 图像 | 文本 | -| [o3](/zh/development/comfy-router/models/openai/o3/code) | `openai/o3` | 文本, 图像 | 文本 | -| [o4-mini](/zh/development/comfy-router/models/openai/o4-mini/code) | `openai/o4-mini` | 文本, 图像 | 文本 | +| [GPT 4.1 Mini](/zh/development/comfy-router/models/openai/gpt-4-1-mini/code) | `openai/gpt-4.1-mini` | 文本、图像 | 文本 | +| [GPT 4.1](/zh/development/comfy-router/models/openai/gpt-4-1/code) | `openai/gpt-4.1` | 文本、图像 | 文本 | +| [GPT 4o](/zh/development/comfy-router/models/openai/gpt-4o/code) | `openai/gpt-4o` | 文本、图像 | 文本 | +| [GPT 5.5 Pro](/zh/development/comfy-router/models/openai/gpt-5-5-pro/code) | `openai/gpt-5.5-pro` | 文本、图像 | 文本 | +| [GPT 5.5](/zh/development/comfy-router/models/openai/gpt-5-5/code) | `openai/gpt-5.5` | 文本、图像 | 文本 | +| [GPT 5.6 Luna](/zh/development/comfy-router/models/openai/gpt-5-6-luna/code) | `openai/gpt-5.6-luna` | 文本、图像 | 文本 | +| [GPT 5.6 Sol](/zh/development/comfy-router/models/openai/gpt-5-6-sol/code) | `openai/gpt-5.6-sol` | 文本、图像 | 文本 | +| [GPT 5.6 Terra](/zh/development/comfy-router/models/openai/gpt-5-6-terra/code) | `openai/gpt-5.6-terra` | 文本、图像 | 文本 | +| [GPT 5 Mini](/zh/development/comfy-router/models/openai/gpt-5-mini/code) | `openai/gpt-5-mini` | 文本、图像 | 文本 | +| [GPT 5 Nano](/zh/development/comfy-router/models/openai/gpt-5-nano/code) | `openai/gpt-5-nano` | 文本、图像 | 文本 | +| [GPT 5](/zh/development/comfy-router/models/openai/gpt-5/code) | `openai/gpt-5` | 文本、图像 | 文本 | +| [GPT 6 Astra](/zh/development/comfy-router/models/openai/gpt-6-astra/code) | `openai/gpt-6-astra` | 文本、图像 | 文本 | +| [GPT 6 Luna](/zh/development/comfy-router/models/openai/gpt-6-luna/code) | `openai/gpt-6-luna` | 文本、图像 | 文本 | +| [GPT 6 Sol](/zh/development/comfy-router/models/openai/gpt-6-sol/code) | `openai/gpt-6-sol` | 文本、图像 | 文本 | +| [GPT Image 1.5](/zh/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | 文本、图像 | 图像 | +| [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | 文本、图像 | 图像 | +| [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | 文本、图像 | 图像 | +| [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | 文本、图像 | 图像 | +| [o3](/zh/development/comfy-router/models/openai/o3/code) | `openai/o3` | 文本、图像 | 文本 | ## Openrouter diff --git a/zh/development/comfy-router/models/bria/image-edit-relight/code.mdx b/zh/development/comfy-router/models/bria/image-edit-relight/code.mdx index c15d997c7c..4fa399ee82 100644 --- a/zh/development/comfy-router/models/bria/image-edit-relight/code.mdx +++ b/zh/development/comfy-router/models/bria/image-edit-relight/code.mdx @@ -2,17 +2,18 @@ title: "将 Image Edit Relight 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 bria/image-edit-relight：端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Image Edit Relight" -translationSourceHash: 63b5bcef +translationSourceHash: 620fcec7 translationFrom: development/comfy-router/models/bria/image-edit-relight/code.mdx translationBlockHashes: "_intro": cc88af3e "Quick start": 4329dd4b - "Schema": fb8fdff1 + "Schema": 8f45e738 "Examples": f04b0762 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/bria/image-edit-relight.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -160,7 +161,7 @@ curl https://api.comfy.org/v2/models/bria/image-edit-relight/requests/$REQUEST_I 要编辑的图像。支持的输入类型为 Base64 编码字符串，或指向可公开访问图像文件的 URL。接受的格式为 JPEG、JPG、PNG、WEBP。 - + 光照方向，取值为 "front"、"side"、"bottom" 或 "top-down" 之一。 @@ -205,7 +206,7 @@ curl https://api.comfy.org/v2/models/bria/image-edit-relight/requests/$REQUEST_I - 提示词的优化版本；若 COMPLETED 的生成任务中 Bria 未进行优化，则为 null。可为 null 是因为该键是存在的并携带 null，而不是被省略；在 bria/image-edit-gen-fill 上实际观察到过。 + 提示词的优化版本；若 COMPLETED 的生成任务中 Bria 未进行优化，则为 null。可为 null 是因为该键存在并携带 null，而不是被省略；在 bria/image-edit-gen-fill 上实际观察到过。 @@ -213,7 +214,7 @@ curl https://api.comfy.org/v2/models/bria/image-edit-relight/requests/$REQUEST_I - 结构化指令，即以字符串形式序列化的 JSON 文档，由 `/v2/structured_instruction/generate` 返回。该操作不会填充任何一个 URL。 + 由 `/v2/structured_instruction/generate` 返回的结构化指令，即以字符串形式序列化的 JSON 文档。该操作不会填充其中任何一个 URL。 diff --git a/zh/development/comfy-router/models/krea/krea-3/code.mdx b/zh/development/comfy-router/models/krea/krea-3/code.mdx index acd55f4f3c..781696b1c2 100644 --- a/zh/development/comfy-router/models/krea/krea-3/code.mdx +++ b/zh/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,15 +2,16 @@ title: "通过 Comfy Router 使用 Krea 3" description: "通过 Comfy Router 调用 krea/krea-3：端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Krea 3" -translationSourceHash: a539ac5a +translationSourceHash: bf8b60e8 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": 9c44fce0 + "Schema": 672a9195 "Examples": 276619d9 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/krea/krea-3.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -155,7 +156,7 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 输入图像 URL，最多 8 个。每个都必须是先将图像上传到 POST /proxy/krea/assets（multipart 表单字段 `file`）后返回的 image_url；任何不是主机 app-uploads.krea.ai 上的 https URL 的链接（包括你自己的 https URL）都会被以 400 拒绝，而非实时上传的 app-uploads.krea.ai 链接则会以 5xx 错误失败。文生图时省略。 + 输入图像 URL，最多 8 个。将图像上传到 POST /proxy/krea/assets（multipart 表单字段 `file`）后返回的 image_url 始终会被接受。是否接受其他公开的 https URL 取决于环境：在不接受的环境中，任何链接，只要它不是主机 app-uploads.krea.ai 上的 https URL，都会以 400 拒绝；在会接受的环境中，任何公开的 https 图像 URL 都会被接受，而格式错误或不是 https 的 URL 会以 400 拒绝。在这种情况下，对于格式正确的 https URL，调用方可以修正的引用会以 400 拒绝并指明其主机：其主机在抓取前检查时无法解析或无法公开访问；它重定向的次数超过允许值、重定向到不是 https 的 URL，或重定向到无法公开访问的主机；它返回 408 或 429 以外的 4xx；它不是图像；它是格式无法读取的图像；其图像尺寸标头不在前 2 MiB 内；或者未声明长度或使用分块编码的响应在其图像尺寸标头之前结束。抓取它时发生的任何其他失败，都会让 POST /proxy/krea 以 502 错误失败（Comfy Router 会以 500 internal_error 回应）：临时性 DNS、TLS 或连接失败，超时，源站 408、429、5xx 或其他非 200 状态，或者通过了该检查但在抓取建立连接时无法解析或无法公开访问的主机。在不接受其他 URL 的环境中，不是实时上传的 app-uploads.krea.ai 链接会以 5xx 错误失败；在会接受的环境中，它会像任何其他无法访问的引用一样以 400 拒绝。当服务器尚未确定适用哪种情况时，任何 https URL，只要其主机不是 app-uploads.krea.ai 链接，无论是否公开，都会以 503 错误失败，并且可以安全重试。文生图时省略。 diff --git a/zh/development/comfy-router/models/luma_2/ray-3-2/code.mdx b/zh/development/comfy-router/models/luma_2/ray-3-2/code.mdx index f89f6148bd..256fe0b323 100644 --- a/zh/development/comfy-router/models/luma_2/ray-3-2/code.mdx +++ b/zh/development/comfy-router/models/luma_2/ray-3-2/code.mdx @@ -2,14 +2,15 @@ title: "搭配 Comfy Router 使用 Ray 3.2" description: "通过 Comfy Router 调用 luma_2/ray-3.2：endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Ray 3.2" -translationSourceHash: a796913b +translationSourceHash: 86ca3c26 translationFrom: development/comfy-router/models/luma_2/ray-3-2/code.mdx translationBlockHashes: "_intro": 3348ca65 "Quick start": ad992b88 - "Schema": 50c63e36 + "Schema": 0c4fe0bc "Examples": fdb0ab6e --- + {/* 生成文件。由 `pnpm code-pages:gen` 从 router-schemas/luma_2/ray-3.2.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -168,11 +169,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ 输出宽高比。ray-3.2 视频模型支持 9:16、3:4、1:1、4:3、16:9、21:9 这一子集。 - 可能的值：`3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` + 可选值：`3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` - 用于风格/内容引导的参考图像。type 为 'image' 时最多 9 张，type 为 'image_edit' 时最多 8 张。 + 用于风格/内容引导的参考图像。类型 'image' 最多 9 张，类型 'image_edit' 最多 8 张。 @@ -180,11 +181,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 先前已完成生成的 UUID，用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 先前已完成生成的 UUID，可复用为来源。由 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时为必填（对于视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（视频来源使用 url 时也必填，例如在 video_edit / video_reframe 上使用 video/mp4）。 @@ -198,7 +199,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ 输出图像格式 - 可能的值：`png`、`jpeg` + 可选值：`png`、`jpeg` @@ -206,7 +207,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请提供 generation_id、url 或 data 中的恰好一个。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。generation_id、url 或 data 中必须且只能提供一个。 @@ -214,11 +215,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 先前已完成生成的 UUID，用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 先前已完成生成的 UUID，可复用为来源。由 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时为必填（对于视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（视频来源使用 url 时也必填，例如在 video_edit / video_reframe 上使用 video/mp4）。 @@ -228,27 +229,27 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ 风格预设 - 可能的值：`auto`、`manga` + 可选值：`auto`、`manga` 要执行的生成类型。image/image_edit 由 uni-1 / uni-1-max 模型生成；video/video_edit/video_reframe 由 ray-3.2 模型生成。 - 可能的值：`image`、`image_edit`、`video`、`video_edit`、`video_reframe` + 可选值：`image`、`image_edit`、`video`、`video_edit`、`video_reframe` - ray-3.2 的视频输出设置。此处仅建模影响验证和计费的字段；其他字段（编辑控制项、source_position）将原样转发给 Luma。 + ray-3.2 的视频输出设置。此处仅列出影响验证和计费的字段；其他字段（编辑控制项、source_position）会原样转发给 Luma。 - ray-3.2 video / video_edit 的片段时长。默认为 5s。HDR 生成（type 为 video）仅限 5s。 + ray-3.2 video / video_edit 的片段时长。默认为 5s。HDR 生成（类型 video）限制为 5s。 - 可能的值：`5s`、`10s` + 可选值：`5s`、`10s` - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请提供 generation_id、url 或 data 中的恰好一个。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。generation_id、url 或 data 中必须且只能提供一个。 @@ -256,11 +257,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 先前已完成生成的 UUID，用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 先前已完成生成的 UUID，可复用为来源。由 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时为必填（对于视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（视频来源使用 url 时也必填，例如在 video_edit / video_reframe 上使用 video/mp4）。 @@ -268,19 +269,19 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 暂不可用：在 Luma 提供 EXR 交付之前，带 `exr_export=true` 的请求会以 400 拒绝。将来会在 MP4 之外同时导出 EXR 文件（需要 hdr 为 true）。video_reframe 下会被拒绝。 + 尚不可用：在 Luma 提供 EXR 交付前，带 exr_export=true 的请求会以 400 被拒绝。将随 MP4 一同导出 EXR 文件（需要 hdr true）。对 video_reframe 会被拒绝。 - 以 HDR 渲染。需要 720p/1080p。video_reframe 下会被拒绝。 + 以 HDR 渲染。需要 720p/1080p。对 video_reframe 会被拒绝。 - `keyframes` 对应的输出帧位置，长度相同；5s 时为 0–120，10s 时为 0–240。原样转发。 + `keyframes` 的输出帧位置，长度一致；5s 为 0–120，10s 为 0–240。原样转发。 - 引导帧图像（1–64），与 start_frame/end_frame 互斥。按请求的时长计费；keyframes 请求绝不会是单关键帧延长。 + 引导帧图像（1–64），与 start_frame/end_frame 互斥。按请求的时长计费；keyframes 请求绝不会是单关键帧扩展。 @@ -288,11 +289,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 先前已完成生成的 UUID，用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 先前已完成生成的 UUID，可复用为来源。由 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时为必填（对于视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（视频来源使用 url 时也必填，例如在 video_edit / video_reframe 上使用 video/mp4）。 @@ -300,17 +301,17 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 循环播放生成的片段。仅创建时可用（type 为 video）。 + 循环播放生成的片段。仅限创建（类型 video）。 - ray-3.2 视频的输出分辨率。默认为 720p。360p 为草稿档位。HDR 需要 720p 或 1080p。 + ray-3.2 视频的输出分辨率。默认为 720p。360p 是草稿档位。HDR 需要 720p 或 1080p。 - 可能的值：`360p`、`540p`、`720p`、`1080p` + 可选值：`360p`、`540p`、`720p`、`1080p` - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请提供 generation_id、url 或 data 中的恰好一个。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。generation_id、url 或 data 中必须且只能提供一个。 @@ -318,11 +319,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 先前已完成生成的 UUID，用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 之前已完成的一次生成的 UUID，可复用作来源。供 ray-3.2 的 video_edit / video_reframe 使用。 - MIME 类型。与 data 搭配时为必填（对于视频来源，还需搭配 url，例如在 video_edit / video_reframe 上使用 video/mp4）。 + MIME 类型。与 data 一同必填（对于视频来源，还需与 url 一同提供，例如 video_edit / video_reframe 上的 video/mp4）。 @@ -330,10 +331,10 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 启用网络搜索依据 + 启用网络搜索作为依据 -根据 Router 在 `GET /v2/models/luma_2/ray-3.2/openapi.json` 提供的 schema 生成，该文档也是它在请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/luma_2/ray-3.2/openapi.json` 提供的 schema 生成，该文档与它在请求到达提供商之前用来校验调用的文档相同。 ### 输出 @@ -342,7 +343,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 供程序化处理的机器可读失败代码 + 机器可读的失败代码，用于程序化处理 可能的值：`content_moderated`、`generation_failed`、`budget_exhausted`、`output_not_found` @@ -360,7 +361,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 一条生成的输出条目 + 一条生成输出条目 @@ -368,11 +369,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 预签名 URL（1 小时过期） + 预签名 URL（1 小时后过期） - 生成的当前状态 + 生成当前的状态 可能的值：`queued`、`processing`、`completed`、`failed` diff --git a/zh/development/comfy-router/models/luma_2/uni-1-max/code.mdx b/zh/development/comfy-router/models/luma_2/uni-1-max/code.mdx index 7474460314..6e71e9b6ed 100644 --- a/zh/development/comfy-router/models/luma_2/uni-1-max/code.mdx +++ b/zh/development/comfy-router/models/luma_2/uni-1-max/code.mdx @@ -2,17 +2,18 @@ title: "搭配 Comfy Router 使用 Uni 1 Max" description: "通过 Comfy Router 调用 luma_2/uni-1-max：端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Uni 1 Max" -translationSourceHash: 90d7c51e +translationSourceHash: e88275ff translationFrom: development/comfy-router/models/luma_2/uni-1-max/code.mdx translationBlockHashes: "_intro": 86e0cfe7 "Quick start": dfff1d3d - "Schema": 4916d345 + "Schema": d7d29898 "Examples": f813a867 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/luma_2/uni-1-max.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -153,13 +154,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ ### 输入 - 输出宽高比。ray-3.2 视频模型支持 9:16、3:4、1:1、4:3、16:9、21:9 这一子集。 + 输出宽高比。ray-3.2 视频模型支持以下子集：9:16、3:4、1:1、4:3、16:9、21:9。 可能的值：`3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` - 用于风格/内容引导的参考图像。type 为 'image' 时最多 9 张，type 为 'image_edit' 时最多 8 张。 + 用于风格/内容引导的参考图像。类型 'image' 最多 9 张，类型 'image_edit' 最多 8 张。 @@ -167,11 +168,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 先前已完成生成的 UUID，可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 之前已完成的生成任务的 UUID，用于复用作来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 同时使用时为必填（对于视频来源，还需与 url 同时使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（对于视频来源，与 url 一起使用时也必填，例如在 video_edit / video_reframe 中的 video/mp4）。 @@ -193,7 +194,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 对图像或视频的引用。用于风格/内容引导、引导式生成、视频编辑/重新取景来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 + 对图像或视频的引用。用于风格/内容引导、引导生成、video-edit/video-reframe 来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 @@ -201,11 +202,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 先前已完成生成的 UUID，可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 之前已完成的生成任务的 UUID，用于复用作来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 同时使用时为必填（对于视频来源，还需与 url 同时使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（对于视频来源，与 url 一起使用时也必填，例如在 video_edit / video_reframe 中的 video/mp4）。 @@ -225,17 +226,17 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - ray-3.2 的视频输出设置。此处仅对影响验证和计费的字段建模；其他字段（编辑控制、source_position）会原样转发给 Luma。 + ray-3.2 的视频输出设置。此处仅对影响验证和计费的字段建模；其他字段（编辑控件、source_position）将原样转发给 Luma。 - ray-3.2 video / video_edit 的片段时长。默认为 5s。HDR 生成（type 为 video）仅限 5s。 + ray-3.2 video / video_edit 的视频片段时长。默认 5s。HDR 生成（type 为 video）仅限 5s。 可能的值：`5s`、`10s` - 对图像或视频的引用。用于风格/内容引导、引导式生成、视频编辑/重新取景来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 + 对图像或视频的引用。用于风格/内容引导、引导生成、video-edit/video-reframe 来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 @@ -243,11 +244,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 先前已完成生成的 UUID，可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 之前已完成的生成任务的 UUID，用于复用作来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 同时使用时为必填（对于视频来源，还需与 url 同时使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（对于视频来源，与 url 一起使用时也必填，例如在 video_edit / video_reframe 中的 video/mp4）。 @@ -255,7 +256,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 随 MP4 一并导出 EXR 文件。要求 hdr 为 true。在 video_reframe 中会被拒绝。 + 尚不可用：在 Luma 提供 EXR 交付之前，exr_export=true 的请求会被拒绝并返回 400。将在 MP4 之外同时导出一个 EXR 文件（要求 hdr 为 true）。在 video_reframe 中会被拒绝。 @@ -267,7 +268,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 引导帧图像（1–64），与 start_frame/end_frame 互斥。按请求的时长计费；keyframes 请求绝不会是单关键帧延长。 + 引导帧图像（1–64），与 start_frame/end_frame 互斥。按请求的时长计费；keyframes 请求绝不会被视为单关键帧扩展。 @@ -275,11 +276,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 先前已完成生成的 UUID，可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 之前已完成的生成任务的 UUID，用于复用作来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 同时使用时为必填（对于视频来源，还需与 url 同时使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（对于视频来源，与 url 一起使用时也必填，例如在 video_edit / video_reframe 中的 video/mp4）。 @@ -287,29 +288,29 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 循环已生成的片段。仅创建时可用（type 为 video）。 + 循环生成的视频片段。仅用于创建（type 为 video）。 - ray-3.2 视频的输出分辨率。默认为 720p。360p 是草稿档位。HDR 要求 720p 或 1080p。 + ray-3.2 视频的输出分辨率。默认 720p。360p 是草稿档位。HDR 要求 720p 或 1080p。 可能的值：`360p`、`540p`、`720p`、`1080p` - 对图像或视频的引用。用于风格/内容引导、引导式生成、视频编辑/重新取景来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 + 对图像或视频的引用。用于风格/内容引导、引导生成、video-edit/video-reframe 来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 - Base64 编码的图像或视频数据 +Base64 编码的图像或视频数据 - 此前已完成的生成 UUID，可复用为来源。供 ray-3.2 的 video_edit / video_reframe 使用。 + 先前一次已完成生成的 UUID，可用作来源复用。供 ray-3.2 的 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时必填（对于视频来源，还需与 url 一起使用，例如在 video_edit / video_reframe 上使用 video/mp4）。 + MIME 类型。与 data 一起使用时必填（对于视频来源，与 url 一起使用时也必填，例如 video_edit / video_reframe 上的 video/mp4）。 @@ -317,10 +318,10 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 启用网络搜索接地 + 启用 Google / 搜索依据 -根据 Router 在 `GET /v2/models/luma_2/uni-1-max/openapi.json` 提供的 schema 生成，该文档也是 Router 在请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/luma_2/uni-1-max/openapi.json` 提供的 schema 生成，该文档也是 Router 在请求到达提供商之前用来验证调用的同一份文档。 ### 输出 @@ -335,7 +336,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 人类可读的失败描述，仅在生成状态为 FAILED 时填充。成功时为 `null`。 + 人类可读的失败描述，仅在生成状态为 FAILED 时填充。生成成功时为 `null`。 @@ -347,7 +348,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 一个已生成的输出条目 + 一条已生成的输出条目 @@ -355,7 +356,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 预签名 URL（有效期 1 小时） + 预签名 URL（1 小时后过期） diff --git a/zh/development/comfy-router/models/luma_2/uni-1/code.mdx b/zh/development/comfy-router/models/luma_2/uni-1/code.mdx index 64cd355e54..2aaa9160d4 100644 --- a/zh/development/comfy-router/models/luma_2/uni-1/code.mdx +++ b/zh/development/comfy-router/models/luma_2/uni-1/code.mdx @@ -2,17 +2,18 @@ title: "将 Uni 1 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 luma_2/uni-1：端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Uni 1" -translationSourceHash: 5f33116a +translationSourceHash: 897d09ee translationFrom: development/comfy-router/models/luma_2/uni-1/code.mdx translationBlockHashes: "_intro": a9aaf4ab "Quick start": 9d667b90 - "Schema": 6ccb738a + "Schema": fe7e100f "Examples": f993c215 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/luma_2/uni-1.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -155,11 +156,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ 输出宽高比。ray-3.2 视频模型支持 9:16、3:4、1:1、4:3、16:9、21:9 这一子集。 - 可能的值：`3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` + 可选值：`3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` - 用于风格/内容引导的参考图像。类型为 'image' 时最多 9 张，类型为 'image_edit' 时最多 8 张。 + 用于风格/内容引导的参考图像。type 为 'image' 时最多 9 个，type 为 'image_edit' 时最多 8 个。 @@ -167,11 +168,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 之前已完成生成的 UUID，可复用为来源。用于 ray-3.2 的 video_edit / video_reframe。 + 此前已完成生成的 UUID，用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时必填（视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（对于视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 @@ -179,13 +180,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 要使用的模型。uni-1 / uni-1-max 用于图像生成，ray-3.2 用于视频生成、编辑和重新取景。 + 要使用的模型。uni-1 / uni-1-max 用于图像生成，ray-3.2 用于视频生成、编辑与重新取景。 输出图像格式 - 可能的值：`png`、`jpeg` + 可选值：`png`、`jpeg` @@ -193,7 +194,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请仅提供 generation_id、url 或 data 三者之一。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。generation_id、url 或 data 三者中必须且只能提供一个。 @@ -201,11 +202,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 之前已完成生成的 UUID，可复用为来源。用于 ray-3.2 的 video_edit / video_reframe。 + 此前已完成生成的 UUID，用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时必填（视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（对于视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 @@ -215,27 +216,27 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ 风格预设 - 可能的值：`auto`、`manga` + 可选值：`auto`、`manga` 要执行的生成类型。image/image_edit 由 uni-1 / uni-1-max 模型生成；video/video_edit/video_reframe 由 ray-3.2 模型生成。 - 可能的值：`image`、`image_edit`、`video`、`video_edit`、`video_reframe` + 可选值：`image`、`image_edit`、`video`、`video_edit`、`video_reframe` - ray-3.2 的视频输出设置。此处仅对影响验证和计费的字段建模；其他字段（编辑控制项、source_position）会原样转发给 Luma。 + ray-3.2 的视频输出设置。此处仅建模影响验证与计费的字段；其他字段（编辑控制项、source_position）会原样转发给 Luma。 - ray-3.2 video / video_edit 的片段时长。默认 5s。HDR 生成（类型 video）仅限 5s。 + ray-3.2 video / video_edit 的片段时长。默认 5s。HDR 生成（type 为 video）仅限于 5s。 - 可能的值：`5s`、`10s` + 可选值：`5s`、`10s` - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请仅提供 generation_id、url 或 data 三者之一。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。generation_id、url 或 data 三者中必须且只能提供一个。 @@ -243,11 +244,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 之前已完成生成的 UUID，可复用为来源。用于 ray-3.2 的 video_edit / video_reframe。 + 此前已完成生成的 UUID，用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时必填（视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（对于视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 @@ -255,19 +256,19 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 随 MP4 一并导出 EXR 文件。要求 hdr 为 true。在 video_reframe 中会被拒绝。 + 尚不可用：在 Luma 交付 EXR 之前，exr_export=true 的请求会以 400 被拒绝。正式支持后会在 MP4 之外同时导出一个 EXR 文件（需要 hdr 为 true）。video_reframe 会拒绝该字段。 - 以 HDR 渲染。要求 720p/1080p。在 video_reframe 中会被拒绝。 + 以 HDR 渲染。需要 720p/1080p。video_reframe 会拒绝该字段。 - `keyframes` 的输出帧位置，长度相同；5s 时为 0–120，10s 时为 0–240。原样转发。 + `keyframes` 的输出帧位置，长度需与之一致；5s 时为 0–120，10s 时为 0–240。原样转发。 - 引导帧图像（1–64），与 start_frame/end_frame 互斥。按请求的时长计费；keyframes 请求绝不会被视为单关键帧扩展。 + 引导帧图像（1–64），与 start_frame/end_frame 互斥。按请求的时长计费；keyframes 请求永远不会被视为单关键帧延长。 @@ -275,11 +276,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 之前已完成生成的 UUID，可复用为来源。用于 ray-3.2 的 video_edit / video_reframe。 + 此前已完成生成的 UUID，用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时必填（视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起使用时必填（对于视频来源还需与 url 一起使用，例如 video_edit / video_reframe 上的 video/mp4）。 @@ -287,17 +288,17 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 循环播放生成的片段。仅创建时可用（类型 video）。 + 循环生成的片段。仅创建时可用（type 为 video）。 - ray-3.2 video 的输出分辨率。默认为 720p。360p 是草稿档位。HDR 要求 720p 或 1080p。 + ray-3.2 video 的输出分辨率。默认 720p。360p 为草稿档位。HDR 需要 720p 或 1080p。 - 可能的值：`360p`、`540p`、`720p`、`1080p` + 可选值：`360p`、`540p`、`720p`、`1080p` - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请仅提供 generation_id、url 或 data 三者之一。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。generation_id、url 或 data 三者中必须且只能提供一个。 @@ -305,11 +306,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 此前已完成的生成 UUID，可复用为来源。供 ray-3.2 的 video_edit / video_reframe 使用。 + 先前已完成的生成记录的 UUID，用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一同使用时为必填（对于视频来源还需与 url 一同使用，例如 video_edit / video_reframe 上的 video/mp4）。 + MIME 类型。与 data 一起时为必填（对于视频来源还需配合 url，例如 video_edit / video_reframe 上的 video/mp4）。 @@ -317,10 +318,10 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 启用 Web 搜索接地 + 启用搜索 grounding -由 Router 在 `GET /v2/models/luma_2/uni-1/openapi.json` 提供并据此生成的 schema，与它在请求到达提供商之前校验调用时所使用的是同一份文档。 +根据 Router 在 `GET /v2/models/luma_2/uni-1/openapi.json` 上提供的 schema 生成，与它在请求到达提供商之前用于校验调用的是同一份文档。 ### 输出 @@ -329,13 +330,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 用于程序化处理的机器可读失败代码 + 供程序化处理的机器可读失败代码 可能的值：`content_moderated`、`generation_failed`、`budget_exhausted`、`output_not_found` - 人类可读的失败描述，仅在 FAILED 生成时填充。成功时为 `null`。 + 人类可读的失败描述，仅在生成状态为 FAILED 时填充。生成成功时为 `null`。 @@ -343,11 +344,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 使用的模型 + 所使用的模型 - 生成的输出条目 + 一个已生成的输出条目 @@ -355,7 +356,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 预签名 URL（1 小时有效） + 预签名 URL（1 小时后过期） diff --git a/zh/development/comfy-router/models/veed/fabric-1-0/code.mdx b/zh/development/comfy-router/models/veed/fabric-1-0/code.mdx index 33bf55a00e..48d45f3b1f 100644 --- a/zh/development/comfy-router/models/veed/fabric-1-0/code.mdx +++ b/zh/development/comfy-router/models/veed/fabric-1-0/code.mdx @@ -2,14 +2,15 @@ title: "使用 Fabric 1.0 与 Comfy Router" description: "通过 Comfy Router 调用 veed/fabric-1.0：端点、请求形状以及 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 --- + {/* GENERATED FILE. Generated from router-schemas/veed/fabric-1.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -154,7 +155,7 @@ curl https://api.comfy.org/v2/models/veed/fabric-1.0/requests/$REQUEST_ID \ ### 输入 - 用于对口型同步的语音轨道的公开 http(s) URL。视频时长与音频相同。 + 用于对口型同步的语音轨道的公开 http(s) URL。视频时长与音频相同。当音频长度超过单次调用的输入上限时，请求会被拒绝并返回 400。 diff --git a/zh/development/comfy-router/models/veed/lipsync-2-0/code.mdx b/zh/development/comfy-router/models/veed/lipsync-2-0/code.mdx index 8096d48c4b..b6ebd81298 100644 --- a/zh/development/comfy-router/models/veed/lipsync-2-0/code.mdx +++ b/zh/development/comfy-router/models/veed/lipsync-2-0/code.mdx @@ -2,14 +2,15 @@ title: "使用 Comfy Router 调用 Lipsync 2.0" description: "通过 Comfy Router 调用 veed/lipsync-2.0：端点、请求形状以及 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 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/veed/lipsync-2.0.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -150,7 +151,7 @@ curl https://api.comfy.org/v2/models/veed/lipsync-2.0/requests/$REQUEST_ID \ ### 输入 - 用于给视频对口型的新音频轨道的公开 http(s) URL。 + 用于给视频对口型的新音频轨道的公开 http(s) URL。当音频长度超过单次调用的输入上限时，请求会以 400 被拒绝。 diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index 1caa523e99..7319ce7f67 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -2,17 +2,17 @@ title: "Comfy Router API 参考" description: "每个 Comfy Router 端点、参数、响应体和错误分类，均由 Comfy API 契约生成。" sidebarTitle: "API 参考" -translationSourceHash: 1b971d1c +translationSourceHash: 7bdc66a2 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": fbcaaf0e - "Error buckets": 36170340 + "Endpoints": 222fd740 + "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 3ecabac6 + "Pre-flight cost estimates": 862a49f8 "Result assets": 65fc939b "Per-model input and output schemas": 61c6bde8 - "Schemas": 77cfa4db + "Schemas": 0c65163b --- @@ -233,7 +233,7 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 请求无效。请检查错误类型和请求体。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Comfy-Upstream-Status`、`X-Comfy-Upstream-Detail`、`X-Comfy-Refusal-Subject`、`Idempotent-Replayed` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `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` @@ -839,6 +839,7 @@ Router 错误的机器可读类别，同时也会在 `X-Comfy-Error-Type` 响应 | `queue_timeout` | 已排队的请求等待超过了其队列超时时间，始终未被准入。 | | `request_not_found` | `request_id` 未指向该调用方在此模型下的任何请求。 | | `queue_backlog_full` | 调用方已有过多等待运行的排队请求，因此此次提交被拒绝。 | +| `result_expired` | 请求存在且已完成，但其结果已不再存储，因此收集时没有可返回的内容。 | ## 响应头 @@ -1033,6 +1034,24 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 ## Schemas +### RouterBilledWorkspace + +被拒绝的调用本会扣费的电子钱包，位于 `RouterErrorResponse.billed_workspace`。它回答“哪个钱包余额不足？”，但未必是调用方界面当前所选的工作区：即使正在使用一个有余额的团队，团队成员的个人凭证在这里也会指向其个人钱包。仅在同时存在 `denied_reason` 时出现。 + +**字段** + + + Cloud 工作区 id。在旧式计费通道上不存在。 + + + + `personal` 或 `team`。这是一个开放字符串：其他任何值都按 personal 处理。 + + + + 当该调用向调用方在工作区出现之前的 Metronome 客户计费、而不是向 Cloud 工作区计费时为 `legacy`；该客户没有工作区 id。Cloud 工作区不出现此字段。 + + ### RouterChargesOnPolicyRejection 内容政策拒绝是否会对该模型计费。请将未知值视为可能计费。 @@ -1100,7 +1119,7 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 - 该报价定价所依据的费率卡片的获取时间。该预估不是价格锁定：运行按评级时生效的费率计费，而非此时间点的费率。每当未读取任何费率卡片时（`reason: pricing_unavailable`、`byok`，或无法从任何卡片定价的 `not_quotable` 调用），这里就是该报价被应答的时间。 + 该报价定价所依据的费率卡片的获取时间。该预估不是价格锁定：运行按评级时生效的费率计费，而非此时间点的费率。从提供商公布的价格清单取得的 `estimated` 报价（按提供商上报成本计费的模型）会带有该清单的读取日期；而计费数量由该清单预测、再按费率卡片定价的报价（按提供商上报积分计费的模型）则取两个日期中较早的一个。每当未读取任何费率卡片时（`reason: pricing_unavailable`、`byok`，或无法从任何卡片定价的 `not_quotable` 调用），这里就是该报价被应答的时间。 date-time @@ -1120,7 +1139,7 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 - 对 Router 失败的粗粒度、机器可读的分类，同时镜像到 `X-Comfy-Error-Type` 响应头，以便调用方无需解析响应体即可分支判断。该集合目前是封闭的，共十九个值：六个请求级分类 `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits` 和 `model_not_found`，以及传输层的 `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found` 和 `queue_backlog_full`。“封闭”描述的是当前文档所记录的集合，并不是一个永远成立的界限：该集合预计还会增长，因此这里刻意使用普通字符串而不是 `enum`，客户端必须将无法识别的值视为 `internal_error`，而不是对上面的列表做穷举 switch，并在下次新增取值时出错。 + 对 Router 失败的粗粒度、机器可读的分类，同时镜像到 `X-Comfy-Error-Type` 响应头，以便调用方无需解析响应体即可分支判断。该集合目前是封闭的，共二十个值：六个请求级分类 `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits` 和 `model_not_found`，以及传输层的 `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full` 和 `result_expired`。“封闭”描述的是当前文档所记录的集合，并不是一个永远成立的界限：该集合预计还会增长，因此这里刻意使用普通字符串而不是 `enum`，客户端必须将无法识别的值视为 `internal_error`，而不是对上面的列表做穷举 switch，并在下次新增取值时出错。 类型：[`RouterErrorType`](#routererrortype) @@ -1133,6 +1152,20 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 内容策略拒绝针对的是哪个输入或输出，采用 Router 层面的封闭词表：`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio`。当提供商未指明具体模态时，仅用 `input` / `output` 这两个值来指明是哪一侧。仅当 `error_type` 为 `content_policy_violation` 且提供商以机器可读代码指明了被拒绝的对象时才存在；否则不存在。绝不会是提供商原文。目前已为 BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI 和 Wan（万相）的拒绝给出该字段，也为 MiniMax Router 的 Nano Banana 链路中的 Gemini 拒绝给出该字段；如果提供商的拒绝未说明针对哪一侧，该字段就会缺失。它与 `X-Comfy-Refusal-Subject` 响应头对应。 + + 计费侧针对合作伙伴节点支出拒绝的策略分支：`no_funds` 表示计费钱包为空，`unspecified` 表示该调用在没有资金读数的情形下被拒绝。仅当 `error_type` 为 `insufficient_credits` 且部署会上报钱包事实时出现；否则不出现。这是机器可读的代码而非展示文本：展示 `detail`，按此字段分支。 + + + + 被拒绝的调用本会扣费的电子钱包，位于 `RouterErrorResponse.billed_workspace`。它回答“哪个钱包余额不足？”，但未必是调用方界面当前所选的工作区：即使正在使用一个有余额的团队，团队成员的个人凭证在这里也会指向其个人钱包。仅在同时存在 `denied_reason` 时出现。 + + 类型：[`RouterBilledWorkspace`](#routerbilledworkspace) + + + + 被拒绝的请求以何种方式完成认证：`personal_api_key`、`team_api_key`、`personal_session` 或 `team_session`。它回答“该换成哪份凭证来向另一个钱包计费？”。它不是权限，也不授予任何权限。仅在同时存在 `denied_reason` 时出现。 + + ### RouterErrorType 机器可读的 Router 错误类别，同时也会在 `X-Comfy-Error-Type` 标头中发送。 @@ -1146,7 +1179,7 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 **字段** - 模型以内容政策为由拒绝的调用，是否仍向调用方计费。各提供商的做法不尽相同，而这种差异在调用时无法察觉，因此用户即使同时看到同一次调用的错误与扣费，也无从事先得知。所以这里在调用之前按模型明确说明，而不是留待各提供商各自口口相传。 + 模型以内容政策为由拒绝的调用，是否仍向调用方计费。各提供商的做法不尽相同，而这种差异在调用时无法察觉，因此用户即使同时看到同一次调用的错误与扣费，也无从事先得知。所以这里在调用之前按模型明确说明，而不是留待各提供商各自口口相传。当该值为 `yes` 时，同步路由上的 `content_policy_violation` 错误可能带有 `X-Comfy-Credits-Used`：当提供商拒绝了模型生成的输出，且 Comfy 记录了该次被拒生成的用量时会带上它，并携带该金额。输入侧的拒绝与同键重放（`Idempotent-Replayed: true`）不带此头；没有该头的拒绝不会上报，也不能证明是免费的。 类型：[`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection)