From 3f8f93cd819c838e2f48f62177db9b51e3ea8116 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Fri, 30 Oct 2026 11:28:01 +0800 Subject: [PATCH 1/6] i18n: sync zh/ja/ko translations with upstream/main (2026-10-30) --- ja/development/api-development/sdks.mdx | 27 +- ja/development/cloud/api-reference.mdx | 5 +- ja/development/comfy-router/limitations.mdx | 37 +- ja/development/comfy-router/litellm.mdx | 12 +- ja/development/comfy-router/models.mdx | 52 +- .../flux-video-upscale/code.mdx | 9 +- .../models/bria/image-edit-relight/code.mdx | 7 +- .../dreamina-seedance-2-0-260128/code.mdx | 153 +- .../code.mdx | 142 +- .../dreamina-seedance-2-0-mini/code.mdx | 159 +- .../dreamina-seedance-2-5-260628/code.mdx | 147 +- .../byteplus/seedance-1-0-pro-250528/code.mdx | 170 +- .../seedance-1-0-pro-fast-251015/code.mdx | 131 +- .../byteplus/seedance-1-5-pro-251215/code.mdx | 136 +- .../models/fal/h3-max-turbo/code.mdx | 7 +- .../models/google/gemini/code.mdx | 2218 ++++++++++++----- .../models/ideogram/ideogram-4-5/code.mdx | 83 +- .../comfy-router/models/krea/krea-3/code.mdx | 7 +- .../models/luma_2/ray-3-2/code.mdx | 49 +- .../models/luma_2/uni-1-max/code.mdx | 87 +- .../comfy-router/models/luma_2/uni-1/code.mdx | 89 +- .../models/openai/gpt-image-1-5/code.mdx | 24 +- .../openai/gpt-image-2-5-flare/code.mdx | 33 +- .../openai/gpt-image-2-5-sunburst/code.mdx | 27 +- .../models/openai/gpt-image-2/code.mdx | 33 +- .../models/veed/fabric-1-0/code.mdx | 7 +- .../models/veed/lipsync-2-0/code.mdx | 7 +- ja/development/comfy-router/reference.mdx | 648 ++--- .../video/minimax/minimax-h3-fastvideo.mdx | 15 +- .../video/minimax/minimax-h3-prompt-guide.mdx | 29 +- ko/development/api-development/sdks.mdx | 15 +- ko/development/cloud/api-reference.mdx | 5 +- ko/development/comfy-router/limitations.mdx | 37 +- ko/development/comfy-router/litellm.mdx | 14 +- ko/development/comfy-router/models.mdx | 52 +- .../flux-video-upscale/code.mdx | 13 +- .../models/bria/image-edit-relight/code.mdx | 7 +- .../dreamina-seedance-2-0-260128/code.mdx | 133 +- .../code.mdx | 124 +- .../dreamina-seedance-2-0-mini/code.mdx | 150 +- .../dreamina-seedance-2-5-260628/code.mdx | 117 +- .../byteplus/seedance-1-0-pro-250528/code.mdx | 142 +- .../seedance-1-0-pro-fast-251015/code.mdx | 134 +- .../byteplus/seedance-1-5-pro-251215/code.mdx | 125 +- .../models/fal/h3-max-turbo/code.mdx | 7 +- .../models/google/gemini/code.mdx | 2214 +++++++++++----- .../models/ideogram/ideogram-4-5/code.mdx | 73 +- .../comfy-router/models/krea/krea-3/code.mdx | 7 +- .../models/luma_2/ray-3-2/code.mdx | 61 +- .../models/luma_2/uni-1-max/code.mdx | 67 +- .../comfy-router/models/luma_2/uni-1/code.mdx | 51 +- .../models/openai/gpt-image-1-5/code.mdx | 30 +- .../openai/gpt-image-2-5-flare/code.mdx | 27 +- .../openai/gpt-image-2-5-sunburst/code.mdx | 21 +- .../models/openai/gpt-image-2/code.mdx | 6 +- .../models/veed/fabric-1-0/code.mdx | 7 +- .../models/veed/lipsync-2-0/code.mdx | 7 +- ko/development/comfy-router/reference.mdx | 650 ++--- .../video/minimax/minimax-h3-fastvideo.mdx | 17 +- .../video/minimax/minimax-h3-prompt-guide.mdx | 29 +- zh/development/api-development/sdks.mdx | 11 +- zh/development/cloud/api-reference.mdx | 9 +- zh/development/comfy-router/limitations.mdx | 43 +- zh/development/comfy-router/litellm.mdx | 20 +- zh/development/comfy-router/models.mdx | 92 +- .../flux-video-upscale/code.mdx | 9 +- .../models/bria/image-edit-relight/code.mdx | 7 +- .../dreamina-seedance-2-0-260128/code.mdx | 145 +- .../code.mdx | 153 +- .../dreamina-seedance-2-0-mini/code.mdx | 125 +- .../dreamina-seedance-2-5-260628/code.mdx | 152 +- .../byteplus/seedance-1-0-pro-250528/code.mdx | 154 +- .../seedance-1-0-pro-fast-251015/code.mdx | 133 +- .../byteplus/seedance-1-5-pro-251215/code.mdx | 126 +- .../models/fal/h3-max-turbo/code.mdx | 7 +- .../models/google/gemini/code.mdx | 2211 +++++++++++----- .../models/ideogram/ideogram-4-5/code.mdx | 75 +- .../comfy-router/models/krea/krea-3/code.mdx | 7 +- .../models/luma_2/ray-3-2/code.mdx | 63 +- .../models/luma_2/uni-1-max/code.mdx | 51 +- .../comfy-router/models/luma_2/uni-1/code.mdx | 79 +- .../models/openai/gpt-image-1-5/code.mdx | 73 +- .../openai/gpt-image-2-5-flare/code.mdx | 68 +- .../openai/gpt-image-2-5-sunburst/code.mdx | 62 +- .../models/openai/gpt-image-2/code.mdx | 8 +- .../models/veed/fabric-1-0/code.mdx | 7 +- .../models/veed/lipsync-2-0/code.mdx | 7 +- zh/development/comfy-router/reference.mdx | 678 ++--- .../video/minimax/minimax-h3-fastvideo.mdx | 13 +- .../video/minimax/minimax-h3-prompt-guide.mdx | 29 +- 90 files changed, 8403 insertions(+), 5106 deletions(-) diff --git a/ja/development/api-development/sdks.mdx b/ja/development/api-development/sdks.mdx index 299df75116..9dc6994459 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"; @@ -110,20 +111,20 @@ await job.getOutputs("9")[0].toFile("out.png"); ## ベースURLの選択 -| 接続先 | Base URL | APIキー | +| 接続先 | ベースURL | APIキー | |---|---|---| | **Comfy Cloud** | `https://cloud.comfy.org` (デフォルト) | 必須 | | **Comfy API デプロイ** | `https://.run.comfy.app` | 必須 | -| **ご自身のComfyUI** | `http://127.0.0.1:8189` (ローカルプロキシ) | デフォルトでは不要。オプションの静的ベアラートークン | +| **ご自身の ComfyUI** | `http://127.0.0.1:8189` (ローカルプロキシ) | デフォルトでは不要。任意で静的ベアラートークンを指定可能 | -ベースURLはコンストラクタ引数ではなく、`COMFY_BASE_URL`環境変数から取得されます: +ベースURLはコンストラクタ引数ではなく、`COMFY_BASE_URL` 環境変数から取得されます: ```bash export COMFY_BASE_URL="https://.run.comfy.app" # Comfy API デプロイ export COMFY_BASE_URL="http://127.0.0.1:8189" # セルフホストプロキシ ``` -この変数はクライアントが構築されるたびに読み取られ、`http(s)` URLである必要があります。未設定または空白の場合はComfy Cloudを意味します。したがって、クライアント自体はどこでも同じです: +この変数はクライアントが構築されるたびに読み取られ、`http(s)` URL である必要があります。未設定または空白の場合は Comfy Cloud を意味します。したがって、クライアント自体はどこでも同じです: ```python Python @@ -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 @@ -144,20 +145,20 @@ const client = new Comfy({ apiKey: "comfyui-..." }); そのまま動作します。[APIキー](/ja/development/api-development/getting-an-api-key)を作成し、クライアントに渡します。 - APIアクセスには有料のComfy Cloudサブスクリプションが必要です。無料プランには含まれません。同時に実行できるジョブ数はプランによって異なります。[同時実行の制限](/ja/development/deploy/cloud-usage#同時実行の制限)をご覧ください。 + APIアクセスには有料の Comfy Cloud サブスクリプションが必要です。無料プランには含まれません。同時に実行できるジョブ数はプランによって異なります。[同時実行の制限](/ja/development/deploy/cloud-usage#同時実行の制限)をご覧ください。 ### Comfy API デプロイ -[開発者プラットフォーム](https://platform.comfy.org)を通じてデプロイしたワークフローには、専用のエンドポイントが割り当てられます。`COMFY_BASE_URL`をそのエンドポイントに指定し、Comfy Cloudとまったく同じようにAPIキーを使用します。このガイドのすべてが同じように機能します。ただし、[ジョブのラベルとジョブ一覧](#ジョブにラベルを付けて後で見つける)は Comfy Cloud ではまだサポートされていません。 +[開発者プラットフォーム](https://platform.comfy.org)を通じてデプロイしたワークフローには、専用のエンドポイントが割り当てられます。`COMFY_BASE_URL` をそのエンドポイントに指定し、Comfy Cloud とまったく同じように APIキーを使用します。このガイドのすべてが同じように機能します。ただし、[ジョブのラベルとジョブ一覧](#ジョブにラベルを付けて後で見つける)は Comfy Cloud ではまだサポートされていません。 -Comfy APIデプロイは、そのBuildに含まれるモデルとカスタムノードを使用して複数のワークフローを実行できます。各ジョブについて、`get_workflow()`は`format: "api"`を持ち、実行されたグラフを`.graph`プロパティに含むワークフローレスポンスを返します。 +Comfy API デプロイは、その Build に含まれるモデルとカスタムノードを使用して複数のワークフローを実行できます。各ジョブについて、`get_workflow()` は `format: "api"` を持ち、実行されたグラフを `.graph` プロパティに含むワークフローレスポンスを返します。 -### ご自身のComfyUI +### ご自身の ComfyUI -セルフホスト環境では、v2 API は ComfyUI と一緒に動作する小規模なオープンソースサービス [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy) によって提供されます。インストールして実行し、`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 @@ -348,7 +349,7 @@ SDKを通じて送信したジョブは常に`api`を返します。v2送信に ラベルは、ジョブを送信するときに付けるキーと値の組です。たとえば `client: acme` や `project: spring` です。ラベルを使うと、ジョブがどのクライアントやプロジェクトのために実行されたかを記録できます。そうすれば、ジョブ ID の対応表を自前で持たなくても、1 つのクライアントのジョブを一覧できます。ラベルとジョブ一覧には、現在の SDK リリース([インストール](#インストール)のバージョン注記に記載されているもの)が必要です。 -ラベルは [Comfy API デプロイ](#comfy-api-デプロイ)に送信したジョブで使えます。そのため、[ベースURLの選択](#ベースurlの選択)で示したとおり、`COMFY_BASE_URL` をデプロイのアドレスに設定してください。Comfy Cloud は現時点ではラベルを受け付けず、ジョブ一覧には `501` とコード `not_implemented` を返します。セルフホストの [comfy-api-proxy](#ご自身のcomfyui) もラベルを保持しません。proxy 独自の `metadata` フィールドは 1 つのテキスト文字列なので、ラベルのマップを拒否します。proxy のジョブ一覧はラベルによる絞り込みを無視するため、そこではラベルを指定した SDK の一覧呼び出しはジョブを 1 件も返さず、HTTP で同じフィルターを送るとすべてのジョブが返ります。 +ラベルは [Comfy API デプロイ](#comfy-api-デプロイ)に送信したジョブで使えます。そのため、[ベースURLの選択](#ベースurlの選択)で示したとおり、`COMFY_BASE_URL` をデプロイのアドレスに設定してください。Comfy Cloud は現時点ではラベルを受け付けず、ジョブ一覧には `501` とコード `not_implemented` を返します。セルフホストの [comfy-api-proxy](#ご自身の-comfyui) もラベルを保持しません。proxy 独自の `metadata` フィールドは 1 つのテキスト文字列なので、ラベルのマップを拒否します。proxy のジョブ一覧はラベルによる絞り込みを無視するため、そこではラベルを指定した SDK の一覧呼び出しはジョブを 1 件も返さず、HTTP で同じフィルターを送るとすべてのジョブが返ります。 制限: diff --git a/ja/development/cloud/api-reference.mdx b/ja/development/cloud/api-reference.mdx index 581b1859e6..c27bfdfb4d 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' diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index 08f0099f7c..0a79861f55 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: 235802c5 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": cf6e2050 + "Models without a pre-flight estimate": 495bdb2b + "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 がその拒否された生成に対して使用量を記録したときに付き、その金額が示されます。入力側の拒否、同一キーのリプレイ、およびヘッダーの小数 2 桁では表示できないほど少額の課金には付きません。ヘッダーのない拒否は報告されていないだけであり、無料ではありません。詳細は [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` オブジェクトを読み取ってください。見積もり機能の展開中は、このルートは `error_type: not_enabled` とともに `403` を返し、送信には `estimate` が含まれません。それぞれの価格は、Comfy がその実行に対して請求するレートカードに基づいて決まります(コストをベンダーが報告する形で課金されるモデルは、代わりにベンダーの公開価格表から見積もられます)が、その金額は見積もりであり最終的な請求額ではなく、ワークスペースの使用量と請求の記録にある確定した請求額が最終となります。また、価格を固定するものでもありません。独自のプロバイダーキーでの実行は、`/estimate` がその実行の金額を返したとしても Comfy からは請求されません。また、`unknown` の見積もりには金額が含まれておらず、それは無料を意味するものではありません。`X-Comfy-Credits-Used` は、実行に対する事後的な丸められた数値のままですが、領収書ではありません。`exact`、`estimated`、`unknown` の読み取り方については、[実行前のコスト見積もり](/ja/development/comfy-router/reference#事前のコスト見積もり) を参照してください。実行前に価格を算出できないモデルは、[事前見積もりのないモデル](#事前見積もりのないモデル) に一覧されています。 ## 事前見積もりのないモデル @@ -114,36 +115,40 @@ 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` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`, `ideogram/p-image-ideogram` - **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` -- **luma**: `luma/photon-1`, `luma/photon-flash-1`, `luma/ray-2`, `luma/ray-flash-2` +- **luma**: `luma/photon-1`, `luma/photon-flash-1` - **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` - **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) です。サポートはプロバイダーによって異なります。 +Routerはモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、`/proxy/…` 配下のパートナープロキシルートが必要になる場合があります。これらはRouterの外部にあり、そのコントラクトには記述されていません。Router自体のサーフェスは [Comfy Router specification](/ja/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がチェックするのは、リンクが `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..e1b472e215 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: 71f7e7b3 translationFrom: development/comfy-router/litellm.mdx translationBlockHashes: "_intro": 1ddb0d0a "Configure the pass-through": 380c3ae3 - "How spend is recorded": f852c18c + "How spend is recorded": 4a9dcb84 "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 はすべてのパススルーレスポンスでこのヘッダーを読み取り、リクエストの支出として記録するため、それらのモデル用の価格表を自分で管理する必要はありません。 @@ -97,16 +98,17 @@ X-Litellm-Total-Tokens: 0 ### コストを報告しない実行 -一部の実行には `x-litellm-response-cost` が付きません。`X-Comfy-Credits-Used` と同じケースで存在しません: +一部の実行には `x-litellm-response-cost` が付きません。これらのほとんどの場合、`X-Comfy-Credits-Used` も存在しません: - Comfy クレジットではなく、自分のプロバイダーキーに請求される実行 - Router の、実行ごとのクレジット価格を報告するモデルのリストにまだ載っていないモデル。そのリストは保守的で、一部のプロバイダーはまったく載っていません - Comfy の請求に到達しなかった課金 -- エラーレスポンス + +1 つだけ異なるケースがあります。エラーレスポンスです。`billing.charges_on_policy_rejection` が `yes` のモデルからの同期的な `content_policy_violation` は、拒否された生成に対して Comfy が記録した使用量とともに `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 はこれをゼロとして記録します。 +ヘッダーが存在しない場合、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..a91ea5dde9 100644 --- a/ja/development/comfy-router/models.mdx +++ b/ja/development/comfy-router/models.mdx @@ -2,18 +2,18 @@ title: "Comfy Router モデル" sidebarTitle: "すべてのモデル" description: "Comfy Router で利用できるすべてのモデルを、各モデルの入力と出力のモダリティとあわせて、プロバイダー別にまとめています。" -translationSourceHash: f12be9e4 +translationSourceHash: d2265d41 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 9b1b4039 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 "BytePlus": 0ff87da0 "Elevenlabs": 7d6dbcc6 - "fal": 00f4c6b2 + "fal": 63e65674 "Freepik": 51b8af46 "Gemini Interactions": ca46b908 "Google": 4932820b @@ -23,12 +23,12 @@ translationBlockHashes: "Kling": 3002befa "Krea": 16b83e5e "LTX": 32595bf9 - "Luma": 37a12a19 + "Luma": 8cd2a7ce "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) を参照してください。 @@ -53,7 +54,7 @@ translationBlockHashes: ## 出力から探す - + - [SwitchX](/ja/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [FLUX 3 Video](/ja/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` @@ -89,8 +90,6 @@ translationBlockHashes: - [LTX 2.5 Fast](/ja/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ja/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` - [Ray 3.2](/ja/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` -- [Ray 2](/ja/development/comfy-router/models/luma/ray-2/code): `luma/ray-2` -- [Ray Flash 2](/ja/development/comfy-router/models/luma/ray-flash-2/code): `luma/ray-flash-2` - [MiniMax H3](/ja/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` - [Image To Video](/ja/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` - [Text To Video](/ja/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` @@ -106,8 +105,7 @@ translationBlockHashes: - [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ja/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/ja/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` -- [Video Background Removal](/ja/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` -- [Veo 3.1 Fast Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` +- [Video Background Removal](/ja/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal`- [Veo 3.1 Fast Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` - [HappyHorse 1.0 I2V](/ja/development/comfy-router/models/wan/happyhorse-1-0-i2v/code): `wan/happyhorse-1.0-i2v` @@ -135,7 +133,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` @@ -161,8 +159,7 @@ translationBlockHashes: - [Image Edit Remove Background Guided](/ja/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/ja/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/ja/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [Image Edit Replace Object By Text](/ja/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` -- [Image Edit Reseason](/ja/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [Image Edit Replace Object By Text](/ja/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text`- [Image Edit Reseason](/ja/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` - [Image Edit Restore](/ja/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` - [Image](/ja/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` @@ -198,7 +195,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` @@ -214,8 +210,7 @@ translationBlockHashes: - [Recraft V4.1 Utility](/ja/development/comfy-router/models/recraft/recraftv4-1-utility/code): `recraft/recraftv4_1_utility` - [Recraft V4.1 Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-vector/code): `recraft/recraftv4_1_vector` - [Recraft V4.1](/ja/development/comfy-router/models/recraft/recraftv4-1/code): `recraft/recraftv4_1` -- [Recraft V4 Pro](/ja/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro` -- [Recraft V4 Styles Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` +- [Recraft V4 Pro](/ja/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro`- [Recraft V4 Styles Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` - [Recraft V4 Styles Pro](/ja/development/comfy-router/models/recraft/recraftv4-styles-pro/code): `recraft/recraftv4_styles_pro` - [Recraft V4 Styles Vector](/ja/development/comfy-router/models/recraft/recraftv4-styles-vector/code): `recraft/recraftv4_styles_vector` - [Recraft V4 Styles](/ja/development/comfy-router/models/recraft/recraftv4-styles/code): `recraft/recraftv4_styles` @@ -269,14 +264,13 @@ translationBlockHashes: - [Wan 2.5 T2V Preview](/ja/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` - [Wan 2.6 I2V](/ja/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` - [Wan 2.6 R2V](/ja/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` -- [Wan 2.6 T2V](/ja/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` -- [Wan 2.7 I2V](/ja/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` +- [Wan 2.6 T2V](/ja/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v`- [Wan 2.7 I2V](/ja/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` - [Wan 2.7 T2V](/ja/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` - [Wan 3.0 Video Prime](/ja/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` - [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 +284,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 +313,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` @@ -332,11 +325,7 @@ translationBlockHashes: - [GPT 5](/ja/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [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` +- [GPT 6 Sol](/ja/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol`- [o3](/ja/development/comfy-router/models/openai/o3/code): `openai/o3` - [Chat Completions](/ja/development/comfy-router/models/openrouter/chat-completions/code): `openrouter/chat-completions` @@ -448,7 +437,7 @@ translationBlockHashes: | [Crystal Upscaler](/ja/development/comfy-router/models/fal/crystal-upscaler/code) | `fal/crystal-upscaler` | 画像 | 画像 | | [Crystal Video Upscaler](/ja/development/comfy-router/models/fal/crystal-video-upscaler/code) | `fal/crystal-video-upscaler` | ビデオ | ビデオ | | [FLUX 3 Max](/ja/development/comfy-router/models/fal/flux-3-max/code) | `fal/flux-3-max` | テキスト, 画像 | ビデオ + オーディオ | -| [H3 Max Turbo](/ja/development/comfy-router/models/fal/h3-max-turbo/code) | `fal/h3-max-turbo` | テキスト, 画像 | ビデオ + オーディオ | +| [H3 Max Turbo](/ja/development/comfy-router/models/fal/h3-max-turbo/code) | `fal/h3-max-turbo` | テキスト, 画像, ビデオ, オーディオ | ビデオ + オーディオ | | [H3 Max](/ja/development/comfy-router/models/fal/h3-max/code) | `fal/h3-max` | テキスト, 画像, ビデオ, オーディオ | ビデオ + オーディオ | | [Patina](/ja/development/comfy-router/models/fal/patina/code) | `fal/patina` | 画像 | 画像 | @@ -543,8 +532,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` | テキスト | 画像 | -| [Ray 2](/ja/development/comfy-router/models/luma/ray-2/code) | `luma/ray-2` | テキスト, 画像 | ビデオ | -| [Ray Flash 2](/ja/development/comfy-router/models/luma/ray-flash-2/code) | `luma/ray-flash-2` | テキスト, 画像 | ビデオ | ## Luma 2 @@ -584,7 +571,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 +585,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/black-forest-labs/flux-video-upscale/code.mdx b/ja/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx index bf2dfa22eb..656f7a91ed 100644 --- a/ja/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx +++ b/ja/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx @@ -2,16 +2,17 @@ title: "FLUX Video Upscale を Comfy Router で使用する" description: "Comfy Router 経由で HTTP 上で FLUX Video Upscale を使ってビデオをアップスケーリングするための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "FLUX Video Upscale" -translationSourceHash: 0b09f0ee +translationSourceHash: 37a8dde1 translationFrom: development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx translationBlockHashes: "_intro": cf804f5f "Quick start": b745a238 - "Schema": 4675f835 + "Schema": c0dca73f "Examples": d1ffa3d6 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -170,7 +171,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - アップスケールするビデオ。HTTP(S) URL または base64 エンコードされた MP4 のいずれかです。ソース映像は最大 20 秒、50MB までです。 + アップスケールするビデオ。HTTP(S) URL または base64 エンコードされた MP4 のいずれかです。ソース映像は最大 20 秒、50MB、1 フレームあたり 2560x1440(3.7 メガピクセル)までです。より大きなソースは、送信する前にダウンスケールしてください。 @@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - ソース解像度に対する出力のスケール。出力はソースのアスペクト比を保持し、1 フレームあたり約 14.4 メガピクセルに制限されるため、非常に大きなソースでは要求した係数より小さくスケールされます。 + ソース解像度に対する出力のスケール。出力はソースのアスペクト比を保持し、1 フレームあたり約 14.4 メガピクセルに制限されるため、非常に大きなソースでは要求した係数より小さくスケールされます。解像度のオプションはありません。2K(2560x1440)や 4K(3840x2160)を目標にする場合は、目標の高さをソースの高さで割ってください。720p のソースは 2 で 2K、3 で 4K に達します。1080p のソースは 2 で 4K に達しますが、2K には達しません。2K には 1.33 が必要です。 範囲: `1.5` から `3` 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/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 235bad36b1..1df3726492 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,19 +2,20 @@ title: "Dreamina Seedance 2.0 260128 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-260128 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 98890ddf +translationSourceHash: 9604ca27 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 5c27d10f + "Schema": 6c5da06a "Examples": 641c458b --- + {/* 生成済みファイル。router-schemas/byteplus/dreamina-seedance-2-0-260128.json から `pnpm code-pages:gen` によって生成されます。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -196,7 +197,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque ### 入力 - この生成タスクの結果を受け取るコールバック通知先 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果を取得するには、代わりにタスクステータスのルートをポーリングしてください。 形式: `uri` @@ -206,23 +207,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力をサポートします。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力をサポートしています。 オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオの公開 URL(wav、mp3)。 +オーディオ URL: オーディオ(wav、mp3)の公開 URL。 Base64: 形式 data:audio/\;base64,\ アセット ID: 形式 asset://\ - Seedance 2.5 専用。最終ビデオとしてレンダリングする Draft タスク。これは唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクの prompt、入力アセット、duration、ratio、seed、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。resolution のデフォルトは 1080p で、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングするドラフトタスク。コンテンツ項目として唯一のものである必要があります。 +最終ビデオはドラフトタスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。解像度は既定値が 1080p で、1080p のみをサポートします。 - `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 + `draft` を true に設定してドラフトビデオを作成したときに返されるタスク ID。 @@ -230,8 +231,8 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセスできることを確認してください。 + 画像から動画への生成のための画像コンテンツ(type が "image_url" の場合) +画像 URL: 画像 URL にアクセス可能であることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります アセット ID: 形式 asset://\ @@ -242,41 +243,33 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 指定可能な値: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して、生成するビデオを記述します。 +テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 -パラメータ(任意): テキストプロンプトの後に --[parameters] を追加して、ビデオの仕様を制御します: -- --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) -- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) -- --duration (--dur): 3~12 秒(デフォルト: 5) -- --framepersecond (--fps): 24(デフォルト: 24) -- --watermark (--wm): true/false(デフォルト: false) -- --seed (--seed): -1~2^32-1(デフォルト: -1) -- --camerafixed (--cf): true/false(デフォルト: false) +パラメータ(任意): テキストプロンプトの後に --[parameters] を追加してビデオの仕様を制御します: +- --resolution (--rs): 480p、720p、1080p(既定値: 720p) +- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(既定値: 16:9 または adaptive) +- --duration (--dur): 3〜12 秒(既定値: 5) +- --framepersecond (--fps): 24(既定値: 24) +- --watermark (--wm): true/false(既定値: false) +- --seed (--seed): -1 から 2^32-1(既定値: -1) +- --camerafixed (--cf): true/false(既定値: false) 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の制限を公表しておらず、検証(2026-09-17)では 40,000 文字を受け付けました。 -これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトでは -送信時のサイズがその数倍になる場合があります。これはこの 1 つのフィールドを制限するものであり、 -リクエスト全体を制限するものではありません。`content` は配列であり、 -リクエストごとのボディ制限がドキュメント全体を制限します。これを強制するのは -Comfy Router(/v2/models/byteplus/\{model})のレイヤーです。直接 v1 /proxy を呼び出す場合は、 -代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックをはるかに上回る値に -設定されているため、正当なプロンプトがこれで判定されることはありません。呼び出し元が -さらに必要とする場合は引き上げてください。 +Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus はテキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。 +バイト数ではなく文字数をカウントするため、マルチバイトのプロンプトは通信時にこのサイズの数倍になることがあります。これはこの 1 つのフィールドを制限するものであり、リクエスト全体を制限するものではありません。`content` は配列であり、ドキュメント全体を制限するのはリクエストごとの body 制限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})です。v1 /proxy を直接呼び出した場合は、代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトが拒否されることはありません。呼び出し元がさらに多くを必要とする場合は引き上げてください。 - 入力コンテンツのタイプ + 入力コンテンツの種類 - 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 指定可能な値: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -285,67 +278,67 @@ Comfy Router(/v2/models/byteplus/\{model})のレイヤーです。直接 v1 ビデオ URL またはアセット ID。 -ビデオ URL: ビデオの公開 URL(mp4、mov)。 +ビデオ URL: ビデオ(mp4、mov)の公開 URL。 アセット ID: 形式 asset://\ - Seedance 2.5 専用。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p のドラフトビデオを生成します。解像度は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。ドラフトタスク ID は 7 日間有効です。 ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 - 範囲: `2` ~ `30` + 範囲: `2` から `30` - タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。既定値は 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` ~ `259200` + 範囲: `3600` から `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオが含まれるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオが含まれるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対して断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは、拒否されたモダリティがオーディオだった場合だけであり、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 - 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接 v1 呼び出しでは必ずこれを指定する必要があります。プロキシは他の値を拒否し、省略された場合も 400 を返します。このスキーマの `required` リストには含まれていません。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元は省略します。 + 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ず指定する必要があります。プロキシは他の値や省略された値を 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを埋めるためであり、Router の呼び出し元は省略します。 - Seedance 2.5 専用。出力ビデオのコンテナ形式。mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズも小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。高い色精度を持ち、ポストプロダクションに適しています。ファイルサイズは大きくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズが小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適していますが、ファイルサイズは大きくなります。 - 指定可能な値: `mp4`、`mov` + 取り得る値: `mp4`, `mov` - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の first-frame / first-last-frame 生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)を受け付けます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 では、これらのモードでも具体的な比率を指定できます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け入れられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け入れます。 - 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 取り得る値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 -注意: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 - 指定可能な値: `480p`、`720p`、`1080p`、`4k` + 取り得る値: `480p`, `720p`, `1080p`, `4k` - 生成済みビデオの最後のフレーム画像を返すかどうか。 -true: 生成済みビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報の照会を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、そのピクセル単位の幅と高さは生成済みビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成済みのビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用することで、複数の連続したビデオを素早く生成できます。 -false: 生成済みビデオの最後のフレーム画像を返しません。 + 生成されたビデオの最終フレーム画像を返すかどうか。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、「ビデオ生成タスクの情報を照会する」を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用するため、複数の連続したビデオをすばやく生成できます。 +false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 範囲: `-1` から `4294967295` @@ -353,39 +346,53 @@ false: 生成済みビデオの最後のフレーム画像を返しません。 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`、`flex` + 取り得る値: `default`, `flex` - 生成済みビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオにウォーターマークが含まれるかどうか。 -`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 ### 出力 - ビデオ生成タスクが完了した後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy ストレージに再ホストされます。ここにあるその他のフィールドはすべて BytePlus 自身のものです。ヌル許容です。BytePlus はタスクの 24 時間後に URL をクリアするため、その後ポーリングした成功ステータスのドキュメントでは `content` が存在しないか null である可能性があります。 + ビデオ生成タスクが完了した後の出力です。出力ビデオのダウンロードURLと、BytePlus が返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにある他のフィールドはすべて BytePlus 自身のものです。Nullable: BytePlus はタスクの24時間後に URL をクリアするため、その後ポーリングした成功済みドキュメントでは `content` が存在しないか null である可能性があります。 - 生成されたビデオの最終フレームのダウンロード URL です。リクエストで `return_last_frame` を設定した場合に返されます。この URL から画像形式を推測しないでください。BytePlus はリクエスト側では最終フレームを PNG として記載していますが、Router は提供されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` はその両方が失敗した場合の最後のフォールバックにすぎません。Router は最終フレームを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL です。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後からポーリングすると残り 1 時間しかない URL が返されることがあります。再ホストを実行できなかった場合、このフィールドには BytePlus 自身の URL がそのまま残ります。BytePlus はタスクの 24 時間後にその URL をクリアします。いずれにせよリンクは失効するため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロードURLで、リクエストで `return_last_frame` が設定された場合に返されます。この URL から画像形式を推測しないでください。BytePlus はリクエスト側で最終フレームを PNG として記載していますが、Router は提供されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` はそのどちらも失敗した場合の最後のフォールバックにすぎません。Router は最終フレームを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの24時間後にそれをクリアします。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。 - 生成されたビデオのコンテナ形式(mp4 または mov)です。BytePlus がこれを `content` の中にネストして返す場合に含まれます。Seedance モデルでは `content` のトップレベルの兄弟フィールドとして返すことの方が多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router は存在する方のフィールドを読み取ります。 + BytePlus が `content` の中にネストして返す場合の、生成されたビデオのコンテナ形式(mp4 または mov)です。Seedance モデルでは `content` のトップレベルの兄弟として返すことがより一般的で、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + + + + 上流の URL が機能しなくなる RFC 3339 の時刻です。URL 自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlus が文書化している URL の寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ含まれ、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + 形式: `date-time` + + + + 最終フレームに対する BytePlus 自身のダウンロードURLで、再ホストされた `last_frame_url` の隣にそのままのバイト列で返されます。条件は `upstream_video_url` と同じです。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラークレデンシャルです。 + + + + 出力ビデオに対する BytePlus 自身のダウンロードURLで、再ホストされた `video_url` の隣にそのままのバイト列で返されます。サーバー側で Comfy がオプトインしたワークスペースによってポーリングされる Seedance 2.x のタスクにのみ含まれます(リクエストパラメーターはありません)。それ以外のすべての場合、たとえばワークスペースに解決されないクレデンシャル(特定のワークスペースにスコープされていないレガシー APIキーなど)では含まれず、生成から24時間後に BytePlus が URL をクリアすると存在しなくなります。これはプレサインドのオブジェクトストレージ URL であり、したがってベアラークレデンシャルです。保持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットとして扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストが消費します。 - 出力ビデオのダウンロード URL です。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL です。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後からポーリングすると残り 1 時間しかない URL が返されることがあります。再ホストを実行できなかった場合、このフィールドには BytePlus 自身の URL がそのまま残ります。BytePlus はタスクの 24 時間後にその URL をクリアし、一部のモデルではダウンロード回数が 100 回に制限されます。いずれにせよリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時間です。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 - 生成されたビデオの再生時間(秒)です。BytePlus がこの点について一貫していないため、整数ではなく数値として宣言されています。ビデオタスクでは整数秒が返されることが確認されている一方、BytePlus の同種のサーフェスでは小数の再生時間が報告されるため、クライアントは整数値であると仮定してはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す一方、BytePlus の関連サーフェスでは小数の再生時間が報告されることが観測されており、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 @@ -393,15 +400,15 @@ false: 生成済みビデオの最後のフレーム画像を返しません。 - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のように、ドット区切りの理由が付く場合があります。これは enum ではなくオープンな文字列です。その他のコードは検証やプロバイダーの障害を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの障害を上書きすることはありません。 + 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは列挙型ではなくオープンな文字列で、他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 エラーメッセージ - - ビデオ生成タスクの ID +```mdx + ビデオ生成タスクのID @@ -409,15 +416,15 @@ false: 生成済みビデオの最後のフレーム画像を返しません。 - 生成されたビデオのコンテナ形式(mp4 または mov)で、`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 自身のフィールドで、そのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedanceのビデオタスククエリはここでこの値を返します。BytePlus独自のフィールドで、変更されずにそのまま転送されます。 - 生成されたビデオの解像度です。例えば `1080p` です。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シードです。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -429,7 +436,7 @@ false: 生成済みビデオの最後のフレーム画像を返しません。 - タスクが最後に更新された時間です。値は秒単位の UNIX タイムスタンプです。 + タスクが最後に更新された時間。値はUNIXタイムスタンプ(秒単位)です。 @@ -441,7 +448,7 @@ false: 生成済みビデオの最後のフレーム画像を返しません。 - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。したがって、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは入力トークン数は計算されず、0が既定値となります。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index a76e21550a..5fd194b017 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Dreamina Seedance 2.0 Fast 260128 を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-fast-260128 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: acad6428 +translationSourceHash: b02c6ed1 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": a00368da + "Schema": e03c503a "Examples": 7714eccd --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -181,7 +182,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### 入力 - この生成タスクの結果を受け取るコールバック通知アドレス + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりにタスクステータスのルートをポーリングして結果を取得してください。 形式: `uri` @@ -191,11 +192,11 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみでは使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 - オーディオ URL、Base64 エンコード、またはアセット ID。 + オーディオ URL、Base64 エンコーディング、またはアセット ID。 オーディオ URL: オーディオの公開 URL(wav、mp3)。 Base64: 形式 data:audio/\;base64,\ アセット ID: 形式 asset://\ @@ -203,7 +204,7 @@ Base64: 形式 data:audio/\;base64,\ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクの prompt、入力アセット、duration、ratio、seed、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。resolution はデフォルトで 1080p となり、1080p のみをサポートします。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。resolution はデフォルトで 1080p となり、1080p のみをサポートします。 @@ -215,52 +216,52 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画を生成するための画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセスできることを確認してください。 -Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります + 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) +画像 URL: 画像 URL にアクセス可能であることを確認してください。 +Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ アセット ID: 形式 asset://\ コンテンツ項目の役割/位置。 -画像の場合: first_frame、last_frame、または reference_image。 +画像の場合: first_frame、last_frame、reference_image。 ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 指定可能な値: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオの説明。 +テキストプロンプト(必須): 中国語および英語の文字を使用して、生成するビデオを記述します。 パラメータ(任意): テキストプロンプトの後に --[parameters] を追加してビデオの仕様を制御します: -- --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) -- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) -- --duration (--dur): 3~12 秒(デフォルト: 5) +- --resolution (--rs): 480p, 720p, 1080p(デフォルト: 720p) +- --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive(デフォルト: 16:9 または adaptive) +- --duration (--dur): 3-12 秒(デフォルト: 5) - --framepersecond (--fps): 24(デフォルト: 24) - --watermark (--wm): true/false(デフォルト: false) -- --seed (--seed): -1~2^32-1(デフォルト: -1) +- --seed (--seed): -1 から 2^32-1(デフォルト: -1) - --camerafixed (--cf): true/false(デフォルト: false) 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。 -これは文字数をカウントし、バイト数ではないため、マルチバイトのプロンプトは +バイト数ではなく文字数をカウントするため、マルチバイトのプロンプトは 転送時にこのサイズの数倍になる可能性があります。これはこの 1 つのフィールドを制限するものであり、 -リクエストではありません: `content` は配列であり、ドキュメント全体を制限するのは -リクエストごとのボディ制限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})であり、 -v1 /proxy への直接呼び出しでは代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックより -はるかに高く設定されているため、本物のプロンプトを判定することはありません。呼び出し元がより多くを -必要とする場合は引き上げてください。 +リクエスト全体ではありません。`content` は配列であり、リクエストごとのボディ制限が +ドキュメント全体を制限します。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})です。 +v1 /proxy を直接呼び出す場合は、代わりに BytePlus 自身のバリデータが応答します。 +実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトがこれによって +判定されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 - 入力コンテンツのタイプ + 入力コンテンツの種類 - 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 指定可能な値: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -281,111 +282,124 @@ v1 /proxy への直接呼び出しでは代わりに BytePlus 自身のバリデ ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 - 範囲: `2` ~ `30` + 範囲: `2` から `30` タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` ~ `259200` + 範囲: `3600` から `259200` Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオが含まれるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +false: モデルは無音のビデオを出力します。これをサポートするモデルでは、生成されたオーディオトラックはプロバイダーによってビデオとは別にコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対して断続的に発生することがあります。そのような場合にサイレントビデオにするには `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キューのリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 - 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接 v1 呼び出しでは必ずこれを指定する必要があります。プロキシは他の値や省略された値を 400 で拒否します。これがこのスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを補完するためであり、Router の呼び出し元は省略します。 + 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ずこれを指定する必要があります。プロキシはそれ以外の値や省略された値を 400 で拒否します。このスキーマの `required` リストには含まれません。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを埋めるため、Router の呼び出し元はこれを省略します。 - Seedance 2.5 のみ。出力ビデオのコンテナ形式。mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さなファイルサイズを実現します。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、高い色精度を持ち、ポストプロダクションに適しています。ファイルサイズは大きくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズが小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 - 指定可能な値: `mp4`, `mov` + 指定可能な値: `mp4`、`mov` 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 +Seedance 2.5 の最初のフレーム / 最初と最後のフレームからの生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け付けられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け付けます。 - 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートしています。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 - 指定可能な値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`、`720p`、`1080p`、`4k` - 生成されるビデオの最終フレーム画像を返すかどうか。 -true: 生成されるビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会する API を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、そのピクセル幅と高さは生成されるビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオをすばやく生成できます。 -false: 生成されるビデオの最終フレーム画像を返しません。 + 生成されたビデオの最後のフレーム画像を返すかどうか。 +true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会する呼び出しによって最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用し、複数の連続したビデオを迅速に生成できます。 +false: 生成されたビデオの最後のフレーム画像を返しません。 - ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 - 範囲: `-1` ~ `4294967295` + 範囲: `-1` から `4294967295` - 処理に使用するサービスのティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしていません。 + 処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`, `flex` + 指定可能な値: `default`、`flex` - 生成されるビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。 ### 出力 - ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy ストレージに再ホストされます。ここにある他のフィールドはすべて BytePlus 自身のものです。Null 許容: BytePlus はタスクの24時間後に URL をクリアするため、その後でポーリングした成功ドキュメントでは `content` が存在しないか null になることがあります。 + ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージへ再ホスト(RE-HOST)されます。ここにある他のフィールドはすべて BytePlus 自身のものです。Nullable: BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないか null になっていることがあります。 - 生成されたビデオの最終フレームのダウンロード URL で、リクエストで `return_last_frame` を設定したときに返されます。この URL から画像形式を推測しないでください。BytePlus はリクエスト側で最終フレームを PNG として規定していますが、Router は渡されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` はその両方が失敗したときの最後の手段のフォールバックにすぎません。Router は最終フレームを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドには BytePlus 自身の URL がそのまま入り、BytePlus はタスクの24時間後にそれをクリアします。いずれにしてもリンクは失効するため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成済みビデオの最終フレームのダウンロード URL で、リクエストが `return_last_frame` を設定したときに返されます。この URL から画像形式を推測しないでください。BytePlus はリクエスト側で最終フレームを PNG として規定していますが、Router は渡されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` は両方が失敗したときの最後のフォールバックにすぎません。Router は最終フレームを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再表示されるため、後のポーリングでは残り 1 時間程度の URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。 - 生成されたビデオのコンテナ形式 (mp4 または mov) で、BytePlus が `content` の中に入れ子にして返す場合のものです。Seedance モデルでは `content` のトップレベルの兄弟として返すことのほうが多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + 生成済みビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の中にネストして返す場合のものです。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことのほうが多く(トップレベルの `output_format` フィールドを参照)、Router は存在するほうを読み取ります。 + + + + 上流 URL が機能しなくなる RFC 3339 時刻。URL 自体が持つ最も早い署名時刻と有効期間を足したもので、`updated_at` が存在する場合はタスクの `updated_at` に 24 時間(BytePlus が文書化している URL の寿命)を足した時刻より遅くなることはなく、存在しない場合はタスクの `updated_at` に 24 時間を足した時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + Format: `date-time` + + + + 最終フレームの BytePlus 自身のダウンロード URL で、再ホストされた `last_frame_url` の隣にバイト単位でそのまま返されます。条件は `upstream_video_url` と同じです。オプトインしたワークスペースのみ、Seedance 2.x のみ、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラー資格情報です。 + + + + 出力ビデオの BytePlus 自身のダウンロード URL で、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングする Seedance 2.x のタスクでのみ存在します(リクエストパラメータはありません)。それ以外では存在しません。ワークスペースに解決されない資格情報(特定のワークスペースにスコープされていないレガシー APIキーなど)も含まれ、生成から 24 時間後に BytePlus が URL をクリアすると存在しなくなります。これは署名付きオブジェクトストレージの URL であり、したがってベアラー資格情報です。保持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットとして扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 では BytePlus がダウンロード回数を 100 回に制限しており、そのうち 1 回は Router 自身の再ホストが消費します。 - 出力ビデオのダウンロード URL。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドには BytePlus 自身の URL がそのまま入り、BytePlus はタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数が100回に制限されます。いずれにしてもリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロード URL です。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再表示されるため、後のポーリングでは残り 1 時間程度の URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルでは 100 回のダウンロードに制限します。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻。値は UNIX タイムスタンプ (秒) です。 + タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 - 生成されたビデオの再生時間 (秒)。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクでは秒単位の整数が返されることが確認されており、同系列の BytePlus の他のサーフェスでは小数の再生時間が報告されるため、クライアントは整数値だと仮定してはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの再生時間(秒)。BytePlus が一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す一方、同系列の BytePlus のサーフェスは小数の再生時間を報告することが観測されており、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のように、ドット区切りの理由が付くことがあります。これは enum ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のように、ドット区切りの理由が付くことがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープおよび HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 エラーメッセージ - - ビデオ生成タスクの ID +ビデオ生成タスクのID @@ -393,15 +407,15 @@ false: 生成されるビデオの最終フレーム画像を返しません。 - 生成されたビデオのコンテナ形式 (mp4 または mov) で、`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 自身のフィールドで、そのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedanceのビデオタスククエリはここに返します。BytePlus独自のフィールドで、変更されずにそのまま転送されます。 - 生成されたビデオの解像度 (例: `1080p`)。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -409,11 +423,11 @@ false: 生成されるビデオの最終フレーム画像を返しません。 タスクの状態 - 取り得る値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 指定可能な値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - タスクが最後に更新された時刻。値は UNIX タイムスタンプ (秒) です。 + タスクが最後に更新された時間。値は秒単位のUNIXタイムスタンプです。 @@ -421,11 +435,11 @@ false: 生成されるビデオの最終フレーム画像を返しません。 - モデルが生成したトークン数 + モデルによって生成されたトークン数 - ビデオ生成モデルでは入力トークン数は計算されず、デフォルトで 0 になります。したがって、total_tokens = completion_tokens です。 + ビデオ生成モデルでは、入力トークン数は計算されず、0がデフォルトです。したがって、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index caafd86dbf..a3b6e2d2e4 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Dreamina Seedance 2.0 Mini を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-mini を呼び出す方法: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 69d38df7 +translationSourceHash: 28c5c053 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 2279819f + "Schema": 3c26a330 "Examples": db01067e --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/byteplus/dreamina-seedance-2-0-mini.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -181,7 +182,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 入力 - この生成タスクの結果を受け取るコールバック通知先アドレス + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果を取得するには、代わりにタスクステータス取得ルートをポーリングしてください。 形式: `uri` @@ -191,23 +192,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request - 入力オーディオオブジェクト。オーディオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応します。 + 入力オーディオオブジェクト。オーディオ入力をサポートするのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単独では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力もサポートします。 - オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオ(wav、mp3)の公開 URL。 + オーディオURL、Base64 エンコード、またはアセット ID。 +オーディオURL: オーディオの公開URL(wav、mp3)。 Base64: 形式 data:audio/\;base64,\ アセット ID: 形式 asset://\ - Seedance 2.5 のみ。最終ビデオとしてレンダリングするドラフトタスク。唯一のコンテンツ項目である必要があります。 -最終ビデオはドラフトタスクの prompt、入力アセット、duration、ratio、seed、generate_audio、omni_reference_task_type を再利用するため、これらを再送信しないでください。resolution のデフォルトは 1080p で、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。解像度のデフォルトは 1080p で、1080p のみサポートします。 - `draft` を true に設定してドラフトビデオを作成したときに返されるタスク ID。 + Draft ビデオを `draft` を true に設定して作成したときに返されたタスク ID。 @@ -215,8 +216,8 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセスできることを確認してください。 + 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) +画像URL: 画像URLにアクセス可能であることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります アセット ID: 形式 asset://\ @@ -227,157 +228,173 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 取り得る値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して記述する、生成するビデオの説明。 +テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 -パラメータ(任意): テキストプロンプトの後に --[parameters] を追加してビデオの仕様を制御します。 -- --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) -- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) -- --duration (--dur): 3〜12 秒(デフォルト: 5) -- --framepersecond (--fps): 24(デフォルト: 24) -- --watermark (--wm): true/false(デフォルト: false) -- --seed (--seed): -1 〜 2^32-1(デフォルト: -1) -- --camerafixed (--cf): true/false(デフォルト: false) +パラメータ(任意): テキストプロンプトの後に --[parameters] を追加して、ビデオの仕様を制御します: +- --resolution(--rs): 480p、720p、1080p(デフォルト: 720p) +- --ratio(--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) +- --duration(--dur): 3〜12 秒(デフォルト: 5) +- --framepersecond(--fps): 24(デフォルト: 24) +- --watermark(--wm): true/false(デフォルト: false) +- --seed(--seed): -1 〜 2^32-1(デフォルト: -1) +- --camerafixed(--cf): true/false(デフォルト: false) 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の制限を公表しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 -これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトは -ワイヤー上ではこのサイズの数倍になる可能性があります。これはこの 1 つのフィールドを制限するものであり、 -リクエスト全体を制限するものではありません。`content` は配列であり、ドキュメント全体を -制限するのはリクエスト本体ごとの上限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})であり、 -直接の v1 /proxy 呼び出しでは代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックより -はるかに高く設定されているため、正当なプロンプトがこれによって判定されることはありません。 -呼び出し元がより多くを必要とする場合は引き上げてください。 +テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を +受け付けました。バイト数ではなく文字数をカウントするため、マルチバイトの +プロンプトは通信時にこのサイズの数倍になることがあります。これはこの 1 つの +フィールドを制限するものであり、リクエスト全体を制限するものではありません: +`content` は配列であり、ドキュメント全体を制限するのはリクエストごとの +ボディ上限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model}) +であり、v1 /proxy への直接呼び出しでは BytePlus 自身のバリデータが代わりに +応答します。実際のトラフィックよりはるかに高く設定されているため、正規の +プロンプトがこれによって判断されることはありません。呼び出し元がより多くを +必要とする場合は引き上げてください。 - 入力コンテンツの種類 + 入力コンテンツのタイプ - 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 取り得る値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 入力ビデオオブジェクト。ビデオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。 + 入力ビデオオブジェクト。ビデオ入力をサポートするのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 - ビデオ URL またはアセット ID。 -ビデオ URL: ビデオ(mp4、mov)の公開 URL。 + ビデオURLまたはアセット ID。 +ビデオURL: ビデオの公開URL(mp4、mov)。 アセット ID: 形式 asset://\ - Seedance 2.5 のみ。480p のドラフトビデオを生成します。resolution は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオをレンダリングします。ドラフトタスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 プロ: [4,12] または -1。Seedance 1.0: [2,12]。 範囲: `2` 〜 `30` - タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 範囲: `3600` 〜 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 プロでサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外の点では受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 - 呼び出すモデルの ID。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ずこれを指定する必要があります。プロキシは他の値や省略された値を 400 で拒否します。これがこのスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するためであり、Router の呼び出し元は省略します。 + 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628。`POST /proxy/byteplus/api/v3/contents/generations/tasks` への直接の v1 呼び出しでは、これを必ず指定する必要があります。プロキシはそれ以外の値や省略された値を 400 で拒否します。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントから設定するため、このスキーマの `required` リストには含まれていません。そのため Router の呼び出し元は省略します。 - Seedance 2.5 のみ。出力ビデオのコンテナ形式。mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズも小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適していますが、ファイルサイズは大きくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性があり、ファイルサイズも小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適していますが、ファイルサイズは大きくなります。 指定可能な値: `mp4`, `mov` - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはこのフィールドの省略)が受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 指定可能な値: `480p`, `720p`, `1080p`, `4k` 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定した後、ビデオ生成タスクに関する情報の照会を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。つまり、先に生成されたビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオをすばやく生成できます。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報を照会する API を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークも含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオを素早く生成できます。 false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 を指定するとランダムなシードを使用します。 範囲: `-1` から `4294967295` - 処理用のサービステア。Seedance 2.5、2.0 と 2.0 fast は flex(オフライン推論)をサポートしません。 + 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 指定可能な値: `default`, `flex` - 生成されたビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。 +`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で Router が提供するスキーマから生成されたもので、リクエストがプロバイダーに届く前に Router が呼び出しを検証する際に使用するのと同じドキュメントです。 ### 出力 - ビデオ生成タスクが完了した後の出力。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされます。ここにある他のすべてのフィールドは BytePlus 独自のものです。Null 許容: BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした成功済みのドキュメントでは `content` が存在しないか null になっている可能性があります。 + ビデオ生成タスク完了後の出力。出力ビデオのダウンロードURLと、BytePlusが返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyストレージに再ホストされます。ここにある他のフィールドはすべてBytePlus独自のものです。Null許容: BytePlusはタスクの24時間後にURLをクリアするため、その後でポーリングされた成功済みドキュメントは `content` が存在しないかnullである可能性があります。 - 生成済みビデオの最終フレームのダウンロード URL。リクエストで `return_last_frame` を設定した場合に返されます。この URL から画像形式を推測しないでください。BytePlus はリクエスト側で最終フレームを PNG と記載していますが、Router は渡されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` はその両方が失敗したときの最後のフォールバックにすぎません。Router は最終フレームを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間の署名が付き、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 独自の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成済みビデオの最終フレームのダウンロードURL。リクエストで `return_last_frame` を設定したときに返されます。このURLから画像形式を推測しないでください。BytePlusはリクエスト側で最終フレームをPNGとしてドキュメント化しており、Routerは提供されたバイト列をそのまま再ホストし、アップストリームのContent-Typeまたはコンテンツスニッフから型を判定します。`image/jpeg` は、両方が失敗した場合の最後の手段のフォールバックにすぎません。Routerは最終フレームをComfyストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り最短1時間のものが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりにBytePlus独自のURLを保持します。BytePlusはタスクの24時間後にそれをクリアします。いずれにしてもリンクは期限切れになるため、URLを保存するのではなくフレームをダウンロードしてください。 - 生成済みビデオのコンテナ形式(mp4 または mov)。BytePlus がこれを `content` の中に入れ子にして返す場合に含まれます。Seedance モデルはこれを `content` のトップレベルの兄弟フィールドとして返すことのほうが多く(トップレベルの `output_format` フィールドを参照)、Router は存在するほうを読み取ります。 + 生成済みビデオのコンテナ形式(mp4 または mov)。BytePlusが `content` 内にネストする場合に含まれます。Seedanceモデルはより一般的には `content` のトップレベルの兄弟としてこれを返します(トップレベルの `output_format` フィールドを参照)。Routerはいずれか存在する方を読み取ります。 + + + + アップストリームURLが機能しなくなるRFC 3339時刻。URL自体が持つ有効性に最も早い署名時刻を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusがドキュメント化しているURLの寿命)を加えた時刻より遅くなることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ含まれ、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の有効期間とは無関係です。 + + 形式: `date-time` + + + + 最終フレームのBytePlus独自のダウンロードURL。再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインされたワークスペースのみ、Seedance 2.x のみ、BytePlusがクリアすると存在しなくなり、`upstream_expires_at` まではベアラー資格情報です。 + + + + 出力ビデオのBytePlus独自のダウンロードURL。再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfyがサーバー側でオプトインしたワークスペースによってポーリングされるSeedance 2.xタスクにのみ含まれます(リクエストパラメーターはありません)。それ以外のすべての場合には含まれません。ワークスペースに解決されない資格情報(特定のワークスペースにスコープされていないレガシーAPIキーなど)も同様です。また、生成から24時間後にBytePlusがURLをクリアすると存在しなくなります。これは署名済みオブジェクトストレージURLであり、したがってベアラー資格情報です。保持している人は誰でも有効期限までビデオをダウンロードできるため、秘密情報として扱ってください。`upstream_expires_at` に期限切れになり、Seedance 2.5 ではBytePlusが100ダウンロードに制限しており、そのうちの1回はRouter自身の再ホストが消費します。 - 出力ビデオのダウンロード URL。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間の署名が付き、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 独自の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数が 100 回に制限されます。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURL。RouterはビデオをComfyストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り最短1時間のものが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりにBytePlus独自のURLを保持します。BytePlusはタスクの24時間後にそれをクリアし、一部のモデルでは100ダウンロードに制限します。いずれにしてもリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻。値は UNIX タイムスタンプ(秒)です。 + タスクが作成された時刻。値は秒単位のUNIXタイムスタンプです。 - 生成済みビデオの再生時間(秒)。BytePlus がこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数の秒を返すこともあれば、BytePlus の関連サーフェスが小数の再生時間を報告することも確認されているため、クライアントは整数値を前提にしてはいけません。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの再生時間(秒)。BytePlusがこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返すことや、兄弟のBytePlusサーフェスが小数の再生時間を報告することが観察されているため、クライアントは整数値を仮定してはいけません。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報。タスクが成功した場合はnullが返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは enum ではなくオープンな文字列です。他のコードは検証エラーやプロバイダー側の障害を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答の両方でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + アップストリームのModelArkエラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetectedはコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFakeのようなドット区切りの理由が付く場合があります。これは列挙型ではなくオープンな文字列です。他のコードは検証とプロバイダーの失敗を説明します。RouterはHTTP 400エラーエンベロープおよびHTTP 200の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きしません。 @@ -385,23 +402,21 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で - ビデオ生成タスクの ID - - + タスクで使用されたモデルの名前とバージョン - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリが返すのはこちらです。BytePlus 独自のフィールドで、そのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。 - 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -409,11 +424,11 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で タスクの状態 - 取り得る値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 指定可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - タスクが最後に更新された時刻。値は UNIX タイムスタンプ(秒)です。 + タスクが最後に更新された日時。値は秒単位の UNIX タイムスタンプです。 @@ -421,11 +436,11 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で - モデルが生成したトークン数 + モデルによって生成されたトークン数 - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトは 0 です。したがって、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは入力トークン数は計算されず、0 が既定値です。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 28a20f0458..32aea062d4 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,18 +2,19 @@ title: "Dreamina Seedance 2.5 260628 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-5-260628 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンス。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 9a342bd4 +translationSourceHash: 07fd9c64 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0467a987 + "Schema": 0a76af44 "Examples": 5465695b --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -194,7 +195,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 入力 - この生成タスクの結果を受け取るコールバック通知先アドレス + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックは一切送信されません。結果を取得するには、代わりにタスクステータスルートをポーリングしてください。 形式: `uri` @@ -204,23 +205,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque - 入力オーディオオブジェクト。オーディオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単独では使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力もサポートします。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみで使用することはできません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 - オーディオ URL、Base64 エンコード、またはアセット ID。 + オーディオ URL、Base64 エンコーディング、またはアセット ID。 オーディオ URL: オーディオの公開 URL(wav、mp3)。 Base64: 形式 data:audio/\;base64,\ アセット ID: 形式 asset://\ - Seedance 2.5 専用。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。resolution のデフォルトは 1080p で、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。再度送信しないでください。解像度はデフォルトで 1080p になり、1080p のみをサポートします。 - `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 + Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。 @@ -230,7 +231,7 @@ Base64: 形式 data:audio/\;base64,\ 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) 画像 URL: 画像 URL にアクセスできることを確認してください。 -Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります +Base64 エンコーディングされたコンテンツ: 形式は data:image/\;base64,\ である必要があります アセット ID: 形式 asset://\ @@ -240,44 +241,44 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 指定可能な値: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` + 設定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオを説明します。 +テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 -パラメータ(任意): テキストプロンプトの後に --[parameters] を追加すると、ビデオの仕様を制御できます: -- --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) -- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) -- --duration (--dur): 3~12 秒(デフォルト: 5) -- --framepersecond (--fps): 24(デフォルト: 24) -- --watermark (--wm): true/false(デフォルト: false) -- --seed (--seed): -1 ~ 2^32-1(デフォルト: -1) -- --camerafixed (--cf): true/false(デフォルト: false) +パラメータ(任意): テキストプロンプトの後に --[parameters] を追加して、ビデオの仕様を制御します: +- --resolution(--rs): 480p、720p、1080p(デフォルト: 720p) +- --ratio(--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) +- --duration(--dur): 3〜12 秒(デフォルト: 5) +- --framepersecond(--fps): 24(デフォルト: 24) +- --watermark(--wm): true/false(デフォルト: false) +- --seed(--seed): -1 から 2^32-1(デフォルト: -1) +- --camerafixed(--cf): true/false(デフォルト: false) 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の制限を公開しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 -これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトは -転送時にこの数倍のサイズになる可能性があります。これはこの 1 つのフィールドを制限するもので、 -リクエスト全体を制限するものではありません: `content` は配列であり、 -ドキュメント全体を制限するのはリクエストごとのボディ制限です。これを強制するのは -Comfy Router(/v2/models/byteplus/\{model})であり、v1 の /proxy を直接呼び出す場合は -代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、 -本物のプロンプトが判定されることはありません。呼び出し元がさらに必要とする場合は引き上げてください。 +テキスト長の上限を公表しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 +これは文字数をカウントし、バイト数ではないため、マルチバイトのプロンプトは +ワイヤー上でこのサイズの数倍になる場合があります。これはこの 1 つのフィールドを制限するものであり、 +リクエスト全体を制限するものではありません。`content` は配列であり、リクエストごとの +ボディ制限がドキュメント全体を制限します。これを適用するのは Comfy Router +(/v2/models/byteplus/\{model})です。v1 /proxy を直接呼び出す場合は、代わりに BytePlus 自身の +バリデータが応答します。実際のトラフィックをはるかに上回る値に設定されているため、 +本物のプロンプトが拒否されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 入力コンテンツのタイプ - 指定可能な値: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` + 設定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 入力ビデオオブジェクト。ビデオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。 + 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 @@ -287,102 +288,116 @@ Comfy Router(/v2/models/byteplus/\{model})であり、v1 の /proxy を直 - Seedance 2.5 専用。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目で渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 - 範囲: `2` ~ `30` + 範囲: `2` から `30` タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` ~ `259200` + 範囲: `3600` から `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされます。生成されたビデオに映像と同期したオーディオが含まれるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは、拒否されたモダリティがオーディオだった場合のみで、同期 Router のレスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` を指定して Draft を作り直してください。 - 呼び出すモデルの ID。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への v1 の直接呼び出しでは必ずこれを指定する必要があります。プロキシは他の値、および省略された値を 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するためで、Router の呼び出し元は省略します。 + 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ず指定する必要があります。プロキシは他の値や省略された値を 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントから設定するためで、Router の呼び出し元は省略します。 - Seedance 2.5 専用。出力ビデオのコンテナ形式。mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズはより小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適しています。ファイルサイズはより大きくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さなファイルサイズ。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、高い色精度を持ち、ポストプロダクションに適しています。ファイルサイズは大きくなります。 - 指定可能な値: `mp4`、`mov` + 指定可能な値: `mp4`, `mov` - 生成されたビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・末尾フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率を指定した場合は、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け付けます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみ受け付けられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 - 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。 -注意: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートします。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートしています。 - 指定可能な値: `480p`、`720p`、`1080p`、`4k` + 指定可能な値: `480p`, `720p`, `1080p`, `4k` 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報の照会を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。前回生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオをすばやく生成できます。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報をクエリする呼び出しで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオを素早く生成できます。 false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 の場合はランダムなシードが使用されます。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 - 範囲: `-1` ~ `4294967295` + 範囲: `-1` から `4294967295` - 処理用のサービステア。Seedance 2.5、2.0 と 2.0 fast は flex(オフライン推論)をサポートしていません。 + 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしていません。 - 指定可能な値: `default`、`flex` + 指定可能な値: `default`, `flex` - 生成されたビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオに透かしを含めるかどうか。 -Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する対象となる同一のドキュメントです。 +Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 ### 出力 - ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy ストレージに再ホストされ、ここにあるその他のフィールドはすべて BytePlus 独自のものです。Null 許容: BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした succeeded ドキュメントは `content` が存在しないか null である可能性があります。 + ビデオ生成タスク完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合にはその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにある他のフィールドはすべて BytePlus 自身のものです。null 許容: BytePlus はタスクの24時間後に URL をクリアするため、その後ポーリングされた succeeded ドキュメントでは `content` が存在しないか null になることがあります。 - 生成ビデオの最終フレームのダウンロード URL で、リクエストで `return_last_frame` を設定した場合に返されます。この URL から画像形式を推測しないでください。BytePlus はリクエスト側では最終フレームを PNG と記載していますが、Router は配信されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングに基づいて型を判定します。`image/jpeg` はその両方が失敗したときの最後のフォールバックにすぎません。Router は最終フレームを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 独自の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれにせよリンクは失効するため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード URL で、リクエストで `return_last_frame` を設定した場合に返されます。この URL から画像フォーマットを推測しないでください。BytePlus はリクエスト側で最終フレームを PNG としてドキュメント化していますが、Router は提供されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` はその両方が失敗した場合の最後のフォールバックにすぎません。Router は最終フレームを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再送されるため、後でポーリングすると残り1時間程度のものが返されることがあります。再ホストを実行できなかった場合は、代わりに BytePlus 自身の URL がそのまま残り、BytePlus はタスクの24時間後にそれをクリアします。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。 - 生成ビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の中にネストして返す場合のものです。Seedance モデルでは `content` のトップレベルの兄弟として返すことがより一般的です。トップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + BytePlus が `content` の中に入れ子にしている場合の、生成されたビデオのコンテナ形式(mp4 または mov)です。Seedance モデルは通常これを `content` のトップレベルの兄弟として返します。トップレベルの `output_format` フィールドを参照してください。Router は存在する方の値を読み取ります。 + + + + 上流 URL が動作しなくなる RFC 3339 時刻です。URL 自体が持つ最も早い署名時刻に有効期間を加えた時刻で、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlus がドキュメント化している URL の寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + 形式: `date-time` + + + + BytePlus 自身の最終フレーム用ダウンロード URL で、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラ認証情報です。 + + + + BytePlus 自身の出力ビデオ用ダウンロード URL で、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングした Seedance 2.x タスクにのみ存在し(リクエストパラメーターはありません)、それ以外の場合は存在しません。特定のワークスペースにスコープされていないレガシー APIキーなど、ワークスペースに解決されない認証情報も含まれます。また、BytePlus が生成の24時間後に URL をクリアすると存在しなくなります。これは署名付きオブジェクトストレージ URL であるためベアラ認証情報です。保有する誰もが有効期限までビデオをダウンロードできるので、秘密情報として扱ってください。`upstream_expires_at` で期限切れとなり、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストで消費されます。 - 出力ビデオのダウンロード URL です。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 独自の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数を 100 回に制限します。いずれにせよリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロード URL です。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再送されるため、後でポーリングすると残り1時間程度のものが返されることがあります。再ホストを実行できなかった場合は、代わりに BytePlus 自身の URL がそのまま残り、BytePlus はタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時間です。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻です。値は UNIX タイムスタンプ(秒)です。 - 生成ビデオの再生時間(秒)です。BytePlus がこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクでは整数秒が返されることが観測されており、同系列の BytePlus の他のサーフェスでは小数の再生時間が報告されているため、クライアントは整数値を前提にしてはなりません。BytePlus 独自のフィールドで、succeeded のビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)です。整数ではなく数値として宣言されているのは、BytePlus の扱いが一貫していないためです。ビデオタスクでは整数秒が返されることが観測されており、隣接する BytePlus のサーフェスでは小数の再生時間が報告されているため、クライアントは整数値を仮定してはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 @@ -390,7 +405,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のようにドット区切りの理由が付く場合があります。これは enum ではなくオープンな文字列です。その他のコードは検証およびプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは enum ではなくオープンな文字列です。その他のコードは検証およびプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 @@ -406,15 +421,15 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - 生成ビデオのコンテナ形式(mp4 または mov)で、`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドで、そのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリが返す場所はここです。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 - 生成ビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、succeeded のビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、succeeded のビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -426,7 +441,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - タスクが最後に更新された時間です。値は秒単位の UNIX タイムスタンプです。 + タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 @@ -438,7 +453,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - ビデオ生成モデルでは、入力トークン数は計算されず 0 がデフォルトです。したがって、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index fa9e5a7ffa..1a86cca8c8 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Seedance 1.0 Pro 250528 を使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-250528 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 084b73ac +translationSourceHash: 450bbe6e translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": af62a34c + "Schema": fc979e05 "Examples": 815d621e --- + {/* 生成済みファイル。`pnpm code-pages:gen` によって router-schemas/byteplus/seedance-1-0-pro-250528.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -181,7 +182,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 入力 - この生成タスクの結果を受け取るコールバック通知先アドレス + 無視されます。BytePlusのリクエスト形状との互換性のために受け付けられますが、タスクの送信前に削除されるため、コールバックが送信されることはありません。結果はタスクステータスのルートをポーリングして取得してください。 形式: `uri` @@ -191,23 +192,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ - 入力オーディオオブジェクト。オーディオ入力に対応するのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応します。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみを使用できません。少なくとも1つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 - オーディオの URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオの公開 URL(wav、mp3)。 -Base64: 形式は data:audio/\;base64,\ -アセット ID: 形式は asset://\ + オーディオURL、Base64エンコード、またはアセットID。 +オーディオURL: オーディオ(wav、mp3)の公開URL。 +Base64: 形式 data:audio/\;base64,\ +アセットID: 形式 asset://\ - Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクの prompt、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。resolution はデフォルトで 1080p になり、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングするドラフトタスク。唯一のコンテンツ項目である必要があります。 +最終ビデオはドラフトタスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。resolution はデフォルトで 1080p となり、1080p のみをサポートします。 - `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 + `draft` を true に設定してドラフトビデオを作成したときに返されるタスクID。 @@ -216,13 +217,13 @@ Base64: 形式は data:audio/\;base64,\ 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセスできることを確認してください。 -Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります -アセット ID: 形式は asset://\ +画像URL: 画像URLにアクセスできることを確認してください。 +Base64エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります +アセットID: 形式 asset://\ - コンテンツ項目の役割 / 位置。 + コンテンツ項目の役割/位置。 画像の場合: first_frame、last_frame、または reference_image。 ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 @@ -233,100 +234,98 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオを説明します。 +テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 パラメータ(任意): テキストプロンプトの後に --[parameters] を追加すると、ビデオの仕様を制御できます: -- --resolution(--rs): 480p、720p、1080p(デフォルト: 720p) -- --ratio(--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) -- --duration(--dur): 3~12 秒(デフォルト: 5) -- --framepersecond(--fps): 24(デフォルト: 24) -- --watermark(--wm): true/false(デフォルト: false) -- --seed(--seed): -1 ~ 2^32-1(デフォルト: -1) -- --camerafixed(--cf): true/false(デフォルト: false) +- --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) +- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) +- --duration (--dur): 3〜12秒(デフォルト: 5) +- --framepersecond (--fps): 24(デフォルト: 24) +- --watermark (--wm): true/false(デフォルト: false) +- --seed (--seed): -1 〜 2^32-1(デフォルト: -1) +- --camerafixed (--cf): true/false(デフォルト: false) 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の上限を公表しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 -これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトでは -転送時のサイズがこの数倍になることがあります。これはこの 1 つのフィールドを制限するもので、 -リクエスト全体を制限するものではありません: `content` は配列であり、ドキュメント全体を -制限するのはリクエストごとのボディ上限です。これを適用するのは Comfy Router -(/v2/models/byteplus/\{model})であり、v1 /proxy を直接呼び出した場合は BytePlus 自身の -バリデータが代わりに応答します。実際のトラフィックよりはるかに高く設定されているため、 -正当なプロンプトを判定の対象にすることはありません。呼び出し元がより多くを必要とする場合は -引き上げてください。 +Comfy側のガードレールであり、BytePlusの制約ではありません。BytePlus は +テキスト長の上限を公開しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 +これは文字数をカウントし、バイト数ではないため、マルチバイトのプロンプトは +ワイヤ上でこのサイズの数倍になる場合があります。これはこの1つのフィールドを制限するものであり、 +リクエスト全体ではありません: `content` は配列であり、リクエストごとのボディ制限が +ドキュメント全体を制限します。Comfy Router(/v2/models/byteplus/\{model})が +これを適用するサーフェスです。v1 /proxy を直接呼び出す場合は、BytePlus 自身のバリデータが +代わりに応答します。実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトを +判定することはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 - 入力コンテンツの種類 + 入力コンテンツのタイプ 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 入力ビデオオブジェクト。ビデオ入力に対応するのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 + 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 - ビデオ URL またはアセット ID。 -ビデオ URL: ビデオの公開 URL(mp4、mov)。 -アセット ID: 形式は asset://\ + ビデオURLまたはアセットID。 +ビデオURL: ビデオ(mp4、mov)の公開URL。 +アセットID: 形式 asset://\ - Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 -最終的な 1080p ビデオをレンダリングするには、返されたタスク ID を `draft_task` コンテンツ項目で渡します。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p のドラフトビデオを生成します。resolution は 480p である必要があります。 +返されたタスクIDを `draft_task` コンテンツ項目に渡すと、最終的な 1080p ビデオがレンダリングされます。ドラフトタスクIDは7日間有効です。 - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 - 範囲: `2` ~ `30` + 範囲: `2` 〜 `30` - タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。デフォルト 172800(48時間)。範囲: [3600, 259200]。 - 範囲: `3600` ~ `259200` + 範囲: `3600` 〜 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされます。生成されるビデオに映像と同期したオーディオを含めるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +false: モデルは無音のビデオを出力します。サポートされているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外では受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするために `false` を送信してください。これが有効なのは、拒否されたモダリティがオーディオであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` を指定して Draft を再作成してください。 - 呼び出すモデルの ID。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への v1 直接呼び出しでは必ずこれを指定する必要があり、プロキシは他の値や省略された場合は 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを補うためであり、Router の呼び出し元は省略します。 + 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは、これを必ず指定する必要があります。プロキシは他の値や省略された値を 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するためであり、Router の呼び出し元は省略します。 Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性を持ち、ファイルサイズが小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。高い色精度を持ち、ポストプロダクションに適しています。ファイルサイズは大きくなります。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さいファイルサイズを備えます。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適しています。ファイルサイズは大きくなります。 - 指定可能な値: `mp4`, `mov` + 指定可能な値: `mp4`、`mov` - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみ受け付けます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け付けます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 - 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - ビデオ解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートしています。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 - 指定可能な値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`、`720p`、`1080p`、`4k` 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報のクエリを呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、そのピクセル幅と高さは生成されたビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオをすばやく生成できます。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会するを呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオの最終フレームが次のビデオタスクの先頭フレームとして使用され、複数の連続したビデオをすばやく生成できます。 false: 生成されたビデオの最終フレーム画像を返しません。 @@ -337,57 +336,70 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 処理のサービス階層。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしていません。 + 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`, `flex` + 指定可能な値: `default`、`flex` - 生成されたビデオに透かしを含めるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同一のドキュメントです。 +Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 ### 出力 - ビデオ生成タスク完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy ストレージへ再ホストされ、ここにあるその他のフィールドはすべて BytePlus 自身のものです。Nullable - BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングされた succeeded ドキュメントは `content` が欠落しているか null である可能性があります。 + ビデオ生成タスクの完了後の出力。出力ビデオのダウンロード URL と、BytePlus が返す場合にはその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy ストレージに再ホストされ、ここにある他のすべてのフィールドは BytePlus 自身のものです。Nullable:BytePlus はタスクの 24 時間後に URL をクリアするため、その後ポーリングした成功済みドキュメントでは `content` が存在しないか null になることがあります。 - 生成されたビデオの最終フレームのダウンロード URL です。リクエストで `return_last_frame` を設定した場合に返されます。この URL から画像フォーマットを推測しないでください。BytePlus はリクエスト側で最終フレームを PNG として文書化しており、Router は提供されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフから型を決定します。`image/jpeg` は両方とも失敗した場合の最後の手段のフォールバックにすぎません。Router は最終フレームを Comfy ストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかないものが返されることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれにせよリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。 + `return_last_frame` がリクエストで設定された場合に返される、生成されたビデオの最終フレームのダウンロード URL。この URL から画像形式を推測しないでください。BytePlus はリクエスト側で最終フレームを PNG と記載していますが、Router は提供されたバイト列をそのまま再ホストし、アップストリームの Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` は両方が失敗した場合の最後のフォールバックにすぎません。Router は最終フレームを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL です。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。 - 生成されたビデオのコンテナフォーマット (mp4 または mov) です。BytePlus が `content` 内にネストして返す場合に含まれます。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことの方が多く、トップレベルの `output_format` フィールドを参照してください。Router は存在する方のいずれかを読み取ります。 + BytePlus が `content` 内にネストして返す場合の、生成されたビデオのコンテナ形式(mp4 または mov)。Seedance モデルはこれを `content` と同じ階層のトップレベルフィールドとして返すことがより一般的です。トップレベルの `output_format` フィールドを参照してください。Router は存在する方のフィールドを読み取ります。 + + + + アップストリーム URL が機能しなくなる RFC 3339 時刻。URL 自体が持つ有効期間を最も早い署名時刻に加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に 24 時間(BytePlus が文書化している URL の寿命)を加えた時刻より遅くなることはありません。存在しない場合はタスクの `updated_at` に 24 時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + 形式: `date-time` + + + + BytePlus 自身の最終フレームのダウンロード URL。再ホストされた `last_frame_url` の隣にバイト単位でそのまま返され、`upstream_video_url` と同じ条件です。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラー資格情報です。 + + + + BytePlus 自身の出力ビデオのダウンロード URL。再ホストされた `video_url` の隣にバイト単位でそのまま返されます。サーバー側で Comfy がオプトインしたワークスペースがポーリングする Seedance 2.x タスクにのみ存在し(リクエストパラメータはありません)、それ以外のすべて(ワークスペースに解決されない資格情報、たとえばワークスペースにスコープされていないレガシー APIキーなど)では存在しません。また、BytePlus が生成の 24 時間後に URL をクリアすると存在しなくなります。これは事前署名されたオブジェクトストレージ URL であるため、ベアラー資格情報です。保持している人は有効期限までビデオをダウンロードできるので、秘密情報と同様に扱ってください。`upstream_expires_at` に期限切れとなり、Seedance 2.5 では BytePlus がダウンロード回数を 100 回に制限しており、そのうち 1 回は Router 自身の再ホストで消費されます。 - 出力ビデオのダウンロード URL です。Router はビデオを Comfy ストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかないものが返されることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルでは 100 ダウンロードに制限しています。いずれにせよリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロード URL。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL です。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数を 100 回に制限します。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時間です。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻。値は UNIX タイムスタンプ(秒)です。 - 生成されたビデオの再生時間 (秒) です。整数ではなく数値として宣言されているのは、BytePlus がこれについて一貫していないためです。ビデオタスクでは整数秒を返すことが観測されており、兄弟の BytePlus サーフェスでは小数の再生時間を報告しているため、クライアントは整数値を前提にしてはなりません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)。BytePlus が一貫していないため、整数ではなく数値として宣言されています。ビデオタスクでは整数秒が返される一方、BytePlus の関連サーフェスでは小数の再生時間が報告されることが確認されているため、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のようにドット区切りの理由が付くことがあります。これは列挙型ではなくオープンな文字列で、その他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 エラーエンベロープおよび HTTP 200 の失敗タスク応答でポリシーファミリーを認識し、トランスポートの失敗を上書きすることはありません。 + アップストリーム ModelArk のエラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のようにドット区切りの理由が付くことがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 エラーエンベロープおよび HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 エラーメッセージ - - ビデオ生成タスクの ID +The ID of the video generation task @@ -395,27 +407,27 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 - 生成されたビデオのコンテナフォーマット (mp4 または mov) で、`content` の兄弟としてトップレベルで返されます。ここが Seedance ビデオタスククエリがそれを返す場所です。BytePlus 自身のフィールドで、そのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 自身のフィールドで、変更されずにそのまま転送されます。 - 生成されたビデオの解像度です。例えば `1080p` です。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの解像度。例えば `1080p` です。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクに実際に使用された生成シードです。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - フォーマット: `int64` + 形式: `int64` タスクの状態 - 可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 取りうる値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - タスクが最後に更新された時間です。値は秒単位の UNIX タイムスタンプです。 + タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 @@ -427,7 +439,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。したがって、total_tokens = completion_tokens です。 + ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 414aab9405..1c1df19527 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,17 +2,18 @@ title: "Seedance 1.0 Pro Fast 251015 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-fast-251015 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて解説します。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 600f57b4 +translationSourceHash: 43683424 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 1df5b053 + "Schema": a882b2d8 "Examples": 1469ab97 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-fast-251015.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -181,7 +182,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### 入力 - この生成タスクの結果を受け取るコールバック通知先 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果は代わりにタスクステータスのルートをポーリングして取得してください。 形式: `uri` @@ -191,7 +192,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque - 入力オーディオオブジェクト。オーディオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応します。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみでは使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 @@ -202,12 +203,12 @@ Base64: 形式 data:audio/\;base64,\ - Seedance 2.5 のみ。最終ビデオとしてレンダリングするドラフトタスク。これは唯一のコンテンツ項目である必要があります。 -最終ビデオはドラフトタスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。解像度のデフォルトは 1080p で、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。解像度はデフォルトで 1080p となり、1080p のみをサポートします。 - `draft` を true に設定してドラフトビデオを作成したときに返されるタスク ID。 + `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 @@ -216,7 +217,7 @@ Base64: 形式 data:audio/\;base64,\ 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) -画像URL: 画像URLにアクセスできることを確認してください。 +画像 URL: 画像 URL にアクセスできることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります アセット ID: 形式 asset://\ @@ -233,7 +234,7 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオの説明。 +テキストプロンプト(必須): 中国語および英語の文字で記述する、生成するビデオの説明。 パラメータ(任意): テキストプロンプトの後に --[parameters] を追加してビデオの仕様を制御します: - --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) @@ -241,31 +242,32 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b - --duration (--dur): 3〜12 秒(デフォルト: 5) - --framepersecond (--fps): 24(デフォルト: 24) - --watermark (--wm): true/false(デフォルト: false) -- --seed (--seed): -1 ~ 2^32-1(デフォルト: -1) +- --seed (--seed): -1 から 2^32-1(デフォルト: -1) - --camerafixed (--cf): true/false(デフォルト: false) 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の制限を公表しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 -これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトでは -転送時のサイズがこの数倍になることがあります。これはこの 1 つのフィールドを制限するもので、 -リクエストを制限するものではありません。`content` は配列であり、ドキュメント全体を -制限するのはリクエストごとのボディ制限です。これを適用するのは Comfy Router -(/v2/models/byteplus/\{model})です。v1 /proxy を直接呼び出す場合は、代わりに -BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、 -正当なプロンプトを判定することはありません。呼び出し元がより多くを必要とする場合は -引き上げてください。 +テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を +受け付けました。バイト数ではなく文字数をカウントするため、マルチバイトの +プロンプトはワイヤ上でこのサイズの数倍になる可能性があります。これはこの +1 つのフィールドを制限するものであり、リクエスト全体ではありません。 +`content` は配列であり、リクエスト全体のドキュメントを制限するのは +リクエストごとのボディ制限です。これを適用するのは Comfy Router +(/v2/models/byteplus/\{model})であり、v1 /proxy を直接呼び出した場合は +BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く +設定されているため、本物のプロンプトが制限されることはありません。呼び出し元が +より多くを必要とする場合はこの値を引き上げてください。 - 入力コンテンツの種類 + 入力コンテンツのタイプ 取り得る値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 入力ビデオオブジェクト。ビデオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。 + 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 @@ -275,118 +277,131 @@ BytePlus 自身のバリデータが応答します。実際のトラフィッ - Seedance 2.5 のみ。480p のドラフトビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオをレンダリングします。ドラフトタスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目に渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 - 範囲: `2` ~ `30` + 範囲: `2` から `30` タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` ~ `259200` + 範囲: `3600` から `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされます。生成されるビデオに映像と同期したオーディオが含まれるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +false: モデルは無音のビデオを出力します。これをサポートするモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対して断続的に発生することがあります。その場合はサイレントビデオにするために `false` を送信してください。これが有効なのは、拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 - 呼び出すモデルの ID。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ずこれを指定する必要があります。プロキシは他の値を拒否し、省略された場合も 400 を返します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するためであり、Router の呼び出し元は省略します。 + 呼び出すモデルの ID です。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは、これを必ず指定する必要があります。プロキシは他の値や省略された値を 400 で拒否します。これはこのスキーマの `required` リストには含まれません。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを埋めるため、Router の呼び出し元は省略します。 - Seedance 2.5 のみ。出力ビデオのコンテナ形式。mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性を持ち、ファイルサイズを小さくできます。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。高い色精度を持ち、ポストプロダクションに適しています。ファイルサイズは大きくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式です。 +mp4: 一般用途向けコンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さいファイルサイズを備えます。 +mov: プロ向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 指定可能な値: `mp4`, `mov` - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 では、これらのモードでも具体的な比率を指定できます。 + 生成されたビデオの比率。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の最初のフレーム / 最初と最後のフレーム生成: 出力は最初のフレームの比率に従うため、`adaptive` のみ(またはフィールドの省略)が受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro および pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートしています。 + ビデオ解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro、pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 指定可能な値: `480p`, `720p`, `1080p`, `4k` - 生成されるビデオの最後のフレーム画像を返すかどうか。 -true: 生成されるビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会する API を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、そのピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオを素早く生成できます。 -false: 生成されるビデオの最後のフレーム画像を返しません。 + 生成されたビデオの最後のフレーム画像を返すかどうか。 +true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定した後、ビデオ生成タスクの情報を照会する操作を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームが次のビデオタスクの最初のフレームとして使用されるため、複数の連続したビデオをすばやく生成できます。 +false: 生成されたビデオの最後のフレーム画像を返しません。 - ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 範囲: `-1` から `4294967295` - 処理のサービスティア。Seedance 2.5、2.0 および 2.0 fast は flex(オフライン推論)をサポートしていません。 + 処理用のサービス階層。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 指定可能な値: `default`, `flex` - 生成されるビデオにウォーターマークを含めるかどうか。 + 生成されたビデオにウォーターマークが含まれるかどうか。 -Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` で提供しているスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +`GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 - ビデオ生成タスク完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最後のフレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされます。ここにあるその他のフィールドはすべて BytePlus 自身のものです。Nullable: BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした succeeded ドキュメントでは `content` が存在しないか null である可能性があります。 + ビデオ生成タスクが完了した後の出力で、出力ビデオのダウンロードURLと、BytePlusが返す場合にはその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージへ再ホストされ、ここにある他のフィールドはすべてBytePlus独自のものです。Null許容:BytePlusはタスクの24時間後にURLを消去するため、その後でポーリングした成功ドキュメントでは `content` が存在しないかnullになっていることがあります。 - 生成済みビデオの最後のフレームのダウンロード URL。リクエストで `return_last_frame` を設定した場合に返されます。この URL から画像フォーマットを推測しないでください。BytePlus はリクエスト側では最後のフレームを PNG としてドキュメント化しており、Router は渡されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` はその両方が失敗した場合の最後の手段のフォールバックにすぎません。Router は最後のフレームを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロードURL。リクエストで `return_last_frame` を設定したときに返されます。このURLから画像形式を推測しないでください。BytePlusはリクエスト側で最終フレームをPNGとして文書化しており、Routerは提供されたバイト列をそのまま再ホストし、上流のContent-Typeまたはコンテンツスニッフィングから型を判定します。`image/jpeg` は両方が失敗したときの最後の手段のフォールバックにすぎません。Routerは最終フレームをComfyのストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再送されるため、後のポーリングでは残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりにBytePlus独自のURLを保持し、BytePlusはタスクの24時間後にそれを消去します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくフレームをダウンロードしてください。 - 生成済みビデオのコンテナフォーマット(mp4 または mov)。BytePlus が `content` の中にネストして返す場合のものです。Seedance モデルはより一般的には `content` のトップレベルの兄弟として返します。トップレベルの `output_format` フィールドを参照してください。Router は存在する方のフィールドを読み取ります。 + 生成されたビデオのコンテナ形式(mp4 または mov)。BytePlusが `content` の中にネストして返す場合のものです。Seedanceモデルでは、`content` のトップレベルの兄弟として返すことの方が一般的です(トップレベルの `output_format` フィールドを参照)。Routerはいずれか存在する方を読み取ります。 + + + + 上流URLが機能しなくなるRFC 3339時刻。URL自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間を加えた時刻(BytePlusが文書化しているURLの寿命)より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + 形式: `date-time` + + + + 最終フレームに対するBytePlus独自のダウンロードURL。再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.x のみ、BytePlusが消去すると存在しなくなり、`upstream_expires_at` まではベアラー認証情報です。 + + + + 出力ビデオに対するBytePlus独自のダウンロードURL。再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfyがサーバー側でオプトインしたワークスペースがポーリングするSeedance 2.xタスクにのみ存在します(リクエストパラメータはありません)。それ以外の場合は存在せず、ワークスペースに解決されない認証情報(特定のワークスペースにスコープされていないレガシーAPIキーなど)も含まれます。また、BytePlusが生成の24時間後にURLを消去すると存在しなくなります。これは署名付きオブジェクトストレージのURLであり、したがってベアラー認証情報でもあるため、保持している人は誰でも有効期限までビデオをダウンロードできます。秘密情報として扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 ではBytePlusがダウンロード回数を100回に制限しており、そのうち1回はRouter自身の再ホストで消費されます。 - 出力ビデオのダウンロード URL。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルでは 100 ダウンロードに制限します。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURL。RouterはビデオをComfyのストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再送されるため、後のポーリングでは残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりにBytePlus独自のURLを保持し、BytePlusはタスクの24時間後にそれを消去し、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時間。値は UNIX タイムスタンプ(秒)です。 + タスクが作成された時刻。値は秒単位のUNIXタイムスタンプです。 - 生成済みビデオの再生時間(秒)。整数ではなく数値として宣言されています。これは BytePlus が一貫していないためです。ビデオタスクが整数秒を返す一方で、姉妹の BytePlus サーフェスでは小数の再生時間が報告されることが観測されているため、クライアントは整数値を仮定してはなりません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)。BytePlusがこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返すこともあれば、同じBytePlusの別のサーフェスが小数の再生時間を報告することも確認されているため、クライアントは値が整数であると仮定してはいけません。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報。タスクが成功した場合はnullが返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列です。その他のコードは検証およびプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープおよび HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流のModelArkエラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列で、他のコードは検証やプロバイダーの失敗を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 エラーメッセージ - - ビデオ生成タスクの ID +The ID of the video generation task @@ -394,17 +409,17 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` - 生成済みビデオのコンテナフォーマット(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 自身のフィールドで、そのまま転送されます。 + 生成済みビデオのコンテナ形式 (`mp4` または `mov`)。Seedance のビデオタスククエリが返す場所である、`content` の兄弟としてトップレベルで返されます。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 - 生成済みビデオの解像度。例えば `1080p` です。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの解像度 (例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - フォーマット: `int64` + 形式: `int64` @@ -414,7 +429,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` - タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒)です。 + タスクが最後に更新された時間。値は UNIX タイムスタンプ (秒) です。 @@ -426,7 +441,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。したがって、total_tokens = completion_tokens です。 + ビデオ生成モデルでは、入力トークン数は計算されず、0 がデフォルトになります。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index c0c47d2b81..7a54185e4e 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Seedance 1.5 Pro 251215 を使用する" description: "Comfy Router 経由で byteplus/seedance-1-5-pro-251215 を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。" sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 13f3fe20 +translationSourceHash: 1d016721 translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 6d6d6ec1 + "Schema": 35f3b5dc "Examples": 7e73ac5c --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-5-pro-251215.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -181,7 +182,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ ### 入力 - この生成タスクの結果を受け取るコールバック通知先アドレス + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果は代わりにタスクステータスのルートをポーリングして取得してください。 形式: `uri` @@ -191,23 +192,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ - 入力オーディオオブジェクト。オーディオ入力に対応するのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオ(wav、mp3)の公開 URL。 +オーディオ URL: オーディオの公開 URL(wav、mp3)。 Base64: 形式 data:audio/\;base64,\ アセット ID: 形式 asset://\ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクの prompt、入力アセット、duration、ratio、seed、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。resolution はデフォルトで 1080p となり、1080p のみをサポートします。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。resolution のデフォルトは 1080p で、1080p のみをサポートします。 - Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。 + `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 @@ -215,7 +216,7 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画を生成するための画像コンテンツ(type が "image_url" の場合) + 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) 画像 URL: 画像 URL にアクセスできることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります アセット ID: 形式 asset://\ @@ -231,11 +232,11 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオを記述します。 +テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 -パラメータ(任意): テキストプロンプトの後に --[parameters] を追加してビデオの仕様を制御します: +パラメータ(任意): テキストプロンプトの後に --[parameters] を追加して、ビデオの仕様を制御します: - --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) - --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) - --duration (--dur): 3~12 秒(デフォルト: 5) @@ -247,36 +248,35 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の制限を公表しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 -これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトは転送時に -このサイズの数倍になる可能性があります。これが制限するのはこの 1 つのフィールドのみで、 -リクエスト全体ではありません。`content` は配列であり、ドキュメント全体を制限するのは -リクエストごとの body 制限です。これを適用するのは Comfy Router -(/v2/models/byteplus/\{model})です。直接の v1 /proxy 呼び出しでは、代わりに -BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、 -正当なプロンプトを弾くことはありません。呼び出し元がさらに必要とする場合は -引き上げてください。 +テキスト長の上限を公開しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。 +文字数(バイト数ではない)でカウントするため、マルチバイトのプロンプトは +転送上でこのサイズの数倍になることがあります。これはこの 1 つのフィールドを制限するものであり、 +リクエスト全体ではありません。`content` は配列であり、リクエスト全体のボディ上限が +ドキュメント全体を制限します。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})であり、 +v1 /proxy を直接呼び出した場合は BytePlus 自身のバリデータが代わりに応答します。 +実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトが +これによって判定されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 - 入力コンテンツのタイプ + 入力コンテンツの種類 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 入力ビデオオブジェクト。ビデオ入力に対応するのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 + 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 ビデオ URL またはアセット ID。 -ビデオ URL: ビデオ(mp4、mov)の公開 URL。 +ビデオ URL: ビデオの公開 URL(mp4、mov)。 アセット ID: 形式 asset://\ Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目に渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 +返されたタスク ID を `draft_task` コンテンツ項目で指定して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 @@ -286,99 +286,113 @@ BytePlus 自身のバリデータが応答します。実際のトラフィッ - タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 範囲: `3600` から `259200` Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 -true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +true: モデルは同期オーディオ付きのビデオを出力します。 +false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外の点では受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。ただしこれが有効なのは拒否されたモダリティがオーディオだった場合だけで、同期 Router のレスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` を指定して Draft を作り直してください。 - 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ずこれを指定する必要があり、プロキシは他の値や省略された値を 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを補完するためであり、Router の呼び出し元は省略します。 + 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ず指定する必要があります。プロキシはそれ以外の値や未指定の値を 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントから補完するためで、Router の呼び出し元は省略します。 - Seedance 2.5 のみ。出力ビデオのコンテナ形式。mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性を持ち、ファイルサイズが小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、高い色精度を持ち、ポストプロダクションに適しています。ファイルサイズは大きくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズは小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 - 指定可能な値: `mp4`, `mov` + 取り得る値: `mp4`, `mov` - 生成されるビデオのアスペクト比。Seedance 2.0 & 2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の最初フレーム / 最初と最後のフレームからの生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 - 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 取り得る値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - ビデオの解像度。Seedance 2.5、2.0 & 2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 -注: Seedance 2.0 & 2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 - 指定可能な値: `480p`, `720p`, `1080p`, `4k` + 取り得る値: `480p`, `720p`, `1080p`, `4k` - 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報の取得を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、そのピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオの最終フレームを次のビデオタスクの最初のフレームとして使用することで、複数の連続したビデオをすばやく生成できます。 -false: 生成されたビデオの最終フレーム画像を返しません。 + 生成されたビデオの最後のフレーム画像を返すかどうか。 +true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、「ビデオ生成タスクの情報を照会する」を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用し、複数の連続したビデオをすばやく生成できます。 +false: 生成されたビデオの最後のフレーム画像を返しません。 - ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 範囲: `-1` から `4294967295` - 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 + 処理に使用するサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`, `flex` + 取り得る値: `default`, `flex` - 生成されたビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -Router が `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +`GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。 ### 出力 - ビデオ生成タスクが完了した後の出力で、出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy ストレージに再ホストされます。ここにあるその他のフィールドはすべて BytePlus 自身のものです。NULL 許容です。BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないか null である可能性があります。 + ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロードURLと、BytePlus が返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにある他のすべてのフィールドは BytePlus 自身のものです。Null 許容: BytePlus はタスクの24時間後にURLをクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないか null になることがあります。 - 生成されたビデオの最終フレームのダウンロード URL で、リクエストで `return_last_frame` を設定したときに返されます。この URL から画像フォーマットを推測しないでください。BytePlus はリクエスト側で最終フレームを PNG として文書化していますが、Router は配信されたバイトをそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` は両方が失敗したときの最後の手段のフォールバックにすぎません。Router は最終フレームを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間分署名され、23 時間のメモから再生されるため、後のポーリングでは残り 1 時間しかないものを返すことがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれの場合もリンクは失効するため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロードURLで、リクエストで `return_last_frame` を設定した場合に返されます。このURLから画像形式を推測しないでください。BytePlus はリクエスト側で最終フレームを PNG として記載しており、Router は提供されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフから型を判定します。`image/jpeg` は両方が失敗した場合の最後のフォールバックにすぎません。Router は最終フレームを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 自身のURLのままとなり、BytePlus はタスクの24時間後にそれをクリアします。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくフレームをダウンロードしてください。 - 生成されたビデオのコンテナフォーマット(mp4 または mov)で、BytePlus がそれを `content` の中にネストする場合に返されます。Seedance モデルはより一般的には `content` のトップレベルの兄弟としてこれを返します(トップレベルの `output_format` フィールドを参照)。Router は存在する方のいずれかを読み取ります。 + BytePlus が `content` の中にネストして返す場合の、生成されたビデオのコンテナ形式 (mp4 または mov) です。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことの方が多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + + + + 上流のURLが機能しなくなる RFC 3339 時刻です。URL自体が持つ最も早い署名時刻に有効期間を加えたものであり、`updated_at` が存在する場合はタスクの `updated_at` に24時間 (BytePlus が文書化しているURLの寿命) を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻となります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + 形式: `date-time` + + + + 最終フレームに対する BytePlus 自身のダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でそのまま返されます。つまりオプトインしたワークスペースのみ、Seedance 2.x のみが対象で、BytePlus がクリアした後は存在せず、`upstream_expires_at` まではベアラー資格情報として扱われます。 + + + + 出力ビデオに対する BytePlus 自身のダウンロードURLで、再ホストされた `video_url` の隣にそのまま返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングする Seedance 2.x のタスクにのみ存在し (リクエストパラメータはありません)、それ以外のすべての場合、例えばワークスペースに解決されない資格情報 (特定のワークスペースにスコープされていないレガシー APIキーなど) では存在しません。また、BytePlus が生成の24時間後にURLをクリアすると存在しなくなります。これは署名付きオブジェクトストレージのURLであり、したがってベアラー資格情報です。保持している誰もが有効期限までビデオをダウンロードできるため、シークレットと同様に扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストが消費します。 - 出力ビデオのダウンロード URL。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間分署名され、23 時間のメモから再生されるため、後のポーリングでは残り 1 時間しかないものを返すことがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数を 100 回に制限しています。いずれの場合もリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 自身のURLのままとなり、BytePlus はタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 - 生成されたビデオの再生時間(秒)。BytePlus がこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す一方で、隣接する BytePlus のサーフェスは小数の再生時間を報告することが観測されているため、クライアントは整数値を仮定してはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間 (秒) です。整数ではなく数値として宣言されているのは、BytePlus の扱いが一貫していないためです。ビデオタスクでは整数秒が返されることが観測されており、同系列の BytePlus のサーフェスでは小数の再生時間が報告されることもあるため、クライアントは整数値であると仮定してはなりません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これはオープンな文字列であり、列挙型ではありません。他のコードは検証およびプロバイダーの失敗を表します。Router は HTTP 400 エラーエンベロープおよび HTTP 200 の失敗タスク応答においてポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のように、ドットで区切られた理由が付くことがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 @@ -386,7 +400,7 @@ Router が `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で提 - ビデオ生成タスクの ID + ビデオ生成タスクのID @@ -394,15 +408,15 @@ Router が `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で提 - 生成されたビデオのコンテナフォーマット(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリが返すのはここです。BytePlus 自身のフィールドで、そのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてTOP LEVELで返されます。Seedanceのビデオタスククエリがこの位置で返すためです。BytePlus自身のフィールドであり、変更されずに転送されます。 - 生成されたビデオの解像度。例えば `1080p`。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus自身のフィールドであり、成功したビデオタスクで返され、変更されずに転送されます。 - タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus自身のフィールドであり、成功したビデオタスクで返され、変更されずに転送されます。 形式: `int64` @@ -410,11 +424,11 @@ Router が `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で提 タスクの状態 - 可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 取り得る値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - タスクが最後に更新された時刻。値は秒単位の UNIX タイムスタンプです。 + タスクが最後に更新された時間。値は秒単位のUNIXタイムスタンプです。 @@ -426,7 +440,7 @@ Router が `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で提 - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。したがって、total_tokens = completion_tokens です。 + ビデオ生成モデルでは入力トークン数は計算されず、0が既定値です。したがって、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/fal/h3-max-turbo/code.mdx b/ja/development/comfy-router/models/fal/h3-max-turbo/code.mdx index 5b8384e7e1..dcc3a64f95 100644 --- a/ja/development/comfy-router/models/fal/h3-max-turbo/code.mdx +++ b/ja/development/comfy-router/models/fal/h3-max-turbo/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router で H3 Max Turbo を使用する" description: "Comfy Router 経由で fal/h3-max-turbo を呼び出す: エンドポイント、リクエスト形状、Router が返すレスポンス。" sidebarTitle: "H3 Max Turbo" -translationSourceHash: 77aca164 +translationSourceHash: d670af32 translationFrom: development/comfy-router/models/fal/h3-max-turbo/code.mdx translationBlockHashes: - "_intro": 3932e8e2 + "_intro": 7c031ba1 "Quick start": 37ecc981 "Schema": fa803ecb "Examples": 53e0f9d0 --- - {/* GENERATED FILE. Generated from router-schemas/fal/h3-max-turbo.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; Comfy Router が fal から提供する `fal/h3-max-turbo` の APIリファレンス。 -**入力:** テキスト, 画像 · **出力:** ビデオ + オーディオ +**入力:** テキスト, 画像, ビデオ, オーディオ · **出力:** ビデオ + オーディオ ## クイックスタート diff --git a/ja/development/comfy-router/models/google/gemini/code.mdx b/ja/development/comfy-router/models/google/gemini/code.mdx index 786edf43c6..24e0f24922 100644 --- a/ja/development/comfy-router/models/google/gemini/code.mdx +++ b/ja/development/comfy-router/models/google/gemini/code.mdx @@ -2,34 +2,21 @@ title: "Comfy Router で Google Gemini を使用する" description: "Comfy Router 経由で HTTP を使って Google Gemini のテキストモデルを呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Google Gemini" -translationSourceHash: 5e4f183f +translationSourceHash: ccf669d3 translationFrom: development/comfy-router/models/google/gemini/code.mdx -translationBlockHashes: - "_intro": 10922fe1 - "Quick start": 933ea7f2 - "Schema": e3abcc1c - "Examples": 4bb73c12 --- - - - - - - {/* 生成済みファイル。このディレクトリの code.yaml を編集し、`pnpm code-pages:gen` を実行してください。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; Google Gemini の API リファレンス。Google Gemini は Google のマルチモーダルテキストモデル群で、Flash および Pro の各ティアにわたり、高速なドラフト作成から深い推論までをカバーします。 -**入力:** テキスト, 画像, オーディオ, ビデオ · **出力:** テキスト - ## クイックスタート [あなたの Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router) でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK (`pip install comfy-sdk` および `npm install @comfyorg/sdk`) を使用します。cURL スニペットは raw HTTP 経由で同じ呼び出しを行います。 -呼び出したいモデルを選択してください。モデルは 1 つのリクエストとレスポンスの形状を共有しており、以下で一度だけ説明します。 +呼び出すモデルを選択してください。以下のすべて(スニペットからスキーマ、例に至るまで)は、選択内容に従います。 @@ -211,219 +198,1241 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview/requests/$R - - -**モデル ID:** `vertexai/gemini-3.5-flash` -**エンドポイント:** `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash` +

スキーマ

- - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy +

入力

-# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. -async def main(): - async with AsyncComfy() as client: - result = await client.models.run( - "vertexai/gemini-3.5-flash", - { - "contents": [ - { - "role": "user", - "parts": [ - { - "text": "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - "generationConfig": { - "temperature": 0.7, - "maxOutputTokens": 256, - }, - }, - ) + + モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 + - print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + + + -asyncio.run(main()) -``` + + URI ベースのデータ。 + -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; + + URI + -// Reads COMFY_API_KEY from the environment. -// The SDK automatically creates an idempotency key and reuses it for automatic retries. -type Result = { candidates: { content: { parts: { text: string }[] } }[] }; -const result = await comfy.models.run("vertexai/gemini-3.5-flash", { - contents: [ - { - role: "user", - parts: [ - { - text: "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - generationConfig: { - temperature: 0.7, - maxOutputTokens: 256, - }, -}); -if (result.kind !== "json") throw new Error("expected a JSON result"); + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 -console.log("text:", result.data.candidates[0].content.parts[0].text); -``` + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + -```bash cURL -curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" -``` -
-
- -同じ本文を `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備が整い次第、このプロセスからでも別のプロセスからでも収集できます。[キュー配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集について順を追って説明します。 + + 生バイトのインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + - -```python Python -import asyncio -from comfy_sdk import AsyncComfy + + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB -# Reads COMFY_API_KEY from the environment. -# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. -async def main(): - async with AsyncComfy() as client: - handle = await client.models.submit( - "vertexai/gemini-3.5-flash", - { - "contents": [ - { - "role": "user", - "parts": [ - { - "text": "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - "generationConfig": { - "temperature": 0.7, - "maxOutputTokens": 256, - }, - }, - ) - print("request_id:", handle.request_id) # with the model ID, all another process needs + 形式: `byte` + - # Poll until the request completes, waiting the Retry-After the server names. - async for update in handle.iter_events(): - print(update.status, update.queue_position) + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. - result = await handle.get() + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + - print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + + モデルがこのパートのビデオをどのように読み取るか。`"AGENTIC"` を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを判断します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + -asyncio.run(main()) -``` + + テキストプロンプトまたはコードスニペット。 + -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; + + このパートがモデルからの思考/推論ステップであることを示します。 + -// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. -type Result = { candidates: { content: { parts: { text: string }[] } }[] }; -const handle = await comfy.models.submit("vertexai/gemini-3.5-flash", { - contents: [ - { - role: "user", - parts: [ - { - text: "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - generationConfig: { - temperature: 0.7, - maxOutputTokens: 256, - }, -}); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs + + 指定可能な値: `user`, `model` + -// Poll until the request completes, waiting the Retry-After the server names. -for await (const update of handle.events()) { - console.log(update.status, update.queuePosition); -} + + 生成のサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作にフォールバックします。 + -// The same result models.run() returns. A request that failed or was cancelled rejects here. -const result = await handle.get(); -if (result.kind !== "json") throw new Error("expected a JSON result"); + + 画像生成の設定 + -console.log("text:", result.data.candidates[0].content.parts[0].text); -``` + + 生成された画像のアスペクト比 + -```bash cURL -# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. -curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" + + 任意。生成された画像の画像出力形式。 + -# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. -REQUEST_ID="" -curl -i https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID/status \ - -H "X-API-Key: $COMFY_API_KEY" + + 任意。出力画像の圧縮品質。 + -# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. -curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID \ - -H "X-API-Key: $COMFY_API_KEY" -``` - - -
-
- -**モデル ID:** `vertexai/gemini-2.5-pro` + + 任意。出力を保存する画像形式(Vertex AI のパス、つまり Comfy 独自の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエストの場合)。そこで受け付けられる値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールド名を示す 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。そのアップストリームにはそのようなプロパティがなく、存在する場合は呼び出し全体を拒否するため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どのパスでも、送信した値を前提とせず、返されたレスポンスのパート(`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み取ってください。 + -**エンドポイント:** `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro` + + 任意。生成された画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値 1K を使用します。 + - - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy + + レスポンスで生成できるトークンの最大数。1 トークンは約 4 文字です。100 トークンはおおよそ 60~80 語に相当します。 -# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. -async def main(): - async with AsyncComfy() as client: - result = await client.models.run( - "vertexai/gemini-2.5-pro", - { - "contents": [ - { - "role": "user", - "parts": [ - { - "text": "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - "generationConfig": { - "temperature": 0.7, - "maxOutputTokens": 256, + 範囲: `16` ~ `65536` + + + + + + + +シードが特定の値に固定されている場合、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定論的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで利用可能です: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + temperature は応答生成中のサンプリングに使用されます。これは topP と topK が適用されるときに発生します。temperature はトークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由奔放でない、あるいは創造的でない応答が求められるプロンプトに適しており、高い temperature はより多様または創造的な結果につながります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定論的になりますが、わずかなばらつきが生じる可能性はあります。モデルが返す応答が一般的すぎる場合、短すぎる場合、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください + + 範囲: `0` から `2` + + 形式: `float` + + + + オプション。thinking 機能の設定です。thinking とは、モデルが複雑なタスクをより小さなステップに分解して、より高品質な応答を生成するプロセスです。 + + + + オプション。true の場合、モデルは自身の思考を応答に含めます。 + + + + オプション。モデルの thinking プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 + + + + オプション。モデルの thinking レベルです。 + + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + + + + Top-K は、モデルが出力のためにトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンは、モデルの語彙内のすべてのトークンの中で最も確率が高いものになります。top-K が 3 の場合、次に選択されるトークンは、temperature を使用して、最も確率の高い 3 個のトークンの中から選択されます。 + + 範囲: `1` から `…` + + + + 指定した場合、nucleus サンプリングが使用されます。 +Top-P は、モデルが出力のためにトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値と等しくなるまで、最も確率の高いもの(top-K を参照)から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 +ランダム性の少ない応答には低い値を、ランダム性の多い応答には高い値を指定してください。 + + 範囲: `0` から `1` + + 形式: `float` + + + + 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に適用されます。 + + + + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 指定可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に答えてください」や「応答に専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part の content は別々の段落にしてください。 + + + + 1 つのメッセージを構成する、順序付けられた parts のリストです。part ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数など入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 + + + + テキストプロンプトまたはコードスニペット。 + + + + メッセージを作成するエンティティの識別情報です。以下の値がサポートされています。user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空白のままにするか、未設定にすることができます。 + + 指定可能な値: `user`, `model` + + + + システムが、モデルの知識や範囲外のアクションまたは一連のアクションを実行するために外部システムとやり取りできるようにするコードです。Function calling を参照してください。 + + + + + + + + + + + + + + + + 関数パラメータの JSON スキーマ + + + + true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に有効期限が切れます。 + + + + ビデオ入力の場合、ビデオの開始オフセットと終了オフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } および "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。 + + + + ビデオのタイムライン位置に対する再生時間のオフセットを表します。 + + + + ナノ秒解像度での符号付き秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。 + + Range: `0` to `999999999` + + + + 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲でなければなりません。 + + Range: `-315576000000` to `315576000000` + + + + ビデオのタイムライン位置に対する再生時間のオフセットを表します。 + + + + ナノ秒解像度での符号付き秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。 + + Range: `0` to `999999999` + + + + 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲でなければなりません。 + + Range: `-315576000000` to `315576000000` + + +このドキュメントは、Router が `GET /v2/models/vertexai/gemini-3.1-pro-preview/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となる、同じドキュメントです。 + +

出力

+ + + + + + + + + + + + + + + + + + + + + + + + + + + 形式: `date` + + + + + + + + + + + + + + + + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 + + + + + + + + URI ベースのデータ。 + + + + URI + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 + + 指定できる値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 生のバイトによるインラインデータ。gemini-2.0-flash-lite と gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + + + + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、そのデータのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + + 形式: `byte` + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 + + 指定できる値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + モデルがこのパートのビデオをどのように読み取るかを指定します。固定レートのフレームサンプリングではなく、検査するセグメントをモデルに判断させるには "AGENTIC" を設定します。省略した場合は、デフォルトの固定レートサンプリングが使用されます。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + + + + テキストプロンプトまたはコードスニペット。 + + + + このパートがモデルによる思考/推論のステップであることを示します。 + + + + 指定できる値: `user`, `model` + + + + + + + + + + + + 指定できる値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + コンテンツが指定された安全性カテゴリに違反している確率 + + 指定できる値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + レスポンスが作成されたタイムスタンプ。 + + + + レスポンスの生成に使用されたモデルのバージョン。 + + + + + + + + + + + + + + + + + + + + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + コンテンツが指定された安全性カテゴリに違反する確率 + + 指定可能な値: `NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 応答の一意の識別子。 + + + + + + + + 出力専用。入力内のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 + + + + 応答内のトークン数。 + + + + モダリティごとの候補トークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの合計サイズであり、キャッシュされたコンテンツ内のトークン数も含まれます。 + + + + モダリティごとのプロンプトトークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + thoughts 出力に含まれるトークン数。 + + + + ツール使用プロンプトに含まれるトークン数。 + + + + モダリティごとのツール使用プロンプトトークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + トークンの合計数(プロンプト + 候補)。 + + + + リクエストに使用されたトラフィックタイプ(例: PROVISIONED_THROUGHPUT)。 + + +

例

+ +

入力

+ +```json +{ + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence." + } + ] + } + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256 + } +} +``` + +

出力

+ +```json +{ + "candidates": [ + { + "content": { + "role": "model", + "parts": [ + { + "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep." + } + ] + }, + "finishReason": "STOP" + } + ], + "usageMetadata": { + "promptTokenCount": 18, + "candidatesTokenCount": 24 + } +} +``` +
+ +**モデル ID:** `vertexai/gemini-3.5-flash` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash` + + + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Reads COMFY_API_KEY from the environment. +# The SDK automatically creates an idempotency key and reuses it for automatic retries. +async def main(): + async with AsyncComfy() as client: + result = await client.models.run( + "vertexai/gemini-3.5-flash", + { + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256, + }, + }, + ) + + print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Reads COMFY_API_KEY from the environment. +// The SDK automatically creates an idempotency key and reuses it for automatic retries. +type Result = { candidates: { content: { parts: { text: string }[] } }[] }; +const result = await comfy.models.run("vertexai/gemini-3.5-flash", { + contents: [ + { + role: "user", + parts: [ + { + text: "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + generationConfig: { + temperature: 0.7, + maxOutputTokens: 256, + }, +}); +if (result.kind !== "json") throw new Error("expected a JSON result"); + +console.log("text:", result.data.candidates[0].content.parts[0].text); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" +``` + + + +同じ本文を `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備が整い次第、このプロセスからでも別のプロセスからでも収集できます。[キュー配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集について順を追って説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Reads COMFY_API_KEY from the environment. +# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-3.5-flash", + { + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256, + }, + }, + ) + print("request_id:", handle.request_id) # with the model ID, all another process needs + + # Poll until the request completes, waiting the Retry-After the server names. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # The provider's own payload, the same value models.run() returns. + # A request that failed or was cancelled raises the typed Router error here. + result = await handle.get() + + print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Reads COMFY_API_KEY from the environment. +// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +type Result = { candidates: { content: { parts: { text: string }[] } }[] }; +const handle = await comfy.models.submit("vertexai/gemini-3.5-flash", { + contents: [ + { + role: "user", + parts: [ + { + text: "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + generationConfig: { + temperature: 0.7, + maxOutputTokens: 256, + }, +}); +console.log("requestId:", handle.requestId); // with the model ID, all another process needs + +// Poll until the request completes, waiting the Retry-After the server names. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// The same result models.run() returns. A request that failed or was cancelled rejects here. +const result = await handle.get(); +if (result.kind !== "json") throw new Error("expected a JSON result"); + +console.log("text:", result.data.candidates[0].content.parts[0].text); +``` + +```bash cURL +# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" + +# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +

スキーマ

+ +

入力

+ + + モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 + + + + + + + + URI ベースのデータ。 + + + + URI + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 生バイトのインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + + + + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + + 形式: `byte` + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + モデルがこのパートのビデオをどのように読み取るか。`"AGENTIC"` を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを判断します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + + + + テキストプロンプトまたはコードスニペット。 + + + + このパートがモデルからの思考/推論ステップであることを示します。 + + + + 指定可能な値: `user`, `model` + + + + 生成のサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作にフォールバックします。 + + + + 画像生成の設定 + + + + 生成された画像のアスペクト比 + + + + 任意。生成された画像の画像出力形式。 + + + + 任意。出力画像の圧縮品質。 + + + + 任意。出力を保存する画像形式(Vertex AI のパス、つまり Comfy 独自の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエストの場合)。そこで受け付けられる値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールド名を示す 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。そのアップストリームにはそのようなプロパティがなく、存在する場合は呼び出し全体を拒否するため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どのパスでも、送信した値を前提とせず、返されたレスポンスのパート(`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み取ってください。 + + + + 任意。生成された画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値 1K を使用します。 + + + + レスポンスで生成できるトークンの最大数。1 トークンは約 4 文字です。100 トークンはおおよそ 60~80 語に相当します。 + + 範囲: `16` ~ `65536` + + + + + + + +シードが特定の値に固定されている場合、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定論的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで利用可能です: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + temperature は応答生成中のサンプリングに使用されます。これは topP と topK が適用されるときに発生します。temperature はトークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由奔放でない、あるいは創造的でない応答が求められるプロンプトに適しており、高い temperature はより多様または創造的な結果につながります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定論的になりますが、わずかなばらつきが生じる可能性はあります。モデルが返す応答が一般的すぎる場合、短すぎる場合、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください + + 範囲: `0` から `2` + + 形式: `float` + + + + オプション。thinking 機能の設定です。thinking とは、モデルが複雑なタスクをより小さなステップに分解して、より高品質な応答を生成するプロセスです。 + + + + オプション。true の場合、モデルは自身の思考を応答に含めます。 + + + + オプション。モデルの thinking プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 + + + + オプション。モデルの thinking レベルです。 + + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + + + + Top-K は、モデルが出力のためにトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンは、モデルの語彙内のすべてのトークンの中で最も確率が高いものになります。top-K が 3 の場合、次に選択されるトークンは、temperature を使用して、最も確率の高い 3 個のトークンの中から選択されます。 + + 範囲: `1` から `…` + + + + 指定した場合、nucleus サンプリングが使用されます。 +Top-P は、モデルが出力のためにトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値と等しくなるまで、最も確率の高いもの(top-K を参照)から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 +ランダム性の少ない応答には低い値を、ランダム性の多い応答には高い値を指定してください。 + + 範囲: `0` から `1` + + 形式: `float` + + + + 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に適用されます。 + + + + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 指定可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に答えてください」や「応答に専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part の content は別々の段落にしてください。 + + + + 1 つのメッセージを構成する、順序付けられた parts のリストです。part ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数など入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 + + + + テキストプロンプトまたはコードスニペット。 + + + + メッセージを作成するエンティティの識別情報です。以下の値がサポートされています。user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空白のままにするか、未設定にすることができます。 + + 指定可能な値: `user`, `model` + + + + システムが、モデルの知識や範囲外のアクションまたは一連のアクションを実行するために外部システムとやり取りできるようにするコードです。Function calling を参照してください。 + + + + + + + + + + + + + + + + 関数パラメータの JSON スキーマ + + + + true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に有効期限が切れます。 + + + + ビデオ入力の場合、ビデオの開始オフセットと終了オフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } および "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。 + + + + ビデオのタイムライン位置に対する再生時間のオフセットを表します。 + + + + ナノ秒解像度での符号付き秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。 + + Range: `0` to `999999999` + + + + 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲でなければなりません。 + + Range: `-315576000000` to `315576000000` + + + + ビデオのタイムライン位置に対する再生時間のオフセットを表します。 + + + + ナノ秒解像度での符号付き秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。 + + Range: `0` to `999999999` + + + + 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲でなければなりません。 + + Range: `-315576000000` to `315576000000` + + +このドキュメントは、Router が `GET /v2/models/vertexai/gemini-3.5-flash/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となる、同じドキュメントです。 + +

出力

+ + + + + + + + + + + + + + + + + + + + + + + + + + + 形式: `date` + + + + + + + + + + + + + + + + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 + + + + + + + + URI ベースのデータ。 + + + + URI + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 + + 指定できる値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 生のバイトによるインラインデータ。gemini-2.0-flash-lite と gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + + + + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、そのデータのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + + 形式: `byte` + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 + + 指定できる値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + モデルがこのパートのビデオをどのように読み取るかを指定します。固定レートのフレームサンプリングではなく、検査するセグメントをモデルに判断させるには "AGENTIC" を設定します。省略した場合は、デフォルトの固定レートサンプリングが使用されます。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + + + + テキストプロンプトまたはコードスニペット。 + + + + このパートがモデルによる思考/推論のステップであることを示します。 + + + + 指定できる値: `user`, `model` + + + + + + + + + + + + 指定できる値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + コンテンツが指定された安全性カテゴリに違反している確率 + + 指定できる値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + レスポンスが作成されたタイムスタンプ。 + + + + レスポンスの生成に使用されたモデルのバージョン。 + + + + + + + + + + + + + + + + + + + + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + コンテンツが指定された安全性カテゴリに違反する確率 + + 指定可能な値: `NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 応答の一意の識別子。 + + + + + + + + 出力専用。入力内のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 + + + + 応答内のトークン数。 + + + + モダリティごとの候補トークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの合計サイズであり、キャッシュされたコンテンツ内のトークン数も含まれます。 + + + + モダリティごとのプロンプトトークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + thoughts 出力に含まれるトークン数。 + + + + ツール使用プロンプトに含まれるトークン数。 + + + + モダリティごとのツール使用プロンプトトークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + トークンの合計数(プロンプト + 候補)。 + + + + リクエストに使用されたトラフィックタイプ(例: PROVISIONED_THROUGHPUT)。 + + +

例

+ +

入力

+ +```json +{ + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence." + } + ] + } + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256 + } +} +``` + +

出力

+ +```json +{ + "candidates": [ + { + "content": { + "role": "model", + "parts": [ + { + "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep." + } + ] + }, + "finishReason": "STOP" + } + ], + "usageMetadata": { + "promptTokenCount": 18, + "candidatesTokenCount": 24 + } +} +``` +
+ +**モデル ID:** `vertexai/gemini-2.5-pro` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro` + + + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Reads COMFY_API_KEY from the environment. +# The SDK automatically creates an idempotency key and reuses it for automatic retries. +async def main(): + async with AsyncComfy() as client: + result = await client.models.run( + "vertexai/gemini-2.5-pro", + { + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256, }, }, ) @@ -502,75 +1511,294 @@ async def main(): ) print("request_id:", handle.request_id) # with the model ID, all another process needs - # Poll until the request completes, waiting the Retry-After the server names. - async for update in handle.iter_events(): - print(update.status, update.queue_position) + # Poll until the request completes, waiting the Retry-After the server names. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # The provider's own payload, the same value models.run() returns. + # A request that failed or was cancelled raises the typed Router error here. + result = await handle.get() + + print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Reads COMFY_API_KEY from the environment. +// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +type Result = { candidates: { content: { parts: { text: string }[] } }[] }; +const handle = await comfy.models.submit("vertexai/gemini-2.5-pro", { + contents: [ + { + role: "user", + parts: [ + { + text: "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + generationConfig: { + temperature: 0.7, + maxOutputTokens: 256, + }, +}); +console.log("requestId:", handle.requestId); // with the model ID, all another process needs + +// Poll until the request completes, waiting the Retry-After the server names. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// The same result models.run() returns. A request that failed or was cancelled rejects here. +const result = await handle.get(); +if (result.kind !== "json") throw new Error("expected a JSON result"); + +console.log("text:", result.data.candidates[0].content.parts[0].text); +``` + +```bash cURL +# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" + +# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +

スキーマ

+ +

入力

+ +_フィールドは Google が公開している API 仕様に従っており、CI でその仕様と照合されます。このモデルに対する Router 独自のスキーマはまだ公開されていないため、リクエストは検証されずにプロバイダーへ転送されます。_ + + + これまでの会話。古い順に並びます。パートは `text`、またはプロンプトと一緒に画像、オーディオ、ビデオを送信するための `inlineData` です。 + + + + そのターンを誰が作成したか。 + + 指定可能な値: `user`, `model` + + + + ターンのコンテンツパート。 + + + + テキストパート。 + + + + インラインメディアパート。 + + + + メディアタイプ。例: `image/png` + + + + Base64 でエンコードされたメディアのバイト列。 + + + + 会話全体に適用されるシステムプロンプト。 + + + + + + + + + + + + サンプリングと長さの設定。 + + + + サンプリングのランダム性。デフォルト値はモデル固有です。 + + 範囲: `0` から `2` + + + + 核サンプリングのしきい値。デフォルト値はモデル固有です。 + + + + top-k サンプリングのカットオフ。デフォルト値はモデル固有です。 + + + + 生成トークン数の上限。 + + + + 再現可能なサンプリングのためのシード。 + + + + 生成された時点で生成を終了させる文字列。 + + + + 対応モデルでの推論強度の制御。 + + + + 指定可能な値: `MINIMAL`, `LOW`, `MEDIUM`, `HIGH` + + + + 回答と合わせてモデルの推論を返します。 + + + + モデルが呼び出せる関数宣言。 + + + + + + + + + + + + + + + + 関数の引数の JSON Schema。 + + +

出力

+ +Router は Google のネイティブなレスポンスを変更せずに返します。テキストは `candidates[0].content.parts[0].text` にあります。 + + + 生成された候補。複数を要求しない限り 1 つです。 + + + + + + + + 指定可能な値: `model` + + + + + + + + 生成されたテキスト。 + + + + モデルが `tools` のいずれかを呼び出すことを選択した場合に存在します。 + + + + + + + + + + + + 生成が停止した理由: `STOP`、`MAX_TOKENS`、`SAFETY` など + + + + 呼び出しのトークン数の内訳。 + + + + プロンプト内のトークン数。 + + + + 生成された候補内のトークン数。 + + + + プロンプト自体がブロックされた場合に存在します。結果を読み取る前に `candidates` が存在するか確認してください。`usageMetadata` もブロックされたレスポンスに含まれることがあります。 + - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. - result = await handle.get() + + プロンプトがブロックされた理由。候補は返されないため、プロンプトを言い換えて再試行してください。 - print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + 指定可能な値: `SAFETY`, `OTHER`, `BLOCKLIST`, `PROHIBITED_CONTENT`, `IMAGE_SAFETY` + -asyncio.run(main()) -``` +

例

-```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; +

入力

-// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. -type Result = { candidates: { content: { parts: { text: string }[] } }[] }; -const handle = await comfy.models.submit("vertexai/gemini-2.5-pro", { - contents: [ +```json +{ + "contents": [ { - role: "user", - parts: [ + "role": "user", + "parts": [ { - text: "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, + "text": "Describe a single red maple leaf on a white background in one sentence." + } + ] + } ], - generationConfig: { - temperature: 0.7, - maxOutputTokens: 256, - }, -}); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs - -// Poll until the request completes, waiting the Retry-After the server names. -for await (const update of handle.events()) { - console.log(update.status, update.queuePosition); + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256 + } } - -// The same result models.run() returns. A request that failed or was cancelled rejects here. -const result = await handle.get(); -if (result.kind !== "json") throw new Error("expected a JSON result"); - -console.log("text:", result.data.candidates[0].content.parts[0].text); ``` -```bash cURL -# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. -curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" - -# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. -REQUEST_ID="" -curl -i https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID/status \ - -H "X-API-Key: $COMFY_API_KEY" +

出力

-# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. -curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID \ - -H "X-API-Key: $COMFY_API_KEY" +```json +{ + "candidates": [ + { + "content": { + "role": "model", + "parts": [ + { + "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep." + } + ] + }, + "finishReason": "STOP" + } + ], + "usageMetadata": { + "promptTokenCount": 18, + "candidatesTokenCount": 24 + } +} ``` - -
-
**モデル ID:** `vertexai/gemini-2.5-flash` @@ -751,476 +1979,182 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash/requests/$REQUEST - - - -## スキーマ - -### 入力 - - - モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 - - - - - - - - URI ベースのデータ。 - - - - URI - - - - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - - 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - - - - 生バイトのインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - - - - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB - - 形式: `byte` - - - - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - - 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - - - - モデルがこのパートのビデオをどのように読み取るか。`"AGENTIC"` を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを判断します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 - - - - テキストプロンプトまたはコードスニペット。 - - - - このパートがモデルからの思考/推論ステップであることを示します。 - - - - 指定可能な値: `user`, `model` - - - - 生成のサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作にフォールバックします。 - - - - 画像生成の設定 - - - - 生成された画像のアスペクト比 - - - - 任意。生成された画像の画像出力形式。 - - - - 任意。出力画像の圧縮品質。 - - - - 任意。出力を保存する画像形式(Vertex AI のパス、つまり Comfy 独自の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエストの場合)。そこで受け付けられる値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールド名を示す 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。そのアップストリームにはそのようなプロパティがなく、存在する場合は呼び出し全体を拒否するため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どのパスでも、送信した値を前提とせず、返されたレスポンスのパート(`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み取ってください。 - - - - 任意。生成された画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値 1K を使用します。 - - - - レスポンスで生成できるトークンの最大数。1 トークンは約 4 文字です。100 トークンはおおよそ 60~80 語に相当します。 - - 範囲: `16` ~ `65536` - - - - - - - -シードが特定の値に固定されている場合、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定論的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで利用可能です: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 - - - - - - - - temperature は応答生成中のサンプリングに使用されます。これは topP と topK が適用されるときに発生します。temperature はトークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由奔放でない、あるいは創造的でない応答が求められるプロンプトに適しており、高い temperature はより多様または創造的な結果につながります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定論的になりますが、わずかなばらつきが生じる可能性はあります。モデルが返す応答が一般的すぎる場合、短すぎる場合、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください - - 範囲: `0` から `2` - - 形式: `float` - - - - オプション。thinking 機能の設定です。thinking とは、モデルが複雑なタスクをより小さなステップに分解して、より高品質な応答を生成するプロセスです。 - - - - オプション。true の場合、モデルは自身の思考を応答に含めます。 - - - - オプション。モデルの thinking プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 - - - - オプション。モデルの thinking レベルです。 - - 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` - - - - Top-K は、モデルが出力のためにトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンは、モデルの語彙内のすべてのトークンの中で最も確率が高いものになります。top-K が 3 の場合、次に選択されるトークンは、temperature を使用して、最も確率の高い 3 個のトークンの中から選択されます。 - - 範囲: `1` から `…` - - - - 指定した場合、nucleus サンプリングが使用されます。 -Top-P は、モデルが出力のためにトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値と等しくなるまで、最も確率の高いもの(top-K を参照)から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 -ランダム性の少ない応答には低い値を、ランダム性の多い応答には高い値を指定してください。 - - 範囲: `0` から `1` - - 形式: `float` - - - - 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に適用されます。 - - - - 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - - - - 指定可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` - - - - モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に答えてください」や「応答に専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part の content は別々の段落にしてください。 - - - 1 つのメッセージを構成する、順序付けられた parts のリストです。part ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数など入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 - +

スキーマ

- - テキストプロンプトまたはコードスニペット。 +

入力

+ +_フィールドは Google が公開している API 仕様に従っており、CI でその仕様と照合されます。このモデルに対する Router 独自のスキーマはまだ公開されていないため、リクエストは検証されずにプロバイダーへ転送されます。_ + + + これまでの会話。古い順に並びます。パートは `text`、またはプロンプトと一緒に画像、オーディオ、ビデオを送信するための `inlineData` です。 - - メッセージを作成するエンティティの識別情報です。以下の値がサポートされています。user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空白のままにするか、未設定にすることができます。 + + そのターンを誰が作成したか。 指定可能な値: `user`, `model` - - システムが、モデルの知識や範囲外のアクションまたは一連のアクションを実行するために外部システムとやり取りできるようにするコードです。Function calling を参照してください。 + + ターンのコンテンツパート。 - - + + テキストパート。 - - + + インラインメディアパート。 - - + + メディアタイプ。例: `image/png` - - 関数パラメータの JSON スキーマ + + Base64 でエンコードされたメディアのバイト列。 - - true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に有効期限が切れます。 + + 会話全体に適用されるシステムプロンプト。 - - ビデオ入力の場合、ビデオの開始オフセットと終了オフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } および "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。 + + - - ビデオのタイムライン位置に対する再生時間のオフセットを表します。 + + - - ナノ秒解像度での符号付き秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。 - - Range: `0` to `999999999` + + サンプリングと長さの設定。 - - 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲でなければなりません。 + + サンプリングのランダム性。デフォルト値はモデル固有です。 - Range: `-315576000000` to `315576000000` + 範囲: `0` から `2` - - ビデオのタイムライン位置に対する再生時間のオフセットを表します。 + + 核サンプリングのしきい値。デフォルト値はモデル固有です。 - - ナノ秒解像度での符号付き秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。 - - Range: `0` to `999999999` + + top-k サンプリングのカットオフ。デフォルト値はモデル固有です。 - - 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲でなければなりません。 + + 生成トークン数の上限。 + - Range: `-315576000000` to `315576000000` + + 再現可能なサンプリングのためのシード。 -このドキュメントは、Router が `GET /v2/models/vertexai/gemini-3.1-pro-preview/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となる、同じドキュメントです。 + + 生成された時点で生成を終了させる文字列。 + -### 出力 + + 対応モデルでの推論強度の制御。 + - - - + + 指定可能な値: `MINIMAL`, `LOW`, `MEDIUM`, `HIGH` + - - - + + 回答と合わせてモデルの推論を返します。 + - - - + + モデルが呼び出せる関数宣言。 + - + - + - + - + - + - + - - 形式: `date` - + + 関数の引数の JSON Schema。 + - - - +

出力

- - - +Router は Google のネイティブなレスポンスを変更せずに返します。テキストは `candidates[0].content.parts[0].text` にあります。 - - + + 生成された候補。複数を要求しない限り 1 つです。 - モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 - - - - - URI ベースのデータ。 - - - - URI - - - - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 - - 指定できる値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - - - - 生のバイトによるインラインデータ。gemini-2.0-flash-lite と gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - - - - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、そのデータのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB - - 形式: `byte` - - - - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 - - 指定できる値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - - - - モデルがこのパートのビデオをどのように読み取るかを指定します。固定レートのフレームサンプリングではなく、検査するセグメントをモデルに判断させるには "AGENTIC" を設定します。省略した場合は、デフォルトの固定レートサンプリングが使用されます。gemini-3.7-flash 以降の Flash モデルでサポートされています。 - - - - テキストプロンプトまたはコードスニペット。 - - - - このパートがモデルによる思考/推論のステップであることを示します。 - - - 指定できる値: `user`, `model` - - - - + 指定可能な値: `model` - + - - 指定できる値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - - - - コンテンツが指定された安全性カテゴリに違反している確率 - - 指定できる値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - - - - レスポンスが作成されたタイムスタンプ。 - - - - レスポンスの生成に使用されたモデルのバージョン。 - - - - + + 生成されたテキスト。 - - + + モデルが `tools` のいずれかを呼び出すことを選択した場合に存在します。 - + - + - - 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - - - - コンテンツが指定された安全性カテゴリに違反する確率 - - 指定可能な値: `NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` - - - - 応答の一意の識別子。 + + 生成が停止した理由: `STOP`、`MAX_TOKENS`、`SAFETY` など - - - - - 出力専用。入力内のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 - - - - 応答内のトークン数。 - - - - モダリティごとの候補トークンの内訳。 - - - - 入力または出力コンテンツのモダリティの種類。 - - 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` - - - - 指定されたモダリティのトークン数。 + 呼び出しのトークン数の内訳。 - リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの合計サイズであり、キャッシュされたコンテンツ内のトークン数も含まれます。 - - - - モダリティごとのプロンプトトークンの内訳。 - - - - 入力または出力コンテンツのモダリティの種類。 - - 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + プロンプト内のトークン数。 - - 指定されたモダリティのトークン数。 - - - - thoughts 出力に含まれるトークン数。 - - - - ツール使用プロンプトに含まれるトークン数。 - - - - モダリティごとのツール使用プロンプトトークンの内訳。 - - - - 入力または出力コンテンツのモダリティの種類。 - - 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + 生成された候補内のトークン数。 - - 指定されたモダリティのトークン数。 + + プロンプト自体がブロックされた場合に存在します。結果を読み取る前に `candidates` が存在するか確認してください。`usageMetadata` もブロックされたレスポンスに含まれることがあります。 - - トークンの合計数(プロンプト + 候補)。 - + + プロンプトがブロックされた理由。候補は返されないため、プロンプトを言い換えて再試行してください。 - - リクエストに使用されたトラフィックタイプ(例: PROVISIONED_THROUGHPUT)。 + 指定可能な値: `SAFETY`, `OTHER`, `BLOCKLIST`, `PROHIBITED_CONTENT`, `IMAGE_SAFETY` -## 例 +

例

-### 入力 +

入力

```json { @@ -1241,7 +2175,7 @@ Top-P は、モデルが出力のためにトークンを選択する方法を } ``` -### 出力 +

出力

```json { @@ -1264,5 +2198,7 @@ Top-P は、モデルが出力のためにトークンを選択する方法を } } ``` + + diff --git a/ja/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx b/ja/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx index a0ccb68197..1c65d81127 100644 --- a/ja/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx +++ b/ja/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router で Ideogram 4.5 を使用する" description: "Comfy Router 経由で ideogram/ideogram-4-5 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Ideogram 4.5" -translationSourceHash: 2cd2cad8 +translationSourceHash: 9c2a625d translationFrom: development/comfy-router/models/ideogram/ideogram-4-5/code.mdx translationBlockHashes: "_intro": 3e988502 "Quick start": c8cd302a - "Schema": ea1fb25c + "Schema": 493d453f "Examples": f5f40ced --- + {/* GENERATED FILE. Generated from router-schemas/ideogram/ideogram-4-5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -147,85 +148,87 @@ curl https://api.comfy.org/v2/models/ideogram/ideogram-4-5/requests/$REQUEST_ID ## スキーマ - ### 入力 + + Precise Edit 専用。`image` が必要です。編集が対象とするソース画像内の領域です。これにより、非常に大きな画像でも1か所だけを編集し、残りをそのままにした状態でフルサイズで返すことができます。`none`(デフォルト)は画像全体を編集します。`auto` は `mask` の周囲に領域を合わせ、`mask` が必須になります。それ以外の場合は `y_min,x_min,y_max,x_max` を4つの非負の整数によるピクセル境界として送信します。`y_max` は `y_min` より大きく、`x_max` は `x_min` より大きく、各辺は最低 256 ピクセル、アスペクト比は 1:6 から 6:1 の間、面積は最大 4,194,304 ピクセルです。`image` のないリクエストで `none` 以外の値を指定すると拒否されます。`context_window` はコンテキストウィンドウのゲートが有効な場合にのみ受け付けられます。有効でない場合、`none` 以外の値は 422 で拒否されます。 + + - 生成後の著作権検出をオプトインします。 + 生成後の著作権検出を有効にします。 - 1枚の画像を、Router が呼び出し元に代わって取得する https URL、またはバイト列をインラインで保持する `data:image/;base64,` URI のいずれかの形式で指定します。受け入れられる画像形式は png、webp、jpeg で、このセットはプロバイダーに委ねられるのではなく解決時に強制されます。つまり svg、gif、avif、tiff はここで拒否され、原因から2ホップ離れたパートナーエラーになるのではなく、送信した画像を名指しして通知されます。 -URL 形式を推奨します。base64 ペイロードはおよそ 4/3 に膨らみ、リクエストボディ全体は 100 MiB に制限されるため、インライン形式ではソース画像が約 75 MB で頭打ちになります。URL ならこれを完全に回避できます。この説明の最後に記載されている画像ごとおよびリクエストごとのメディア上限はボディの上限よりも厳しいため、実サイズの画像ではまずこちらに当たります。 -URL は認証情報なしで解決できなければなりません。Router はサーバー側で取得し、リクエストに呼び出し元の認証情報を一切付けません。そのため、署名がクエリ文字列に含まれる presigned URL がサポートされる形式です。`/api/assets/{id}/content` のような認証済みエンドポイントは、画像ではなく 401 を Router に返します。その URL はご自身でリクエストし、リダイレクト先の署名付き URL を渡してください。 -取得は開かれたインターネットではなく、名前を挙げたホストのセットに限定されます。同じリストは送信する URL だけでなく、すべてのリダイレクトホップにも再適用されます。そのため、それ以外のホストの URL や、リスト外へリダイレクトする URL は、どのプロバイダーにも接触する前に拒否されます。現在このリストは Comfy 自身のアセット配信のみです。すなわち Comfy のアセットバケット配下の署名済み `storage.googleapis.com` URL で、これは `/api/assets/{id}/content` がリダイレクトする形式です。パートナー CDN や通常の https ホストはリストに含まれません。 -2つの拡張が展開中で、どちらも本日時点ではデフォルトでオフです。これらは1つの切り替えの背後で提供され、同時に有効化されます。したがって以下はすべて、まだ依存して実装するものではなく、今後提供予定のものとして扱ってください。どちらかに依存する前に確認してください。 -1つ目は `POST /customers/storage` がアップロード先として署名するバケットです。展開がお使いの環境に到達するまで、そのエンドポイントが発行するアップロード URL はここで拒否されます。バケットは Comfy 自身のものでホストも同じであるにもかかわらずです。つまり「Comfy にアップロードしてから URL を渡す」はまだ機能せず、機能するのは `/api/assets/{id}/content` がリダイレクトする署名付き URL の形式です。 -2つ目は全員に対して一度にではなくアカウント単位で有効化されます。これらのホストの背後にあるバケットは当社のものではなくお客様のものであるためです。上記の切り替えがオンになっていても、サードパーティの受信メディアが有効化されていないアカウントは拒否され、ホストが未サポートだと言われるのではなく、その旨の文言で通知されます。お使いの Comfy 担当者にアカウントでの有効化を依頼してください。さらに、以下のサードパーティのオブジェクトストレージホストを許可します。ここではバケットはお客様のものであり、Router は所有権を主張しません。Cloudflare R2 (`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3 (`s3.amazonaws.com` および `s3..amazonaws.com`。path-style または `.` プレフィックス形式のいずれか)、Azure Blob Storage (`.blob.core.windows.net`)、Alibaba Cloud OSS (`.oss-.aliyuncs.com`。`oss-accelerate` エンドポイントを含む)。これらは具体的にはオブジェクトストレージのエンドポイントです。同じプロバイダードメイン上の汎用エンドポイント、たとえば Alibaba Function Compute のトリガーはリストに含まれず、拒否されます。 -マッチングされるのはプロバイダーではなくホスト名の形式です。したがって上記でプロバイダー名を挙げたからといって、そのプロバイダーが発行しうるすべての URL が受け入れられるわけではありません。呼び出し元がそれぞれもっともらしく持ち込みうる、3つの惜しい例を明示しておきます。R2 のカスタムドメイン (`cdn.example.com`) は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限付きのデバッグ用ホスト名として文書化し、本番トラフィックは代わりにカスタムドメインへ向けるよう案内していますが、カスタムドメインのホスト名には R2 であることを示すものが何も含まれないため、Router は他のホストと区別できず拒否します。`.r2.cloudflarestorage.com` エンドポイントを presign するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント (`s3.dualstack..amazonaws.com`) も受け入れられません。通常のリージョナルエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン (`.z.blob.storage.azure.net`) も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれらの同じ形式が記載されているので、ここに読みに来る必要はありません。 -上記の `` と `pub-` のプレースホルダーは、通常持ち込む形式を示したものであり、階層の深さの制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間の下のより深い名前 (`a.b.pub-.r2.dev`) も受け入れられます。それによって広がるわけではないのは名前空間そのものです。サフィックスはいずれにせよ上記のいずれかでなければなりません。 -以下の例は形状のみを示しています。実際の値には署名のクエリパラメータも含まれますが、公開された例はスペックに永遠に残り、実際の署名は漏洩した認証情報であると同時に機能しなくなるリンクでもあるため、ここでは意図的に省略しています。 -各画像は 25 MiB、1つのリクエストの画像は合計 64 MiB が上限です。 + 1枚の画像を、呼び出し元の代わりに Router が取得する https URL、またはバイト列をインラインで含む `data:image/;base64,` URI のいずれかで指定します。受け付けられる画像形式は png、webp、jpeg で、この組み合わせはプロバイダーに委ねるのではなく解決時に強制されます。svg、gif、avif、tiff はここで拒否され、送信した画像名が示されます。原因から2ホップ離れたパートナーエラーになることはありません。 +URL 形式を推奨します。base64 ペイロードは約 4/3 に膨らみ、リクエスト本文全体は 100 MiB に制限されるため、インライン形式ではソース画像が約 75 MB で上限に達します。URL ならこれを完全に回避できます。この説明の最後に記載する画像ごとおよびリクエストごとのメディア上限は本文の上限より厳しいため、実際のサイズの画像ではまずそちらに達します。 +URL はあなたの認証情報なしで解決できる必要があります。Router はサーバー側で取得し、リクエストに呼び出し元の認証情報を含めません。そのため、署名がクエリ文字列に含まれる形式の署名付き URL がサポートされる形式です。`/api/assets/{id}/content` のような認証が必要なエンドポイントは、画像ではなく 401 を Router に返します。その URL はご自身でリクエストし、リダイレクト先の署名付き URL を渡してください。 +取得は開かれたインターネットではなく、名前を挙げたホスト群に限定されます。同じリストは、送信した URL だけでなくすべてのリダイレクト先にも再適用されます。そのため、他のホストの URL や、リスト外へリダイレクトする URL は、どのプロバイダーにも接続する前に拒否されます。現在このリストは Comfy 自身のアセット配信のみです。Comfy のアセットバケット配下の署名付き `storage.googleapis.com` URL で、これは `/api/assets/{id}/content` がリダイレクトする形式です。パートナー CDN や通常の https ホストはリストに含まれません。 +2つの拡張が展開中で、いずれも現在はデフォルトで無効です。これらは1つの切り替えの背後で提供され、一緒に有効になります。したがって、以下はまだ実装の前提とせず、今後提供予定のものとして扱ってください。どちらかに依存する前にご確認ください。 +1つ目は、`POST /customers/storage` がアップロード先として署名するバケットです。展開があなたの環境に届くまで、そのエンドポイントから得たアップロード URL はここで拒否されます。バケットは Comfy 自身のものでホストも同じであっても変わりません。そのため「Comfy にアップロードしてから URL を渡す」はまだ動作せず、動作するのは `/api/assets/{id}/content` がリダイレクトする署名付き URL の形式です。 +2つ目は全員に一度にではなくアカウントごとに有効になります。これらのホストの背後にあるバケットは当社ではなくあなたのものだからです。上記の切り替えがオンになっても、サードパーティの受信メディアが有効化されていないアカウントは拒否され、ホストが非対応であるというのではなく、その旨がそのまま伝えられます。お使いのアカウントで有効にするよう Comfy の担当者に依頼してください。さらに、以下のサードパーティのオブジェクトストレージホストが許可されます。ここではバケットはあなたのものであり、Router は所有権を主張しません。Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` および `s3..amazonaws.com`、パス形式または `.` 接頭辞形式のいずれか)、Azure Blob Storage(`.blob.core.windows.net`)、Alibaba Cloud OSS(`.oss-.aliyuncs.com`、`oss-accelerate` エンドポイントを含む)。これらは特にオブジェクトストレージのエンドポイントです。同じプロバイダードメイン上の汎用エンドポイント(Alibaba Function Compute のトリガーなど)はリストに含まれず、拒否されます。 +照合されるのはプロバイダーではなくホスト名の形式です。したがって、上でプロバイダー名を挙げたからといって、そのプロバイダーが発行できるすべての URL が受け入れられるわけではありません。呼び出し元が妥当にたどり着きうる3つの惜しい例を明示しておきます。R2 のカスタムドメイン(`cdn.example.com`)は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限付きのデバッグ用ホスト名として文書化し、本番トラフィックは代わりにカスタムドメインに向けるよう案内していますが、カスタムドメインのホスト名には R2 であることを示すものが何もないため、Router は他のホストと区別できず拒否します。`.r2.cloudflarestorage.com` エンドポイントを署名するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント(`s3.dualstack..amazonaws.com`)も受け入れられません。通常のリージョナルエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン(`.z.blob.storage.azure.net`)も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージには同じ形式が示されるため、それらを読むためにここへ戻る必要はありません。 +上記の `` と `pub-` というプレースホルダーは、通常たどり着く形式を示すものであり、階層の深さの制限ではありません。照合はオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間のより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、これによって広がるのは名前空間そのものではありません。サフィックスは依然として列挙されたもののいずれかである必要があります。 +以下の例は形状のみを示しています。実際の値には署名のクエリパラメータも含まれますが、公開された例は仕様に永久に残り、実際の署名は認証情報の漏えいであると同時に機能しなくなるリンクでもあるため、ここでは意図的に省略しています。 +画像1枚あたり 25 MiB、1リクエストの画像は合計 64 MiB が上限です。唯一の例外は ideogram/ideogram-4-5 Precise Edit(`image` を送る呼び出し)で `context_window` が利用できる場合です。そこでは各画像が最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセル、1リクエストの画像は合計 128 MiB までです。 - 生成操作の任意のソース画像。最初の1枚がプライマリソースで、残りは参照です。最大5枚、マスクありの場合は4枚です。 + 生成操作用の任意のソース画像です。1枚目が主要なソースで、残りは参照です。最大5枚、マスクを使う場合は4枚です。 - 生成時のみ。テキストから画像へのプロンプト書き換え。サポートされる値は auto、on、off です。デフォルトは auto です。 + 生成時のみ。テキストから画像へのプロンプト書き換えです。サポートされる値は auto、on、off です。デフォルトは auto です。 - 1つの画像。呼び出し元に代わって Router が取得する https URL、またはバイトをインラインで含む `data:image/;base64,` URI のいずれかです。受け入れられる画像タイプは png、webp、jpeg であり、このセットはプロバイダーに任されるのではなく解決時に強制されます。svg、gif、avif、tiff はここで拒否され、送信した画像を名指しします。原因から2ホップ離れたパートナーエラーになることはありません。 -URL 形式を推奨します。base64 ペイロードは約 4/3 に膨張し、リクエストボディ全体は 100 MiB に制限されるため、インライン形式では約 75 MB のソース画像で上限に達します。URL はそれを完全に回避します。この説明の最後に記載されている画像ごとおよびリクエストごとのメディア上限は、ボディ上限よりも厳しいため、実際のサイズの画像ではまずそちらに達します。 -URL は認証情報なしで解決可能でなければなりません。Router はサーバー側で取得し、リクエストに呼び出し元の認証情報を付与しません。そのため、署名がクエリ文字列にある署名付き URL がサポートされる形式です。`/api/assets/{id}/content` のような認証済みエンドポイントは、画像ではなく Router に 401 を返します。その URL を自分でリクエストし、リダイレクト先の署名付き URL を渡してください。 -取得はオープンインターネットではなく、名前付きのホストセットに限定されます。同じリストが、送信した URL だけでなく、すべてのリダイレクトホップにも再適用されます。そのため、他のホストの URL、またはリスト外にリダイレクトする URL は、プロバイダーに接触する前に拒否されます。現在、そのリストは Comfy 自身のアセット配信のみです。Comfy アセットバケット配下の署名付き `storage.googleapis.com` URL であり、これは `/api/assets/{id}/content` がリダイレクトする形式です。パートナー CDN や通常の https ホストはリストにありません。 -2つの拡張が展開中であり、どちらも現在デフォルトではオフです。それらは1つの切り替えの背後で提供され、一緒に有効になります。そのため、以下はすべて今後のものとして扱い、まだ依存して構築する対象とはしないでください。どちらかに依存する前に確認してください。 -1つ目は、`POST /customers/storage` がアップロード先として署名するバケットです。ロールアウトがあなたの環境に到達するまで、そのエンドポイントからのアップロード URL はここで拒否されます。バケットは Comfy 自身のものであり、ホストも同じであってもです。そのため「Comfy にアップロードして URL を渡す」はまだ機能せず、機能する形式は `/api/assets/{id}/content` がリダイレクトする署名付き URL です。 -2つ目は、全員に一度にではなくアカウントごとに有効化されます。これらのホストの背後にあるバケットは当社のものではなくあなたのものであるためです。上記の切り替えがオンになっていても、サードパーティの受信メディアが有効化されていないアカウントは拒否され、ホストがサポートされていないと告げられるのではなくその旨の文言で通知されます。あなたの Comfy 担当者にアカウントでの有効化を依頼してください。さらに、以下のサードパーティのオブジェクトストレージホストを許可します。バケットはあなたのものであり、Router はそれに対する所有権を主張しません。Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` および `s3..amazonaws.com`、パス形式または `.` を前置する形式のいずれか)、Azure Blob Storage(`.blob.core.windows.net`)、Alibaba Cloud OSS(`.oss-.aliyuncs.com`、`oss-accelerate` エンドポイントを含む)。これらは特にオブジェクトストレージのエンドポイントです。同じプロバイダードメイン上の汎用エンドポイント、たとえば Alibaba Function Compute のトリガーはリストになく、拒否されます。 -一致するのはホスト名の形式であり、プロバイダーではありません。そのため、上記でプロバイダーを挙げることは、そのプロバイダーが発行できるすべての URL が受け入れられることを意味しません。3つの惜しい例は、呼び出し元がそれぞれを無理なく持ち込む可能性があるため、明確に述べておく価値があります。R2 のカスタムドメイン(`cdn.example.com`)は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限されたデバッグ用ホスト名として文書化し、本番トラフィックは代わりにカスタムドメインに向けますが、カスタムドメインはそのホスト名に R2 であることを示すものを何も含まないため、Router は他のホストと区別できず拒否します。`.r2.cloudflarestorage.com` エンドポイントに署名するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント(`s3.dualstack..amazonaws.com`)も受け入れられません。通常のリージョンエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン(`.z.blob.storage.azure.net`)も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれらの同じ形式が示されるため、ここに来て読む必要はありません。 -上記の `` と `pub-` のプレースホルダーは、通常持ち込む形式を示しています。深さの制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われます。そのため、同じ名前空間のより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。それによって広がらないのは名前空間自体です。サフィックスは依然としてリストにあるものの1つでなければなりません。 -以下の例は形状のみを示しています。実際の値は署名クエリパラメータも含みますが、公開された例は仕様に永遠に残り、実際の署名は漏洩した認証情報であると同時に機能しなくなるリンクでもあるため、ここでは意図的に省略しています。 -各画像は 25 MiB に制限され、1つのリクエストの画像は合計 64 MiB に制限されます。 + 画像1枚を、呼び出し元の代わりに Router が取得する https URL、またはバイト列をインラインで含む `data:image/;base64,` URI のいずれかで指定します。受け付ける画像形式は png、webp、jpeg で、この組み合わせはプロバイダーに委ねるのではなく解決時に強制されます。svg、gif、avif、tiff はここで拒否され、送信した画像を名指しで示します。原因から2ホップ離れたパートナーのエラーにはなりません。 +URL 形式を推奨します。base64 ペイロードは約 4/3 に膨張し、リクエストボディ全体は 100 MiB が上限なので、インライン形式ではソース画像が概ね 75 MB のあたりで上限に達します。URL ならこれを完全に回避できます。この説明の末尾に示す画像あたり・リクエストあたりのメディア上限はボディの上限より厳しいため、実サイズの画像ではまずそちらに当たります。 +URL は認証情報なしで解決できなければなりません。Router はサーバー側で取得し、呼び出し元の認証情報をリクエストに含めません。そのため、署名がクエリ文字列に入っているプレサインド URL がサポートされる形式です。`/api/assets/{id}/content` のような認証が必要なエンドポイントは、画像ではなく 401 を Router に返します。その URL はご自身でリクエストし、リダイレクト先の署名付き URL を渡してください。 +取得は開かれたインターネットではなく、名前を挙げたホスト群に限定されます。同じリストは、送信した URL だけでなく各リダイレクトホップにも再適用されます。したがって、それ以外のホストの URL や、リスト外へリダイレクトする URL は、プロバイダーに接触する前に拒否されます。現時点でそのリストは Comfy 自身のアセット配信のみです。Comfy のアセットバケット配下の署名付き `storage.googleapis.com` URL で、これが `/api/assets/{id}/content` のリダイレクト先となる形式です。パートナーの CDN や通常の https ホストはリストに含まれません。 +2つの拡張がロールアウト中で、どちらも現時点ではデフォルトで無効です。これらは1つの切り替えの背後で提供され、まとめて有効になります。そのため以下はすべて将来のものとして扱い、まだ前提に組み込まないでください。どちらかに依存する前に確認してください。 +1つ目は `POST /customers/storage` がアップロード先として署名するバケットです。ロールアウトがお使いの環境に届くまで、そのエンドポイントが発行するアップロード URL はここで拒否されます。バケットが Comfy 自身のものでホストも同じであってもです。つまり「Comfy にアップロードしてから URL を渡す」はまだ機能せず、機能するのは `/api/assets/{id}/content` がリダイレクトする署名付き URL の形式です。 +2つ目は全員一斉ではなくアカウント単位で有効になります。これらのホストの背後にあるバケットは当社ではなくお客様のものだからです。上記の切り替えがオンになっていても、サードパーティのインバウンドメディアが有効化されていないアカウントは拒否され、ホストが非対応だとは言われず、その旨がそのまま伝えられます。お使いのアカウントで有効にするよう Comfy の担当者に依頼してください。さらに次のサードパーティのオブジェクトストレージホストを許可します。バケットはお客様のものであり、Router はそれに対する所有権を主張しません: Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` および `s3..amazonaws.com`、パス形式または `.` 前置き形式のいずれか)、Azure Blob Storage(`.blob.core.windows.net`)、Alibaba Cloud OSS(`.oss-.aliyuncs.com`、`oss-accelerate` エンドポイントを含む)。これらはあくまでオブジェクトストレージのエンドポイントです。同じプロバイダーのドメイン上の汎用エンドポイント、たとえば Alibaba Function Compute のトリガーはリストになく拒否されます。 +照合されるのはプロバイダーではなくホスト名の形式です。したがって上でプロバイダーを挙げたからといって、そのプロバイダーが発行しうるすべての URL が受け入れられるわけではありません。呼び出し元が妥当に辿り着きうる3つの惜しい形式を明示しておきます。R2 のカスタムドメイン(`cdn.example.com`)は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限のあるデバッグ用ホスト名として文書化し、本番トラフィックはカスタムドメインに向けるよう案内していますが、カスタムドメインのホスト名には R2 であることを示す情報がないため、Router は他のホストと区別できず拒否します。`.r2.cloudflarestorage.com` エンドポイントをプレサインドするか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント(`s3.dualstack..amazonaws.com`)も受け入れられません。通常のリージョン別エンドポイントを使用してください。Azure Blob の別名 DNS ゾーン(`.z.blob.storage.azure.net`)も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージには同じ形式が示されるため、ここに戻って読む必要はありません。 +上記の `` と `pub-` のプレースホルダーは、通常用いる形式を示すものであって、階層の深さの制限ではありません。照合はオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間のより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし名前空間自体が広がるわけではなく、サフィックスは一覧にあるもののいずれかでなければなりません。 +以下の例は形状のみを示しています。実際の値には署名のクエリパラメータも付きますが、ここでは意図的に省略しています。公開された例は仕様の中に永久に残り、実際の署名は漏えいした認証情報であると同時に、やがて機能しなくなるリンクでもあるからです。各画像は 25 MiB、1 回のリクエストの画像は合計 64 MiB までです。唯一の例外は ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)で `context_window` が利用できる場合です。その場合は各画像が最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセルまで、1 回のリクエストの画像は合計 128 MiB までとなります。 - 返す画像の数。それぞれが課金されます。 + 返す画像の数です。各画像が課金対象になります。 範囲: `1` から `8` - 画像の指示または説明。1 から 10,000 文字。 + 画像に対する指示または説明で、1 から 10,000 文字です。 - 品質ティア。これは課金レートでもあります。ソース画像ありの場合: very_low、low、medium、または high(デフォルトは medium)。ソース画像なしの場合: low、medium、または high(デフォルトは high)。テキストから画像へのリクエストで very_low は拒否されます。 + 品質ティアであり、課金レートでもあります。ソース画像がある場合: very_low、low、medium、high(デフォルトは medium)。ソース画像がない場合: low、medium、high(デフォルトは high)。テキストから画像へのリクエストで very_low は拒否されます。 - 指定可能な値: `very_low`、`low`、`medium`、`high` + 可能な値: `very_low`、`low`、`medium`、`high` - Precise Edit 用のオプションの参照画像。`image` が必要です。最大4枚、マスクありの場合は3枚まで。 + Precise Edit 用のオプションの参照画像です。`image` が必要です。最大 4 枚、マスクを使用する場合は 3 枚までです。 - 再現可能な結果のためのシード。 + 再現可能な結果を得るためのシードです。 範囲: `0` から `2147483647` - 生成専用。出力サイズ。auto(デフォルト)、source(画像が必要)、または WIDTHxHEIGHT。マスクを送信する場合は省略してください。両方を設定したリクエストは拒否されます。 + 生成時のみ。出力サイズです。auto(デフォルト)、source(画像が必要)、または WIDTHxHEIGHT。マスクを送信する場合は省略してください。両方を設定したリクエストは拒否されます。 -Router が `GET /v2/models/ideogram/ideogram-4-5/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する対象となるドキュメントと同じです。 +`GET /v2/models/ideogram/ideogram-4-5/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 - 生成済みの画像。 + 生成された画像。 @@ -237,7 +240,7 @@ Router が `GET /v2/models/ideogram/ideogram-4-5/openapi.json` で提供する - 生成済み画像の解像度。 + 生成された画像の解像度。 @@ -245,7 +248,7 @@ Router が `GET /v2/models/ideogram/ideogram-4-5/openapi.json` で提供する - 生成済み画像の URL。 + 生成された画像への URL。 @@ -253,7 +256,7 @@ Router が `GET /v2/models/ideogram/ideogram-4-5/openapi.json` で提供する - この生成に使用されたシード。 + 生成に使用されたシード。 ## 例 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..78d8d20395 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: 56990dce translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": 9c44fce0 + "Schema": c0a0ccaf "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 で拒否されます(ポートが数値であっても範囲外である URL はこのチェックでは捕捉されず、代わりに 502 で失敗する可能性があります)。その場合の正しい形式の https URL については、呼び出し側が修正できる参照はそのホスト名を示して 400 で拒否されます。ホストが解決できない、またはフェッチ前のチェック時に公開到達可能でない、許可された回数を超えてリダイレクトする、https ではない URL や公開到達可能でないホストへリダイレクトする、408 または 429 以外の 4xx を返す、画像ではない、読み取れない形式の画像である、画像サイズヘッダーが最初の 2 MiB 内にない、または宣言された長さがない、しくは chunked エンコーディングのレスポンスが画像サイズヘッダーより前に終了する、といった場合です。それ以外のフェッチ失敗は POST /proxy/krea で 502 エラーになります(Comfy Router はこれを 500 internal_error で返します)。一時的な DNS、TLS、接続の失敗、タイムアウト、オリジンからの 408、429、5xx その他の非 200 ステータス、またはそのチェックを通過したもののフェッチの接続時に解決できない、もしくは公開到達可能でないホストです。他の URL が受け入れられない環境では、実際のアップロードではない app-uploads.krea.ai のリンクは 5xx エラーで失敗します。受け入れられる環境では、他の到達不能な参照と同様に 400 で拒否されます。サーバーがどちらに該当するかをまだ学習していない間は、app-uploads.krea.ai のリンクではないホストを持つ https URL は、公開かどうかに関わらず、再試行しても安全な 503 エラーで失敗します。テキストから画像への生成では省略します。 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..c489584fad 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"; @@ -172,7 +173,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - スタイル/コンテンツのガイダンス用の参照画像。type 'image' では最大 9 枚、type 'image_edit' では最大 8 枚です。 + スタイル/コンテンツのガイダンス用の参照画像。type 'image' の場合は最大 9 枚、type 'image_edit' の場合は最大 8 枚です。 @@ -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,11 +193,11 @@ 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` @@ -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 のうち 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 @@ -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)。 @@ -238,17 +239,17 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/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` - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうち 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 @@ -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 では拒否されます。 + 利用不可: 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` の出力フレーム位置。同じ長さである必要があります。5s の場合は 0–120、10s の場合は 0–240。そのまま転送されます。 - ガイドフレーム画像(1–64)。start_frame/end_frame とは同時に使用できません。指定した再生時間で課金されます。keyframes リクエストが単一キーフレームの延長として扱われることはありません。 + ガイドフレーム画像(1–64)。start_frame/end_frame との併用はできません。指定した再生時間で課金されます。keyframes リクエストが単一キーフレームの延長になることはありません。 @@ -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)。 @@ -310,11 +311,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 つだけを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 - Base64 でエンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオデータ @@ -322,18 +323,18 @@ 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)。 - 公開アクセス可能な画像またはビデオの URL + 一般公開されている画像またはビデオの URL - ウェブ検索グラウンディングを有効にします + 検索グラウンディングを有効にします -`GET /v2/models/luma_2/ray-3.2/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +`GET /v2/models/luma_2/ray-3.2/openapi.json` で Router が公開しているスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使うドキュメントと同じものです。 ### 出力 @@ -348,11 +349,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 人間が読める失敗の説明。失敗した生成時のみ設定されます。成功時は `null` です。 + 人が読める形式の失敗の説明。FAILED の生成時のみ設定されます。成功時は `null` です。 - 生成 ID + 生成の識別子 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..85fc401d89 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,7 +156,7 @@ 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` @@ -167,25 +168,25 @@ 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)。 - 公開アクセス可能な画像またはビデオの URL + 一般にアクセス可能な画像またはビデオの URL - 使用するモデル。画像生成には 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-max/requests/$REQUEST_ID \ - 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうちちょうど 1 つを指定してください。 + 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 @@ -201,41 +202,41 @@ 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)。 - 公開アクセス可能な画像またはビデオの 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 に制限されています。 - 取り得る値: `5s`、`10s` + 指定可能な値: `5s`、`10s` - 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうちちょうど 1 つを指定してください。 + 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 @@ -243,19 +244,19 @@ 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)。 - 公開アクセス可能な画像またはビデオの URL + 一般にアクセス可能な画像またはビデオの URL - 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-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,15 +276,15 @@ 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)。 - 公開アクセス可能な画像またはビデオの URL + 一般にアクセス可能な画像またはビデオの URL @@ -291,36 +292,36 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 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検索のグラウンディングを有効にする -`GET /v2/models/luma_2/uni-1-max/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同じドキュメントです。 +`GET /v2/models/luma_2/uni-1-max/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証するために使用するドキュメントと同じです。 ### 出力 @@ -329,13 +330,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - プログラムで処理するための機械可読な失敗コード + プログラムによる処理のための機械可読な失敗コード - 指定可能な値: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` + Possible values: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` - 人間が読める失敗の説明。FAILED の生成時のみ設定されます。成功時は `null` です。 + 人が読める形式の失敗の説明。FAILED の生成時のみ設定されます。成功時は `null` です。 @@ -347,7 +348,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 生成済み出力のエントリ + 生成された出力エントリ @@ -361,13 +362,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ 生成の現在の状態 - 指定可能な値: `queued`, `processing`, `completed`, `failed` + Possible values: `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` + Possible values: `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..a34699533c 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` @@ -197,7 +198,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - Base64 エンコードされた画像またはビデオデータ + Base64 でエンコードされた画像またはビデオデータ @@ -205,33 +206,33 @@ 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` @@ -239,7 +240,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 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 では拒否されます。 + まだ利用できません: 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/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,21 +280,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 - 生成されたクリップをループします。作成時のみ(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` @@ -301,26 +302,26 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 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 が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 @@ -331,15 +332,15 @@ 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`、`video`、`video_edit`、`video_reframe` + 指定可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` ## 例 diff --git a/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx index d4936f0c68..fb4c682084 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で GPT Image 1.5 を使用する" description: "Comfy Router 経由で openai/gpt-image-1.5 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 1.5" -translationSourceHash: 38ba43fc +translationSourceHash: a1545fc4 translationFrom: development/comfy-router/models/openai/gpt-image-1-5/code.mdx translationBlockHashes: "_intro": 7a84676f "Quick start": f364e3f2 - "Schema": 43008228 + "Schema": 8b660697 "Examples": c73859ec --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-1.5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -172,24 +173,25 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-1.5/requests/$REQUEST_ID \
- 1 つの画像を、Router が呼び出し元に代わって取得する https URL、またはバイト列をインラインで含む `data:image/;base64,` URI のいずれかで指定します。受け付けられる画像形式は png、webp、jpeg で、この集合はプロバイダーに任されるのではなく解決時に強制されます。svg、gif、avif、tiff はここで拒否され、送信した画像が示されます。原因から 2 ホップ離れたパートナーエラーになることはありません。 + 1 つの画像を、Router が呼び出し元に代わって取得する https URL、またはバイト列をインラインで含む `data:image/;base64,` URI のいずれかで指定します。受け付けられる画像形式は png、webp、jpeg で、この集合はプロバイダーに任されるのではなく解決時に強制されます。svg、gif、avif、tiff は、原因から 2 ホップ離れたパートナーエラーになるのではなく、送信した画像を名指ししてここで拒否されます。 URL 形式を推奨します。base64 ペイロードは約 4/3 に膨らみ、リクエストボディ全体は 100 MiB に制限されるため、インライン形式ではソース画像が約 75 MB で上限に達します。URL ならこれを完全に回避できます。この説明の最後に示す画像ごとおよびリクエストごとのメディア上限はボディの上限よりも厳しいため、実用的なサイズの画像ではまずそちらに達します。 URL は認証情報なしで解決できる必要があります。Router はサーバー側で取得し、リクエストに呼び出し元の認証情報を付けません。そのため署名がクエリ文字列にある事前署名済み URL がサポートされる形式です。`/api/assets/{id}/content` のような認証が必要なエンドポイントは、画像ではなく 401 を Router に返します。その URL はご自身でリクエストし、リダイレクト先の署名付き URL を渡してください。 取得は開かれたインターネットではなく、名前を挙げたホスト群に限定されます。同じリストは送信した URL だけでなく、すべてのリダイレクト先にも再適用されます。したがって、それ以外のホストの URL や、リスト外へリダイレクトする URL は、プロバイダーに接続する前に拒否されます。現在このリストは Comfy 自身のアセット配信のみです。Comfy のアセットバケット配下の署名付き `storage.googleapis.com` URL で、`/api/assets/{id}/content` がリダイレクトする形式です。パートナー CDN や通常の https ホストはリストに含まれません。 2 つの拡張が展開中で、どちらも現在はデフォルトで無効です。これらは 1 つの切り替えの背後で提供され、一緒に有効化されます。したがって以下はすべて今後に予定されているものとして扱い、まだそれに依存した実装はしないでください。どちらかに依存する前に確認してください。 1 つ目は `POST /customers/storage` がアップロード先として署名するバケットです。展開がお使いの環境に到達するまで、このエンドポイントから得たアップロード URL はここで拒否されます。バケットは Comfy 自身のものでホストも同じであるにもかかわらずです。そのため「Comfy にアップロードしてから URL を渡す」方法はまだ機能せず、機能するのは `/api/assets/{id}/content` がリダイレクトする署名付き URL です。 -2 つ目は全員に一度にではなくアカウント単位で有効化されます。これらのホストの背後にあるバケットは当社のものではなくお客様のものであるためです。上の切り替えがオンになっていても、サードパーティの受信メディアが有効になっていないアカウントは拒否され、ホストがサポート対象外であるとは告げられず、その文言で通知されます。お使いのアカウントで有効化するよう Comfy の担当者に依頼してください。これにより、バケットがお客様のもので Router が所有権を主張しない以下のサードパーティ オブジェクトストレージ ホストも追加で許可されます: Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` および `s3..amazonaws.com`、パス形式または `.` を先頭に付ける形式のいずれか)、Azure Blob Storage(`.blob.core.windows.net`)、Alibaba Cloud OSS(`.oss-.aliyuncs.com`、`oss-accelerate` エンドポイントを含む)。これらは具体的にはオブジェクトストレージのエンドポイントです。同じプロバイダーのドメイン上の汎用エンドポイント、たとえば Alibaba Function Compute のトリガーはリストに含まれず拒否されます。 +2 つ目は全員に一度にではなくアカウント単位で有効化されます。これらのホストの背後にあるバケットは当社のものではなくお客様のものであるためです。上の切り替えがオンになっていても、サードパーティの受信メディアが有効になっていないアカウントは拒否され、ホストがサポート対象外であると告げられるのではなく、その旨がそのままの文言で通知されます。お使いのアカウントで有効化するよう Comfy の担当者に依頼してください。これにより、バケットがお客様のもので Router が所有権を主張しない以下のサードパーティ オブジェクトストレージ ホストも追加で許可されます: Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` および `s3..amazonaws.com`、パス形式または `.` を先頭に付ける形式のいずれか)、Azure Blob Storage(`.blob.core.windows.net`)、Alibaba Cloud OSS(`.oss-.aliyuncs.com`、`oss-accelerate` エンドポイントを含む)。これらは具体的にはオブジェクトストレージのエンドポイントです。同じプロバイダーのドメイン上の汎用エンドポイント、たとえば Alibaba Function Compute のトリガーはリストに含まれず拒否されます。 照合されるのはプロバイダーではなくホスト名の形式です。したがって上でプロバイダーを挙げたからといって、そのプロバイダーが発行しうるすべての URL が受け入れられるわけではありません。呼び出し元がそれぞれに到達するのは自然なことなので、紛らわしい 3 つのケースを明示しておきます。R2 のカスタムドメイン(`cdn.example.com`)は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限のあるデバッグ用ホスト名として文書化し、本番トラフィックはカスタムドメインに向けるよう案内していますが、カスタムドメインのホスト名には R2 であることを示す情報がないため、Router は他のホストと区別できず拒否します。`.r2.cloudflarestorage.com` エンドポイントに署名するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント(`s3.dualstack..amazonaws.com`)も受け入れられません。通常のリージョナルエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン(`.z.blob.storage.azure.net`)も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれと同じ形式が記載されているため、それらを読むためにここに来る必要はありません。上記の `` と `pub-` というプレースホルダーは、通常アクセスする際の形式を示すものであり、階層の制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間の下にあるより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、それによって広がるわけではないのは名前空間そのものです。サフィックスは依然として列挙されたもののいずれかでなければなりません。 +上記の `` と `pub-` プレースホルダーは、通常たどり着く形式を示したものであり、深さの制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間配下のより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、それによって広がるわけではないのは名前空間そのものです。サフィックスは依然として列挙されたもののいずれかでなければなりません。 以下の例は形状のみを示しています。実際の値には署名用のクエリパラメータも含まれますが、ここでは意図的に省略しています。公開された例は仕様の中に永久に残り、実際の署名は漏えいした認証情報であると同時に、やがて機能しなくなるリンクでもあるためです。 -各画像は 25 MiB、1 つのリクエストの画像は合計 64 MiB に制限されます。 +各画像は 25 MiB、1 回のリクエストの画像は合計 64 MiB に制限されます。唯一の例外は ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)で `context_window` が利用可能な場合です。その場合は各画像が最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセル、1 回のリクエストの画像は合計最大 128 MiB となります。 - 実行する gpt-image モデル。Router がアドレス指定されたモデル id を差し込むため、/v2/models/openai/gpt-image-2 をアドレス指定する呼び出し元はこれを送信しません。 + 実行する gpt-image モデル。Router がアドレス指定されたモデル ID を差し込むため、/v2/models/openai/gpt-image-2 を指定する呼び出し元はこれを送信しません。 - コンテンツモデレーションの設定 + コンテンツモデレーション設定 指定可能な値: `low`, `auto` @@ -213,7 +215,7 @@ URL は認証情報なしで解決できる必要があります。Router はサ
- ライブストリームと併用する場合にのみ意味を持ちますが、このサーフェスではそれを提供できません。`stream` は送信しても `false` に確定されます。生成時、`0` または `null` 以外の値は、リクエストが `stream: true` も送信しているかどうかに関わらず、400 で拒否されます。`image` を含むリクエストでは、このフィールドは転送されずに破棄されます。省略してください。 + ライブストリームと併用する場合にのみ意味を持ちますが、このサーフェスではライブストリームを提供できません。`stream` を送信しても `false` に確定されます。生成時には、リクエストが `stream: true` も送信するかどうかに関わらず、`0` または `null` 以外の値は 400 で拒否されます。`image` を含むリクエストでは、このフィールドは転送されずに破棄されます。省略してください。 範囲: `0` 〜 `3` @@ -223,17 +225,17 @@ URL は認証情報なしで解決できる必要があります。Router はサ
- 生成または編集された画像の品質。`xhigh` と `max` は gpt-image-2.5-flare と gpt-image-2.5-sunburst が追加された 2 つのティアです。`standard` と `hd` は dall-e 時代の表記であり、採用されているどのモデルも読み取りません。 + 生成または編集された画像の品質。`xhigh` と `max` は gpt-image-2.5-flare と gpt-image-2.5-sunburst のために追加された 2 つのティアです。`standard` と `hd` は dall-e 時代の綴りであり、受け入れられているどのモデルも解釈しません。 指定可能な値: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` - 画像のサイズ(例: 1024x1024、1536x1024、auto) + 画像のサイズ(例: 1024x1024, 1536x1024, auto) - これを送信する呼び出し元が拒否されないように宣言されていますが、このサーフェスでは無効です。Router はディスパッチ前にこれを `false` に確定します。これは `text/event-stream` を中継するのではなく、プロバイダーのレスポンスを取得するためです(`image` を含むリクエストでは、編集がそれを含めずに再エンコードされるため、代わりにフィールドが破棄されます)。どの Comfy サーフェスも gpt-image の partial-image ストリーミングを提供していません。v1 の `POST /proxy/openai/images/generations` イングレスは `stream: true` を 400 で拒否し、リクエストを上流に転送することはありません。そのため、フィールドを省略し、完了したレスポンスを 1 つの JSON ボディとして読み取ってください。ストリームが開かれることはないため、`stream: true` と 1 より大きい `n` の組み合わせに対する OpenAI の制限はここでは適用されません。`n` は送信されたまま転送されます。 + 送信した呼び出し元が拒否されないように宣言されていますが、このサーフェスでは無効です。Router はディスパッチ前にこれを `false` に確定します。`text/event-stream` を中継するのではなく、プロバイダーのレスポンスをキャプチャするためです(`image` を含むリクエストでは、編集がそれを付けずに再エンコードされるため、代わりにこのフィールドが破棄されます)。Comfy のどのサーフェスも gpt-image の部分画像ストリーミングを提供しません。v1 の `POST /proxy/openai/images/generations` イングレスは `stream: true` を 400 で拒否し、リクエストを上流へ転送することはありません。そのため、このフィールドは省略し、完了したレスポンスを 1 つの JSON ボディとして読み取ってください。ストリームが開かれることはないため、`stream: true` と 1 より大きい `n` の組み合わせに関する OpenAI の制限はここでは適用されません。`n` は送信されたとおりに転送されます。 diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx index beead5fb94..623495fbfc 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx @@ -2,13 +2,13 @@ title: "GPT Image 2.5 Flare を Comfy Router で使う" description: "Comfy Router 経由で openai/gpt-image-2.5-flare を呼び出します: endpoint、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 2.5 Flare" -translationSourceHash: 48fb6d21 +translationSourceHash: e3a1017e translationFrom: development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx translationBlockHashes: "_intro": 1e1ed044 "Quick start": c9749309 "Serving providers": ef0e9384 - "Schema": 122f72c5 + "Schema": a7048d34 "Examples": c73859ec --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/openai/gpt-image-2.5-flare.json から生成されています。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,19 +193,19 @@ URL は認証情報なしで解決できる必要があります。Router はサ 1 つ目は、`POST /customers/storage` がアップロード先として署名するバケットです。ロールアウトがお使いの環境に届くまで、そのエンドポイントからのアップロード URL はここで拒否されます。バケットは Comfy 自身のものでホストも同じであっても拒否されます。つまり「Comfy にアップロードしてから URL を渡す」はまだ動作せず、動作するのは `/api/assets/{id}/content` がリダイレクトする署名付き URL です。 2 つ目は、全員に一度にではなくアカウントごとに有効化されます。これらのホストの背後にあるバケットは当社ではなくお客様のものだからです。上記の切り替えがオンになっても、サードパーティの受信メディアが有効化されていないアカウントは拒否され、ホストが非対応だと言われるのではなく、その旨がそのまま伝えられます。お使いのアカウントで有効化するよう Comfy の担当者に依頼してください。さらに、次のサードパーティのオブジェクトストレージホストを許可します。ここではバケットはお客様のものであり、Router はその所有権を主張しません: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`)、Amazon S3 (`s3.amazonaws.com` と `s3..amazonaws.com`、パス形式または `.` プレフィックス形式のいずれか)、Azure Blob Storage (`.blob.core.windows.net`)、Alibaba Cloud OSS (`.oss-.aliyuncs.com`、`oss-accelerate` エンドポイントを含む)。これらは特にオブジェクトストレージのエンドポイントです。同じプロバイダードメイン上の汎用エンドポイント、たとえば Alibaba Function Compute のトリガーはリストになく、拒否されます。 マッチングされるのはホスト名の形式であり、プロバイダーではありません。そのため、上でプロバイダー名を挙げたからといって、そのプロバイダーが発行できるすべての URL が受け入れられるわけではありません。呼び出し元がそれぞれのケースに到達するのはもっともなことなので、惜しい 3 つのケースを明示しておく価値があります。R2 のカスタムドメイン (`cdn.example.com`) は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限されたデバッグ用ホスト名として文書化し、本番トラフィックは代わりにカスタムドメインに向けるよう案内していますが、カスタムドメインのホスト名には R2 であると識別する情報がないため、Router は他のホストと区別できず拒否します。`.r2.cloudflarestorage.com` エンドポイントを署名するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント (`s3.dualstack..amazonaws.com`) も受け入れられません。通常のリージョンエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン (`.z.blob.storage.azure.net`) も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれらの同じ形式が記載されているので、それらを読むためにここへ来る必要はありません。 -上記の `` と `pub-` プレースホルダーは、通常アクセスする際の形式を示すものであり、深さの制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間内のより深い名前(`a.b.pub-.r2.dev`)も受け付けられます。ただし、これによって名前空間自体が広がるわけではありません。サフィックスは依然として列挙されているもののいずれかでなければなりません。 -以下の例は形状のみを示しています。実際の値には署名用のクエリパラメータも含まれますが、ここでは意図的に省略しています。公開された例は仕様の中に永久に残り、本物の署名は漏洩した認証情報であると同時に、やがて機能しなくなるリンクでもあるためです。 -各画像は 25 MiB、1 回のリクエストの画像は合計 64 MiB に制限されています。 +上記の `` と `pub-` プレースホルダーは、通常使用する形式を示しています。これらは深さの制限ではありません。一致判定はオブジェクトストレージのドメインサフィックスに基づいて行われるため、同じ名前空間内のより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、これによって名前空間自体が広がるわけではありません。サフィックスは依然として一覧にあるもののいずれかでなければなりません。 +以下の例は形状のみを示しています。実際の値には署名クエリパラメータも含まれますが、ここでは意図的に省略しています。公開された例は仕様の中に永久に残り、実際の署名は漏洩した認証情報であると同時に、機能しなくなるリンクでもあるためです。 +各画像は 25 MiB まで、1 回のリクエストの画像は合計 64 MiB までに制限されています。唯一の例外は ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)で `context_window` が利用可能な場合です。その場合、各画像は最大 50 MB(50,000,000 バイト)および 67,108,864 ピクセルまで、1 回のリクエストの画像は合計 128 MiB までとなります。 - 実行する gpt-image モデル。Router がアドレス指定されたモデル id を挿入するため、/v2/models/openai/gpt-image-2 をアドレス指定する呼び出し元はこれを送信しません。 + 実行する gpt-image モデル。Router がアドレス指定されたモデル ID を差し込むため、/v2/models/openai/gpt-image-2 をアドレス指定する呼び出し元はこれを送信しません。 コンテンツモデレーション設定 - 取り得る値: `low`, `auto` + 可能な値: `low`、`auto` @@ -220,25 +221,25 @@ URL は認証情報なしで解決できる必要があります。Router はサ - 出力画像のフォーマット + 出力画像の形式 - 取り得る値: `png`, `webp`, `jpeg` + 可能な値: `png`、`webp`、`jpeg` - ライブストリームと併用する場合にのみ意味を持ちますが、このサーフェスはそれを提供できません。`stream` は送信した場合でも `false` に確定されます。生成時には、リクエストが `stream: true` も送信しているかどうかに関わらず、`0` または `null` 以外の値は 400 で拒否されます。`image` を含むリクエストでは、このフィールドは転送されずに破棄されます。このフィールドは省略してください。 + ライブストリームと併用する場合にのみ意味がありますが、このサーフェスはライブストリームを提供できません。`stream` は送信しても `false` に確定されます。生成時には、`0` または `null` 以外の値は、リクエストが `stream: true` も送信するかどうかにかかわらず、400 で拒否されます。`image` を含むリクエストでは、このフィールドは転送されずに破棄されます。省略してください。 範囲: `0` から `3` - 生成する画像の、または `image` に対して行う編集のテキスト記述。 + 生成する画像、または `image` に対して行う編集のテキスト説明。 - 生成または編集された画像の品質。`xhigh` と `max` は、gpt-image-2.5-flare と gpt-image-2.5-sunburst が追加された 2 つのティアです。`standard` と `hd` は dall-e 時代の表記であり、受け入れられているどのモデルも解釈しません。 + 生成または編集された画像の品質。`xhigh` と `max` は、gpt-image-2.5-flare と gpt-image-2.5-sunburst のために追加された 2 つのティアです。`standard` と `hd` は dall-e 時代の表記であり、受け入れ済みのどのモデルも解釈しません。 - 取り得る値: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` + 可能な値: `auto`、`low`、`medium`、`high`、`xhigh`、`max`、`standard`、`hd` @@ -246,11 +247,11 @@ URL は認証情報なしで解決できる必要があります。Router はサ - 送信した呼び出し元が拒否されないように宣言されていますが、このサーフェスでは無効です。Router はディスパッチ前にこれを `false` に確定します。これは、`text/event-stream` を中継するのではなくプロバイダーの応答をキャプチャするためです(`image` を含むリクエストでは、編集がそれを付けずに再エンコードされるため、代わりにこのフィールドが破棄されます)。どの Comfy サーフェスも gpt-image の partial-image ストリーミングを提供していません。v1 の `POST /proxy/openai/images/generations` イングレスは `stream: true` を 400 で拒否し、リクエストを上流へ転送することはありません。したがって、このフィールドは省略し、完了した応答を 1 つの JSON ボディとして読み取ってください。ストリームが開かれることはないため、`stream: true` と 1 より大きい `n` の併用に関する OpenAI の制限はここでは適用されません。`n` は送信されたとおりに転送されます。 + これを送信する呼び出し元が拒否されないように宣言されていますが、このサーフェスでは無効です。Router はディスパッチ前にこれを `false` に確定します。これは、`text/event-stream` を中継するのではなくプロバイダーの応答をキャプチャするためです(`image` を含むリクエストでは、編集がそれを付けずに再エンコードされるため、代わりにこのフィールドが破棄されます)。どの Comfy サーフェスも gpt-image の partial-image ストリーミングを提供していません。v1 の `POST /proxy/openai/images/generations` イングレスは `stream: true` を 400 で拒否し、リクエストを上流へ転送することはありません。したがって、このフィールドは省略し、完了した応答を 1 つの JSON ボディとして読み取ってください。ストリームが開かれることはないため、`stream: true` と 1 より大きい `n` の併用に関する OpenAI の制限はここでは適用されません。`n` は送信されたとおりに転送されます。 - エンドユーザーの監視用の一意の識別子 + エンドユーザー監視用の一意の識別子 Router が `GET /v2/models/openai/gpt-image-2.5-flare/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する対象となるドキュメントと同じものです。 @@ -314,7 +315,7 @@ Router が `GET /v2/models/openai/gpt-image-2.5-flare/openapi.json` で提供す - 生成された画像の背景が `opaque` か `transparent` か。OpenAI がこの生成に対して解決した値です。リクエストパラメータのデフォルトは `auto` なので、ピン留めしなかった呼び出し元はここでどちらが生成されたかを知ることができます。 + 生成された画像の背景が `opaque` か `transparent` か。OpenAI がこの生成に対して解決した値です。リクエストパラメータのデフォルトは `auto` なので、ピン留めしなかった呼び出し元はここでどちらが生成されたのかを確認できます。 diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx index b6d99e265a..1db01aae15 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router で GPT Image 2.5 Sunburst を使う" description: "Comfy Router 経由で openai/gpt-image-2.5-sunburst を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 2.5 Sunburst" -translationSourceHash: 21e3a50f +translationSourceHash: 89d64476 translationFrom: development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx translationBlockHashes: "_intro": 84874630 "Quick start": 8da85011 "Serving providers": 58af0c87 - "Schema": 8eff0738 + "Schema": 61c5bb52 "Examples": c73859ec --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/openai/gpt-image-2.5-sunburst.json から生成されています。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -194,27 +195,27 @@ URL は認証情報なしで解決できなければなりません。Router は 照合されるのはプロバイダーではなくホスト名の形式です。そのため、上にプロバイダー名を挙げたからといって、そのプロバイダーが発行しうるすべての URL が受け入れられるわけではありません。呼び出し元がそれぞれに妥当にたどり着きうる 3 つの惜しい例は、はっきり述べておく価値があります。R2 のカスタムドメイン (`cdn.example.com`) は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限のあるデバッグ用ホスト名として文書化し、本番トラフィックは代わりにカスタムドメインに向けるよう案内しています。しかしカスタムドメインのホスト名には R2 であることを示すものが何も含まれないため、Router は他のホストと区別できず拒否します。`.r2.cloudflarestorage.com` エンドポイントに署名するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント (`s3.dualstack..amazonaws.com`) も受け入れられません。通常のリージョナルエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン (`.z.blob.storage.azure.net`) も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれらの同じ形式が記載されているので、それらを読むためにここに来る必要はありません。 上記の `` と `pub-` プレースホルダーは、通常たどり着く形式を示したものであり、深さの制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間配下のより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、それによって広がるわけではないのは名前空間そのものです。サフィックスは依然として列挙されたもののいずれかでなければなりません。 下の例は形状のみを示しています。実際の値には署名クエリパラメータも含まれますが、ここでは意図的に省略しています。公開された例はスペックに永遠に残り、実際の署名は漏洩した認証情報であると同時に機能しなくなるリンクでもあるためです。 -各画像は 25 MiB に制限され、1 回のリクエストの画像は合計で 64 MiB に制限されます。 +各画像は 25 MiB、1 回のリクエストの画像は合計 64 MiB に制限されます。唯一の例外は、`context_window` が利用可能な ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)です。そこでは各画像は最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセルまで、1 回のリクエストの画像は合計最大 128 MiB まで可能です。
- 実行する gpt-image モデル。Router がアドレス指定されたモデル ID を組み込むため、/v2/models/openai/gpt-image-2 をアドレス指定する呼び出し元はこれを送信しません。 + 実行する gpt-image モデル。Router はアドレス指定されたモデル ID を差し込むため、/v2/models/openai/gpt-image-2 をアドレス指定する呼び出し元はこれを送信しません。 コンテンツモデレーション設定 - 指定可能な値: `low`, `auto` + 指定可能な値: `low`、`auto` - 生成する画像の数(1〜10)。 + 生成する画像の数(1-10)。 範囲: `1` から `10` - JPEG または WebP の圧縮レベル(0〜100) + JPEG または WebP の圧縮レベル(0-100) 範囲: `0` から `100` @@ -222,23 +223,23 @@ URL は認証情報なしで解決できなければなりません。Router は 出力画像の形式 - 指定可能な値: `png`, `webp`, `jpeg` + 指定可能な値: `png`、`webp`、`jpeg` - ライブストリームと併用する場合にのみ意味を持ちますが、このサーフェスはそれを提供できません。`stream` は送信した場合でも `false` に確定されます。生成時には、`0` または `null` 以外の値は 400 で拒否されます。これはリクエストが `stream: true` も送信しているかどうかに関係ありません。`image` を含むリクエストでは、このフィールドは転送されずに破棄されます。省略してください。 + このサーフェスでは提供できないライブストリームと併用する場合にのみ意味があります。`stream` を送信しても `false` に確定されます。生成時には、リクエストが `stream: true` も送信するかどうかにかかわらず、`0` または `null` 以外の値は 400 で拒否されます。`image` を含むリクエストでは、このフィールドは転送されずに破棄されます。省略してください。 範囲: `0` から `3` - 生成する画像の説明、または `image` に対して行う編集の説明となるテキスト。 + 生成する画像、または `image` に行う編集のテキスト説明。 - 生成または編集された画像の品質。`xhigh` と `max` は gpt-image-2.5-flare と gpt-image-2.5-sunburst が追加された 2 つのティアです。`standard` と `hd` は dall-e 時代の表記であり、採用されているどのモデルも読み取りません。 + 生成または編集された画像の品質。`xhigh` と `max` は、gpt-image-2.5-flare と gpt-image-2.5-sunburst が追加された 2 つのティアです。`standard` と `hd` は dall-e 時代の表記であり、受け入れられているどのモデルも解釈しません。 - 指定可能な値: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` + 指定可能な値: `auto`、`low`、`medium`、`high`、`xhigh`、`max`、`standard`、`hd` @@ -246,7 +247,7 @@ URL は認証情報なしで解決できなければなりません。Router は - 送信した呼び出し元が拒否されないように宣言されていますが、このサーフェスでは無効です。Router はディスパッチ前にこれを `false` に確定します。Router は `text/event-stream` を中継するのではなくプロバイダーのレスポンスをキャプチャするためです(`image` を含むリクエストでは、編集がそれを含めずに再エンコードされるため、このフィールドは代わりに破棄されます)。Comfy のどのサーフェスも gpt-image の部分画像ストリーミングを提供していません。v1 の `POST /proxy/openai/images/generations` 入口は `stream: true` を 400 で拒否し、リクエストを上流に転送しません。したがってこのフィールドは省略し、完了したレスポンスを 1 つの JSON ボディとして読んでください。ストリームが開かないため、`stream: true` と 1 より大きい `n` を組み合わせることに関する OpenAI の制限はここでは適用されません。`n` は送信されたまま転送されます。 + 送信する呼び出し元が拒否されないように宣言されていますが、このサーフェスでは無効です。Router はディスパッチ前にこれを `false` に確定します。Router は `text/event-stream` を中継するのではなくプロバイダーのレスポンスをキャプチャするためです(`image` を含むリクエストでは、編集がそれを含めずに再エンコードされるため、このフィールドは代わりに破棄されます)。Comfy のどのサーフェスも gpt-image の部分画像ストリーミングを提供していません。v1 の `POST /proxy/openai/images/generations` 入口は `stream: true` を 400 で拒否し、リクエストを上流に転送しません。したがってこのフィールドは省略し、完了したレスポンスを 1 つの JSON ボディとして読んでください。ストリームが開かないため、`stream: true` と 1 より大きい `n` を組み合わせることに関する OpenAI の制限はここでは適用されません。`n` は送信されたまま転送されます。 diff --git a/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx index c52eba0e3c..e7ed38190f 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router で GPT Image 2 を使用する" description: "Comfy Router 経由で openai/gpt-image-2 を呼び出す方法: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 2" -translationSourceHash: 6437f5f1 +translationSourceHash: b9cb8af5 translationFrom: development/comfy-router/models/openai/gpt-image-2/code.mdx translationBlockHashes: "_intro": ff220f7e "Quick start": 7ec2e3b6 "Serving providers": 56df172f - "Schema": 0ebd1b14 + "Schema": 4e6e5e53 "Examples": c73859ec --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -193,29 +194,31 @@ URL は認証情報なしで解決できなければなりません。Router は 1 つ目は、`POST /customers/storage` がアップロード先として署名するバケットです。展開がお使いの環境に到達するまでは、そのエンドポイントから得たアップロード URL はここで拒否されます。バケットは Comfy 自身のものでホストも同じであるにもかかわらずです。そのため「Comfy にアップロードしてから URL を渡す」方法はまだ機能せず、機能するのは `/api/assets/{id}/content` がリダイレクトする署名付き URL です。 2 つ目は、全員に対して一度にではなく、アカウントごとに有効になります。これらのホストの背後にあるバケットは当社のものではなくお客様のものであるためです。上記の切り替えがオンになっていても、サードパーティの受信メディアが有効化されていないアカウントは拒否され、ホストが未サポートだと言われるのではなく、その旨の文言で通知されます。お使いのアカウントで有効にするよう Comfy の担当者に依頼してください。これはさらに、以下のサードパーティのオブジェクトストレージホストを許可します。ここではバケットはお客様のものであり、Router はその所有権を主張しません: Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` および `s3..amazonaws.com`、path-style 形式または `.` プレフィックス形式のいずれか)、Azure Blob Storage(`.blob.core.windows.net`)、Alibaba Cloud OSS(`.oss-.aliyuncs.com`、`oss-accelerate` エンドポイントを含む)。これらは特にオブジェクトストレージのエンドポイントです。同じプロバイダードメイン上の汎用エンドポイント、たとえば Alibaba Function Compute のトリガーはリストに含まれず、拒否されます。 照合されるのはプロバイダーではなくホスト名の形式です。したがって、上でプロバイダーを挙げたからといって、そのプロバイダーが発行できるすべての URL が受け入れられるわけではありません。呼び出し元がこれらのいずれかを使ってしまうのはもっともなことなので、紛らわしい 3 つのケースを明示しておきます。R2 のカスタムドメイン(`cdn.example.com`)は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限のあるデバッグ用ホスト名として文書化し、本番トラフィックはカスタムドメインに向けるよう案内していますが、カスタムドメインのホスト名には R2 であることを示す情報がないため、Router は他のホストと区別できず拒否します。`.r2.cloudflarestorage.com` エンドポイントの署名付き URL を生成するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント(`s3.dualstack..amazonaws.com`)も受け入れられません。通常のリージョナルエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン(`.z.blob.storage.azure.net`)も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれらの同じ形式が記載されているので、それらを読むためにここに来る必要はありません。 -上記の `` と `pub-` というプレースホルダーは、通常アクセスする際の形式を示すものであり、階層の制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間の下にあるより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、それによって広がるわけではないのは名前空間そのものです。サフィックスは依然として列挙されたもののいずれかでなければなりません。 -以下の例は形状のみを示しています。実際の値には署名用のクエリパラメータも含まれますが、ここでは意図的に省略しています。公開された例は仕様の中に永久に残り、実際の署名は漏えいした認証情報であると同時に、やがて機能しなくなるリンクでもあるためです。 -各画像は 25 MiB、1 つのリクエストの画像は合計 64 MiB に制限されます。 +上記の `` と `pub-` のプレースホルダーは、通常扱う形式を示すものであり、深さの制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間の下にあるより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、これによって名前空間自体が広がるわけではありません。サフィックスは依然として一覧に記載されたもののいずれかでなければなりません。 + +以下の例は形状のみを示しています。実際の値には署名用のクエリパラメータも含まれますが、ここでは意図的に省略しています。公開された例は仕様に永久に残り、実際の署名は漏えいした認証情報であると同時に、機能しなくなるリンクでもあるためです。 + +各画像は 25 MiB に制限され、1 回のリクエストの画像は合計 64 MiB に制限されます。唯一の例外は ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)で `context_window` が利用可能な場合です。そこでは各画像は最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセルまで、1 回のリクエストの画像は合計 128 MiB まで可能です。 - 実行する gpt-image モデル。Router がアドレス指定されたモデル id を挿入するため、/v2/models/openai/gpt-image-2 をアドレス指定する呼び出し元はこれを送信しません。 + 実行する gpt-image モデル。Router はアドレス指定されたモデル ID を挿入するため、/v2/models/openai/gpt-image-2 をアドレス指定する呼び出し元はこれを送信しません。 コンテンツモデレーション設定 - 指定可能な値: `low`, `auto` + 可能な値: `low`、`auto` - 生成する画像の数(1〜10)。 + 生成する画像の数(1-10)。 範囲: `1` から `10` - JPEG または WebP の圧縮レベル(0〜100) + JPEG または WebP の圧縮レベル(0-100) 範囲: `0` から `100` @@ -223,23 +226,23 @@ URL は認証情報なしで解決できなければなりません。Router は 出力画像の形式 - 指定可能な値: `png`, `webp`, `jpeg` + 可能な値: `png`、`webp`、`jpeg` - ライブストリームと併用する場合にのみ意味を持ちますが、このサーフェスはそれを提供できません。`stream` は送信した場合でも `false` に確定されます。生成時には、`0` または `null` 以外の値は、リクエストが `stream: true` も送信するかどうかに関わらず 400 で拒否されます。`image` を含むリクエストでは、このフィールドは転送されずに破棄されます。省略してください。 + ライブストリームと併用する場合にのみ意味を持ちますが、このサーフェスでは提供できません。送信した場合でも `stream` は `false` に確定されます。生成時には、リクエストが `stream: true` も送信するかどうかに関係なく、`0` または `null` 以外の値は 400 で拒否されます。`image` を含むリクエストでは、このフィールドは転送されずに破棄されます。省略してください。 範囲: `0` から `3` - 生成する画像、または `image` に対して行う編集のテキスト記述。 + 生成する画像、または `image` に加える編集についてのテキスト説明。 - 生成または編集された画像の品質。`xhigh` と `max` は gpt-image-2.5-flare と gpt-image-2.5-sunburst が追加された 2 つのティアです。`standard` と `hd` は dall-e 時代の表記であり、認められたどのモデルも解釈しません。 + 生成済みまたは編集済みの画像の品質。`xhigh` と `max` は gpt-image-2.5-flare および gpt-image-2.5-sunburst が追加された 2 つの階層です。`standard` と `hd` は dall-e 時代の表記で、受け入れられているどのモデルも解釈しません。 - 指定可能な値: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` + 可能な値: `auto`、`low`、`medium`、`high`、`xhigh`、`max`、`standard`、`hd` @@ -247,7 +250,7 @@ URL は認証情報なしで解決できなければなりません。Router は - 送信した呼び出し元が拒否されないように宣言されていますが、このサーフェスでは無効です。Router はディスパッチ前にこれを `false` に確定します。Router は `text/event-stream` を中継するのではなくプロバイダーのレスポンスをキャプチャするためです(`image` を含むリクエストでは、編集がそれを含めずに再エンコードされるため、このフィールドは代わりに破棄されます)。Comfy のどのサーフェスも gpt-image の部分画像ストリーミングを提供していません。v1 の `POST /proxy/openai/images/generations` 入口は `stream: true` を 400 で拒否し、リクエストを上流に転送しません。したがってこのフィールドは省略し、完了したレスポンスを 1 つの JSON ボディとして読んでください。ストリームが開かないため、`stream: true` と 1 より大きい `n` を組み合わせることに関する OpenAI の制限はここでは適用されません。`n` は送信されたまま転送されます。 + 送信する呼び出し元が拒否されないように宣言されていますが、このサーフェスでは無効です。Router はディスパッチ前にこれを `false` に確定します。これは、`text/event-stream` を中継するのではなく、プロバイダーの応答をキャプチャするためです(`image` を含むリクエストでは、編集がそれなしで再エンコードされるため、代わりにこのフィールドが破棄されます)。Comfy のどのサーフェスも gpt-image の部分画像ストリーミングを提供しません。v1 の `POST /proxy/openai/images/generations` イングレスは `stream: true` を 400 で拒否し、リクエストをアップストリームに転送することはありません。そのため、このフィールドを省略し、完了した応答を 1 つの JSON ボディとして読み取ってください。ストリームが決して開かれないため、`stream: true` と 1 より大きい `n` の組み合わせに対する OpenAI の制限はここでは適用されません。`n` は送信されたまま転送されます。 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..e2a40de4ac 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..b797904cb5 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。オーディオが呼び出しごとの入力上限を超えている場合は 400 で拒否されます。 diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index f5eb2d8754..fd47f1f242 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: a6f99965 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 - "Result assets": 65fc939b + "Pre-flight cost estimates": 5952af3f + "Result assets": 18fe6dad "Per-model input and output schemas": 61c6bde8 - "Schemas": 77cfa4db + "Schemas": 984bd216 --- @@ -27,6 +27,8 @@ translationBlockHashes: + + {/* 生成済みファイル: 手動で編集しないでください。 @@ -49,7 +51,7 @@ Comfy API キーは Bearer トークンとして送信することもできま ### `GET /v2/models` -**Comfy Router が実行できるモデルを一覧表示します。** +**Comfy Router で実行できるモデルを一覧表示します。** 利用可能なモデル ID と課金情報を一覧表示します。`has_more` が true の間は `next_cursor` を使用します。 @@ -58,7 +60,7 @@ Comfy API キーは Bearer トークンとして送信することもできま 不透明なページネーションカーソル。 - Type: [`RouterPageCursor`](#routerpagecursor) -- `next_cursor` として返される不透明なカーソル、1〜512 文字 + 型: [`RouterPageCursor`](#routerpagecursor):`next_cursor` として返される不透明なカーソル、1~512 文字 @@ -76,7 +78,7 @@ Comfy API キーは Bearer トークンとして送信することもできま OK - モデルカタログの 1 ページ。 - Body: [`RouterModelListResponse`](#routermodellistresponse) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` + ボディ: [`RouterModelListResponse`](#routermodellistresponse)、ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` @@ -88,45 +90,45 @@ Comfy API キーは Bearer トークンとして送信することもできま 無効なリクエストです。エラータイプとリクエストボディを確認してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 認証情報が不足しているか、無効です。 + 認証情報が不足しているか無効です。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - この呼び出し元またはモデルに対して、このリクエストは許可されていません。 + この呼び出し元またはモデルでは、このリクエストは許可されていません。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router は一時的に利用できません。バックオフして再試行してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}` -**正規のモデル ID でパートナーモデル1件のカタログエントリを取得します。** +**正規のモデル ID で 1 つのパートナーモデルのカタログエントリを取得します。** -カタログ全体を一覧表示せずに、1つのモデルの詳細を読み取ります。 +カタログ全体を一覧せずに、1 つのモデルの詳細を取得します。 **パラメータ** 正規の `{provider}/{model}` モデル ID のプロバイダー部分。 - 型: [`RouterProviderSegment`](#routerprovidersegment)。英数字のスラッグ(例: `anthropic`)、最大64文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字 正規の `{provider}/{model}` モデル ID のモデル部分。 - 型: [`RouterModelSegment`](#routermodelsegment)。英数字のスラッグ(例: `claude-opus-4-6`)、最大128文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 @@ -136,13 +138,13 @@ Comfy API キーは Bearer トークンとして送信することもできま **レスポンス** - OK: モデルのカタログエントリ。 + OK - モデルのカタログエントリ。 - ボディ: [`RouterModelDetail`](#routermodeldetail)。ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` + ボディ: [`RouterModelDetail`](#routermodeldetail) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` - Not Modified: 呼び出し元が `If-None-Match` で送信した `ETag` 以降、エントリは変更されていません。 + Not Modified - `If-None-Match` で呼び出し元が送信した `ETag` 以降、エントリは変更されていません。 ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` @@ -150,30 +152,30 @@ Comfy API キーは Bearer トークンとして送信することもできま 認証情報が不足しているか無効です。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` この呼び出し元またはモデルでは、このリクエストは許可されていません。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router は一時的に利用できません。バックオフして再試行してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}` -**正規のモデル ID でパートナーモデルを同期的に実行します。** +**正規のモデル ID を指定してパートナーモデルを同期的に実行します。** モデルを実行し、完了した結果を同じレスポンスで受け取ります。 @@ -182,37 +184,37 @@ Comfy API キーは Bearer トークンとして送信することもできま 正規の `{provider}/{model}` モデル ID のプロバイダー部分。 - 型: [`RouterProviderSegment`](#routerprovidersegment)、英数字のスラッグ(例: `anthropic`)、最大 64 文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大 64 文字 正規の `{provider}/{model}` モデル ID のモデル部分。 - 型: [`RouterModelSegment`](#routermodelsegment)、英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字 - 1 つの論理的な呼び出しの再試行を安全にする、呼び出し側が生成するキー。 + 呼び出し元が生成するキーで、1 つの論理的な呼び出しの再試行を安全にします。 1〜255 文字 - このモデルを現在のデフォルトの代わりに配信する代替プロバイダーを選択します。代替プロバイダーは `fal`、`wavespeed`、`runware`、`higgsfield` で、`GET /v2/models/{provider}/{model}` は、あるモデルがそれらのどれをサポートしているかを報告します。拒否は固定の順序で判定され、先の判定は、後の判定に該当するかどうかに関係なく応答します。認識されない値(登録されたプロバイダーでさえないもの)は `400` で拒否されます。次に、ボディがマルチパート操作(編集)を選択しているリクエストでの代替プロバイダーは、`detail` が "this request's `image` selects the edit operation" で始まる `409` で拒否されますが、それはそのプロバイダーのこのモデル用のトランスレーターがその操作を提供できない場合に限られます。トランスレーターがメディアを扱えるレッグは通常どおり処理されます。次に、bring-your-own-key 認証情報が解決されたリクエストでは、代替プロバイダーはどれでも `detail` が `this request resolved a BYOK credential` で始まる `409` で拒否されます(そのレスポンスを参照)。そのプロバイダーがこのモデルを提供するかどうかは関係ありません。次に、指定されたプロバイダー自身のゲートがあり、そのプロバイダーがあなたに対して有効になっていない場合は `error_type: not_enabled` を伴う `403` で、ゲートを評価できない場合は `error_type: service_unavailable` を伴う `503` で拒否します。そしてこれら 4 つすべてを通過した後にのみ、このモデル用のレッグを持たない実在のプロバイダーが `error_type: invalid_input` を伴う `400` で拒否されます。これは認識されない値と同じ応答です。`fallback_provider` は、bring-your-own-key リクエスト、ボディがマルチパート操作を選択しているリクエスト、および `strict_mode=true` の下では、拒否されるのではなく何の効果も持ちません。 + このモデルを現在のデフォルトの代わりに処理する代替プロバイダーを選択します。`fal`、`wavespeed`、`runware`、`higgsfield` が代替プロバイダーであり、`GET /v2/models/{provider}/{model}` は、あるモデルがそのうちどれをサポートしているかを報告します。拒否は固定された順序でチェックされ、前段のチェックは後段のチェックの結果に関係なく応答します。未認識の値、つまり登録済みプロバイダーでないものは `400` で拒否されます。次に、ボディがマルチパート操作(編集)を選択するリクエストで代替プロバイダーを指定した場合、`detail` が「this request's `image` selects the edit operation」で始まる `409` で拒否されます。ただし、そのプロバイダーのこのモデル用トランスレーターがその操作を処理できない場合に限ります。メディアを扱えるトランスレーターを持つレッグは通常どおり処理されます。次に、bring-your-own-key 認証情報が解決されたリクエストでは、そのプロバイダーがこのモデルを処理するかどうかに関係なく、代替プロバイダーは `detail` が `this request resolved a BYOK credential` で始まる `409` で拒否されます(そのレスポンスを参照)。次に、指定されたプロバイダー自身のゲートがあり、そのプロバイダーがあなたに対して有効化されていない場合は `error_type: not_enabled` を伴う `403` で、ゲートを評価できない場合は `error_type: service_unavailable` を伴う `503` で拒否します。そして、これら 4 つすべてを通過した後にのみ、このモデル用のレッグを持たない実在のプロバイダーが `error_type: invalid_input` を伴う `400` で拒否されます。これは未認識の値と同じ応答です。`fallback_provider` は、bring-your-own-key リクエスト、ボディがマルチパート操作を選択するリクエスト、および `strict_mode=true` の場合には、拒否されるのではなく無効になります。 - `model_provider` と併用した場合にのみ意味を持ちます。 + `model_provider` と組み合わせた場合にのみ意味を持ちます。 デフォルト: False - 最初の試行が Router または試行したプロバイダーに起因する理由で失敗したときに、Router がこの呼び出しをモデルの他の登録済みプロバイダーに対して再試行するかどうかを制御します。省略した場合、または `false` 以外の値はフォールバックを有効のままにします。`false` は無効にします。フォールバックが成功したレスポンスには `X-Comfy-Router-Fallback-Provider` が付与されます。bring-your-own-key 認証情報が解決されたリクエストでは、このパラメータの値に関係なくフォールバックは利用できません。試行は単に行われず、最初の失敗がそのまま返ります。これは拒否ではなく不作用であり、ここから `409` が発生することはありません。同じ理由で、ボディがマルチパート操作を選択しているリクエストおよび `strict_mode=true` の下でも同様です。それぞれが呼び出しを 1 つのプロバイダーに結び付けるため、別のプロバイダーに対して忠実に再現することはできず、フォールバックは拒否されるのではなく単にスキップされます。その `409` で拒否されるのは明示的な `model_provider` だけであり、この無条件のスキップとは異なり、そのマルチパートの `409` はトランスレーターがその操作を提供できないレッグにのみ適用されます。 + 最初の試行が Router または試行したプロバイダーに起因する理由で失敗した場合に、Router がこの呼び出しをモデルの他の登録済みプロバイダーに対して再試行するかどうかを制御します。省略した場合、または `false` 以外の値の場合はフォールバックが有効のままです。`false` で無効になります。フォールバックが成功したレスポンスには `X-Comfy-Router-Fallback-Provider` が付与されます。bring-your-own-key 認証情報が解決されたリクエストでは、このパラメータの値に関係なくフォールバックは利用できません。試行は単に行われず、最初の失敗がそのまま返されます。これは拒否ではなく無効であり、ここから `409` が発生することはありません。同じ理由で、ボディがマルチパート操作を選択するリクエストおよび `strict_mode=true` の場合も同様です。いずれも呼び出しを 1 つのプロバイダーに結び付け、別のプロバイダーに対して忠実に再生することはできないため、フォールバックは拒否されるのではなく単にスキップされます。その `409` で拒否されるのは明示的な `model_provider` のみであり、この無条件のスキップとは異なり、マルチパートの `409` はトランスレーターがその操作を処理できないレッグにのみ適用されます。 - このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを、受け入れるのではなく拒否するようにオプトインします。ネストされたフィールドはチェックされず、宣言されていないフィールドを許可するスキーマを持つモデルや、作成済みスキーマを持たないモデルの場合は何も拒否されません。また、`strict_mode=true` で送信されたキュー中の送信でも拒否されません。 + このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを、受け入れるのではなく拒否することをオプトインします。ネストされたフィールドはチェックされません。スキーマが未宣言のフィールドを許可しているモデル、または作成済みのスキーマを持たないモデルでは何も拒否されず、`strict_mode=true` で送信されたキュー中の送信でも同様です。 デフォルト: False @@ -221,166 +223,166 @@ Comfy API キーは Bearer トークンとして送信することもできま `application/json` -- [`RouterModelInput`](#routermodelinput)(必須) -パートナーモデルのネイティブ JSON 入力です。`model_provider` がない場合、リクエストはモデルのデフォルトプロバイダーでネイティブディスパッチを実行し、このボディはモデル自身のネイティブスキーマであって、変更されずに転送されます(そこでは `strict_mode` は意味を持たず、何も変わりません)。`model_provider` が代替プロバイダーを選択し、`strict_mode=false`(デフォルト)の場合、ボディは送信前にそのプロバイダーの実際のスキーマに変換されます。正確に表現できないネイティブフィールドは削除され、レスポンスの `X-Comfy-Router-Dropped-Params` ヘッダーで開示されます。暗黙に削除されることはありません。`model_provider` が代替プロバイダーを選択し、`strict_mode=true` の場合、変換は実行されません。ボディはすでにその代替プロバイダー自身の実際のスキーマである必要があり(このモデルのネイティブスキーマではありません。`strict_mode` を参照)、変更されずに転送されます。ボディ自体のフィールドも、複数の操作をサポートするモデルで Router が実行する操作を選択します。編集可能な画像モデルの場合、入力画像を含めると、テキストから画像への操作から画像から画像へ(編集)の操作に切り替わり、それは独自のレートで課金される場合があります。Seedance ビデオモデルの場合、`content[].role` が操作を選択します(最初のフレームの画像は画像から動画へ、参照画像またはクリップは参照から動画を選択します)。ネイティブディスパッチでは、Seedance の課金は役割ではなく `content` 内のメディア種別に従います。ビデオ入力が少しでもあるリクエストは動画から動画へとして課金され、そうでなければ画像があるものは画像から動画へとして、それもなければテキストから動画へとして課金されます。ただし、`draft_task` 項目からの最終レンダーは、それがレンダリングする Draft の操作として課金されます。テキストから動画へと画像から動画へで同じレートを請求するモデルもあります。`model_provider` が代替プロバイダーを選択している場合、条件付きの各操作はそのプロバイダー独自のレートで課金される場合があります。 +パートナーモデルのネイティブ JSON 入力です。`model_provider` を指定しない場合、リクエストはモデルのデフォルトプロバイダー上でネイティブディスパッチを実行し、このボディはモデル自身のネイティブスキーマとなって、そのまま転送されます(`strict_mode` はそこでは意味を持たず、何も変わりません)。`model_provider` が代替プロバイダーを選択し、`strict_mode=false`(デフォルト)の場合、ボディは送信前にそのプロバイダーの実際のスキーマへ変換されます。正確に表現できないネイティブフィールドはドロップされ、レスポンスの `X-Comfy-Router-Dropped-Params` ヘッダーで開示されます。暗黙に破棄されることはありません。`model_provider` が代替プロバイダーを選択し、`strict_mode=true` の場合、変換は実行されません。ボディはすでにその代替プロバイダー自身の実際のスキーマである必要があり(このモデルのネイティブなものではありません。`strict_mode` を参照)、そのまま転送されます。ボディのフィールド自体も、複数の操作をサポートするモデルで Router が実行する操作を選択します。編集可能な画像モデルの場合、入力画像を含めるとテキストから画像への操作から画像から画像へ(編集)の操作に切り替わり、これには独自のレートが適用される場合があります。Seedance ビデオモデルの場合、`content[].role` が操作を選択します(最初のフレーム画像は画像から動画へを選択し、参照画像またはクリップは参照から動画を選択します)。ネイティブディスパッチでは、Seedance の課金は役割ではなく `content` 内のメディア種別に従います。動画入力が含まれるリクエストは動画から動画へとして課金され、そうでなければ画像が含まれるものは画像から動画へとして、それ以外はテキストから動画へとして課金されます。ただし、`draft_task` アイテムからの最終レンダーは、それがレンダリングする Draft の操作として課金されます。一部のモデルではテキストから動画へと画像から動画へが同じレートで課金されます。`model_provider` が代替プロバイダーを選択する場合、条件付けされた各操作にはそのプロバイダー独自のレートが適用される場合があります。 **レスポンス** - OK。`model_provider` を指定しない場合、または `model_provider` を指定して `strict_mode=false`(デフォルト。可能な場合はこのモデルのネイティブな契約に変換して返し、変換に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします。ログに記録され、暗黙に処理されることはありません)の場合、形状はこのモデル自身のネイティブな出力です。`strict_mode=true` の場合は、代替プロバイダーのレスポンスがそのまま返されます。パートナーが生成結果をバイト列として直接返すモデルでは、ボディは `application/json` ではなくパートナー自身の `Content-Type` を持つそのバイト列になります。レスポンスの `Content-Type` で分岐し、JSON ドキュメントであると仮定しないでください。 + OK - `model_provider` なしの場合、または `model_provider` ありで `strict_mode=false`(デフォルト。可能な場合はこのモデルのネイティブな契約に変換して返し、変換に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします。ログに記録され、サイレントにはなりません)の場合、形状はこのモデル自身のネイティブな出力です。`strict_mode=true` の場合は、代替プロバイダーのレスポンスが変更されずにそのまま返されます。パートナーが生成結果をバイト列として直接返すモデルでは、ボディは `application/json` ではなく、パートナー自身の `Content-Type` に基づくそのバイト列になります。レスポンスの `Content-Type` で分岐し、JSON ドキュメントであると想定しないでください。 - Body: [`RouterModelOutput`](#routermodeloutput) または生のバイト列(`*/*`) -- Headers: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` + Body: [`RouterModelOutput`](#routermodeloutput) または生のバイト列 (`*/*`) -- ヘッダー: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` 無効なリクエストです。エラータイプとリクエストボディを確認してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- 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) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `X-Comfy-Credits-Used`, `Idempotent-Replayed` 認証情報が不足しているか、無効です。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router のリクエストレベルの失敗です。リクエストはモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 + Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - この呼び出し元またはモデルに対して、リクエストは許可されていません。 + この呼び出し元またはモデルに対して、このリクエストは許可されていません。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` はオリジナルの呼び出しがまだ実行中であることを意味するため、`Retry-After` を待って同じキーを再利用します。`invalid_input` の場合は新しいキーが必要です。このルートにおける 2 つの `invalid_input` 競合はキーとはまったく無関係で、新しいキーでもどちらも解消されません。1 つは、リクエストボディがマルチパート操作(編集)を選択しているのに `model_provider` が代替プロバイダーを指定しており、そのプロバイダーのこのモデル用トランスレーターが対応できない場合で、`detail` は "this request's `image` selects the edit operation" で始まります。もう 1 つはその後チェックされるもので、リクエストがすでにパス内のプロバイダーに対する BYOK 認証情報を解決済みの場合で、`detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を外すか、BYOK 認証情報なしで(マルチパートの場合は編集もなしで)リクエストを送信してください。 + `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` はオリジナルの呼び出しがまだ実行中であることを意味するため、`Retry-After` を待って同じキーを再利用してください。`invalid_input` は新しいキーが必要です。このルートにおける 2 つの `invalid_input` 競合はキーに関するものではなく、新しいキーでもどちらも解消されません。`model_provider` が代替プロバイダーを指定している場合、リクエストボディが、そのプロバイダーのこのモデル用トランスレーターでは対応できないマルチパート操作(編集)を選択しているときに拒否され、その `detail` は「this request's `image` selects the edit operation」で始まります。また、その後にチェックされるものとして、リクエストがパス内のプロバイダーに対する BYOK 認証情報をすでに解決している場合にも拒否され、その `detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報なしで(マルチパートの場合は編集もなしで)リクエストを送信してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After`(`concurrency_limit_exceeded` の場合) + Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded` の場合) リクエストボディが大きすぎます。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` リクエストの内容がモデルのスキーマに照らして拒否されました。 - Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` + Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` は実行中の呼び出しを減らすことを意味し、`rate_limited` は許可ウィンドウを待つことを意味します。 + `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` は実行中の呼び出しを減らすことを意味し、`rate_limited` は許容量のウィンドウが経過するまで待つことを意味します。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining` + Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining` - プロバイダー自身のレスポンスを結果に変換できませんでした(`provider_error`)。 + プロバイダー自身のレスポンスを結果に変換できませんでした (`provider_error`)。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status` + Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status` - Router は一時的に利用できません。バックオフしながらリトライしてください。 + Router は一時的に利用できません。バックオフしながら再試行してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After`(容量拒否時のみ) + Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (容量拒否の場合のみ) - リクエストがデッドラインを超過しました。リトライする前にエラータイプを確認してください。 + リクエストが期限を超過しました。再試行する前にエラータイプを確認してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `Retry-After` + Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `Retry-After` ### `POST /v2/models/{provider}/{model}/estimate` **モデル呼び出しを実行する前に、実行せずに価格を見積もります。** -このボディをこのモデルで実行した場合のコストを、米ドルで事前に見積もって返します。価格は、実行時の請求に使われるのと同じレートカードから算出されます。これは見積もりであり、最終的な請求額ではありません。実際に支払うのは、ワークスペースの使用状況および請求記録に確定した請求額です。ボディはまずモデルの入力スキーマに対して検証されます。これはデフォルトの実行(`strict_mode` なし、`reject_unknown_fields` なし)が検証するのと同じ方法です。そのため、モデルのスキーマに適合しないボディは、実行時と同じ `422` になります。プロバイダーには何も送信されず、課金も発生しません。この回答は価格の固定ではありません。`pricing_as_of` の時点で有効なレートで算出され、実行は評価時点で有効なレートで請求されます。機能のロールアウト中は、このルートは `403` を返し、`error_type: not_enabled` となります。 +このボディをこのモデルで実行した場合のコストを米ドルで示す事前見積もりを返します。価格は、実行時の請求に使われるのと同じレートカードから算出されます(ベンダーが報告するコストで課金されるモデルの場合は、代わりにベンダーの公開価格表から見積もられます)。これは見積もりであり、最終的な請求額ではありません。実際に支払うのは、ワークスペースの利用状況および請求記録に確定した請求額です。ボディはまずモデルの入力スキーマに対して検証されます。デフォルトの実行(`strict_mode` なし、`reject_unknown_fields` なし)が検証するのと同じ方法です。そのため、モデルのスキーマに適合しないボディは、実行時と同じ `422` になります。プロバイダーには何もディスパッチされず、課金も発生しません。この応答は価格の固定ではありません。`pricing_as_of` の時点で有効な料率で価格が算出され、実行はレーティング時点で有効な料率で課金されます。この機能のロールアウト中は、このルートは `403` を返し、`error_type: not_enabled` となります。 **パラメータ** - 正規の `{provider}/{model}` モデル ID の小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。 + 正規の `{provider}/{model}` モデル ID の小文字プロバイダーセグメント。実行対象のモデルを持つパートナーです。 - 型: [`RouterProviderSegment`](#routerprovidersegment):英数字スラッグ(例: `anthropic`)、最大 64 文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字 - 正規の `{provider}/{model}` モデル ID の小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 + 正規の `{provider}/{model}` モデル ID の小文字モデルセグメント。そのプロバイダー内で実行するモデルです。 - 型: [`RouterModelSegment`](#routermodelsegment):英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 - このモデルを提供する代替プロバイダーを、現在のデフォルトの代わりに選択します。 + 現在のデフォルトの代わりに、このモデルを提供する別のプロバイダーを選択します。 **リクエストボディ** -`application/json`:[`RouterModelInput`](#routermodelinput)(必須) +`application/json` -- [`RouterModelInput`](#routermodelinput)(必須) -パートナーモデルのネイティブ JSON 入力で、このモデルに対して同期ルートが受け付けるボディと同一です。デフォルトの実行が検証するのと同じく、モデル自身の入力スキーマに対して検証され(このルートは `strict_mode` も `reject_unknown_fields` も受け付けません)、その独自のフィールド(出力数、入力画像が選択する操作)が、何の価格を算出するかを決めます。 +パートナーモデルのネイティブな JSON 入力で、このモデルに対して同期ルートが受け付けるボディと同じものです。デフォルトの実行が検証するのと同様に、モデル自身の入力スキーマに対して検証され(このルートは `strict_mode` や `reject_unknown_fields` を受け付けません)、そのボディ自身のフィールド(出力数、入力画像が選択する操作)が何の価格を算出するかを決めます。 **レスポンス** - 見積もりです。 + 見積もり結果。 - ボディ: [`RouterCostEstimate`](#routercostestimate)、ヘッダー: `X-Comfy-Request-Id` + ボディ: [`RouterCostEstimate`](#routercostestimate) -- ヘッダー: `X-Comfy-Request-Id` 無効なリクエストです。エラータイプとリクエストボディを確認してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 認証情報が不足しているか、無効です。 + 認証情報が不足しているか無効です。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - この呼び出し元またはモデルに対して、リクエストは許可されていません。 + この呼び出し元またはモデルに対してリクエストは許可されていません。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` リクエストボディが大きすぎます。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` 見積もりのボディがモデルのスキーマに対して拒否されたか、パスとは異なるモデルが指定されました。 - ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router は一時的に利用できません。バックオフを伴って再試行してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(容量不足による拒否のみ) + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(容量拒否の場合のみ) ### `GET /v2/models/{provider}/{model}/openapi.json` @@ -392,15 +394,15 @@ Comfy API キーは Bearer トークンとして送信することもできま **パラメータ** - 正規の `{provider}/{model}` モデル ID のうちプロバイダー部分。 + 正規の `{provider}/{model}` モデル ID のプロバイダー部分。 - Type: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字 + 型: [`RouterProviderSegment`](#routerprovidersegment)(英数字のスラッグ、例: `anthropic`、最大64文字) - 正規の `{provider}/{model}` モデル ID のうちモデル部分。 + 正規の `{provider}/{model}` モデル ID のモデル部分。 - Type: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 + 型: [`RouterModelSegment`](#routermodelsegment)(英数字のスラッグ、例: `claude-opus-4-6`、最大128文字) @@ -412,7 +414,7 @@ Comfy API キーは Bearer トークンとして送信することもできま OK - モデルの入力スキーマと出力スキーマを、単体の OpenAPI ドキュメントとして返します。 - Body: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` + 本文: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` @@ -422,53 +424,53 @@ Comfy API キーは Bearer トークンとして送信することもできま - 認証情報が不足しているか無効です。 + 認証情報が不足しているか、無効です。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - この呼び出し元またはモデルに対して、このリクエストは許可されていません。 + この呼び出し元またはモデルに対して、リクエストは許可されていません。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router がリクエストを完了できませんでした。 + Router はリクエストを完了できませんでした。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router は一時的に利用できません。バックオフして再試行してください。 + Router は一時的に利用できません。バックオフを伴って再試行してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}/requests` **パートナーモデルの実行をキューに送信し、すぐに戻ります。** -Comfy Routerのキュー配信モードです。リクエストボディは、`POST /v2/models/{provider}/{model}` がこのモデルに対して受け付けるものと同じパートナー固有のJSON入力です(ボディの形状は1つ、モデルごとのスキーマは1つ、配信モードは2つ)。ただし、このルートは結果のために接続を保持しません。実行を受け付けてハンドル付きで `201` を返し、呼び出し元は後で以下の3つの読み取りを通じて結果を取得します。 +Comfy Router のキュー配信モードです。リクエストボディは、`POST /v2/models/{provider}/{model}` がこのモデルに対して受け付けるものと同じパートナーネイティブの JSON 入力です(1つのボディ形状、モデルごとに1つのスキーマ、2つの配信モード)。ただし、このルートは結果のために接続を保持しません。実行を受け付け、ハンドルとともに `201` を返し、呼び出し元は後で以下の3つの読み取りによって結果を取得します。 **パラメータ** - 正規の `{provider}/{model}` モデルIDの小文字のプロバイダーセグメント。実行するモデルを持つパートナーです。 + 正規の `{provider}/{model}` モデル ID の小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。 - 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ、例: `anthropic`、最大64文字 + 型: [`RouterProviderSegment`](#routerprovidersegment)、英数字スラッグ(例: `anthropic`)、最大64文字 - 正規の `{provider}/{model}` モデルIDの小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 + 正規の `{provider}/{model}` モデル ID の小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 - 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ、例: `claude-opus-4-6`、最大128文字 + 型: [`RouterModelSegment`](#routermodelsegment)、英数字スラッグ(例: `claude-opus-4-6`)、最大128文字 @@ -476,333 +478,332 @@ Comfy Routerのキュー配信モードです。リクエストボディは、`P - `model_provider` と併用した場合にのみ意味があります。 + `model_provider` と併用した場合のみ意味を持ちます。 デフォルト: False - 呼び出し元が生成するキーで、1つの論理的な呼び出しの再試行を安全にします。 + 1つの論理的な呼び出しを安全に再試行できるようにする、呼び出し元が生成するキー。 - 1~255文字 + 1〜255文字 - このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを、受け入れるのではなく拒否することを選択します。ネストされたフィールドはチェックされません。スキーマが未宣言のフィールドを許可しているモデル、または作成済みスキーマを持たないモデルでは何も拒否されません。また、`strict_mode=true` で送信されたキューへの送信でも何も拒否されません。 + このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを受け入れるのではなく、拒否することを選択します。ネストされたフィールドはチェックされず、宣言されていないフィールドを許可するスキーマを持つモデル、または作成されたスキーマを持たないモデルの場合、および `strict_mode=true` で送信されたキューへの送信では、何も拒否されません。 デフォルト: False **リクエストボディ** -`application/json` -- [`RouterModelInput`](#routermodelinput)(必須) +`application/json`: [`RouterModelInput`](#routermodelinput)(必須) -パートナーモデル固有のJSON入力で、同期ルートがこのモデルに対して受け付けるボディと同一です。また、実行する操作を選択し、同じ方法で課金されます。ボディ自身のフィールドが、複数の操作をサポートするモデルでRouterが実行する操作を選択します(入力画像は編集可能な画像モデルを画像から画像へに切り替え、それには独自のレートで課金される場合があります。Seedanceの最初のフレーム画像は画像から動画へを選択し、参照画像またはクリップは参照から動画を選択します)。ネイティブディスパッチでは、Seedanceリクエストはロールではなく `content` 内のメディア種別で課金されます。つまり、ビデオ入力があれば動画から動画へとして課金され、そうでなければ画像があれば画像から動画へ、それもなければテキストから動画へとして課金されます。ただし、`draft_task` アイテムからの最終レンダーは、それがレンダーするDraftの操作として課金されます。一部のモデルはテキストから動画へと画像から動画へに同じレートを課金します。`model_provider` で代替プロバイダーを選択している場合、条件付きの各操作はそのプロバイダー独自のレートで課金される場合があります。同じプロバイダー選択の契約がディスパッチ時にも適用されます。`model_provider` がない場合、または `model_provider` があり `strict_mode=false`(デフォルト)の場合、ボディはモデル固有のドキュメントであり、実行が受け付けられる前にモデル自身の入力スキーマに対して検証されます。そのため、モデルが拒否するボディはここで `422` となり、数分後に失敗するキュー中のリクエストにはなりません。非strictの代替プロバイダーのボディはさらに、ディスパッチ時にそのプロバイダーの実際のスキーマへ変換されます。`strict_mode=true` の場合、ボディはすでに代替プロバイダー自身のスキーマである必要があり、変更されずに転送されます。ネイティブスキーマの検証はスキップされます。これは同期ルートとまったく同じです(`model_provider` と `strict_mode` を参照)。 +パートナーモデルのネイティブ JSON 入力で、同期ルートがこのモデルに対して受け付けるボディと同じものです。また、操作を選択し、同じ方法で課金されます。ボディ自身のフィールドが、複数の操作をサポートするモデルで Router が実行する操作を選択します(入力画像は編集可能な画像モデルを画像から画像へ切り替え、それには独自のレートで課金される場合があります。Seedance の最初のフレーム画像は画像から動画へを選択し、参照画像またはクリップは参照から動画を選択します)。ネイティブディスパッチでは、Seedance リクエストはロールではなく `content` 内のメディア種別で課金されます。ビデオ入力があれば動画から動画へとして課金され、そうでなければ画像があれば画像から動画へ、それもなければテキストから動画へとして課金されます。ただし、`draft_task` 項目からの最終レンダーは、それがレンダリングする Draft の操作として課金されます。一部のモデルではテキストから動画へと画像から動画へに同じレートを請求します。`model_provider` で代替プロバイダーを選択する場合、条件付けされた各操作はそのプロバイダー独自のレートで課金される場合があります。同じプロバイダー選択の契約がディスパッチ時に適用されます。`model_provider` を指定しない場合、または `model_provider` を指定して `strict_mode=false`(デフォルト)の場合、ボディはモデルのネイティブドキュメントであり、実行が受け付けられる前にモデル自身の入力スキーマに対して検証されます。そのため、モデルが拒否するようなボディは、数分後に失敗するキュー中のリクエストではなく、ここで `422` になります。非厳格な代替プロバイダーのボディは、さらにディスパッチ時にそのプロバイダーの実際のスキーマへ変換されます。`strict_mode=true` の場合、ボディはすでに代替プロバイダー自身のスキーマである必要があり、変更されずに転送されます。ネイティブスキーマの検証は、同期ルートとまったく同じようにスキップされます(`model_provider` と `strict_mode` を参照)。 **レスポンス** - Created - 実行がキューに受け付けられました。 + 作成済み。実行がキューに受け付けられました。 - ボディ: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- ヘッダー: `X-Comfy-Request-Id`、`Idempotent-Replayed` + ボディ: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse)、ヘッダー: `X-Comfy-Request-Id`、`Idempotent-Replayed` 認証情報が不足しているか無効です。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` 無効なリクエストです。エラータイプとリクエストボディを確認してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` リクエストボディが大きすぎます。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Routerのリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 + Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - この呼び出し元またはモデルではリクエストが許可されていません。パートナーが生成結果を直接バイトとして返すモデルはまだキューに投入できず、`not_enabled` で拒否されます。代わりに同期ルートで実行してください。 + この呼び出し元またはモデルに対してリクエストは許可されていません。パートナーが生成結果を直接バイトとして返すモデルはまだキューに投入できず、`not_enabled` で拒否されます。代わりに同期ルートで実行してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - モデルIDが見つかりませんでした。 + モデル ID が見つかりませんでした。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `X-Comfy-Error-Type` を確認してください: `concurrency_limit_exceeded` はオリジナルの呼び出しがまだ実行中であることを意味するため、`Retry-After` を待って同じキーを再利用してください。`invalid_input` の場合は新しいキーが必要です。このルート上の 2 つの `invalid_input` 競合はキーとはまったく関係がなく、新しいキーでもどちらも解消されません: 別のプロバイダーを指定する `model_provider` は、リクエスト本文が、そのプロバイダーのこのモデル用トランスレーターが対応できないマルチパート操作(編集)を選択している場合に拒否され、その `detail` は "this request's `image` selects the edit operation" で始まります。さらに、その後チェックされる条件として、リクエストがパス内のプロバイダーに対して BYOK 認証情報をすでに解決している場合があり、その `detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報なしで、かつ(マルチパートの場合)編集なしでリクエストを送信してください。 +`X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` はオリジナルの呼び出しがまだ実行中であることを意味するため、`Retry-After` を待って同じキーを再利用してください。`invalid_input` の場合は新しいキーが必要です。このルートにおける 2 つの `invalid_input` 競合はキーとはまったく関係がなく、新しいキーでもどちらも解消されません。1 つ目は `model_provider` で代替プロバイダーを指定した場合で、リクエストボディが、このモデルに対するそのプロバイダーのトランスレーターでは処理できないマルチパート操作(編集)を選択していると拒否され、その `detail` は「this request's `image` selects the edit operation」で始まります。2 つ目はその後チェックされるもので、リクエストがすでにパス内のプロバイダーに対する BYOK 認証情報を解決済みの場合に拒否され、その `detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報なしで(マルチパートの場合は編集もなしで)リクエストを送信してください。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After`(`concurrency_limit_exceeded` の場合) + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(`concurrency_limit_exceeded` の場合) - リクエストの内容はモデルのスキーマに照らして拒否されました。 + リクエストの内容がモデルのスキーマに対して拒否されました。 - 本文: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` + ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed` - `X-Comfy-Error-Type` を確認してください。`queue_backlog_full` は、保持できる未完了のキュー済みリクエスト数がすでに上限に達していることを意味するため、いずれかが完了してから再送信してください。`rate_limited` は、許容量のウィンドウを待つことを意味します。 + `X-Comfy-Error-Type` を確認してください。`queue_backlog_full` は、許可されている数まで未完了のキュー中リクエストをすでに保持していることを意味するため、そのうちの 1 つが完了したら再度送信してください。`rate_limited` は許可ウィンドウを待つことを意味します。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router は一時的に利用できません。バックオフを伴って再試行してください。 + ルーターは一時的に利用できません。バックオフしながら再試行してください。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After`(容量拒否の場合のみ) + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(容量拒否の場合のみ) ### `GET /v2/models/{provider}/{model}/requests/{request_id}` -**送信済みの 1 件のリクエストの結果を取得します。** +**送信された 1 件のリクエストの結果を取得します。** -結果取得エンドポイントです。正常に完了したリクエストに対しては、パートナーモデル自身のネイティブ出力を返します。これは、同じモデルと同じ入力に対して同期ルートの `200` が返す内容とバイト単位で同一です。つまり 2 つの配信モードは同じ結果形状を生成するため、呼び出し側は別のパーサーを用意することなく両者を切り替えられます。 +結果収集エンドポイントです。正常に完了したリクエストに対しては、パートナーモデル自身のネイティブ出力を、同じモデル・同じ入力に対して同期ルートの `200` が返す内容とバイト単位で同一のまま返します。これにより 2 つの配信モードは 1 つの結果形状を生成し、呼び出し元は別のパーサーを用意することなく両者を切り替えられます。 **パラメータ** - 正規の `{provider}/{model}` モデル ID のうち小文字のプロバイダーセグメント。モデルを実行するパートナーです。 + 正規の `{provider}/{model}` モデル ID の小文字プロバイダーセグメント。実行対象のモデルを持つパートナーです。 - 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大 64 文字 - 正規の `{provider}/{model}` モデル ID のうち小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 + 正規の `{provider}/{model}` モデル ID の小文字モデルセグメント。そのプロバイダー内で実行するモデルです。 - 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字 - 対象とするキュー中のリクエスト。送信時にレスポンス本文で返された `request_id` です。 + 対象となるキュー中のリクエスト。送信時にレスポンス本文で返された `request_id` です。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大 36 文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 **レスポンス** - OK -- 結果を生成したリクエスト(正常に完了したリクエスト、または課金の記録と保存済みの結果の両方を持つターミナル状態のリクエスト)に対して保存された結果を、パートナー自身のメディアタイプでそのまま返します。同期ルートの `200` が返す場合とまったく同じであり、送信時に受け入れたのと同じプロバイダー選択の契約に従います。`model_provider` を指定しない場合、または `model_provider` と `strict_mode=false`(デフォルト。可能な場合はこのモデルのネイティブな契約に変換し、変換に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします。この処理はログに記録され、決して黙って行われることはありません)を指定した場合、形状はこのモデル自身のネイティブ出力です。`strict_mode=true` の場合は、代替プロバイダーのレスポンスがそのまま返されます。パートナーが生成結果をバイト列として直接返すモデルでは、本文は `application/json` ではなくパートナー自身の `Content-Type` を持つそのバイト列です。レスポンスの `Content-Type` で分岐し、JSON ドキュメントであると仮定しないでください。 + OK: 結果を生成したリクエストに対して保存された結果です。正常に完了したリクエスト、または記録済みの課金と保存済みの結果の両方を持つターミナル状態のリクエストが該当します。パートナー自身のメディアタイプのまま、同期ルートの `200` が返すのとまったく同じ形で、また送信時に受け入れたのと同じプロバイダー選択契約のもとで、変更されずに返されます。`model_provider` がない場合、または `model_provider` があり `strict_mode=false`(デフォルト。可能な場合はこのモデルのネイティブ契約に変換され、変換に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします。ログに記録され、決して黙って処理されることはありません)の場合は、形状はこのモデル自身のネイティブ出力です。`strict_mode=true` の場合は、代替プロバイダーのレスポンスが変更されずにそのまま返されます。パートナーが生成結果を直接バイトとして返すモデルの場合、本文は `application/json` ではなくパートナー自身の `Content-Type` を持つそれらのバイト列です。レスポンスの `Content-Type` で分岐し、JSON ドキュメントであると決めつけないでください。 - 本文: [`RouterModelOutput`](#routermodeloutput) または生のバイト列 (`*/*`) -- ヘッダー: `X-Comfy-Request-Id`、`X-Content-Type-Options`、`X-Comfy-Credits-Used` + 本文: [`RouterModelOutput`](#routermodeloutput) または生のバイト列(`*/*`) -- ヘッダー: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` - 受理済み -- リクエストはまだ完了していません。 + 受理済み: リクエストはまだ完了していません。 - 本文: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- ヘッダー: `X-Comfy-Request-Id`、`Retry-After` + 本文: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- ヘッダー: `X-Comfy-Request-Id`, `Retry-After` 認証情報が不足しているか無効です。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` この呼び出し元またはモデルに対して、リクエストは許可されていません。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 + Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router は一時的に利用できません。バックオフを伴って再試行してください。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - リクエストが操作と競合する状態にあります。エラータイプを確認してください。 + リクエストは操作と競合する状態にあります。エラータイプを確認してください。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` リクエストが期限を超過しました。再試行する前にエラータイプを確認してください。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - - Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 + Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` -**送信済みの1件のリクエストのキャンセルを要求します。** +**送信済みのリクエストを 1 件キャンセルするよう要求します。** -まだ完了していないリクエストの停止を Comfy に要求します。これは要求であり保証ではなく、`202` はまさにそのことを示します。`CANCELLATION_REQUESTED` は要求が受け付けられたことを意味し、実行が停止したことを意味するものではありません。パートナー側で既に処理中の実行はそのまま完了する可能性があり(パートナーでの生成は、誰が結果を受け取ったかに関わらず、完了すれば課金されます)、そのため実際に何が起きたかを知る必要がある呼び出し元は、後でステータスエンドポイントを読み取ります。そこでは、有効になったキャンセルは、他のすべてのターミナルな結果と同様に `error_type` を持つ `COMPLETED` として示されます。 +まだ完了していないリクエストを停止するよう Comfy に要求します。これは要求であり保証ではないため、`202` はまさにそのことを示します。`CANCELLATION_REQUESTED` は要求が受け付けられたという意味であり、実行が停止したという意味ではありません。パートナー側ですでに送信済みの実行はそのまま完了する可能性があります。そして完了したパートナーでの生成は、誰が結果を取得したかに関係なく課金されます。そのため、実際に何が起きたかを知る必要がある呼び出し元は、後からステータスエンドポイントを参照します。そこでは、有効になったキャンセルは他のすべての終端結果と同様に `COMPLETED` となり、`error_type` を持ちます。 **パラメータ** - 正規の `{provider}/{model}` モデル ID の小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。 + 正規の `{provider}/{model}` モデル ID のうち、小文字のプロバイダーセグメント。実行するモデルを提供するパートナーです。 - 型: [`RouterProviderSegment`](#routerprovidersegment):英数字のスラッグ(例: `anthropic`)、最大 64 文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字 - 正規の `{provider}/{model}` モデル ID の小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 + 正規の `{provider}/{model}` モデル ID のうち、小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 - 型: [`RouterModelSegment`](#routermodelsegment):英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 - 対象となるキュー中のリクエスト。送信時にレスポンスボディで返された `request_id` です。 + 対象とするキュー中のリクエスト。送信時にレスポンスボディで返された `request_id` です。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid):`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大 36 文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大 36 文字 **レスポンス** - 受理済み。`CANCELLATION_REQUESTED`。 + 受け付け済み - `CANCELLATION_REQUESTED`。 - ボディ: [`RouterQueueCancelResponse`](#routerqueuecancelresponse)、ヘッダー: `X-Comfy-Request-Id` + ボディ: [`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- ヘッダー: `X-Comfy-Request-Id` - 競合。`ALREADY_COMPLETED`。 + 競合 - `ALREADY_COMPLETED`。 - ボディ: [`RouterQueueCancelResponse`](#routerqueuecancelresponse)、ヘッダー: `X-Comfy-Request-Id` + ボディ: [`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- ヘッダー: `X-Comfy-Request-Id` 無効なリクエストです。エラータイプとリクエストボディを確認してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` 認証情報が不足しているか無効です。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - この呼び出し元またはモデルでは、このリクエストは許可されていません。 + この呼び出し元またはモデルでは、そのリクエストは許可されていません。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router は一時的に利用できません。バックオフを伴って再試行してください。 + Router は一時的に利用できません。バックオフしながらリトライしてください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 + Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}/status` -**送信済みリクエスト1件のキュー状態を読み取ります。** +**送信済みの1件のリクエストのキュー状態を読み取ります。** -ポーリングエンドポイントです。リクエストの現在の状態を返し、結果は決して返しません。そのためクライアントは、ポーリングのたびに出力を転送することなく、長時間の生成を監視できます。結果は、この応答が `COMPLETED` を示したときに、以下の読み取りから一度だけ取得します。 +ポーリング用のエンドポイントです。リクエストの現在の状態を返し、結果は決して返しません。そのためクライアントは、ポーリングのたびに出力を転送することなく、長時間の生成を監視できます。結果は、ここで `COMPLETED` が返されたときに、後述の読み取りから一度だけ取得します。 **パラメータ** - 正規の `{provider}/{model}` モデル ID の小文字プロバイダーセグメント。実行対象のモデルを持つパートナーです。 + 正規の `{provider}/{model}` モデル ID のうち、小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。 - 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大64文字 + 型: [`RouterProviderSegment`](#routerprovidersegment)。英数字のスラッグ(例: `anthropic`)、最大64文字 - 正規の `{provider}/{model}` モデル ID の小文字モデルセグメント。そのプロバイダー内で実行するモデルです。 + 正規の `{provider}/{model}` モデル ID のうち、小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 - 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大128文字 + 型: [`RouterModelSegment`](#routermodelsegment)。英数字のスラッグ(例: `claude-opus-4-6`)、最大128文字 対象とするキュー中のリクエスト。送信時にレスポンスボディで返された `request_id` です。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid)。`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字 **レスポンス** - OK - リクエストの現在のキュー状態です。 + OK - リクエストの現在のキュー状態。 - ボディ: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- ヘッダー: `X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source` + ボディ: [`RouterQueueStatusResponse`](#routerqueuestatusresponse)。ヘッダー: `X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Credits-Used`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source` - 認証情報が不足しているか無効です。 + 認証情報が不足しているか、無効です。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - この呼び出し元またはモデルに対して、そのリクエストは許可されていません。 + この呼び出し元またはモデルに対して、このリクエストは許可されていません。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router が一時的に利用できません。バックオフを伴って再試行してください。 + Router は一時的に利用できません。バックオフしながら再試行してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` -ここでの説明は簡潔です。モデルの選択、検証、再試行、課金については [Comfy Router API の使用](/ja/development/comfy-router/api) を、ヘッダーの動作については [ヘッダー](/ja/development/comfy-router/headers) を参照してください。 +ここでの説明は簡潔にしています。モデルの選択、検証、再試行、課金については [Comfy Router API の使用](/ja/development/comfy-router/api) を、ヘッダーの動作については [ヘッダー](/ja/development/comfy-router/headers) を参照してください。 ## エラーバケット @@ -840,6 +841,7 @@ Router が受け付けたものの、完了できなかったリクエストに | `queue_timeout` | キュー中のリクエストが、一度も受け入れられることなくキュータイムアウトを超えて待機し続けました。 | | `request_not_found` | `request_id` が、このモデルにおける呼び出し元のどのリクエストも指していません。 | | `queue_backlog_full` | 呼び出し元が既に実行待ちのキュー中リクエストを抱えすぎているため、この送信は拒否されました。 | +| `result_expired` | リクエストは存在し、完了していましたが、その結果はもう保存されていないため、collect に返すものがありません。 | ## レスポンスヘッダー @@ -969,39 +971,39 @@ Router が受け付けたものの、完了できなかったリクエストに ## 事前のコスト見積もり -`POST /v2/models/{provider}/{model}/estimate` は、リクエストボディを実行せずにその価格を見積もります。また、キュー中の送信 (`POST /v2/models/{provider}/{model}/requests`) は、その `201` で `estimate` と同じ [`RouterCostEstimate`](#routercostestimate) を返します。どちらも、Comfy がその実行の請求に用いるレートカードから価格が決まります。どちらが返す数値も見積もりであり、最終的な請求額ではありません。ワークスペースの利用状況および請求記録にある確定額が最終です。自分のプロバイダーキーでの実行は Comfy から課金されません(後述)。見積もりの展開中は、このルートは `error_type: not_enabled` を伴う `403` を返し、送信レスポンスは `estimate` を省略します。カタログには依然として価格が含まれていません。 +`POST /v2/models/{provider}/{model}/estimate` は、ボディを実行せずにその価格を算出します。また、キュー中の送信(`POST /v2/models/{provider}/{model}/requests`)は、その `201` 応答で `estimate` と同じ [`RouterCostEstimate`](#routercostestimate) を返します。どちらも、Comfy がその実行に対して請求する料率表に基づいて価格付けされます。ただし、ベンダーが報告するコストで請求されるモデルは、ベンダーの公開価格表から `estimated` として算出されます。返される数値はすべて見積もりであり、最終的な請求額ではありません。ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。自分のプロバイダーキーでの実行は Comfy からは請求されません(下記参照)。見積もりの展開中は、このルートは `403` と `error_type: not_enabled` を返し、送信レスポンスには `estimate` が含まれません。カタログには引き続き価格が掲載されていません。 -金額を確認する前に `source` を読んでください。数値が不足していても、決して無料という意味ではありません。 +金額より先に `source` を読んでください。数値の欠落は無料を意味しません。 | `source` | 含まれるもの | 読み方 | | --- | --- | --- | -| `exact` | `amount`、`amount_cents`、`credits` | `pricing_as_of` のレートに基づく、このボディに対する請求額に等しい見積もりです。ワークスペースの利用状況および請求記録にある確定額が最終です。 | -| `estimated` | `min_amount`、`max_amount` とそれぞれの `_cents` 形式(`amount` はなし) | 請求額がプロバイダーから報告される数量に依存し、ボディがその数量の境界を定める見積もりです。請求額はその境界の間になると見込まれ、ワークスペースの利用状況および請求記録にある確定額が最終です。 | -| `unknown` | `reason`(数値はなし) | 実行前に価格を示すことができませんでした。その他の `source` の値はすべて `unknown` として扱ってください。 | +| `exact` | `amount`、`amount_cents`、`credits` | `pricing_as_of` の料率でこのボディに対して請求される額と等しい見積もりです。ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。 | +| `estimated` | `min_amount`、`max_amount` とその `_cents` 形式、`amount` は含まれない | プロバイダーが報告する数量に請求額が依存し、その数量の上下限がボディで決まる見積もりです。請求額は上下限の範囲内になると見込まれ、ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。 | +| `free` | `amount` は "0"、`amount_cents` と `credits` は `0` | 料率表がこのリクエストをゼロで価格付けするため、見積もりは `0` です。ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。`0` と表示されるのは `free` の見積もりだけです。 | +| `unknown` | `reason`、数値なし | 実行前に価格を提示できませんでした。その他の `source` 値は `unknown` として扱ってください。 | -`unknown` の見積もりの `reason` は次のいずれかです。 +`unknown` の見積もりの `reason` は次のいずれかです: -- `not_quotable`: Router はこの呼び出しが実行される前に価格を算出できません。プロバイダーが後から報告する数量で課金され、ボディがその範囲を定めていないか、送信されたままの内容では価格を算出できないためです。認識できない `reason` はすべて `not_quotable` として扱ってください。 -- `unpriced_model`: レートカードがこのリクエストの価格を定めていません。 -- `byok`(キュー中の送信のみ): 実行が自分のプロバイダーキーを使用するため、Comfy はその実行に対して何も課金しません。 -- `pricing_unavailable`(キュー中の送信のみ): リクエストを受け付けた時点でレートカードを読み取れませんでした。送信はそれでも受け入れられ、実行は通常どおり課金されます。 +- `not_quotable`: Router はこの呼び出しを実行前に価格付けできません。プロバイダーが報告する数量で請求され、その数量の上下限がボディで決まらないか、送信されたままのボディを価格付けできないためです。認識できない `reason` は `not_quotable` として扱ってください。 +- `unpriced_model`: 料率表がこのリクエストを価格付けしていません。 +- `byok`(キュー中の送信のみ): 実行は自分のプロバイダーキーを使用するため、Comfy は何も請求しません。 +- `pricing_unavailable`(キュー中の送信のみ): リクエストの受け付け時に料率表を読み取れませんでした。送信はそのまま受け付けられ、実行は通常どおり請求されます。 -Router が実行前にまだ価格を算出できないモデルは、[事前見積もりのないモデル](/ja/development/comfy-router/limitations#事前見積もりのないモデル) に一覧されています。そこに一覧されていないモデルでも、特定のボディに対しては `unknown` を返すことがあるため、すべての見積もりで `source` を読んでください。 +Router がまだ実行前に価格付けできないモデルは、[事前見積もりのないモデル](/ja/development/comfy-router/limitations#事前見積もりのないモデル)に一覧されています。そこに載っていないモデルでも、特定のボディでは `unknown` を返すことがあるため、すべての見積もりで `source` を読んでください。 -見積もりがフェイルクローズするのは、次の場合です。 +見積もりがフェイルクローズするのは次の場合です: -- 数値を出すためにレートカードが必要で、カードが読み込まれていないか古い場合、`/estimate` は推測ではなく `503` を返します。キュー中の送信が見積もりを理由に拒否されることはありません。代わりに `reason: pricing_unavailable` を伴う `source: unknown` を返します。実行前にまったく価格を算出できない呼び出し(`not_quotable`)、または自分のプロバイダーキーでのキュー中の送信(`byok`)は、カードを読まずに応答されるため、その `200` はカードが新しいかどうかについて何も示しません。 -- `/estimate` は、デフォルトの実行と同様に、モデル自身の入力スキーマに対してボディを検証します。そのため、モデルのスキーマに適合しないボディには、実行が返すのと同じ `422` が、同じ `detail[]` の形状で返ります。価格の算出もディスパッチも行われません。 -- キュー中の送信の冪等な再生(`Idempotent-Replayed: true`)は `estimate` を省略します。元の見積もりは保存されないためです。 +- 数値に料率表が必要で、カードが読み込まれていないか古い場合、`/estimate` は推測ではなく `503` を返します。キュー中の送信は見積もりを理由に拒否されることはなく、代わりに `source: unknown` と `reason: pricing_unavailable` を含みます。実行前にまったく価格付けできない呼び出し(`not_quotable`)、または自分のプロバイダーキーでのキュー中の送信(`byok`)は、カードを読まずに応答されるため、その `200` はカードが新しいかどうかについては何も示しません。 +- `/estimate` はデフォルトの実行と同様に、モデル自身の入力スキーマに対してボディを検証します。そのため、モデルのスキーマに適合しないボディは、実行が返すのと同じ `422` を、同じ `detail[]` 形状で受け取ります。何も価格付けもディスパッチもされません。 +- キュー中の送信の冪等なリプレイ(`Idempotent-Replayed: true`)は `estimate` を含みません。元の見積もりが保存されていないためです。 -見積もりの限界。`200` の数値は、その実行が受け入れられることや、まさにその額が課金されることを約束するものではありません。 +見積もりの限界。`200` の数値は、実行が受け付けられること、または正確にその金額が請求されることを約束するものではありません: -- `/estimate` は `strict_mode` や `reject_unknown_fields` を受け取らないため、モデルのネイティブな契約のみを検証します。`strict_mode=true` の実行が代替プロバイダー自身のスキーマで受け入れるボディも、ここでは `422` になることがあります。また、`reject_unknown_fields=true` の実行なら拒否するであろう、宣言されていないトップレベルフィールドも、ここでは価格が算出されます。 -- `pricing_as_of` は、レートカードを取得した時刻です(カードを読まなかった場合は、見積もりに応答した時刻)。これは価格の固定ではありません。実行は、評価された時点で有効なレートで課金されます。 -- `/estimate` が見積もるのは、`model_provider` が指定するレグ、またはネイティブのプロバイダーです。`fallback_provider` や `strict_mode` パラメータは受け取りません。フォールバックの再試行が別のプロバイダーに到達した同期実行は、そのプロバイダーのレートで課金され、見積もりはそのレートを示していません。実行のレスポンスにある `X-Comfy-Router-Fallback-Provider` が、それが発生したことを示します。キュー中の送信にはフォールバックがないため、その `estimate` は実行されるレグを見積もります。 -- `/estimate` とキュー中の送信の `estimate` は、`model_provider` のレグにおける同じボディ、または兄弟オペレーションで実行されるボディに対して、わずかに異なるドキュメントの価格を算出することがあります。送信の `estimate` は、その実行が送るドキュメントに基づいて価格が算出されます。 -- `/estimate` は常にプラットフォームの請求額を見積もります。自分のプロバイダーキーでの実行は Comfy から課金されませんが、`/estimate` はそれを検出せず、依然として数値を返します。`reason: byok` を返すのはキュー中の送信だけです。 -- ドルは丸めていないセントから、最大 8 桁の小数で表示され、課金対象となる 1 セント未満の `amount` が `0` と表示されることはありません。`credits` は `round(amount × 211, 2)` で、`X-Comfy-Credits-Used` が請求額に適用するのと同じ換算です。そのため、非常に小さな非ゼロの価格では `credits` が `0` にラウンドされることがあります。それが問題になる場合は `credits` ではなく `amount` または `amount_cents` で予算を立ててください。このヘッダーは実行後の数値のままであり、残高は Comfy プラットフォーム上にあります。 +- `/estimate` は `strict_mode` や `reject_unknown_fields` を受け取らないため、モデルのネイティブな契約のみを検証します。`strict_mode=true` の実行が代替プロバイダー自身のスキーマで受け付けるボディが、ここでは `422` になることがあります。また、`reject_unknown_fields=true` の実行なら拒否する未宣言のトップレベルフィールドが、ここでは価格付けされます。Anthropic Messages モデルは例外です。そのスキーマは未宣言のフィールドを許容するため、`reject_unknown_fields=true` の実行でも何も拒否せず、見積もりは未宣言のトップレベルフィールド `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` および空の `mcp_servers` のみを価格付けします。その他の未宣言のトップレベルフィールドがあると、`reason: not_quotable` とともに `unknown` を返します。 +- `pricing_as_of` は料率表を取得した時刻、またはベンダーの公開価格表から取得した `estimated` の見積もりの場合はその価格表を読んだ日付です(どちらも読まれていない場合は、見積もりを返した時刻です)。これは価格の固定ではありません。実行は、レーティング時点で有効な料率で請求されます。 +- `/estimate` は `model_provider` が示すレグ、またはネイティブのプロバイダーを価格付けします。`fallback_provider` や `strict_mode` パラメータは受け取りません。フォールバックのリトライが別のプロバイダーで行われる同期実行は、そのプロバイダーの料率で請求され、見積もりはそのレグを価格付けしていません。実行のレスポンスの `X-Comfy-Router-Fallback-Provider` が、それが発生したことを示します。キュー中の送信にはフォールバックがないため、その `estimate` は実行されるレグを価格付けします。 +- `/estimate` とキュー中の送信の `estimate` は、`model_provider` レグの同じボディ、または兄弟オペレーションで実行されるボディについて、わずかに異なるドキュメントを価格付けすることがあります。送信の `estimate` は、実行が送信するドキュメントに基づいて価格付けされます。 +- `/estimate` は常にプラットフォームの請求額を算出します。自分のプロバイダーキーでの実行は Comfy から請求されませんが、`/estimate` はそれを検出せずに数値を返します。`reason: byok` を返すのはキュー中の送信だけです。- ドルは丸めていないセントから最大8桁の小数で表示され、課金対象の1セント未満の `amount` が `0` と表示されることはありません。`credits` は `round(amount × 211, 2)` であり、これは `X-Comfy-Credits-Used` が課金に適用するのと同じ変換です。そのため、ごく小さい非ゼロの価格では `credits` が `0` にラウンドされることがあります。これが重要となる場合は、`credits` ではなく `amount` または `amount_cents` で予算を立ててください。このヘッダーは引き続き、1回の実行に対する事後的な数値です。残高は Comfy プラットフォーム上にあります。 ## 結果アセット @@ -1022,6 +1024,8 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 その他のモデルは、プロバイダーのアセット参照またはインラインバイトを返します。プロバイダーの URL はプロバイダーの有効期限に従います。これは上記の有効期間よりはるかに短い場合があり、Router の契約では規定されていません。 +**オリジナルの BytePlus URL(Seedance 2.x、オプトイン)。** Comfy がサーバー側でオプトインしたワークスペースでは、Seedance 2.x の結果に、コピーされた URL の隣に BytePlus 自身の URL が `content.upstream_video_url` と `content.upstream_last_frame_url` として含まれ、さらに `content.upstream_expires_at` も含まれます。リクエストパラメーターはなく、デフォルトでオプトインされるワークスペースはありません。これらの URL は生成から 24 時間後に期限切れとなり、BytePlus がクリアすると存在しなくなります。Seedance 2.5 では BytePlus がそれぞれ 100 ダウンロードに制限しており、Router 自身のコピーがそのうち 1 回を使用します。各 URL はそのオブジェクトのベアラークレデンシャルです。保持している誰でも、期限が切れるまでアセットをダウンロードできます。 + コピーはアセットごとのベストエフォートです。1 つのコピーが失敗した場合、そのエントリはプロバイダーの参照を保持します。レスポンスには Comfy とプロバイダーの両方の URL が含まれる可能性があり、アセットごとの明示的なコピーステータスフィールドはありません。生成は引き続き成功し、課金されます。1 つの正常に再ホストされたアセットから、すべての URL の有効期間を推測しないでください。 結果が Comfy ホストかどうかは、完了した呼び出しが後でその `Idempotency-Key` レコードから再生できるかどうかも決定します。上記の `Idempotency-Key` パラメーターは、再生できない場合に再試行が何で応答されるかを説明しています。 @@ -1034,107 +1038,139 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 ## スキーマ +### RouterBilledWorkspace + +拒否された呼び出しが請求しようとしていたウォレットで、`RouterErrorResponse.billed_workspace` に含まれます。「どのウォレットが空なのか?」に答えるものです。呼び出し元の UI で現在選択済みのワークスペースとは限らず、チームメンバーが個人の認証情報を使っている場合は、資金のあるチームが開かれていてもここにはそのメンバーの個人ウォレットが示されます。`denied_reason` と一緒にのみ存在します。 + +**フィールド** + + + クラウドのワークスペース ID。レガシーレールでは存在しません。 + + + + `personal` または `team`。オープンな文字列であり、それ以外の値は個人として扱ってください。 + + + + 呼び出しがクラウドワークスペースではなく、呼び出し元のワークスペース以前の Metronome 顧客に請求する場合は `legacy`。その顧客にはワークスペース ID がありません。クラウドワークスペースの場合は存在しません。 + + ### RouterChargesOnPolicyRejection -このモデルでコンテンツポリシーによる拒否が課金されるかどうか。不明な値は課金される可能性があるものとして扱ってください。 +コンテンツポリシーによる拒否がこのモデルで課金されるかどうか。不明な値は課金される可能性があるものとして扱ってください。 型: `string` ### RouterCostEstimate -この呼び出しにかかる費用を、ディスパッチ前に、実行の課金に用いられるのと同じレートカードから米ドルで見積もった事前見積もりです。最終的な請求額ではありません。実際に支払うのは、ワークスペースの使用量および請求記録にある確定した請求額です。実行後に報告される `X-Comfy-Credits-Used` は事後に丸められた数値であり、領収書ではありません。`source` はその数値をどこまで信頼できるかを示します。`exact` は `amount` を持ち、`estimated` は `min_amount` と `max_amount` を持ち `amount` は持ちません。`unknown` はどちらも持たず `reason` を持ちます。`amount` が存在しないことを無料と読み取らないでください。価格の固定ではありません。`pricing_as_of` を参照してください。 +この呼び出しにかかる費用を米ドルで事前に見積もったもので、ディスパッチ前に、実行の請求に使用される同じレートカードから価格設定されます(または、ベンダーが報告するコストで請求されるモデルの場合は、ベンダーの公開価格表から見積もられます)。最終請求額ではありません。実際に支払うのは、ワークスペースの使用量と請求記録にある確定請求額です。実行後に報告される `X-Comfy-Credits-Used` は四捨五入された事後的な数値であり、領収書ではありません。`source` はその数値をどの程度信頼できるかを示します。`exact` は `amount` を持ち、`free` は `amount` "0" を持ち(レートカードではこのリクエストがゼロと価格設定されています)、`estimated` は `min_amount` と `max_amount` を持ち `amount` を持ちません。`unknown` はどちらも持たず、`reason` を持ちます。`amount` がないことを無料と解釈しないでください。価格ロックではありません。`pricing_as_of` を参照してください。 **フィールド** - `exact` | `estimated` | `unknown`。それ以外の値は `unknown` として読み取ります。`exact` と `estimated` はいずれも見積もりを表すもので、どちらも最終的な請求額ではありません。`unknown` は数値を持ちません。 + `exact` | `estimated` | `free` | `unknown`。その他の値は `unknown` として扱います。`exact` と `estimated` はどちらも見積もりを示すもので、どちらも最終請求額ではありません。`free` はレートカードがこのリクエストをゼロと価格設定していることを意味するため、`amount` は "0" です。`unknown` は数値を持ちません。 - 常に `USD` です。 + 常に `USD`。 - 小数文字列としてのドル額。例: "0.04"。最大 8 桁の小数で、指数表記はありません。課金対象となる 1 セント未満の価格が "0" として表示されることはありません。`source` が `exact` の場合のみ存在します。最終的な請求額ではありません。最終的なのは、ワークスペースの使用量および請求記録にある確定した請求額です。 + 推定コストをドル建ての小数文字列で表したもの(例: "0.04")。最大 8 桁の小数部を持ち、指数表記は使用しません。課金対象の 1 セント未満の価格が "0" として表示されることはなく、"0" になるのは `free` の見積もりだけです。`source` が `exact` または `free` の場合にのみ存在します。最終請求額ではありません。最終的な請求額は、ワークスペースの使用量と請求記録にある確定請求額です。 - 小数文字列としてのドル額の下限。`source` が `estimated` の場合のみ存在します。 + 見積もりの下限をドル建ての小数文字列で表したものです。これは見積もりであり、保証された下限ではありません。たとえば、プロバイダーがリクエストした量より少ない結果を返した場合(画像がない場合など)、見積もりが過去の呼び出しから学習した典型的な価格である場合、またはリクエスト量に対して価格が一定に上昇しない場合には、請求額がこれより少なくなることがあります。`source` が `estimated` の場合にのみ存在します。 - 小数文字列としてのドル額の上限。`source` が `estimated` の場合のみ存在します。 + 見積もりの上限をドル建ての小数文字列で表したものです。これは見積もりであり、保証された上限ではありません。たとえば、プロバイダーが要求より多く返した場合(要求より多くの画像が返る場合など)、見積もりが過去の呼び出しから学習されたものである場合、またはリクエスト量に対して価格が一定に上昇しない場合には、請求額がこれより多くなることがあります。`source` が `estimated` の場合にのみ存在します。 - 計算用の、端数処理を行っていない米セント単位の同じ数値。`amount` とともに存在します。 + 同じ数値を米セント単位で表したもの(四捨五入なし、計算用)。`amount` と共に存在します。 double - 端数処理を行っていない米セント単位の `min_amount`。`min_amount` とともに存在します。 + `min_amount` を米セント単位で表したもの(四捨五入なし)。`min_amount` と共に存在します。 double - 米セント単位の `max_amount`。`max_amount` とともに存在します。 + `max_amount` を米セント単位で表したもの。`max_amount` と共に存在します。 double - プラットフォームの換算($1 = 211 credits)を用いた Comfy クレジット単位の `amount`。小数第 2 位に丸められます。`exact` な見積もりで `X-Comfy-Credits-Used` が保持すると想定される値です。このヘッダーは事後に丸められた数値であり、領収書ではありません。ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。 + `amount` をプラットフォームの換算($1 = 211 クレジット)で Comfy クレジットに変換し、小数第 2 位で四捨五入したもの。`exact` の見積もりで `X-Comfy-Credits-Used` が持つと想定される数値です。このヘッダーは四捨五入された事後的な数値であり、領収書ではありません。最終的な請求額は、ワークスペースの使用量と請求記録にある確定請求額です。 double - この見積もりが対象とするプロバイダーのレッグ。キュー中の送信では、実行されるレッグになります。 + この見積もりが対象とするプロバイダー側のレッグ。キュー中の送信では、実行されるレッグです。 - 正規の Comfy Router モデル ID で、`{provider}/{model}` の形式です。`POST /v2/models/{provider}/{model}` でモデルを指定する値とまったく同じもので、呼び出し元は何からも再導出することなくそのパスに埋め込めます。その `pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で連結したもので、`maxLength` はそれらの合計にその区切り文字を加えたものです。 + 正規の Comfy Router モデル ID で、`{provider}/{model}` の形式です。`POST /v2/models/{provider}/{model}` でモデルを指定する際の値とまったく同じであるため、呼び出し側は何かから再導出することなく、そのパスにそのまま埋め込むことができます。その `pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で結合したもので、`maxLength` はそれらの合計に区切り文字を加えた長さです。 - 型: [`RouterModelId`](#routermodelid)。モデル ID(例: `anthropic/claude-opus-4-6`)、最大 193 文字 + 型: [`RouterModelId`](#routermodelid)。モデル ID、例: `anthropic/claude-opus-4-6`、最大 193 文字 - この見積もりの価格算出に使用したレートカードを取得した日時。実行は、評価された時点で有効な料率で課金され、この瞬間の料率で課金されるわけではありません。レートカードが読まれなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格を算出できない `not_quotable` の呼び出し)は、見積もりが返された日時を示します。 + この見積もりの価格設定に使用したレートカードを取得した日時。見積もりは価格ロックではありません。実行は、評価時点で有効な料金で請求され、この時点の料金ではありません。ベンダーの公開価格表から取得した `estimated` 見積もり(ベンダーが報告するコストで請求されるモデル)では、代わりにその価格表を読み取った日付を持ちます。請求数量をその価格表から予測し、その後レートカードで価格設定するもの(ベンダーが報告するクレジットで請求されるモデル)では、2 つの日付のうち古い方を持ちます。レートカードを読み取らなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し)は、これは見積もりに回答した時点です。 date-time - `source` が `unknown` の場合のみ存在します。`not_quotable`(Router は実行前にこの呼び出しの価格を算出できません。価格がプロバイダーから返される内容に依存するか、リクエストボディが課金対象の数量を定めていないためです)、`unpriced_model`(レートカードにこのリクエストの価格がない)、`byok`(キュー中の送信のみ: 実行は自身のプロバイダーキーを使用するため、Comfy は何も請求しません)、または `pricing_unavailable`(キュー中の送信のみ: リクエストの受け入れ時にレートカードを読めませんでした。これは一時的なもので、実行は通常どおり課金されます)。それ以外の値は `not_quotable` として読み取ります。 + `source` が `unknown` の場合にのみ存在します。`not_quotable`(Router は実行前にこの呼び出しの価格を決定できません。価格がプロバイダーから返される内容に依存するか、リクエスト本文が請求対象の数量を制限していないためです)、`unpriced_model`(レートカードがこのリクエストを価格設定していません)、`byok`(キュー中の送信のみ:実行はユーザー自身のプロバイダーキーを使用するため、Comfy はその実行に対して何も請求しません)、または `pricing_unavailable`(キュー中の送信のみ:リクエストの受け付け時にレートカードを読み取れませんでした。これは一時的なもので、実行は通常どおり請求されます)。その他の値は `not_quotable` として扱います。 ### RouterErrorResponse -認証、アクセス、モデル検索、クォータ、プロバイダーの転送に関する失敗のエラーボディです。 +認証、アクセス、モデル検索、クォータ、プロバイダーのトランスポート失敗に対するエラーボディです。 **フィールド** - 失敗を人間が読める形で説明したもので、エンドユーザーに提示しても安全です。機械的にパースされることはありません。代わりに `error_type` で分岐してください。退役したモデルに対する `model_not_found` の場合、後継モデルが記録されていて呼び出し元から参照できるときは `detail` に ` was retired on ; use ` が入り、そうでないときは通常の候補リストではなく ` was retired on ` だけが入ります。ここで示される後継モデルは常に、呼び出しの向き先を変更できる有効なカタログ ID です。提供終了日がまだ未来であるモデルは退役していません。その日付までは `GET /v2/models` に一覧表示され、実行可能なままです。`detail` の他の部分と同様に、この退役に関する文言は表示用であり、互換性の保証はありません。機械的にパースされないというルールには、文書化された 2 つの例外があります。`POST /v2/models/{provider}/{model}` では、`409` が `invalid_input` バケットを共有する 3 つの無関係な条件に対して返され、それらを区別するのは `detail` だけです。`detail` が「this request's `image` selects the edit operation」で始まる場合は multipart の `model_provider` 拒否であり、`detail` が `this request resolved a BYOK credential` で始まる場合は BYOK の `model_provider` 拒否です。どちらも新しい `Idempotency-Key` では解消しません。そのルートにおける他の `invalid_input` の `409` はキーの競合です。どちらのプレフィックスも安定した契約用語であり、マッチングしてもかまいません。これ以外の箇所では、`detail` で分岐することに互換性の保証はありません。 + 失敗についての人間が読める説明で、エンドユーザーに提示しても安全です。機械的にパースされることは想定されていません。代わりに `error_type` で分岐してください。退役したモデルに対する `model_not_found` では、後継モデルが記録されていて呼び出し元から参照できる場合、`detail` は ` was retired on ; use ` となり、そうでない場合は通常の候補リストの代わりに ` was retired on ` だけになります。ここに示される後継モデルは、常に呼び出しを再ポイントできる有効なカタログIDです。サンセット日がまだ未来であるモデルは退役していません。`GET /v2/models` にリストされ続け、その日付まで実行可能なままです。`detail` の他の部分と同様、この退役に関する文言は表示用であり、互換性の保証はありません。機械的にパースされないというルールには、文書化された2つの例外があります。`POST /v2/models/{provider}/{model}` では、`409` は `invalid_input` バケットを共有する3つの無関係な条件に対して返され、それらを区別するのは `detail` だけです。「this request's `image` selects the edit operation」で始まる `detail` はマルチパートの `model_provider` 拒否であり、「this request resolved a BYOK credential」で始まる `detail` は BYOK の `model_provider` 拒否です。どちらも新しい `Idempotency-Key` では解消されません。そのルート上の他の `invalid_input` の `409` はキーの競合です。どちらのプレフィックスも安定した契約用語であり、マッチングに使用できます。他のどこでも、`detail` での分岐に互換性の保証はありません。 - 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` ではなくプレーンな文字列になっています。したがってクライアントは、認識できない値を `internal_error` として扱うべきであり、上記のリストを網羅的に switch して次の追加で壊れてはいけません。 - 型: [`RouterErrorType`](#routererrortype) + Type: [`RouterErrorType`](#routererrortype) - モデルプロバイダーがリクエストを拒否した理由を、範囲を限定してサニタイズしたものです。`error_type` が `invalid_input` で、`X-Comfy-Upstream-Status` がプロバイダーの `4xx` または `2xx` の場合にのみ存在します。つまり、プロバイダーがリクエストを不正な形式として拒否し、その理由を述べた場合です。通常このステータスは `4xx` です。成功のエンベロープ内で拒否された生成を報告するプロバイダーでは `2xx` になります(BytePlus の失敗タスクのポーリングは HTTP `200` で、理由はボディに含まれます)。それ以外のすべての失敗では存在しません。プロバイダーの `5xx`、トランスポートの失敗、コンテンツポリシーによる拒否、および Router が自身について発生させた拒否が含まれます。`X-Comfy-Upstream-Detail` ヘッダーに反映されます。 + モデルプロバイダーがリクエストを拒否した理由のうち、範囲を限定してサニタイズしたものです。`error_type` が `invalid_input` で、`X-Comfy-Upstream-Status` がプロバイダーの `4xx` または `2xx` の場合にのみ存在します。つまり、プロバイダーがリクエストを不正な形式として拒否し、その理由を述べた場合です。通常そのステータスは `4xx` です。プロバイダーが拒否された生成を成功のエンベロープ内で報告する場合(BytePlus の失敗タスクのポーリングは HTTP `200` で、理由がボディに含まれます)は `2xx` になります。プロバイダーの `5xx`、トランスポート失敗、コンテンツポリシー拒否、Router 自身に関するあらゆる拒否など、他のすべての失敗では存在しません。`X-Comfy-Upstream-Detail` ヘッダーを反映します。 - コンテンツポリシーによる拒否がどの入力または出力に関するものかを、Router レベルの閉じた語彙として示します。`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio` です。プロバイダーがモダリティを特定しなかった場合、単なる `input` / `output` の値がどちら側かを示します。`error_type` が `content_policy_violation` で、プロバイダーが拒否された対象を機械可読なコードで示した場合にのみ存在し、それ以外では存在しません。プロバイダーのテキストが入ることはありません。現在は BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI、Wan の拒否に対して、また MiniMax Router の Nano Banana レッグにおける Gemini の拒否に対しても付与されます。拒否がどちら側に関するものかを示さないプロバイダーでは存在しません。`X-Comfy-Refusal-Subject` ヘッダーに反映されます。 + コンテンツポリシー拒否がどの入力または出力に関するものかを、Router レベルの閉じた語彙で示します。`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio` です。プロバイダーがモダリティを指定しなかった場合、素の `input` / `output` 値がどちら側かを示します。`error_type` が `content_policy_violation` で、プロバイダーが拒否対象を機械可読なコードで指定した場合にのみ存在し、それ以外では存在しません。プロバイダーのテキストでは決してありません。現在、BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI、Wan の拒否と、MiniMax Router の Nano Banana レグの Gemini 拒否について名前が付きます。拒否がどちら側に関するものかを示さないプロバイダーでは存在しません。`X-Comfy-Refusal-Subject` ヘッダーを反映します。 + + + + パートナーノードの支出拒否に対する請求のポリシー分岐です。請求対象のウォレットが空の場合は `no_funds`、資金の読み取りがそう示さずに呼び出しが拒否された場合は `unspecified` です。`error_type` が `insufficient_credits` で、デプロイメントがウォレットの情報を報告する場合にのみ存在し、それ以外では存在しません。表示テキストではなく機械可読なコードです。`detail` を表示し、分岐はこの値で行ってください。 + + + + 拒否された呼び出しが請求するはずだったウォレットを、`RouterErrorResponse.billed_workspace` で示します。「どのウォレットが空なのか?」に答えるものであり、呼び出し元の UI が現在選択しているワークスペースとは限りません。資金のあるチームが開いていても、チームメンバーの個人クレデンシャルはここに個人ウォレットを示します。`denied_reason` と一緒にのみ存在します。 + + Type: [`RouterBilledWorkspace`](#routerbilledworkspace) + + + + 拒否されたリクエストがどのように認証されたかを示します。`personal_api_key`、`team_api_key`、`personal_session`、`team_session` のいずれかです。「もう一方のウォレットに請求するには、どのクレデンシャルに切り替えればよいか?」に答えます。これは権限ではなく、何も付与しません。`denied_reason` と一緒にのみ存在します。 -### RouterErrorType +### RouterErrorType {#routererrortype} 機械可読な Router エラーカテゴリ。`X-Comfy-Error-Type` ヘッダーでも送信されます。 @@ -1142,19 +1178,19 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 ### RouterModelBilling -モデルを呼び出す前に確認すべき課金動作。価格や使用量は含みません。 +モデルを呼び出す前に確認すべき課金動作。価格や使用量は含まれません。 **フィールド** - コンテンツポリシーを理由にこのモデルが拒否した呼び出しでも、呼び出し元に課金されるかどうか。プロバイダーによって異なり、その違いは呼び出し時には見えず、同じ呼び出しでエラーと課金の両方を見たユーザーには知りようがありません。そのため、プロバイダーごとの伝聞に任せるのではなく、モデルごとに、呼び出しの前に明示されます。 + このモデルがコンテンツポリシーを理由に拒否した呼び出しが、それでも呼び出し元に課金されるかどうか。プロバイダーごとに異なり、その違いは呼び出し時には見えず、同じ呼び出しに対してエラーと課金の両方を見たユーザーには知りようがありません。そのため、プロバイダーごとの言い伝えに任せるのではなく、呼び出し前にモデルごとに明記しています。`yes` の場合、同期ルートの `content_policy_violation` エラーは `X-Comfy-Credits-Used` を含むことがあります。プロバイダーがモデルの生成済み出力を拒否し、Comfy がその拒否された生成に対して使用量を記録した場合に含まれ、その量が示されます。入力側の拒否、同一キーのリプレイ(`Idempotent-Replayed: true`)、およびヘッダーの小数点以下2桁に表示されないほど少額の課金には含まれません。ヘッダーのない拒否は報告されないだけで、無料だった証拠ではありません。 型: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) ### RouterModelDetail -1つの Comfy Router モデルに関するモデルごとの詳細: カタログ一覧がそのモデルについて報告するすべての情報に加え、単一モデルのルートだけが持つモデル単位のフィールドです。 +1つの Comfy Router モデルに関するモデルごとの詳細: カタログ一覧がそのモデルについて報告するすべての内容に加え、単一モデルルートのみが持つモデルごとのフィールド。 [`RouterModelListEntry`](#routermodellistentry)、[`RouterModelDetailFields`](#routermodeldetailfields) を構成します。 @@ -1162,310 +1198,310 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 ### RouterModelDetailFields -モデル詳細エンドポイントが返すオプションのフィールドです。 +モデル詳細エンドポイントが返す任意のフィールド。 **フィールド** - このモデルの OpenAPI ドキュメントの URL。入力スキーマと出力スキーマを含みます。 + このモデルのOpenAPIドキュメントのURL。入力スキーマと出力スキーマを含みます。 - HTTPS URL(例: `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`)、最大 2048 文字 + HTTPS URL(例: `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`)、最大2048文字 ### RouterModelId -`POST /v2/models/{provider}/{model}` で使用されるモデルIDです。 +`POST /v2/models/{provider}/{model}` で使用されるモデル ID。 -型: `string`。モデルID(例: `anthropic/claude-opus-4-6`)、最大193文字 +型: `string`。モデル ID(例: `anthropic/claude-opus-4-6`)、最大 193 文字。 ### RouterModelInput -モデルの入力オブジェクトです。フィールドと検証については、選択済みモデルのOpenAPIドキュメントを参照してください。 +モデル入力オブジェクトです。フィールドと検証については、選択済みモデルの OpenAPI ドキュメントを参照してください。 型: `object` ### RouterModelInputSchemaDocument -1つのモデルの入力と出力を記述した、独立した OpenAPI ドキュメント。 +1つのモデルの入力と出力のためのスタンドアロンOpenAPIドキュメントです。 -型: `object` +Type: `object` ### RouterModelListEntry -モデルの ID と課金情報です。 +モデルの ID と課金情報。 **フィールド** - 正規の Comfy Router モデル ID、`{provider}/{model}` です。これは `POST /v2/models/{provider}/{model}` でモデルを指定する値そのものなので、呼び出し側は他の何かから再導出することなくこのパスに埋め込むことができます。`pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で連結したもので、`maxLength` はそれらの合計にこの区切り文字を加えた長さです。 + 正規の Comfy Router モデル ID である `{provider}/{model}`。これは `POST /v2/models/{provider}/{model}` でモデルを指定する値そのものであり、呼び出し元は何かから再導出することなく、そのままこのパスに埋め込むことができます。`pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で連結したもので、`maxLength` は両者の長さの合計にその区切り文字を加えた値です。 - 型: [`RouterModelId`](#routermodelid) -- モデル ID、例: `anthropic/claude-opus-4-6`、最大 193 文字 + 型: [`RouterModelId`](#routermodelid):モデル ID(例: `anthropic/claude-opus-4-6`)、最大 193 文字 - 正規の `{provider}/{model}` モデル ID の小文字の `provider` セグメントで、どのパートナーのモデルを扱うかを示します。呼び出しルートの `provider` パスパラメータとカタログエントリの `provider` フィールドはどちらもこの 1 つのスキーマを参照しており、これによって一覧に載る ID と受け付ける ID が食い違わないようになっています。 + 正規の `{provider}/{model}` モデル ID のうち小文字の `provider` セグメント。対象となるモデルを提供するパートナーを指します。呼び出しルートの `provider` パスパラメーターとカタログエントリの `provider` フィールドはどちらもこの 1 つのスキーマを参照しており、これによって一覧に載る ID と受け付ける ID が食い違わないようになっています。 - 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ、例: `anthropic`、最大 64 文字 + 型: [`RouterProviderSegment`](#routerprovidersegment):英数字スラッグ(例: `anthropic`)、最大 64 文字 - 正規の `{provider}/{model}` モデル ID の小文字の `model` セグメントで、そのプロバイダー内で実行するモデルを指します。呼び出しルートの `model` パスパラメータとカタログエントリの `model` フィールドで共有されており、`RouterProviderSegment` と同じく食い違いを防ぐためです。 + 正規の `{provider}/{model}` モデル ID のうち小文字の `model` セグメント。そのプロバイダー内で実行するモデルを指します。呼び出しルートの `model` パスパラメーターとカタログエントリの `model` フィールドで共有されており、`RouterProviderSegment` と同じく食い違いを防ぐための構成です。 - 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ、例: `claude-opus-4-6`、最大 128 文字 + 型: [`RouterModelSegment`](#routermodelsegment):英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字 - 呼び出しの前に呼び出し側が必要とするモデルごとの課金情報です。価格ではありません。使用量やコストの数値はここには現れません。 + 呼び出し元が呼び出しの前に必要とする、モデルごとの課金情報。価格ではありません。使用量やコストの数値がここに現れることはありません。 型: [`RouterModelBilling`](#routermodelbilling) - このモデルの `GET /v2/models/{provider}/{model}/openapi.json` ドキュメントの現在の強力な `ETag` です。スキーマが変わっていない間に `304` を得るには、その読み取りで `If-None-Match` としてこれを送信します。また、前回確認した値と比較すれば、すべてのドキュメントを取得することなく、どのモデルのスキーマが変わったかを知ることができます。この呼び出し元に対してその読み取りが現時点で `200` を返さない場合、この値は存在しません。スキーマサービスが利用不可である、モデルのドキュメントをレンダリングできない、またはレスポンスの構築中にモデルがこの呼び出し元にとって利用不可になった、といった場合です。タグが存在しないことはスキーマの変更ではありません。モデルのドキュメントを再読み取りして、現在のタグを確認してください。 + このモデルの `GET /v2/models/{provider}/{model}/openapi.json` ドキュメントの現在の strong `ETag`。スキーマが変わっていない間に `304` を得たい場合は、その読み取りで `If-None-Match` として送信します。また、前回確認した値と比較すれば、すべてのドキュメントを取得しなくても、どのモデルのスキーマが変更されたかを知ることができます。この呼び出し元に対してその読み取りが現時点で `200` を返さない場合、この値は省略されます。スキーマサービスが利用不可である、モデルのドキュメントをレンダリングできない、またはレスポンスの構築中にそのモデルがこの呼び出し元にとって利用不可になった場合です。タグが存在しないことはスキーマの変更を意味しません。現在のタグを知るには、モデルのドキュメントを再読み取りしてください。 ### RouterModelListResponse -Router モデルカタログの 1 ページです。 +Router モデルカタログの 1 ページ分です。 **フィールド** - このページのモデルで、最大 `limit` 件です。 + このページに含まれるモデルで、最大 `limit` 件です。 型: [`RouterModelListEntry`](#routermodellistentry) の配列 - このページより先に別のページが存在するかどうか。これが true である間は辿り続けてください。短い、または空の `data` からカタログの終端を推測しないでください。 + このページより後に別のページが存在するかどうか。この値が true の間は取得を続けてください。`data` が短い、または空であることからカタログの終端を推測しないでください。 - Router リストへの不透明なカーソルです。これはサーバーによって生成され、そのまま往復させるだけのものです。オフセットではなく、モデル ID でもなく、順序付けもされておらず、カタログの再構築をまたいで安定もしません。したがって、カーソルを解析したり、インクリメントしたり、それが得られた走査を超えて永続化したりすることは、いずれも契約の範囲外です。オフセットではなくカーソルを用いるのは、カタログが変化し続けるリストだからです。走査の途中でエントリが追加または削除されると、オフセットによる走査は気付かないうちにエントリをスキップしたり繰り返したりしますが、呼び出し側はそれが起きたことを判別できません。 + Router のリストを指す不透明なカーソルです。これはサーバーが生成するもので、往復してそのまま渡すことだけが想定されています。オフセットではなく、モデル ID でもなく、順序を持たず、カタログの再構築をまたいで安定もしません。そのため、パースする、インクリメントする、取得元の走査を超えて永続化する、といった扱いはすべて契約の範囲外です。オフセットではなくカーソルを使うのは、カタログが動的に変化するリストだからです。オフセットによる走査では、走査の途中でエントリが追加または削除されると、エントリを暗黙にスキップしたり重複して返したりしますが、呼び出し側はそれが起きたことを判別できません。 - 型: [`RouterPageCursor`](#routerpagecursor): `next_cursor` として返される不透明なカーソル、1〜512 文字 + 型: [`RouterPageCursor`](#routerpagecursor) -- `next_cursor` として返される不透明なカーソル、1〜512 文字 - 実際に提供されたページサイズです。最大値を超える `limit` を要求した場合、拒否されるのではなく最大値に切り下げられます。そのため、これは要求した値より小さくなることがあります。送信した値ではなく、この数値でページネーションしてください。さもないと、実際には受け取っていない行が存在すると想定してしまいます。 + 実際に返されたページサイズ。最大値を超える `limit` を要求した場合は拒否されず最大値に切り詰められるため、要求した値より小さくなることがあります。送信した値ではなくこの数値でページングしてください。そうしないと、実際には受け取っていない行が存在するとみなしてしまいます。 1〜100 ### RouterModelOutput -モデルの結果オブジェクト。正確な形状については、選択済みモデルの出力スキーマを参照してください。 +モデルの結果オブジェクトです。正確な形状については、選択済みモデルの出力スキーマを参照してください。 型: `object` ### RouterModelSegment -`{provider}/{model}` 形式のモデル ID におけるモデル部分。 +`{provider}/{model}` 形式のモデル ID のうち、モデル部分を表します。 -型: `string` -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 +型: `string`。英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字です。 ### RouterPageCursor -カタログの不透明なカーソル。`cursor` として変更せずにそのまま渡し直してください。 +不透明なカタログカーソルです。受け取った値は変更せず、そのまま `cursor` として渡してください。 -型: `string` -- `next_cursor` として返される不透明なカーソル。1〜512文字 +型: `string` -- `next_cursor` として返される不透明なカーソル、1–512文字 ### RouterProviderSegment -`{provider}/{model}` というモデル ID のうち、プロバイダー部分。 +`{provider}/{model}` 形式のモデル ID のうち、プロバイダー部分です。 -型: `string`。英数字のスラッグ(例: `anthropic`)、最大 64 文字 +型: `string`。英数字スラッグ(例: `anthropic`)、最大 64 文字です。 ### RouterQueueCancelResponse -このルートが解決したリクエストを記述する 2 つのステータス、`202` と `409` に対するキャンセル要求への応答です。成功エンベロープとエラーエンベロープに分けるのではなく、両方で 1 つのボディ形状を共有します。どちらも同じ表明、つまりキャンセルが何を見つけたかを示すものであり、ステータスコードごとに異なる型をパースしなければならないクライアントにとって、分割には何の利点もないからです。 +このルートが解決したリクエストを表す2つのステータス(`202` と `409`)における、キャンセル要求への応答です。成功エンベロープとエラーエンベロープに分けるのではなく、両方で1つのボディ形状を共有します。どちらも同じ内容(キャンセルで見つかったこと)を表しており、ステータスコードごとに異なる型をパースしなければならないクライアントは、分割から何も得られないからです。 **フィールド** - キュー中の Router リクエスト 1 つを識別するもの。呼び出し元がポーリング、キャンセル、結果の収集に使うハンドルです。 + キュー中の Router リクエスト1件の識別子。呼び出し元がポーリング、キャンセル、結果の収集に使用するハンドルです。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大 36 文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid)、`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大36文字 - このルートが実際に解決したリクエストを記述する 2 つの結果について、キャンセル要求が何を見つけたか。どちらも HTTP ステータスに反映されるため、クライアントはどちらで分岐してもかまいません。 + キャンセル要求で見つかった内容を、このルートが実際に解決したリクエストを表す2つの結果について示します。どちらも HTTP ステータスに反映されるため、クライアントはどちらで分岐してもかまいません。 型: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) ### RouterQueueCancelStatus -このルートが実際に解決したリクエストを表す2つの結果について、キャンセル要求が何を検出したかを示します。どちらも HTTP ステータスに反映されるため、クライアントはどちらで分岐してもかまいません。 +このルートが実際に解決したリクエストを表す2つの結果について、キャンセル要求が見つけた内容を示します。どちらもHTTPステータスに反映されるため、クライアントはどちらを基準に分岐してもかまいません。 -型: `string` +型: `文字列` ### RouterQueuePosition -応答が構成された時点で、キュー内でこのリクエストより前に並んでいるリクエストの数。0 はこのリクエストが先頭であることを意味します。 +レスポンスが生成された時点で、このリクエストよりキュー内で先行しているリクエストの数。0 はこのリクエストが先頭であることを意味します。 -型: `integer` -- 0 以上 +型: `integer`、0 以上。 ### RouterQueueRequestId キュー中の Router リクエスト1件の識別子。呼び出し元がポーリング、キャンセル、結果の取得に使用するハンドルです。 -型: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大36文字 +型: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字 ### RouterQueueStatus -キュー中の Router リクエストの状態です。取り得る値はちょうど 3 つで、`RouterErrorType` とは異なり、こちらは閉じた `enum` です。これは 2 つのスキーマが意図的に逆方向へ閉じているためです。`RouterErrorType` は失敗を分類するもので、その集合は今後増えていくことが想定されています。そのため、認識できないバケットを厳格に拒否する生成済みクライアントは、何かがすでに問題を起こしているまさにそのときに、最も激しく失敗することになります。一方、こちらはライフサイクルです。後で 4 つ目の状態が追加されたライフサイクルは、enum として宣言されているかどうかにかかわらず、それに対して書かれたすべてのポーリングループにとって破壊的変更になります。そこでこれは enum として宣言され、その制約はクライアントから見える場所に明記されています。 +キュー中の Router リクエストの状態です。値はちょうど3つで、`RouterErrorType` と違いこちらは閉じた `enum` です。これは、2つのスキーマが意図的に逆方向へ閉じられているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えていくことが想定されています。そのため、未知のバケットを厳密に拒否する生成済みクライアントは、何かがすでにうまくいっていないときにこそ最も激しく失敗することになります。一方こちらはライフサイクルであり、後で4番目の状態が追加されたライフサイクルは、enum として宣言されているかどうかにかかわらず、それに対して書かれたすべてのポーリングループにとって破壊的変更になります。そのため enum として宣言され、制約はクライアントが見られる場所に記述されています。 型: `string` ### RouterQueueStatusFields -`RouterQueueStatusResponse` のうち URL ブロックではない半分: キュー中の 1 つのリクエストの識別情報、その現在の状態、そしてその状態がターミナルで実行が成功しなかった場合には、その理由を示す大まかな分類です。 +`RouterQueueStatusResponse` のうち URL ブロックではない半分です。キュー中の 1 リクエストの識別子、その現在の状態、そしてその状態がターミナルで実行が成功しなかった場合には、その理由を示す粗い分類を持ちます。 -**Fields** +**フィールド** - キュー中の Router リクエストを識別するもの。呼び出し元がポーリング、キャンセル、結果の収集に使用するハンドルです。 + キュー中の 1 つの Router リクエストの識別子。呼び出し側がポーリング、キャンセル、結果の取得に使うハンドルです。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 + Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 - キュー中の Router リクエストの状態です。これはちょうど 3 つの値を持ち、`RouterErrorType` とは異なり閉じた `enum` です。これは、2 つのスキーマが意図的に逆方向に閉じているためです。`RouterErrorType` は失敗を分類し、その集合は拡張されることが想定されているため、認識されない分類を厳密に拒否する生成済みのクライアントは、何かが既にうまくいかなくなったまさにその時に最も大きな失敗をすることになります。こちらはライフサイクルであり、後で第 4 の状態が追加されたライフサイクルは、enum として宣言されているかどうかに関係なく、それに対して書かれたすべてのポーリングループにとって破壊的変更となります。そのため enum として宣言されており、制約はクライアントが確認できる場所に記載されています。 + キュー中の Router リクエストの状態。値はちょうど 3 つしかなく、`RouterErrorType` と違ってこれは閉じた `enum` です。これは 2 つのスキーマが意図的に逆方向へ閉じられているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えていくことが想定されているため、未知の分類を厳格に拒否する生成済みクライアントは、何かがすでに失敗したまさにその場面で最も大きく失敗することになります。こちらはライフサイクルであり、後から 4 つ目の状態が追加されるライフサイクルは、enum として宣言されているかどうかに関係なく、それに合わせて書かれたすべてのポーリングループにとって破壊的変更になります。そのため enum として宣言され、制約はクライアントから見える場所に明記されています。 - 型: [`RouterQueueStatus`](#routerqueuestatus) + Type: [`RouterQueueStatus`](#routerqueuestatus) - 応答が構成された時点で、キュー内でこのリクエストの前に何件のリクエストがあるかを示します。0 はこのリクエストが先頭にあることを意味します。 + レスポンスが構成された瞬間に、このリクエストより前のキューに並んでいるリクエストの数。0 はこのリクエストが先頭であることを意味します。 - 型: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 + Type: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 - 成功しなかった `COMPLETED` リクエストにのみ存在し、結果の読み取りがその失敗を返すときに `X-Comfy-Error-Type` に付けるのと同じ大まかな分類を持ちます。これは成功したターミナルリクエストと、失敗またはキャンセルされたリクエストを区別するものです。どちらにも別個のターミナルステータスはありません。また、成功時には null ではなく存在しないため、その存在の有無で分岐してください。 + 成功しなかった `COMPLETED` リクエストにのみ存在し、結果の読み取りがその失敗を返すときに `X-Comfy-Error-Type` に載せるのと同じ粗い分類を持ちます。これは、成功したターミナルリクエストと、失敗またはキャンセルされたリクエストを区別するためのものであり、どちらにも別個のターミナルステータスはありません。また成功時には null ではなく存在しないため、その有無で分岐してください。 - 型: [`RouterErrorType`](#routererrortype) + Type: [`RouterErrorType`](#routererrortype) ### RouterQueueStatusResponse -キュー中の1件のリクエストの現在の状態を、送信時に返されたものと同じ3つのURLと組み合わせて構成したものです。 +キュー中のリクエスト1件の現在の状態を、送信時に返されたものと同じ3つのURLと組み合わせたものです。 -[`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueStatusFields`](#routerqueuestatusfields)を組み合わせます。 +[`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueStatusFields`](#routerqueuestatusfields) を組み合わせます。 型: `object` ### RouterQueueSubmitFields -`RouterQueueSubmitResponse` のうち、URL ブロックではない半分です。新しいリクエストの識別情報と、それが受け付けられた時点の状態を表します。 +`RouterQueueSubmitResponse` のうち URL ブロックではない半分です。新しいリクエストの識別情報と、それが受け付けられた瞬間の状態を表します。 **フィールド** - キュー中の Router リクエスト 1 件の識別子です。呼び出し側がポーリングし、キャンセルし、結果を取得するときのハンドルになります。 + キュー中の Router リクエスト 1 件の識別子。呼び出し元がポーリング、キャンセル、結果の取得に使うハンドルです。 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大 36 文字 - キュー中の Router リクエストの状態です。値はちょうど 3 つあり、`RouterErrorType` とは異なりこちらは閉じた `enum` です。これは 2 つのスキーマが意図的に逆方向に閉じているためです。`RouterErrorType` は失敗を分類するもので、その集合は今後増えていくことが想定されています。そのため、認識できない区分を厳格に拒否する生成済みのクライアントは、まさに何かがすでに失敗したときに最も激しく失敗することになります。一方こちらはライフサイクルであり、後で 4 つ目の状態が追加されるライフサイクルは、enum として宣言されているかどうかにかかわらず、それに対して書かれたすべてのポーリングループにとって破壊的変更になります。そこで enum として宣言し、その制約はクライアントから見える場所に明記しています。 + キュー中の Router リクエストの状態です。値はちょうど 3 つしかなく、`RouterErrorType` とは異なり、これは閉じた `enum` です。2 つのスキーマは意図的に逆方向へ閉じられているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えることが想定されるため、未知の分類を生成済みクライアントが厳格に拒否すると、何かがすでに失敗したまさにそのときに最も大きく失敗することになります。一方こちらはライフサイクルであり、後から 4 つ目の状態を追加するライフサイクルは、enum として宣言されているかどうかに関わらず、それに合わせて書かれたすべてのポーリングループにとって破壊的変更となります。だからこそ enum として宣言し、その制約をクライアントから見える場所に明記しているのです。 型: [`RouterQueueStatus`](#routerqueuestatus) - レスポンスが構成された時点で、キューのうちこのリクエストより前に何件のリクエストがあるかを示します。0 はこのリクエストが先頭にあることを意味します。 + レスポンスが構成された瞬間に、このリクエストよりキューで前に並んでいるリクエストの数です。0 はこのリクエストが先頭であることを意味します。 型: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 - このリクエストの事前コスト見積もりです。呼び出し側に対してコスト見積もりが有効になっている場合、新規受け付け時に含まれます。このリクエストがピン留めされたプロバイダーのレッグを見積もります(キューにはフォールバックループがないため、`fallback_provider` が実行されるレッグを変えることはありません)。数値を提示できない場合でも、`source: unknown` を伴って常に存在します。見積もりのせいで送信が失敗することはありません。冪等なリプレイ(`Idempotent-Replayed: true`)では省略されます。オリジナルの見積もりは保存されないためです。これは見積もりであり、最終的な請求額ではなく、価格の固定でもありません。実行はレーティングが行われる時点で有効な料金で課金され、ワークスペースの使用量および請求記録に確定した請求額が最終となります。 + このリクエストの事前コスト見積もりです。呼び出し元に対してコスト見積もりが有効になっている場合、新規受け付け時に含まれます。このリクエストがピン留めされたプロバイダー側のレグを見積もります(キューにはフォールバックループがないため、`fallback_provider` が実行されるレグを変えることはありません)。数値を提示できない場合でも `source: unknown` として存在し、見積もりのせいで送信が失敗することはありません。冪等なリプレイ時(`Idempotent-Replayed: true`)には、オリジナルの見積もりが保存されていないため省略されます。これは見積もりであって最終的な請求額ではなく、価格の固定でもありません。実行はレーティング時点で有効なレートで課金され、ワークスペースの使用量および請求記録に確定した請求額が最終となります。 型: [`RouterCostEstimate`](#routercostestimate) ### RouterQueueSubmitResponse -実行がキューに受け入れられたときに返されるハンドルです。リクエストの識別情報と状態を、そのライフタイムの残りの部分に対応する 3 つの URL と組み合わせたものです。 +実行がキューに受け入れられたときに返されるハンドル。リクエストの識別情報と状態を、そのライフサイクルの残りを扱う3つのURLと組み合わせたものです。 -[`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueSubmitFields`](#routerqueuesubmitfields) を合成します。 +[`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueSubmitFields`](#routerqueuesubmitfields) を組み合わせます。 型: `object` ### RouterQueueUrls -キュー中の 1 件のリクエストのライフタイムの残りに対応する 3 つの URL です。有効なハンドルを含むすべてのレスポンスで返されるため、クライアントがキュー URL を自分で組み立てることはありません。 +キュー中の1つのリクエストの残りのライフサイクルを扱う3つのURLです。有効なハンドルを含むすべてのレスポンスで返されるため、クライアントがキューのURLを自分で組み立てることはありません。 **フィールド** - このリクエストのステータス読み取りの絶対 URL。 + このリクエストのステータスを読み取るための絶対URL。 URI - このリクエストの結果を取得する絶対 URL。 + このリクエストの結果を取得する絶対URL。 URI - キャンセルを要求する絶対 URL。 + キャンセルを要求する絶対URL。 URI ### RouterValidationErrorContext -失敗した検証ルールについて、プロバイダーから提供される詳細情報。 +失敗した検証ルールに関するプロバイダー提供の詳細。 型: `object` ### RouterValidationErrorDetail -単一のフィールドレベルの検証失敗。 +1 件のフィールドレベルの検証失敗。 **フィールド** - 問題のあるフィールドへのパス。最も外側のセグメントが先頭になります。たとえば `["body", "image_url"]`、または `["body", "images", 0]` のように、整数は配列へのインデックスを表します。 + 問題のあるフィールドへのパス。最も外側のセグメントが先頭です。たとえば `["body", "image_url"]`、または整数が配列内のインデックスを表す場合は `["body", "images", 0]` のようになります。 - この 1 件の失敗を人間が読める形で説明したもの。 + この 1 件の失敗についての人間が読める説明。 - この失敗の具体的で機械可読な理由。プロバイダーからそのまま渡されます。これは型付き SDK の例外階層が分岐に使う値であり、レスポンスヘッダーの `error_type` はその粗い区分にすぎません。 + この失敗の具体的で機械可読な理由。プロバイダーから変更されずにそのまま渡されます。型付き SDK の例外階層が分岐に使うのはこの値です。レスポンスヘッダーの `error_type` は、その大まかな分類にすぎません。 - 1 つの `RouterValidationErrorDetail` で違反した境界値。プロバイダーからそのまま引き継がれます。たとえば `greater_than` に対応する `{"limit_value": 8}`、`image_too_small` に対応する `{"min_width": 512}`、`file_too_large` に対応する `{"max_size_bytes": 10485760}` などです。キー集合はプロバイダーとエラータイプに固有であるため、これは意図的にオープンなオブジェクトとしています。固定のフィールドリストに狭めたり、`msg` 文字列に畳み込んだりすることこそが、移植された統合がコンパイルは通るものの、境界値を読んでいた分岐を黙って失う原因そのものです。エラータイプが境界値を持たない場合は存在しません。 + 1 つの `RouterValidationErrorDetail` で違反した境界値。プロバイダーからそのまま渡されます。たとえば `greater_than` に対応する `{"limit_value": 8}`、`image_too_small` に対応する `{"min_width": 512}`、`file_too_large` に対応する `{"max_size_bytes": 10485760}` などです。キー集合はプロバイダーとエラー種別に固有であるため、これは意図的にオープンなオブジェクトとしています。固定のフィールドリストに絞り込んだり、`msg` 文字列に畳み込んだりすると、移植された統合はまさにコンパイルは通るものの、境界値を読んでいた分岐を黙って失うことになります。エラー種別が境界値を持たない場合は省略されます。 - 型: [`RouterValidationErrorContext`](#routervalidationerrorcontext) + Type: [`RouterValidationErrorContext`](#routervalidationerrorcontext) - 問題のある入力値。呼び出し元が `loc` から再導出することなく何が拒否されたかを確認できるよう、そのまま返されます。文字列、数値、ブール、配列、オブジェクト、null など任意の JSON 型を取りうるため、このスキーマはオブジェクトに狭めず、意図的に型なしのままにしています。プロバイダーが入力をそのまま返さない場合は存在しません。 + 問題のある入力値。呼び出し元が `loc` から再計算しなくても何が拒否されたかを確認できるよう、そのまま返されます。文字列、数値、ブール、配列、オブジェクト、null のいずれの JSON 型も取り得るため、このスキーマはオブジェクトに絞り込まず、意図的に型なしのままにしています。プロバイダーが入力をそのまま返さない場合は省略されます。 - 型: [`RouterValidationErrorInput`](#routervalidationerrorinput) + Type: [`RouterValidationErrorInput`](#routervalidationerrorinput) ### RouterValidationErrorInput -拒否された入力値です。プロバイダーがこれを含める場合に含まれます。 +プロバイダーが拒否された入力値を含める場合、その値です。 ### RouterValidationErrorResponse -`422` 検証エラーのレスポンスボディです。カテゴリの確認には `X-Comfy-Error-Type` を参照してください。 +`422` 検証エラーのレスポンス本文です。カテゴリは `X-Comfy-Error-Type` を参照してください。 **フィールド** - リクエストで検出されたすべての検証失敗です。問題のあるフィールドごとに 1 件のエントリが含まれます。 + リクエストで見つかったすべての検証失敗。問題のあるフィールドごとに1エントリです。 型: [`RouterValidationErrorDetail`](#routervalidationerrordetail) の配列 diff --git a/ja/tutorials/video/minimax/minimax-h3-fastvideo.mdx b/ja/tutorials/video/minimax/minimax-h3-fastvideo.mdx index fb12ea7d43..36a6454fcc 100644 --- a/ja/tutorials/video/minimax/minimax-h3-fastvideo.mdx +++ b/ja/tutorials/video/minimax/minimax-h3-fastvideo.mdx @@ -2,7 +2,7 @@ title: "FastVideo FastH3:ComfyUI ワークフロー例" description: "FastVideo FastH3 は ComfyUI で 8 サンプリングステップで同期オーディオ付きの MiniMax H3 動画を生成します。テキストから動画と先頭・末尾フレームのワークフローに対応。" sidebarTitle: "FastVideo FastH3" -translationSourceHash: 7cbe9703 +translationSourceHash: cb542dfa translationFrom: tutorials/video/minimax/minimax-h3-fastvideo.mdx translationBlockHashes: "_intro": 096c332e @@ -10,9 +10,10 @@ translationBlockHashes: "FastH3 Text to Video": 1c4cb909 "FastH3 Image to Video": ec7d82bf "Model downloads": b88037db - "Workflow structure notes": 0542b184 + "Workflow structure notes": 8f5d2153 --- + [FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2) は、FastVideo チームが MiniMax H3 を DMD2 で蒸留したチェックポイントで、ベースモデルの完全なスケジュールの代わりに **8 サンプリングステップ**でネイティブ同期オーディオ付きの動画を生成します。H3 のテキストエンコーダー、動画 VAE、オーディオ VAE をそのまま使うため、出力設定はベースモデルと同じままで、サンプリングだけが大幅に短縮されます。 FastH3 プレビューは Nuva Lab と NVIDIA FastGen チームとの共同開発によるものです。蒸留の詳細は [FastH3 発表記事](https://haoailab.com/blogs/fasth3-preview/) を参照してください。ComfyUI に同梱されているのは 8 ステップ V2 チェックポイントで、Comfy-Org が [FastVideo-FastH3-Comfy](https://huggingface.co/FastVideo/FastVideo-FastH3-Comfy) リポジトリで再パッキングしました。 @@ -133,11 +134,11 @@ ComfyUI/ ## ワークフロー構造のメモ -両方の FastH3 ワークフローは、ベースの H3 構成と以下のノードを共有し、蒸留固有の設定が加わっています: +両方の FastH3 ワークフローは、ベースの H3 構成と以下のノードを共有し、蒸留固有の設定を持ちます: -- **BlockSparseAttention**: Video Sparse Attention(VSA)を `keep_percent` 10、スケジュールの 20% から実行し、品質を保ちながら注意計算のコストを削減します -- **MiniMaxH3SigmaShift**: 蒸留スケジュールに合わせた H3 シグマシフト(動画 10、オーディオ 3)を適用します -- **ComfyMathExpression**: 長さの入力を、24fps の 17k+5 グリッド上の有効なフレーム `length` に変換します +- **BlockSparseAttention**: Video Sparse Attention(VSA)を `keep_percent` 10、スケジュールの 20% から実行し、品質を保ちながらアテンションのコストを削減します +- **MiniMaxH3SigmaShift**: 蒸留スケジュールに合わせた H3 シグマシフト(ビデオ 10、オーディオ 3)を適用します +- **ComfyMathExpression**: 再生時間の入力を、24fps の 17k+5 グリッド上の有効なフレーム `length` に変換します - **サンプラー**: `res_multistep` サンプラー、`simple` スケジューラ、8 ステップ -FastH3 のウェイトには `to_gate_compress` ゲート層があり、VSA の粗いブランチはこれを読みます。ベース H3 のチェックポイントにはありません。比較するには **Model Sparse Attention** ノードの `method` を `sol-attn` にし、シードを固定します。`sol-attn` は対応ウェイトを必要とせず、任意の H3 チェックポイントで設定した `tau` のまま動作します。 +FastH3 のウェイトには `to_gate_compress` ゲートレイヤーがあり、VSA の粗いブランチはこれを読みます。ベース H3 のチェックポイントにはありません。方法を比較するには、**Model Sparse Attention** ノードの `method` を `sol-attn` に設定し、同じシードを保ちます。`sol-attn` は対応するウェイトを必要とせず、設定した `tau` で任意の H3 チェックポイント上で動作します。 diff --git a/ja/tutorials/video/minimax/minimax-h3-prompt-guide.mdx b/ja/tutorials/video/minimax/minimax-h3-prompt-guide.mdx index d34f9acff9..6964451d70 100644 --- a/ja/tutorials/video/minimax/minimax-h3-prompt-guide.mdx +++ b/ja/tutorials/video/minimax/minimax-h3-prompt-guide.mdx @@ -2,17 +2,18 @@ title: "ComfyUI MiniMax H3 プロンプトガイド: 公式ガイド、ヒント、プロンプト埋め込み" description: "ComfyUI でより良い MiniMax H3 プロンプトを書く方法: MiniMax の公式プロンプト作成ガイド、一般的なプロンプトのコツ、セリフと話者のルール、スタイル埋め込み。" sidebarTitle: "プロンプトガイド" -translationSourceHash: 0d858ae8 +translationSourceHash: 0f1ded35 translationFrom: tutorials/video/minimax/minimax-h3-prompt-guide.mdx translationBlockHashes: "_intro": da22cc9d "Official guides": 3d762c67 - "General tips": 91822299 + "General tips": fab4ad35 "Shots and cuts": 8184dae6 "Dialogue and speakers": 4985438e "Prompt embeddings": 9c899169 --- + H3 は 1 つのマルチモーダルプロンプトにショット、カメラ、台詞、SFX を載せます。このページは公式ガイド、ワークフロー横断のヒント、ショット/台詞ルール、スタイル埋め込みをまとめます。 ## 公式ガイド @@ -26,7 +27,7 @@ H3 は 1 つのマルチモーダルプロンプトにショット、カメラ ## 一般的なヒント -I2VA は先頭に固定の画像位置合わせ行、空行、本文フィールド。FL2VA/L2VA は各モードの位置合わせ行; T2VA はフィールドから直接: +I2VA は固定の画像位置合わせ行で始まり、空行を挟んで本文フィールドが続きます。FL2VA/L2VA はそれぞれ独自の位置合わせ行を使用し、T2VA はフィールドから直接始まります: ```text integrated_multimodal_description: [Shot 1] ... @@ -34,19 +35,19 @@ overall_soundscape: ... non_diegetic_music: ... ``` -プロンプトは**英語**; 台詞/歌詞は ``; 画面文字は原文のまま。 +プロンプトは**英語**で記述します。台詞/歌詞は `` タグ内に、画面に表示する文字は元の言語のまま逐語的に記述します。 -1. **シーン優先**: 全体のあと `integrated_multimodal_description` の `[Shot 1]` 内ショット -2. **1 ブロック**: ショット、カメラ、オーディオ -3. **解像度**: 16:9 ネイティブ **1344×768**; **32** 倍数 -4. **長さ**: `length` は 24fps フレーム(既定 **124** ≈ 5s)、**17k+5** にスナップ -5. **画面文字**: 英語二重引用符、原文(例 `A red neon sign reading "营业中"`); 台詞は `` -6. **R2V オーディオマーカー**: `fully_copy`、`partially_copy`、`reference`、`weak_reference`(公式 ref 表参照) -7. **オーディオフィールド**: `overall_soundscape` は環境/SFX/非言語(1–4 文; 真の無音のみ `N/A`)。台詞とダイジェティック音楽はショット内。`non_diegetic_music` はスコアのみ(1–3 文; 無ければ `N/A`) -8. **ネガティブなし**: `BasicGuider` は `cfg` 1 でネガティブ分岐なし。禁止リストは逆効果; 出すべきものを書くか R2V 保持フィールドを使用 -9. **参照シート(R2V)**: 1 画像に複数パネル; 独自の ``(`` 内だけに書かない)を付け、ショットでパネル指定(例: `` の正面全身) +1. **シーンを先に**: まず全体のシーンを書き、次に `integrated_multimodal_description` の `[Shot 1]` 内に時間指定付きのショットを書く +2. **1 つのブロック**: ショット、カメラ、オーディオをまとめて記述する +3. **解像度**: 16:9 でネイティブ **1344×768**、**32** の倍数 +4. **長さ**: `length` は 24fps のフレーム数(既定 **124** ≈ 5s)で、**17k+5** にスナップされる +5. **画面文字**: 各文字列を英語の二重引用符で囲み、原文のまま記述する(例: `A red neon sign reading "营业中"`)。話される台詞には `` を使用し、引用符は使わない +6. **R2V オーディオマーカー**: 保持分析では、クリップの使われ方に合わせて各オーディオ参照を `fully_copy`、`partially_copy`、`reference`、`weak_reference` のいずれかでマークする(公式の ref ガイドの表を参照) +7. **オーディオフィールド**: `overall_soundscape` = 環境音/SFX/非言語音(1〜4 文。`N/A` は本当に無音の場合のみ)。台詞とダイジェティック音楽はショット内に残す。`non_diegetic_music` = スコアのみ(1〜3 文。なければ `N/A`)。不要な発話が現れる場合は、両方のフィールドを明示的に埋める +8. **ネガティブは使わない**: `BasicGuider` は `cfg` 1 で動作し、ネガティブ分岐はない。禁止リストは不要な概念を追加してしまう。表示すべき内容を記述する(または R2V の保持フィールド `fully_preserved`、`partially_preserved` などを使用する) +9. **参照シート(R2V)**: 1 枚の画像に複数のパネルを含めることができる。シート自体に専用の `` を付け(`` 内だけに書かない)、パネルを説明し、ショットからパネルを指定する(例: `` の正面全身)。パネルには明確にラベルを付ける -ワークフロー固有のタグは各ワークフローページへ。 +ワークフロー固有のタグとコントロールは各ワークフローページにあります。 ## ショットとカット diff --git a/ko/development/api-development/sdks.mdx b/ko/development/api-development/sdks.mdx index 8beead1205..cf612468d2 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 배포 @@ -141,7 +142,7 @@ const client = new Comfy({ apiKey: "comfyui-..." }); ### Comfy Cloud -즉시 사용할 수 있습니다. [API 키](/ko/development/api-development/getting-an-api-key)를 생성하여 클라이언트에 전달하세요. +별도 설정 없이 바로 작동합니다. [API 키](/ko/development/api-development/getting-an-api-key)를 생성하여 클라이언트에 전달하세요. API 액세스에는 유료 Comfy Cloud 구독이 필요합니다. 무료 티어에는 포함되지 않습니다. 동시에 실행할 수 있는 작업 수는 티어에 따라 다릅니다. [동시성 제한](/ko/development/deploy/cloud-usage#동시성-제한)을 참조하세요. @@ -151,13 +152,13 @@ const client = new Comfy({ apiKey: "comfyui-..." }); ### Comfy API 배포 -[개발자 플랫폼](https://platform.comfy.org)을 통해 배포한 워크플로에는 자체 엔드포인트가 제공됩니다. `COMFY_BASE_URL`을 해당 엔드포인트로 지정하고 Comfy Cloud와 동일하게 API 키를 사용하세요. 이 가이드의 모든 내용이 동일하게 작동합니다. 단, [작업 레이블과 작업 목록](#작업에-레이블을-붙이고-나중에-찾기)은 Comfy Cloud에서 아직 지원되지 않습니다. +[개발자 플랫폼](https://platform.comfy.org)을 통해 배포한 워크플로에는 자체 엔드포인트가 제공됩니다. `COMFY_BASE_URL`을 해당 엔드포인트로 지정하고, Comfy Cloud와 동일하게 API 키를 사용하세요. 이 가이드의 모든 내용이 같은 방식으로 작동합니다. 단, [작업 레이블과 작업 목록](#작업에-레이블을-붙이고-나중에-찾기)은 Comfy Cloud에서 아직 지원되지 않습니다. Comfy API 배포는 Build에 포함된 모델과 커스텀 노드를 사용하여 여러 워크플로를 실행할 수 있습니다. 각 작업에 대해 `get_workflow()`는 `format: "api"`를 가지며 실행된 그래프를 `.graph` 속성에 담은 워크플로 응답을 반환합니다. ### 자체 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에서는 ComfyUI와 함께 실행되는 작은 오픈소스 서비스인 [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy)가 v2 API를 제공합니다. 설치하고 실행한 다음 `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..e2eb40898b 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" diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index c1344131f1..bf39dca70d 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: 235802c5 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": cf6e2050 + "Models without a pre-flight estimate": 495bdb2b + "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,9 +103,9 @@ 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#실행-전-비용-예상)을 참조하세요. 실행 전에 가격을 산정할 수 없는 모델은 [사전 추정치가 없는 모델](#사전-견적이-없는-모델)에 나열되어 있습니다. ## 사전 견적이 없는 모델 @@ -114,36 +115,40 @@ 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` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`, `ideogram/p-image-ideogram` - **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` -- **luma**: `luma/photon-1`, `luma/photon-flash-1`, `luma/ray-2`, `luma/ray-flash-2` +- **luma**: `luma/photon-1`, `luma/photon-flash-1` - **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` - **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 명세](/ko/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..9a3a0befe5 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: 71f7e7b3 translationFrom: development/comfy-router/litellm.mdx translationBlockHashes: "_intro": 1ddb0d0a "Configure the pass-through": 380c3ae3 - "How spend is recorded": f852c18c + "How spend is recorded": 4a9dcb84 "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 응답에서 이 헤더를 읽어 요청의 지출로 기록하므로, 해당 모델에 대한 가격표를 유지할 필요가 없습니다. @@ -97,16 +98,17 @@ X-Litellm-Total-Tokens: 0 ### 비용을 보고하지 않는 실행 -일부 실행에는 `x-litellm-response-cost`가 포함되지 않습니다. `X-Comfy-Credits-Used`와 동일한 경우에 이 헤더도 존재하지 않습니다: +일부 실행에는 `x-litellm-response-cost`가 포함되지 않습니다. 이러한 경우 대부분은 `X-Comfy-Credits-Used`도 존재하지 않습니다: - Comfy 크레딧이 아니라 자신의 공급자 키로 청구되는 실행 - 아직 Router의 실행별 크레딧 가격을 보고하는 모델 목록에 없는 모델. 이 목록은 보수적이며, 일부 공급자는 아예 포함되지 않습니다 - Comfy 청구에 도달하지 못한 청구 -- 오류 응답 -또한 Router가 동일한 `Idempotency-Key`(프록시를 통해 `x-pass-Idempotency-Key`로 전송됨)로 재시도할 때 저장된 결과를 재생하는 경우에도 존재하지 않습니다. 해당 재시도에는 다시 요금이 부과되지 않으므로, 재생은 실행의 정확한 비용을 두 번째로 보고하지 않습니다. 같은 이유로, 대기 중인 실행의 결과 수집 중에서는 실행 가격이 기록된 이후의 첫 번째 수집만 이 헤더를 포함합니다. 동일한 결과를 다시 수집해도 여전히 `X-Comfy-Credits-Used`는 반환되지만 `x-litellm-response-cost`는 반환되지 않습니다. +한 가지 경우는 다릅니다: 오류 응답입니다. `billing.charges_on_policy_rejection`이 `yes`인 모델에서 발생한 동기 `content_policy_violation`은 거부된 생성에 대해 Comfy가 기록한 사용량과 함께 `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..a02660db8d 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -2,18 +2,18 @@ title: "Comfy Router 모델" sidebarTitle: "모든 모델" description: "Comfy Router에서 사용할 수 있는 모든 모델을 제공자별로 정리하고, 각 모델의 입력 및 출력 모달리티를 함께 표시합니다." -translationSourceHash: f12be9e4 +translationSourceHash: d2265d41 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 9b1b4039 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 "BytePlus": 0ff87da0 "Elevenlabs": 7d6dbcc6 - "fal": 00f4c6b2 + "fal": 63e65674 "Freepik": 51b8af46 "Gemini Interactions": ca46b908 "Google": 4932820b @@ -23,12 +23,12 @@ translationBlockHashes: "Kling": 3002befa "Krea": 16b83e5e "LTX": 32595bf9 - "Luma": 37a12a19 + "Luma": 8cd2a7ce "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)를 참고하세요. @@ -53,7 +54,7 @@ translationBlockHashes: ## 출력으로 찾기 - + - [SwitchX](/ko/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [FLUX 3 Video](/ko/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` @@ -89,8 +90,6 @@ translationBlockHashes: - [LTX 2.5 Fast](/ko/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ko/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` - [Ray 3.2](/ko/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` -- [Ray 2](/ko/development/comfy-router/models/luma/ray-2/code): `luma/ray-2` -- [Ray Flash 2](/ko/development/comfy-router/models/luma/ray-flash-2/code): `luma/ray-flash-2` - [MiniMax H3](/ko/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` - [Image To Video](/ko/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` - [Text To Video](/ko/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` @@ -106,8 +105,7 @@ 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` +- [Video Background Removal](/ko/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal`- [Veo 3.1 Fast Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` - [HappyHorse 1.0 I2V](/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code): `wan/happyhorse-1.0-i2v` @@ -135,7 +133,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` @@ -161,8 +159,7 @@ translationBlockHashes: - [Image Edit Remove Background Guided](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/ko/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [Image Edit Replace Object By Text](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` -- [Image Edit Reseason](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [Image Edit Replace Object By Text](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text`- [Image Edit Reseason](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` - [Image Edit Restore](/ko/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` - [Image](/ko/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` @@ -198,7 +195,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` @@ -214,8 +210,7 @@ translationBlockHashes: - [Recraft V4.1 Utility](/ko/development/comfy-router/models/recraft/recraftv4-1-utility/code): `recraft/recraftv4_1_utility` - [Recraft V4.1 Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-vector/code): `recraft/recraftv4_1_vector` - [Recraft V4.1](/ko/development/comfy-router/models/recraft/recraftv4-1/code): `recraft/recraftv4_1` -- [Recraft V4 Pro](/ko/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro` -- [Recraft V4 Styles Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` +- [Recraft V4 Pro](/ko/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro`- [Recraft V4 Styles Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` - [Recraft V4 Styles Pro](/ko/development/comfy-router/models/recraft/recraftv4-styles-pro/code): `recraft/recraftv4_styles_pro` - [Recraft V4 Styles Vector](/ko/development/comfy-router/models/recraft/recraftv4-styles-vector/code): `recraft/recraftv4_styles_vector` - [Recraft V4 Styles](/ko/development/comfy-router/models/recraft/recraftv4-styles/code): `recraft/recraftv4_styles` @@ -269,14 +264,13 @@ translationBlockHashes: - [Wan 2.5 T2V Preview](/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` - [Wan 2.6 I2V](/ko/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` - [Wan 2.6 R2V](/ko/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` -- [Wan 2.6 T2V](/ko/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` -- [Wan 2.7 I2V](/ko/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` +- [Wan 2.6 T2V](/ko/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v`- [Wan 2.7 I2V](/ko/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` - [Wan 2.7 T2V](/ko/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` - [Wan 3.0 Video Prime](/ko/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` - [Wan 3.0 Video](/ko/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` - + - [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 +284,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 +313,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` @@ -332,11 +325,7 @@ translationBlockHashes: - [GPT 5](/ko/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [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` +- [GPT 6 Sol](/ko/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol`- [o3](/ko/development/comfy-router/models/openai/o3/code): `openai/o3` - [Chat Completions](/ko/development/comfy-router/models/openrouter/chat-completions/code): `openrouter/chat-completions` @@ -448,7 +437,7 @@ translationBlockHashes: | [Crystal Upscaler](/ko/development/comfy-router/models/fal/crystal-upscaler/code) | `fal/crystal-upscaler` | 이미지 | 이미지 | | [Crystal Video Upscaler](/ko/development/comfy-router/models/fal/crystal-video-upscaler/code) | `fal/crystal-video-upscaler` | 비디오 | 비디오 | | [FLUX 3 Max](/ko/development/comfy-router/models/fal/flux-3-max/code) | `fal/flux-3-max` | 텍스트, 이미지 | 비디오 + 오디오 | -| [H3 Max Turbo](/ko/development/comfy-router/models/fal/h3-max-turbo/code) | `fal/h3-max-turbo` | 텍스트, 이미지 | 비디오 + 오디오 | +| [H3 Max Turbo](/ko/development/comfy-router/models/fal/h3-max-turbo/code) | `fal/h3-max-turbo` | 텍스트, 이미지, 비디오, 오디오 | 비디오 + 오디오 | | [H3 Max](/ko/development/comfy-router/models/fal/h3-max/code) | `fal/h3-max` | 텍스트, 이미지, 비디오, 오디오 | 비디오 + 오디오 | | [Patina](/ko/development/comfy-router/models/fal/patina/code) | `fal/patina` | 이미지 | 이미지 | @@ -543,8 +532,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` | 텍스트 | 이미지 | -| [Ray 2](/ko/development/comfy-router/models/luma/ray-2/code) | `luma/ray-2` | 텍스트, 이미지 | 비디오 | -| [Ray Flash 2](/ko/development/comfy-router/models/luma/ray-flash-2/code) | `luma/ray-flash-2` | 텍스트, 이미지 | 비디오 | ## Luma 2 @@ -584,7 +571,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 +585,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/black-forest-labs/flux-video-upscale/code.mdx b/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx index 6e7238a789..5161b60c8c 100644 --- a/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx +++ b/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 FLUX Video Upscale 사용하기" description: "Comfy Router를 통해 HTTP로 FLUX Video Upscale을 사용해 비디오를 업스케일링하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "FLUX Video Upscale" -translationSourceHash: 0b09f0ee +translationSourceHash: 37a8dde1 translationFrom: development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx translationBlockHashes: "_intro": cf804f5f "Quick start": b745a238 - "Schema": 4675f835 + "Schema": c0dca73f "Examples": d1ffa3d6 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -170,7 +171,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - 업스케일할 비디오로, HTTP(S) URL 또는 base64로 인코딩된 MP4입니다. 소스 영상은 최대 20초, 50MB까지입니다. + 업스케일할 비디오로, HTTP(S) URL 또는 base64로 인코딩된 MP4입니다. 소스 영상은 최대 20초, 50MB, 프레임당 2560x1440(3.7메가픽셀)까지입니다. 소스가 더 크면 제출하기 전에 축소하세요. @@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - 소스 해상도 대비 출력 배율입니다. 출력은 소스의 가로세로 비율을 유지하며 프레임당 약 14.4메가픽셀로 제한되므로, 소스가 매우 큰 경우에는 요청한 배율보다 작게 확대됩니다. + 소스 해상도 대비 출력 배율입니다. 출력은 소스의 가로세로 비율을 유지하며 프레임당 약 14.4메가픽셀로 제한되므로, 소스가 매우 큰 경우에는 요청한 배율보다 작게 확대됩니다. 해상도 옵션은 없습니다. 2K(2560x1440) 또는 4K(3840x2160)를 목표로 하려면 목표 높이를 소스 높이로 나누세요. 720p 소스는 배율 2에서 2K, 배율 3에서 4K에 도달합니다. 1080p 소스는 배율 2에서 4K에 도달하지만 2K에는 도달할 수 없으며, 2K에는 1.33이 필요합니다. 범위: `1.5`부터 `3`까지 @@ -234,7 +235,7 @@ Router가 `GET /v2/models/bfl/video-upscale-v1/openapi.json`에서 제공하는 - 공급자가 보고한 생성 재생 시간(초)입니다. + 공급자가 보고한 생성 소요 시간(초)입니다. 형식: `double` @@ -250,7 +251,7 @@ Router가 `GET /v2/models/bfl/video-upscale-v1/openapi.json`에서 제공하는 - 생성된 결과물에 대한 서명된 URL입니다. Router는 결과물을 Comfy 스토리지에 다시 호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 호스팅 URL입니다. 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간밖에 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없는 리프는 대신 BFL 자체의 수명이 짧은 전송 URL을 유지합니다(비디오는 약 2시간, 이미지는 약 10분). 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 결과물을 다운로드하세요. + 생성된 결과물에 대한 서명된 URL입니다. Router는 결과물을 Comfy 스토리지에 다시 호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 호스팅 URL입니다. 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간밖에 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없는 리프 노드는 대신 BFL 자체의 수명이 짧은 전송 URL을 유지합니다(비디오는 약 2시간, 이미지는 약 10분). 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 결과물을 다운로드하세요. 형식: `uri` 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..4ebc20234c 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,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/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 1a406b5c67..1df7667f38 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,19 +2,20 @@ title: "Comfy Router로 Dreamina Seedance 2.0 260128 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-260128을 호출합니다. endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 98890ddf +translationSourceHash: 9604ca27 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 5c27d10f + "Schema": 6c5da06a "Examples": 641c458b --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -196,29 +197,29 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque ### 입력 - 이 생성 작업 결과에 대한 콜백 알림 주소 + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전혀 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하십시오. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠 + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast, 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID. -오디오 URL: 오디오의 공개 URL (wav, mp3). + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. +오디오 URL: 오디오의 공개 URL(wav, mp3). Base64: 형식 data:audio/\;base64,\ 에셋 ID: 형식 asset://\ Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 prompt, 입력 에셋, duration, ratio, seed, generate_audio 및 omni_reference_task_type을 재사용하므로 이를 다시 전송하지 마세요. resolution은 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마십시오. 해상도는 기본값이 1080p이며 1080p만 지원합니다. @@ -230,8 +231,8 @@ Base64: 형식 data:audio/\;base64,\ - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠 (type이 "image_url"인 경우) -이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). +이미지 URL: 이미지 URL에 접근 가능한지 확인하십시오. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. 에셋 ID: 형식 asset://\ @@ -239,18 +240,18 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 콘텐츠 항목의 역할/위치입니다. 이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 전용). +오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델을 위한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트 (필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. -파라미터 (선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) - --duration (--dur): 3-12초 (기본값: 5) @@ -259,91 +260,98 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -BytePlus의 제약이 아니라 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며, 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 제한은 이 필드 하나만 제한하며 요청 전체를 제한하지는 않습니다: `content`는 배열이고, 요청당 본문 제한이 전체 문서를 제한합니다. 이를 시행하는 표면은 Comfy Router(/v2/models/byteplus/\{model})입니다. 직접 v1 /proxy 호출에서는 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하는 일이 없도록 합니다. 호출자가 더 필요로 하면 이 값을 높이세요. +예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" + +Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 +공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 +될 수 있습니다. 이 제한은 요청 전체가 아니라 이 단일 필드에 적용됩니다. +`content`는 배열이며, 요청당 본문 제한이 전체 문서를 제한합니다. +이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 +직접 호출할 때는 대신 BytePlus 자체 검증기가 응답합니다. 실제 프롬프트에 대해 +판정하지 않도록 실제 트래픽보다 훨씬 높게 설정되어 있습니다. 호출자가 더 +필요로 하면 값을 높이십시오. - 입력 콘텐츠의 유형 + 입력 콘텐츠의 유형입니다. 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 에셋 ID. -비디오 URL: 비디오의 공개 URL (mp4, mov). + 비디오 URL 또는 에셋 ID입니다. +비디오 URL: 비디오의 공개 URL(mp4, mov). 에셋 ID: 형식 asset://\ - Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며 resolution은 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. + Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. 범위: `2` ~ `30` - 작업 타임아웃 임계값(초)입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각과 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙을 공급자가 비디오와 별도로 콘텐츠 검사합니다. 여기서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 그 외에는 허용하는 입력에 대해서도 간헐적으로 나타날 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 이는 거부된 양상이 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 명시됩니다(대기 중인 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 만드세요. - 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 포함되지 않은 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출에서는 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mp4: 호환성이 넓고 파일 크기가 더 작은 범용 컨테이너(H.264/AAC, yuv420p)입니다. +mov: 색상 정밀도가 높아 후반 작업에 적합한 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)이며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성되는 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력이 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 경우만) 허용되며, 구체적인 비율을 지정하면 전송 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 즉, 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임이 다음 비디오 작업의 첫 프레임으로 사용되어 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. - 범위: `-1` ~ `4294967295` + 범위: `-1`에서 `4294967295`까지 - 처리에 사용할 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리에 사용할 서비스 티어입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -352,32 +360,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 기준이 되는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. null일 수 있습니다. BytePlus는 작업 24시간 후 URL을 삭제하므로, 그 이후에 폴링된 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 삭제하므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 판별하며, `image/jpeg`는 둘 다 실패했을 때의 최후 대체값일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 삭제합니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마십시오. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 판별하며, `image/jpeg`는 둘 다 실패했을 때의 최후 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 삭제합니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 프레임을 다운로드하십시오. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 흔하며, 최상위 `output_format` 필드를 참고하세요. Router는 두 위치 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환할 때 제공됩니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많습니다. 최상위 `output_format` 필드를 참조하십시오. Router는 둘 중 존재하는 값을 읽습니다. + + + + 업스트림 URL이 작동을 멈추는 RFC 3339 시각으로, URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재할 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위로 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 즉 옵트인한 워크스페이스에만, Seedance 2.x에만 제공되고, BytePlus가 삭제하면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위로 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 모두 존재하지 않습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 삭제하면 사라집니다. 사전 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀값처럼 다루십시오. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데 그중 1회는 Router 자체의 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 삭제하고 일부 모델에서는 다운로드를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 삭제하고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 비디오를 다운로드하십시오. - 작업이 생성된 시간입니다. 값은 초 단위 UNIX 타임스탬프입니다. + 작업이 생성된 시각입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업은 정수 초를 반환하는 것이 관찰되었지만, 인접한 다른 BytePlus 인터페이스는 소수 재생 시간을 보고하므로 클라이언트는 정수값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 인터페이스들은 소수 재생 시간을 보고하기도 하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -385,7 +407,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 붙을 수 있습니다. 이것은 enum이 아닌 개방형 문자열이며, 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 응답 본문과 HTTP 200 실패 작업 응답에서 정책 계열을 인식하며, 전송 실패를 덮어쓰지 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 개방형 문자열입니다. 다른 코드들은 검증 실패와 공급자 장애를 설명합니다. Router는 전송 계층 장애를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. @@ -393,23 +415,24 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에 - 비디오 생성 작업의 ID + +비디오 생성 작업의 ID - 작업에서 사용한 모델의 이름과 버전 + 해당 작업에서 사용한 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 필드로서 최상위에 반환됩니다. Seedance 비디오 작업 조회가 이 위치에 반환합니다. BytePlus 자체 필드로, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제 항목으로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 자체 필드로, 값을 변경하지 않고 그대로 전달합니다. - 생성된 비디오의 해상도로, 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 값을 변경하지 않고 그대로 전달합니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 해당 작업에서 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 값을 변경하지 않고 그대로 전달합니다. 형식: `int64` @@ -421,7 +444,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에 - 작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위 UNIX 타임스탬프입니다. + 작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. @@ -433,7 +456,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 기본값이 0입니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 517c892428..3f3af5cc1a 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Dreamina Seedance 2.0 Fast 260128 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-fast-260128을 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: acad6428 +translationSourceHash: b02c6ed1 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": a00368da + "Schema": e03c503a "Examples": 7714eccd --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -181,33 +182,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### 입력 - 이 생성 작업 결과에 대한 콜백 알림 주소 + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만, 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 결과는 작업 상태 조회 라우트를 폴링하세요. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠 + 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠입니다. - 입력 오디오 객체입니다. 오디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 단독으로 사용할 수 없으며 최소 1개의 이미지나 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만으로 된 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 Asset ID. -오디오 URL: 오디오의 공개 URL(wav, mp3). -Base64: 형식 data:audio/\;base64,\ -Asset ID: 형식 asset://\ + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. +오디오 URL: 오디오의 공개 URL입니다(wav, mp3). +Base64: 형식은 data:audio/\;base64,\입니다. +에셋 ID: 형식은 asset://\입니다. Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 이들을 다시 보내지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이자 유일한 지원 값인 1080p입니다. - `draft`를 true로 설정하여 Draft 비디오를 생성할 때 반환된 작업 ID입니다. + `draft`가 true로 설정된 상태로 Draft 비디오가 생성되었을 때 반환된 작업 ID입니다. @@ -218,7 +219,7 @@ Asset ID: 형식 asset://\ 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -Asset ID: 형식 asset://\ +에셋 ID: 형식은 asset://\입니다. @@ -227,15 +228,15 @@ Asset ID: 형식 asset://\ 비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). - 사용 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` + 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델에 제공되는 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델의 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용해 생성할 비디오에 대한 설명입니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자로 생성할 비디오를 설명합니다. -파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다. - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) - --duration (--dur): 3-12초 (기본값: 5) @@ -244,30 +245,38 @@ Asset ID: 형식 asset://\ - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -Comfy 측 가드레일이며 BytePlus 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 가드레일은 이 필드 하나만 제한할 뿐 요청 전체를 제한하지 않습니다: `content`는 배열이며, 요청당 본문 제한이 전체 문서를 제한합니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하는 일이 없도록 하며, 호출자에게 더 필요한 경우 값을 높이세요. +예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" + +BytePlus의 제약이 아닌 Comfy 측 보호 장치입니다. BytePlus는 텍스트 길이 +제한을 공개하지 않으며, 테스트(2026-09-17)에서 40,000자까지 허용했습니다. +바이트가 아닌 문자를 세므로, 멀티바이트 프롬프트는 전송 시 이 크기의 +몇 배가 될 수 있습니다. 이 제한은 이 필드 하나만 제한하며 요청 전체를 +제한하지는 않습니다. `content`는 배열이고, 전체 문서는 요청당 본문 +제한으로 제한됩니다. 이를 적용하는 표면은 Comfy Router +(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출할 때는 BytePlus +자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 실제 +프롬프트를 판정하지 않습니다. 호출자에게 더 많은 용량이 필요하면 올리세요. 입력 콘텐츠의 유형입니다. - 사용 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` + 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체입니다. 비디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 Asset ID. -비디오 URL: 비디오의 공개 URL(mp4, mov). -Asset ID: 형식 asset://\ + 비디오 URL 또는 에셋 ID입니다. +비디오 URL: 비디오의 공개 URL입니다(mp4, mov). +에셋 ID: 형식은 asset://\입니다. - Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며 해상도는 480p여야 합니다. -최종 1080p 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. Draft 작업 ID는 7일 동안 유효합니다. + Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. @@ -283,42 +292,40 @@ Asset ID: 형식 asset://\ - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 그 외에는 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원하면 `false`를 보내세요. 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. - 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. v1을 직접 호출해 POST /proxy/byteplus/api/v3/contents/generations/tasks를 사용할 때는 반드시 제공해야 하며, 프록시는 다른 값이나 값이 누락된 경우 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 이를 반드시 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 포함되지 않은 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략하기 때문입니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. - mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 종횡비입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 종횡비를 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율은 전송 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -참: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 일치하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임이 다음 비디오 작업의 첫 프레임으로 사용되므로 여러 개의 연속 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. @@ -329,7 +336,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리용 서비스 티어입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -338,32 +345,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 Router가 호출을 검증하는 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과, BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 다시 호스팅(RE-HOSTED)되며, 여기에 있는 다른 모든 필드는 BytePlus 자체 필드입니다. Null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 동영상 생성 작업이 완료된 후의 출력으로, 출력 동영상의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus의 자체 필드입니다. Nullable: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고, Router는 전달받은 바이트를 그대로 다시 호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 판별합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지에 다시 호스팅하고 이 필드를 재작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 한 시간도 안 되는 URL이 반환될 수 있습니다. 다시 호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 동영상의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 제공받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 판별하며, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus의 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 쪽이든 링크가 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 동영상의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 넣은 경우에 해당합니다. Seedance 모델은 이를 보통 `content`의 최상위 형제 필드로 반환하며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 쪽을 읽습니다. + + + + 업스트림 URL이 작동을 멈추는 RFC 3339 시각: URL 자체가 지니는 가장 이른 서명 시각 더하기 유효 기간이며, `updated_at`이 존재하는 경우 작업의 `updated_at` 더하기 24시간(BytePlus가 문서화한 URL 수명)을 결코 넘지 않고, 그렇지 않으면 작업의 `updated_at` 더하기 24시간입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위로 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 즉 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하고, BytePlus가 지우면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 동영상에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위로 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 없습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 사라집니다. 사전 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 동영상을 다운로드할 수 있으므로 비밀처럼 취급하세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데, 그중 한 번은 Router 자체의 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 다시 호스팅하고 이 필드를 재작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 한 시간도 안 되는 URL이 반환될 수 있습니다. 다시 호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 동영상에 대한 다운로드 URL입니다. Router는 동영상을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus의 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크가 만료되므로 URL을 저장하지 말고 동영상을 다운로드하세요. - 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시각입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업은 정수 초를 반환하는 것이 관찰되었고, 인접한 다른 BytePlus 인터페이스는 소수 재생 시간을 보고하므로, 클라이언트는 이 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 동영상의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어서 정수 대신 숫자로 선언되었습니다. 동영상 작업이 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 인터페이스는 소수 재생 시간을 보고하기도 하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus의 자체 필드로, 성공한 동영상 작업에서 반환되며 변경 없이 전달됩니다. @@ -371,15 +392,14 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.jso - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 있을 수 있습니다. 이는 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답 본문과 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected 및 OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 패밀리에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake가 있습니다. 이는 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 실패를 덮어쓰지는 않습니다. 오류 메시지 - - 비디오 생성 작업의 ID +비디오 생성 작업의 ID @@ -387,15 +407,15 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.jso - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 필드로 최상위에 반환됩니다. Seedance 비디오 작업 조회가 반환하는 위치입니다. BytePlus 자체 필드로, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)입니다. `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. 형식: `int64` @@ -419,7 +439,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.jso - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index cae58f667f..6480680517 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router와 함께 Dreamina Seedance 2.0 Mini 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-mini를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 69d38df7 +translationSourceHash: 28c5c053 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 2279819f + "Schema": 3c26a330 "Examples": db01067e --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-mini.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -181,21 +182,21 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 입력 - 이 생성 작업 결과에 대한 콜백 알림 주소 + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 결과는 작업 상태 라우트를 폴링하세요. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠 + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. - 입력 오디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 단독으로 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast, 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID. + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. 오디오 URL: 오디오의 공개 URL (wav, mp3). Base64: 형식 data:audio/\;base64,\ 에셋 ID: 형식 asset://\ @@ -203,11 +204,11 @@ Base64: 형식 data:audio/\;base64,\ Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. - `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. + Draft 비디오를 `draft`를 true로 설정하여 생성했을 때 반환된 작업 ID입니다. @@ -215,7 +216,7 @@ Base64: 형식 data:audio/\;base64,\ - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠 (type이 "image_url"인 경우) + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다 (type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. 에셋 ID: 형식 asset://\ @@ -224,8 +225,8 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 콘텐츠 항목의 역할/위치입니다. 이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만). +비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 해당). +오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 해당). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -233,9 +234,9 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트 (필수): 중국어 및 영어 문자를 사용한 생성할 비디오에 대한 설명입니다. +텍스트 프롬프트 (필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. -파라미터 (선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터 (선택 사항): 비디오 사양을 제어하려면 텍스트 프롬프트 뒤에 --[parameters]를 추가하세요: - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) - --duration (--dur): 3-12초 (기본값: 5) @@ -244,98 +245,99 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" +예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 -공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍스트 +길이 제한을 공개하지 않으며 테스트에서 40,000자를 허용했습니다 (2026-09-17). 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 -몇 배가 될 수 있습니다. 이 값은 이 필드 하나만 제한하며 요청 전체를 제한하지는 않습니다: -`content`는 배열이고, 전체 문서를 제한하는 것은 요청당 본문 제한입니다. 이를 강제하는 -표면은 Comfy Router (/v2/models/byteplus/\{model})이며, 직접 v1 /proxy 호출에서는 -BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 실제 -프롬프트를 판정하지 않으며, 호출자가 더 필요로 하면 값을 높이세요. +몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 단일 필드에 +적용됩니다. `content`는 배열이며, 문서 전체를 제한하는 것은 요청당 +본문 한도입니다. 이를 강제하는 표면은 Comfy Router +(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출할 때는 대신 +BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 +설정되어 있어 실제 프롬프트를 판정하는 일이 없습니다. 호출자가 더 +필요하면 값을 높이세요. - 입력 콘텐츠의 유형 + 입력 콘텐츠의 유형입니다. 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 에셋 ID. + 비디오 URL 또는 에셋 ID입니다. 비디오 URL: 비디오의 공개 URL (mp4, mov). 에셋 ID: 형식 asset://\ Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하면 최종 1080p 비디오가 렌더링됩니다. Draft 작업 ID는 7일 동안 유효합니다. - 초 단위의 비디오 재생 시간입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. 범위: `2` ~ `30` - 초 단위의 작업 타임아웃 임계값입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. -true: 모델이 동기화된 오디오가 있는 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. +true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 해당 검사에서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 그 외에는 받아들이는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 만드세요. - 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 프록시는 다른 값이나 누락된 값에 대해 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이를 채우기 때문에 Router 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 생략된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mp4: 호환성이 넓고 파일 크기가 더 작은 범용 컨테이너(H.264/AAC, yuv420p)입니다. +mov: 색상 정밀도가 높아 후반 작업에 적합한 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)이며, 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 경우만) 허용되며, 구체적인 비율을 지정하면 전달 전에 400으로 거부됩니다. Seedance 2.0은 이러한 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 이 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 이전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 뒤 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 즉, 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. 범위: `-1` ~ `4294967295` - 처리 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리용 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -344,24 +346,38 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅(RE-HOSTED)되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Null 허용: BytePlus는 작업 후 24시간 뒤에 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 뒤의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 담고 있습니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 다시 호스팅되며, 여기의 다른 모든 필드는 BytePlus의 자체 필드입니다. Null일 수 있습니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑을 통해 형식을 판별하며, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL을 돌려받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간 뒤에 이를 지웁니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL로 이미지 형식을 추론하지 마십시오. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하며, Router는 전달받은 바이트를 그대로 다시 호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지에 다시 호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 다시 호스팅을 수행할 수 없었던 경우 이 필드는 대신 BytePlus의 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하십시오. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩할 때 사용됩니다. Seedance 모델은 더 흔히 이를 `content`의 최상위 형제 필드로 반환하며(최상위 `output_format` 필드 참고), Router는 둘 중 존재하는 것을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 넣는 경우에 해당합니다. Seedance 모델은 이를 `content`의 최상위 형제로 반환하는 경우가 더 많으며, 최상위 `output_format` 필드를 참고하십시오. Router는 둘 중 존재하는 쪽을 읽습니다. + + + + 업스트림 URL이 동작을 멈추는 RFC 3339 시각으로, 가장 이른 서명 시각에 URL 자체가 지닌 유효 기간을 더한 값입니다. `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않으며, 그렇지 않은 경우 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 다시 호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus의 자체 다운로드 URL로, 다시 호스팅된 `last_frame_url` 옆에 `upstream_video_url`과 동일한 조건으로 바이트 단위 그대로 반환됩니다. 옵트인한 워크스페이스에만 해당하고 Seedance 2.x에만 해당하며, BytePlus가 지우면 사라지고 `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus의 자체 다운로드 URL로, 다시 호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 존재하지 않습니다. 여기에는 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 범위가 지정되지 않은 레거시 API 키)이 포함되며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 사라집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 보유한 누구든 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루십시오. `upstream_expires_at`에 만료되며, Seedance 2.5에서 BytePlus는 다운로드 횟수를 100회로 제한하며 그중 1회는 Router 자체의 다시 호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL을 돌려받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간 뒤에 이를 지우고 일부 모델에서는 다운로드를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 다시 호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 다시 호스팅을 수행할 수 없었던 경우 이 필드는 대신 BytePlus의 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하십시오. @@ -369,7 +385,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에 - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이를 일관되게 처리하지 않기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환하는 것이 관찰된 반면, 인접한 BytePlus 인터페이스는 소수 재생 시간을 보고하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 표면에서는 소수 재생 시간을 보고하기도 하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus의 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -377,31 +393,55 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 점으로 구분된 사유가 있을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 열린 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 붙을 수 있습니다. 이는 열거형이 아닌 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않고 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식합니다. 오류 메시지 - - 비디오 생성 작업의 ID +The ID of the video generation task +Wait, I need to translate that too. Let me redo. + +"비디오 생성 작업의 ID" + +Then: +model: "작업에서 사용한 모델의 이름과 버전" + +output_format: "생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 항목으로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus의 자체 필드이며 변경 없이 그대로 전달됩니다." + +resolution: "생성된 비디오의 해상도(예: `1080p`)입니다. BytePlus의 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다." + +seed: "작업에 실제로 사용된 생성 시드입니다. BytePlus의 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다.\n\n 형식: `int64`" + +status: "작업의 상태\n\n 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired`" + +updated_at: "작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다." + +usage: "요청의 토큰 사용량" + +usage.completion_tokens: "모델이 생성한 토큰 수" + +usage.total_tokens: "비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다." + +Note: "total_tokens = completion_tokens" - that's a label with `=`, keep it. Actually it says keep labelled items on own line; here it's inline in prose, keeping as is is fine. 비디오 생성 작업의 ID + - 작업에 사용된 모델의 이름과 버전 + 작업에서 사용한 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 필드로 최상위에 반환됩니다. Seedance 비디오 작업 조회가 이를 반환하는 위치입니다. BytePlus 자체 필드로, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제 항목으로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus의 자체 필드이며 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다(예: `1080p`). BytePlus의 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus의 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. 형식: `int64` @@ -425,7 +465,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 기본값이 0입니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index c0c3e5a1cf..e57578b988 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router에서 Dreamina Seedance 2.5 260628 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-5-260628을 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 9a342bd4 +translationSourceHash: 07fd9c64 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0467a987 + "Schema": 0a76af44 "Examples": 5465695b --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -194,29 +195,29 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 입력 - 이 생성 작업 결과에 대한 콜백 알림 주소 + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠 + 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠입니다. - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 단독으로 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만으로 된 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID. -오디오 URL: 오디오의 공개 URL (wav, mp3). -Base64: 형식 data:audio/\;base64,\ -에셋 ID: 형식 asset://\ + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. +오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. +Base64: 형식은 data:audio/\;base64,\입니다. +에셋 ID: 형식은 asset://\입니다. Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이자 유일한 지원 값인 1080p입니다. @@ -228,17 +229,17 @@ Base64: 형식 data:audio/\;base64,\ - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다 (type이 "image_url"인 경우). + 이미지 기반 비디오 생성용 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. -Base64 인코딩된 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식 asset://\ +Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. +에셋 ID: 형식은 asset://\입니다. 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +이미지의 경우: first_frame, last_frame 또는 reference_image입니다. +비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. +오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -246,9 +247,9 @@ Base64 인코딩된 콘텐츠: 형식은 data:image/\;base64,\ 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트 (필수): 중국어 및 영어 문자를 사용하여 생성할 비디오에 대한 설명입니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. -파라미터 (선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다. - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) - --duration (--dur): 3-12초 (기본값: 5) @@ -259,11 +260,18 @@ Base64 인코딩된 콘텐츠: 형식은 data:image/\;base64,\ 예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로, 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이는 이 필드 하나만 제한하며 요청 전체를 제한하지는 않습니다. `content`는 배열이고, 문서 전체를 제한하는 것은 요청당 본문 제한입니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, 직접 v1 /proxy 호출에서는 대신 BytePlus 자체 검증기가 응답합니다. 실제 프롬프트를 판정하지 않도록 실제 트래픽보다 훨씬 높게 설정되어 있습니다. 호출자가 더 필요하면 이 값을 높이세요. +Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 +텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 +몇 배가 될 수 있습니다. 이 제한은 이 필드 하나만 제한할 뿐 요청 전체를 제한하지 않습니다. +`content`는 배열이며, 요청당 본문 제한이 전체 문서를 제한합니다. 이를 강제하는 표면은 +Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출할 경우에는 +BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 있으므로 +정상적인 프롬프트를 절대 거부하지 않습니다. 호출자가 더 필요로 하면 이 값을 높이세요. - 입력 콘텐츠의 유형 + 입력 콘텐츠의 유형입니다. 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -273,41 +281,40 @@ BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스 - 비디오 URL 또는 에셋 ID. -비디오 URL: 비디오의 공개 URL (mp4, mov). -에셋 ID: 형식 asset://\ + 비디오 URL 또는 에셋 ID입니다. +비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. +에셋 ID: 형식은 asset://\입니다. Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -최종 1080p 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. Draft 작업 ID는 7일 동안 유효합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. 범위: `2` ~ `30` - 작업 타임아웃 임계값(초)입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. -true: 모델이 동기화된 오디오가 있는 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙을 공급자가 비디오와 별도로 콘텐츠 검사합니다. 이 검사에서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 명시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 생략된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 생략된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. - Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. + Seedance 2.5 전용. 출력 비디오의 컨테이너 형식입니다. mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. @@ -315,22 +322,22 @@ mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색 - 생성되는 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만 허용되며(또는 필드를 생략), 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 뒤 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. @@ -341,7 +348,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 처리에 사용할 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -350,32 +357,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다.
-Router가 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에서 Router가 제공하는 스키마로 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 RE-HOSTED되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. null을 허용합니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우며, 그 이후에 폴링한 succeeded 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 뒤의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 담고 있습니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고, Router는 제공받은 바이트를 그대로 re-host하며 업스트림 Content-Type 또는 콘텐츠 스니핑을 통해 형식을 지정합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 대체값일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 re-host하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. re-host를 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고 있지만, Router는 전달받은 바이트를 그대로 재호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 한 시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 그대로 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩할 때 사용됩니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우에 해당합니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며, 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. + + + + 업스트림 URL이 동작을 멈추는 RFC 3339 시각입니다. URL 자체가 지닌 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재할 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않고, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하고, BytePlus가 이를 지우면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 여기에 해당하며, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 사라집니다. presigned 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 취급하세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 한 번은 Router 자체의 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 re-host하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. re-host를 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 한 시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 그대로 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시각입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 대해 일관성이 없기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환하는 것이 관찰되었고, 동일한 BytePlus 인터페이스는 소수 재생 시간을 보고하기도 하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언되었습니다. 비디오 작업에서 정수 초를 반환한 사례가 관찰되었고 같은 BytePlus의 다른 표면에서는 소수 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -383,7 +404,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 이유가 붙을 수 있습니다. 이는 enum이 아닌 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 재정의하지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에는 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열린 문자열이며 열거형이 아닙니다. 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. @@ -399,15 +420,15 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 필드로서 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 쿼리가 이 위치에서 반환합니다. BytePlus 자체 필드로, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도, 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 해상도이며, 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. 형식: `int64` diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 6e8122eeb1..58ec1f2dd5 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Seedance 1.0 Pro 250528 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-250528을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 084b73ac +translationSourceHash: 450bbe6e translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": af62a34c + "Schema": fc979e05 "Examples": 815d621e --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-250528.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -181,33 +182,33 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 입력 - 이 생성 작업의 결과를 받을 콜백 알림 주소 + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` - 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠 + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. - 입력 오디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 단독으로 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast, 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID. -오디오 URL: 오디오의 공개 URL(wav, mp3). -Base64: 형식 data:audio/\;base64,\ -에셋 ID: 형식 asset://\ + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. +오디오 URL: 오디오의 공개 URL입니다(wav, mp3). +Base64: 형식은 data:audio/\;base64,\입니다. +에셋 ID: 형식은 asset://\입니다. - Seedance 2.5 전용. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마십시오. resolution은 기본값이 1080p이며 1080p만 지원합니다. + Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. resolution은 기본값이 1080p이며 1080p만 지원합니다. - `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환되는 작업 ID입니다. + `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. @@ -215,17 +216,17 @@ Base64: 형식 data:audio/\;base64,\ - 이미지 기반 비디오 생성용 이미지 콘텐츠입니다(type이 "image_url"인 경우). -이미지 URL: 이미지 URL에 접근할 수 있는지 확인하십시오. + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). +이미지 URL: 이미지 URL에 접근 가능한지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식 asset://\ +에셋 ID: 형식은 asset://\입니다. - 콘텐츠 항목의 역할/위치. + 콘텐츠 항목의 역할/위치입니다. 이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 전용). +오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -233,7 +234,7 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용한 생성할 비디오에 대한 설명. +텍스트 프롬프트(필수): 생성할 비디오에 대한 설명으로, 중국어 및 영어 문자를 사용합니다. 파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) @@ -244,99 +245,94 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 -텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 -허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 -이 크기의 몇 배가 될 수 있습니다. 이 제한은 이 필드 하나만 제한하며 요청 전체를 -제한하지 않습니다. `content`는 배열이고, 요청 본문 전체를 제한하는 것은 -요청당 본문 제한입니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, -직접 v1 /proxy 호출에서는 대신 BytePlus 자체 검증기가 응답합니다. 실제 -트래픽보다 훨씬 높게 설정되어 있어 실제 프롬프트를 판정하는 일이 없습니다. 호출자에게 더 -많은 용량이 필요하면 이 값을 올리세요. +예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" + +Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 공개하지 않았고 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 단일 필드에 적용됩니다: +`content`는 배열이며, 요청당 본문 제한이 문서 전체를 제한합니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, +v1 /proxy를 직접 호출할 경우에는 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 있어 +실제 프롬프트를 판정하지 않습니다. 호출자에게 더 필요한 경우 값을 높이세요. - 입력 콘텐츠의 유형 + 입력 콘텐츠의 유형입니다. 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 에셋 ID. -비디오 URL: 비디오의 공개 URL(mp4, mov). -에셋 ID: 형식 asset://\ + 비디오 URL 또는 에셋 ID입니다. +비디오 URL: 비디오의 공개 URL입니다(mp4, mov). +에셋 ID: 형식은 asset://\입니다. - Seedance 2.5 전용. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. + Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, resolution은 480p여야 합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하면 최종 1080p 비디오를 렌더링합니다. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초). Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. 범위: `2` ~ `30` - 작업 타임아웃 임계값(초). 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 있는 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 공급자가 생성된 오디오 트랙을 비디오와 별도로 콘텐츠 검사합니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 그 외에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원하면 `false`를 보내세요. 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. - 호출할 모델의 ID. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 생략된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 포함되어 있지 않은 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략하기 때문입니다. - Seedance 2.5 전용. 출력 비디오의 컨테이너 형식입니다. + Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400 오류로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용됩니다. 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 없습니다. 이 매개변수를 사용하면 여러 개의 연속 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임이 다음 비디오 작업의 첫 프레임으로 사용되어 여러 개의 연속 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. - 범위: `-1` ~ `4294967295` + 범위: `-1`부터 `4294967295`까지 - 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리를 위한 서비스 티어입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -345,32 +341,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다.
-`GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력입니다. 출력 비디오의 다운로드 URL과, BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Null을 허용합니다. BytePlus는 작업 24시간 후 URL을 지우므로, 그 이후에 폴링한 succeeded 문서에는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅(RE-HOST)되며, 여기의 다른 모든 필드는 BytePlus 자체의 필드입니다. null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 정리하므로, 그 이후에 폴링한 성공 문서에는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고, Router는 제공받은 바이트를 그대로 재호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 타입을 지정합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 대체값일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL이며, 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 지웁니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL이며, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 판별하며, `image/jpeg`는 두 방법이 모두 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 정리합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많습니다. 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우에 존재합니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으므로 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. + + + + 업스트림 URL이 동작을 멈추는 RFC 3339 시각입니다. URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환되며 조건은 `upstream_video_url`과 같습니다. 옵트인한 워크스페이스에만 제공되고, Seedance 2.x에만 해당하며, BytePlus가 정리한 뒤에는 존재하지 않고, `upstream_expires_at`까지는 bearer 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 존재하지 않습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 특정 워크스페이스에 연결되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 정리하면 없어집니다. presigned 오브젝트 스토리지 URL이므로 bearer 자격 증명입니다. 이를 가진 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데 그중 하나는 Router 자체의 재호스팅이 사용합니다. - 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL이며, 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 지우고 일부 모델에서는 다운로드를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 정리하고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시각입니다. 값은 초 단위 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수 대신 숫자로 선언됩니다. 비디오 작업에서 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 표면에서는 소수 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이를 일관되게 처리하지 않기 때문에 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관측되었고, 인접한 다른 BytePlus 표면은 소수 재생 시간을 보고합니다. 따라서 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 전달됩니다. @@ -378,7 +388,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected 및 OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 점으로 구분된 사유가 있을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake 등입니다. 이것은 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식하며, 전송 실패를 덮어쓰지 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 붙을 수 있습니다. 이는 열거형이 아닌 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식하며, 전송 계층 실패를 덮어쓰지는 않습니다. @@ -386,23 +396,23 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 작업의 ID - + +비디오 생성 작업의 ID 작업에서 사용한 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제로 최상위에 반환됩니다. Seedance 비디오 작업 조회가 반환하는 위치가 바로 여기입니다. BytePlus 자체 필드로, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus 자체 필드로, 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. 형식: `int64` @@ -426,7 +436,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 기본값이 0입니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 0185e2547f..06b3f19b91 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router에서 Seedance 1.0 Pro Fast 251015 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-fast-251015를 호출하는 방법: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 600f57b4 +translationSourceHash: 43683424 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 1df5b053 + "Schema": a882b2d8 "Examples": 1469ab97 --- + {/* 생성된 파일. router-schemas/byteplus/seedance-1-0-pro-fast-251015.json에서 `pnpm code-pages:gen`으로 생성됨. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -181,7 +182,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### 입력 - 이 생성 작업 결과에 대한 콜백 알림 주소입니다. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` @@ -191,19 +192,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque
- 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 단독으로 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. -Base64: 형식은 data:audio/\;base64,\입니다. -에셋 ID: 형식은 asset://\입니다. + 오디오 URL, Base64 인코딩 또는 에셋 ID. +오디오 URL: 오디오의 공개 URL(wav, mp3). +Base64: 형식 data:audio/\;base64,\ +에셋 ID: 형식 asset://\ Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마십시오. 해상도는 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. @@ -216,16 +217,16 @@ Base64: 형식은 data:audio/\;base64,\입니다. 이미지 기반 비디오 생성용 이미지 콘텐츠입니다(type이 "image_url"인 경우). -이미지 URL: 이미지 URL에 접근할 수 있는지 확인하십시오. +이미지 URL: 이미지 URL에 접근 가능한지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식은 asset://\입니다. +에셋 ID: 형식 asset://\ 콘텐츠 항목의 역할/위치입니다. 이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 해당). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 해당). +비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -233,9 +234,9 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오에 대한 설명입니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. -파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다. - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) - --duration (--dur): 3-12초 (기본값: 5) @@ -244,10 +245,17 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. -바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나를 제한합니다. `content`는 배열이며, 전체 문서를 제한하는 것은 요청당 본문 제한입니다. 이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, 직접 v1 /proxy 호출에서는 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 있어 실제 프롬프트를 판정하는 일이 없습니다. 호출자에게 더 많은 용량이 필요하면 이 값을 높이십시오. +예: "아름다운 풍경 --ratio 16:9 --resolution 720p --duration 5" + +Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 +텍스트 길이 제한을 공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 +될 수 있습니다. 이 제한은 요청 전체가 아니라 이 단일 필드에만 적용됩니다. +`content`는 배열이며, 전체 문서를 제한하는 것은 요청당 본문 제한입니다. +이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, +v1 /proxy를 직접 호출할 경우에는 BytePlus 자체 검증기가 대신 응답합니다. +실제 트래픽보다 훨씬 높게 설정되어 있어 실제 프롬프트를 거부하지 않습니다. +호출자가 더 많은 양이 필요하면 값을 높이세요. @@ -261,64 +269,63 @@ BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스 - 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. -에셋 ID: 형식은 asset://\입니다. + 비디오 URL 또는 에셋 ID. +비디오 URL: 비디오의 공개 URL(mp4, mov). +에셋 ID: 형식 asset://\ Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. 범위: `2` ~ `30` - 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 시간 초과 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 그 외에는 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 표시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. - 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략하기 때문에, 이 필드는 이 스키마의 `required` 목록에 없습니다. + 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks 로의 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model} 의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이 값을 생략합니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. - 사용 가능한 값: `mp4`, `mov` + 가능한 값: `mp4`, `mov` - 생성된 비디오의 종횡비입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫 프레임-마지막 프레임 생성: 출력은 첫 프레임의 종횡비를 따르므로 `adaptive`만(또는 필드 생략) 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. - 사용 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro 및 pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. - 사용 가능한 값: `480p`, `720p`, `1080p`, `4k` + 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -참: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다: 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 연속된 여러 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 연속된 여러 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. @@ -329,33 +336,47 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 및 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리용 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. - 사용 가능한 값: `default`, `flex` + 가능한 값: `default`, `flex` 생성된 비디오에 워터마크가 포함되는지 여부입니다. -Router가 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과, BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable: BytePlus는 작업 후 24시간이 지나면 URL을 삭제하므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL로 이미지 형식을 추측하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 판별하며, `image/jpeg`는 둘 다 실패했을 때의 최후 대체값일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 한 시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 대신 BytePlus 자체 URL이 유지되며, BytePlus는 작업 후 24시간이 지나면 이를 삭제합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마세요: BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 타입을 지정하며, `image/jpeg`는 둘 다 실패했을 때의 최후 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지에 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 넣는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참고), Router는 둘 중 존재하는 값을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 보통 이를 `content`의 최상위 형제 필드로 반환합니다. 최상위 `output_format` 필드를 참고하세요. Router는 두 위치 중 존재하는 것을 읽습니다. + + + + 업스트림 URL이 작동을 멈추는 RFC 3339 시각입니다. URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우 해당 작업의 `updated_at`에 24시간을 더한 값(BytePlus가 문서화한 URL 수명)보다 늦지 않고, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + BytePlus 자체의 마지막 프레임 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위로 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다: 옵트인된 워크스페이스 전용, Seedance 2.x 전용, BytePlus가 지우면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + BytePlus 자체의 출력 비디오 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위로 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 사라집니다. 사전 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다: 가진 사람은 누구나 만료 전까지 비디오를 다운로드할 수 있으므로 비밀처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데 그중 1회는 Router 자체의 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 한 시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 대신 BytePlus 자체 URL이 유지되며, BytePlus는 작업 후 24시간이 지나면 이를 삭제하고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. @@ -363,7 +384,7 @@ Router가 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에 - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값을 일관되게 다루지 않기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업에서는 정수 초를 반환한 사례가 관찰되었고, 인접한 다른 BytePlus 인터페이스에서는 소수 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되어 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이에 대해 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환하는 것이 관찰된 한편 인접한 다른 BytePlus 표면은 소수 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -371,37 +392,36 @@ Router가 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 패밀리에 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 붙을 수 있습니다. 이는 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 실패를 덮어쓰지는 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 패밀리에 점으로 구분된 사유가 있을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등입니다. 이것은 열거형이 아닌 열린 문자열입니다: 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식합니다. 오류 메시지 - - 비디오 생성 작업의 ID +비디오 생성 작업의 ID - 작업에 사용된 모델의 이름과 버전 + 작업에서 사용하는 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제로 최상위 수준에서 반환됩니다. Seedance 비디오 작업 조회가 반환하는 위치가 바로 여기입니다. BytePlus 자체 필드이며, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 자체 필드이며 변경 없이 전달됩니다. - 생성된 비디오의 해상도입니다(예: `1080p`). BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되어 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되어 변경 없이 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 전달됩니다. 형식: `int64` - 작업의 상태 + 작업 상태 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` @@ -411,15 +431,15 @@ Router가 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에 - 요청의 토큰 사용량 + 요청의 토큰 사용량입니다. - 모델이 생성한 토큰 수 + 모델이 생성한 토큰 수입니다. - 비디오 생성 모델의 경우 입력 토큰 수를 계산하지 않고 0으로 기본 설정합니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 92c49acdba..b010d78e03 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Seedance 1.5 Pro 251215 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-5-pro-251215를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 13f3fe20 +translationSourceHash: 1d016721 translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 6d6d6ec1 + "Schema": 35f3b5dc "Examples": 7e73ac5c --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/byteplus/seedance-1-5-pro-251215.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -181,29 +182,29 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ ### 입력 - 이 생성 작업의 결과를 받을 콜백 알림 주소입니다. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전혀 전송되지 않습니다. 대신 결과는 작업 상태 라우트를 폴링하여 확인하십시오. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. + 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠 - 입력 오디오 객체입니다. 오디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만으로는 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. -Base64: data:audio/\;base64,\ 형식입니다. -에셋 ID: asset://\ 형식입니다. + 오디오 URL, Base64 인코딩 또는 에셋 ID. +오디오 URL: 오디오의 공개 URL(wav, mp3). +Base64: 형식 data:audio/\;base64,\ +에셋 ID: 형식 asset://\ Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마십시오. 해상도는 기본값이 1080p이며 1080p만 지원합니다. @@ -215,17 +216,17 @@ Base64: data:audio/\;base64,\ 형식입니다. - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). -이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. -Base64 인코딩 콘텐츠: data:image/\;base64,\ 형식이어야 합니다. -에셋 ID: asset://\ 형식입니다. + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠(type이 "image_url"인 경우) +이미지 URL: 이미지 URL에 접근 가능한지 확인하십시오. +Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. +에셋 ID: 형식 asset://\ 콘텐츠 항목의 역할/위치입니다. -이미지: first_frame, last_frame 또는 reference_image. -비디오: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +이미지의 경우: first_frame, last_frame 또는 reference_image. +비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -235,10 +236,10 @@ Base64 인코딩 콘텐츠: data:image/\;base64,\ 형식이어 텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. -파라미터(선택): 비디오 사양을 제어하려면 텍스트 프롬프트 뒤에 --[parameters]를 추가하세요: +파라미터(선택 사항): 비디오 사양을 제어하려면 텍스트 프롬프트 뒤에 --[parameters]를 추가하십시오: - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) -- --duration (--dur): 3-12초 (기본값: 5) +- --duration (--dur): 3~12초 (기본값: 5) - --framepersecond (--fps): 24 (기본값: 24) - --watermark (--wm): true/false (기본값: false) - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) @@ -246,28 +247,36 @@ Base64 인코딩 콘텐츠: data:image/\;base64,\ 형식이어 예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 제한은 요청이 아니라 이 단일 필드에 적용됩니다. `content`는 배열이며, 전체 문서를 제한하는 것은 요청별 본문 제한입니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})입니다. 직접 v1 /proxy 호출에서는 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하는 일이 없도록 합니다. 호출자가 더 필요하면 값을 높이세요. +BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 +제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 +될 수 있습니다. 이 제한은 이 필드 하나만 제한하며 요청 전체를 제한하지 않습니다. +`content`는 배열이며, 요청당 본문 제한이 전체 문서의 크기를 제한합니다. +이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})입니다. +v1 /proxy를 직접 호출하면 대신 BytePlus 자체 검증기가 응답합니다. +실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하는 일이 없도록 하며, +호출자가 더 필요로 하면 값을 높이십시오.
- 입력 콘텐츠의 유형입니다. + 입력 콘텐츠의 유형 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체입니다. 비디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. -에셋 ID: asset://\ 형식입니다. + 비디오 URL 또는 에셋 ID. +비디오 URL: 비디오의 공개 URL(mp4, mov). +에셋 ID: 형식 asset://\ Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -최종 1080p 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. Draft 작업 ID는 7일 동안 유효합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. @@ -277,39 +286,38 @@ BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스 - 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 제한 시간 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각적 요소와 동기화된 오디오가 포함되는지 여부입니다. -true: 모델이 동기화된 오디오가 있는 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. +true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 공급자가 생성된 오디오 트랙을 비디오와 별도로 콘텐츠 검사합니다. 해당 검사에서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 다른 조건에서는 허용하는 입력에 대해 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원하면 `false`를 보내세요. 이는 거부된 모달리티가 오디오였을 때만 도움이 됩니다. 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 해당 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. - 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 누락된 값에 대해 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 생략된 값을 400으로 거부합니다. 이 값은 이 스키마의 `required` 목록에 없습니다. Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략합니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro의 기본값: adaptive. +Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드를 생략하는 경우)만 허용됩니다. 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite의 기본값: 720p. Seedance 1.0 pro 및 pro-fast의 기본값: 1080p. 참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` @@ -317,18 +325,18 @@ Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 즉, 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회 API를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임이 다음 비디오 작업의 첫 프레임으로 사용되므로 여러 개의 연속 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. 범위: `-1` ~ `4294967295` - 처리용 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 및 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -337,24 +345,38 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -Router가 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기에 있는 다른 모든 필드는 BytePlus의 것입니다. Nullable: BytePlus는 작업 24시간 후 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. null 허용: BytePlus는 작업 후 24시간 뒤에 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 제공받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 판별하며, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 1시간도 남지 않은 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus의 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 지웁니다. 어느 경우든 링크는 만료되므로, URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고, Router는 제공받은 바이트를 그대로 재호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지에 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우 이 필드는 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간 뒤에 이를 지웁니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 `content` 안에 중첩해 반환할 때 존재합니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 값을 읽습니다. + + + + 업스트림 URL이 작동을 멈추는 RFC 3339 시간입니다. URL 자체가 지니는 가장 이른 서명 시간에 유효 기간을 더한 값이며, `updated_at`이 있을 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시간을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하며, BytePlus가 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간 뒤에 URL을 지우면 사라집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 보유한 누구나 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데 그중 한 번은 Router 자체 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 1시간도 남지 않은 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus의 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크는 만료되므로, URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우 이 필드는 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간 뒤에 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. @@ -362,7 +384,7 @@ Router가 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이를 일관되게 다루지 않기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업에서 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 표면에서는 소수점 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus의 자체 필드로, 성공한 비디오 작업에서 반환되며 그대로 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 인터페이스들은 소수 재생 시간을 보고하므로 클라이언트는 값을 정수로 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -370,15 +392,14 @@ Router가 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected 및 OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 점으로 구분된 사유가 붙을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake 등입니다. 이것은 열거형이 아니라 열린 문자열입니다. 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식하며, 전송 실패를 덮어쓰지 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 점으로 구분된 사유가 붙을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등입니다. 이것은 열거형이 아니라 열린 문자열입니다. 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 계층 실패를 덮어쓰지 않습니다. 오류 메시지 - - 비디오 생성 작업의 ID +비디오 생성 작업의 ID @@ -386,15 +407,15 @@ Router가 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제로 최상위에 반환됩니다. Seedance 비디오 작업 조회가 반환하는 위치가 바로 여기입니다. BytePlus의 자체 필드로, 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식입니다(mp4 또는 mov). `content`의 형제로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 쿼리가 이 값을 반환하는 위치입니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus의 자체 필드로, 성공한 비디오 작업에서 반환되며 그대로 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus의 자체 필드로, 성공한 비디오 작업에서 반환되며 그대로 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. 형식: `int64` @@ -418,7 +439,7 @@ Router가 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/fal/h3-max-turbo/code.mdx b/ko/development/comfy-router/models/fal/h3-max-turbo/code.mdx index 02936011b9..3828195252 100644 --- a/ko/development/comfy-router/models/fal/h3-max-turbo/code.mdx +++ b/ko/development/comfy-router/models/fal/h3-max-turbo/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router로 H3 Max Turbo 사용하기" description: "Comfy Router를 통해 fal/h3-max-turbo를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "H3 Max Turbo" -translationSourceHash: 77aca164 +translationSourceHash: d670af32 translationFrom: development/comfy-router/models/fal/h3-max-turbo/code.mdx translationBlockHashes: - "_intro": 3932e8e2 + "_intro": 7c031ba1 "Quick start": 37ecc981 "Schema": fa803ecb "Examples": 53e0f9d0 --- - {/* GENERATED FILE. `pnpm code-pages:gen`에 의해 router-schemas/fal/h3-max-turbo.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; fal에서 Comfy Router가 제공하는 `fal/h3-max-turbo`의 API 레퍼런스입니다. -**입력:** 텍스트, 이미지 · **출력:** 비디오 + 오디오 +**입력:** 텍스트, 이미지, 비디오, 오디오 · **출력:** 비디오 + 오디오 ## 빠른 시작 diff --git a/ko/development/comfy-router/models/google/gemini/code.mdx b/ko/development/comfy-router/models/google/gemini/code.mdx index 321378bbb5..5434f7fc2c 100644 --- a/ko/development/comfy-router/models/google/gemini/code.mdx +++ b/ko/development/comfy-router/models/google/gemini/code.mdx @@ -2,34 +2,21 @@ title: "Comfy Router로 Google Gemini 사용하기" description: "Comfy Router를 통해 HTTP로 Google Gemini 텍스트 모델을 호출하는 Python, TypeScript, cURL 코드 조각과 요청 필드 및 결과 형태" sidebarTitle: "Google Gemini" -translationSourceHash: 5e4f183f +translationSourceHash: ccf669d3 translationFrom: development/comfy-router/models/google/gemini/code.mdx -translationBlockHashes: - "_intro": 10922fe1 - "Quick start": 933ea7f2 - "Schema": e3abcc1c - "Examples": 4bb73c12 --- - - - - - - {/* 생성된 파일. 이 디렉터리의 code.yaml을 편집한 뒤 `pnpm code-pages:gen`을 실행하세요. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; Google Gemini API 레퍼런스. Google Gemini는 Google의 멀티모달 텍스트 모델 제품군으로, Flash 및 Pro 등급에 걸쳐 빠른 초안 작성부터 심층 추론까지 아우릅니다. -**입력:** 텍스트, 이미지, 오디오, 비디오 · **출력:** 텍스트 - ## 빠른 시작 [Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python과 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk`와 `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 raw HTTP로 수행합니다. -호출할 모델을 선택하세요. 이 모델들은 하나의 요청 및 응답 형태를 공유하며, 아래에서 한 번만 설명합니다. +호출할 모델을 선택하세요. 스니펫부터 스키마와 예제까지 아래의 모든 내용은 선택한 모델을 따릅니다. @@ -211,219 +198,1241 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview/requests/$R - - -**모델 ID:** `vertexai/gemini-3.5-flash` -**엔드포인트:** `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash` +

스키마

- - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy +

입력

-# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. -async def main(): - async with AsyncComfy() as client: - result = await client.models.run( - "vertexai/gemini-3.5-flash", - { - "contents": [ - { - "role": "user", - "parts": [ - { - "text": "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - "generationConfig": { - "temperature": 0.7, - "maxOutputTokens": 256, - }, - }, - ) + + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + - print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + + + -asyncio.run(main()) -``` + + URI 기반 데이터입니다. + -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; + + URI + -// Reads COMFY_API_KEY from the environment. -// The SDK automatically creates an idempotency key and reuses it for automatic retries. -type Result = { candidates: { content: { parts: { text: string }[] } }[] }; -const result = await comfy.models.run("vertexai/gemini-3.5-flash", { - contents: [ - { - role: "user", - parts: [ - { - text: "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - generationConfig: { - temperature: 0.7, - maxOutputTokens: 256, - }, -}); -if (result.kind !== "json") throw new Error("expected a JSON result"); + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. -console.log("text:", result.data.candidates[0].content.parts[0].text); -``` + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + -```bash cURL -curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" -``` -
-
- -동일한 본문을 `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests` 로 전송합니다. Router는 실행이 수락되는 즉시 `request_id`와 함께 `201`을 반환하고, 준비가 완료되면 이 프로세스든 다른 프로세스든 결과를 수집합니다. [큐 전송](/ko/development/comfy-router/queue) 문서에서 상태, 취소, 수집 과정을 설명합니다. + + 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + - -```python Python -import asyncio -from comfy_sdk import AsyncComfy + + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 해당 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB -# Reads COMFY_API_KEY from the environment. -# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. -async def main(): - async with AsyncComfy() as client: - handle = await client.models.submit( - "vertexai/gemini-3.5-flash", - { - "contents": [ - { - "role": "user", - "parts": [ - { - "text": "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - "generationConfig": { - "temperature": 0.7, - "maxOutputTokens": 256, - }, - }, - ) - print("request_id:", handle.request_id) # with the model ID, all another process needs + 형식: `byte` + - # Poll until the request completes, waiting the Retry-After the server names. - async for update in handle.iter_events(): - print(update.status, update.queue_position) + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. - result = await handle.get() + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + - print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + + 모델이 이 부분의 비디오를 읽는 방식입니다. "AGENTIC"으로 설정하면 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정합니다. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + -asyncio.run(main()) -``` + + 텍스트 프롬프트 또는 코드 조각입니다. + -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; + + 이 부분이 모델의 사고/추론 단계임을 나타냅니다. + -// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. -type Result = { candidates: { content: { parts: { text: string }[] } }[] }; -const handle = await comfy.models.submit("vertexai/gemini-3.5-flash", { - contents: [ - { - role: "user", - parts: [ - { - text: "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - generationConfig: { - temperature: 0.7, - maxOutputTokens: 256, - }, -}); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs + + 가능한 값: `user`, `model` + -// Poll until the request completes, waiting the Retry-After the server names. -for await (const update of handle.events()) { - console.log(update.status, update.queuePosition); -} + + 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략할 때 해당 값을 적용하고, 나머지는 모델 자체 동작을 따릅니다. + -// The same result models.run() returns. A request that failed or was cancelled rejects here. -const result = await handle.get(); -if (result.kind !== "json") throw new Error("expected a JSON result"); + + 이미지 생성 구성 + -console.log("text:", result.data.candidates[0].content.parts[0].text); -``` + + 생성된 이미지의 가로세로 비율 + -```bash cURL -# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. -curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" + + 선택 사항입니다. 생성된 이미지의 이미지 출력 형식입니다. + -# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. -REQUEST_ID="" -curl -i https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID/status \ - -H "X-API-Key: $COMFY_API_KEY" + + 선택 사항입니다. 출력 이미지의 압축 품질입니다. + -# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. -curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID \ - -H "X-API-Key: $COMFY_API_KEY" -``` - - -
-
- -**모델 ID:** `vertexai/gemini-2.5-pro` + + 선택 사항입니다. Vertex AI 경로, 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청에서 출력이 저장될 이미지 형식입니다. 여기서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시키고 요청을 전달하기 전에 소문자로 정규화합니다. 그 외 다른 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없으며 이 속성이 있으면 호출 전체를 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되고 출력 형식은 AI Studio가 선택하는 대로 결정됩니다. 모든 경로에서 전송한 값을 가정하지 말고, 받은 응답 파트에서 미디어 유형(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`)을 다시 읽으세요. + -**엔드포인트:** `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro` + + 선택 사항입니다. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. + - - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy + + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 약 4자입니다. 100 토큰은 대략 60~80단어에 해당합니다. -# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. -async def main(): - async with AsyncComfy() as client: - result = await client.models.run( - "vertexai/gemini-2.5-pro", - { - "contents": [ - { - "role": "user", - "parts": [ - { - "text": "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - "generationConfig": { - "temperature": 0.7, - "maxOutputTokens": 256, + 범위: `16` ~ `65536` + + + + + + + + 시드가 특정 값으로 고정되면 모델은 반복된 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변형이 발생할 수 있습니다. 기본적으로 무작위 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + temperature는 topP와 topK가 적용될 때 발생하는 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 개방적이지 않거나 창의적인 응답이 필요하지 않은 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정론적이지만 약간의 변형은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 반환하는 경우 temperature를 높여 보세요. + + 범위: `0` ~ `2` + + 형식: `float` + + + + 선택 사항입니다. 사고 기능에 대한 구성입니다. 사고란 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + + + + 선택 사항입니다. true이면 모델이 응답에 자신의 사고 내용을 포함합니다. + + + + 선택 사항입니다. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산 내에 머물도록 최선을 다합니다. + + + + 선택 사항입니다. 모델의 사고 수준입니다. + + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + + + + Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중 확률이 가장 높은 토큰입니다. top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개 토큰 중에서 다음 토큰이 선택됩니다. + + 범위: `1` ~ `…` + + + + 지정하면 nucleus 샘플링이 사용됩니다. +Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 것부터( top-K 참조) 가장 낮은 것 순으로 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +무작위성이 더 낮은 응답을 원하면 낮은 값을, 더 무작위적인 응답을 원하면 높은 값을 지정하세요. + + 범위: `0` ~ `1` + + 형식: `float` + + + + 안전하지 않은 콘텐츠를 차단하기 위한 요청별 설정입니다. GenerateContentResponse.candidates에 적용됩니다. + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 가능한 값: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예를 들어 "가능한 한 간결하게 답변하세요" 또는 "응답에 전문 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 역할 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. + + + + 하나의 메시지를 구성하는 순서가 지정된 part 목록입니다. part마다 IANA MIME 유형이 다를 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. + + + + 텍스트 프롬프트 또는 코드 조각입니다. + + + + 메시지를 생성하는 주체의 정체성입니다. 다음 값이 지원됩니다: user: 실제 사람이 보낸 메시지임을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 모델이 생성한 메시지임을 나타냅니다. model 값은 다중 턴 대화 중에 모델의 메시지를 대화에 삽입하는 데 사용됩니다. 다중 턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않을 수 있습니다. + + 가능한 값: `user`, `model` + + + + 시스템이 모델의 지식과 범위 밖의 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호작용할 수 있게 하는 코드 조각입니다. 함수 호출을 참조하세요. + + + + + + + + + + + + + + + + 함수 파라미터의 JSON 스키마 + + + + true이면 생성된 이미지가 클라우드 스토리지에 업로드되고 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. + + + + 비디오 입력의 경우, Duration 형식으로 된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 이 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. + + + + 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + + + 나노초 해상도의 부호 있는 1초 미만 단위입니다. 소수 부분이 있는 음수 초 값이라도 나노초 값은 음수가 아니어야 합니다. + + 범위: `0` ~ `999999999` + + + + 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 범위: `-315576000000` ~ `315576000000` + + + + 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + + + 나노초 해상도의 부호 있는 1초 미만 단위입니다. 소수 부분이 있는 음수 초 값이라도 나노초 값은 음수가 아니어야 합니다. + + 범위: `0` ~ `999999999` + + + + 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 범위: `-315576000000` ~ `315576000000` + + +Router가 `GET /v2/models/vertexai/gemini-3.1-pro-preview/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 대상과 동일한 문서입니다. + +

출력

+ + + + + + + + + + + + + + + + + + + + + + + + + + + 형식: `date` + + + + + + + + + + + + + + + + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + + + + + + + + URI 기반 데이터입니다. + + + + URI + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + + + + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB + + 형식: `byte` + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + + + + 텍스트 프롬프트 또는 코드 스니펫입니다. + + + + 이 부분이 모델의 사고/추론 단계임을 나타냅니다. + + + + 가능한 값: `user`, `model` + + + + + + + + + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. + + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + 응답이 생성된 시점의 타임스탬프입니다. + + + + 응답을 생성하는 데 사용된 모델 버전입니다. + + + + + + + + + + + + + + + + + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률 + + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + 응답의 고유 식별자입니다. + + + + + + + + 출력 전용입니다. 입력에서 캐시된 부분(캐시된 콘텐츠)의 토큰 수입니다. + + + + 응답의 토큰 수입니다. + + + + 모달리티별 후보 토큰의 내역입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 요청의 토큰 수입니다. cachedContent가 설정된 경우에도 이는 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. + + + + 모달리티별 프롬프트 토큰의 내역입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + thoughts 출력에 포함된 토큰 수입니다. + + + + 도구 사용 프롬프트에 포함된 토큰 수입니다. + + + + 모달리티별 도구 사용 프롬프트 토큰의 내역입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 총 토큰 수(프롬프트 + 후보)입니다. + + + + 요청에 사용된 트래픽 유형입니다(예: PROVISIONED_THROUGHPUT). + + +

예시

+ +

입력

+ +```json +{ + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence." + } + ] + } + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256 + } +} +``` + +

출력

+ +```json +{ + "candidates": [ + { + "content": { + "role": "model", + "parts": [ + { + "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep." + } + ] + }, + "finishReason": "STOP" + } + ], + "usageMetadata": { + "promptTokenCount": 18, + "candidatesTokenCount": 24 + } +} +``` +
+ +**모델 ID:** `vertexai/gemini-3.5-flash` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash` + + + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Reads COMFY_API_KEY from the environment. +# The SDK automatically creates an idempotency key and reuses it for automatic retries. +async def main(): + async with AsyncComfy() as client: + result = await client.models.run( + "vertexai/gemini-3.5-flash", + { + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256, + }, + }, + ) + + print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Reads COMFY_API_KEY from the environment. +// The SDK automatically creates an idempotency key and reuses it for automatic retries. +type Result = { candidates: { content: { parts: { text: string }[] } }[] }; +const result = await comfy.models.run("vertexai/gemini-3.5-flash", { + contents: [ + { + role: "user", + parts: [ + { + text: "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + generationConfig: { + temperature: 0.7, + maxOutputTokens: 256, + }, +}); +if (result.kind !== "json") throw new Error("expected a JSON result"); + +console.log("text:", result.data.candidates[0].content.parts[0].text); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests` 로 전송합니다. Router는 실행이 수락되는 즉시 `request_id`와 함께 `201`을 반환하고, 준비가 완료되면 이 프로세스든 다른 프로세스든 결과를 수집합니다. [큐 전송](/ko/development/comfy-router/queue) 문서에서 상태, 취소, 수집 과정을 설명합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Reads COMFY_API_KEY from the environment. +# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-3.5-flash", + { + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256, + }, + }, + ) + print("request_id:", handle.request_id) # with the model ID, all another process needs + + # Poll until the request completes, waiting the Retry-After the server names. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # The provider's own payload, the same value models.run() returns. + # A request that failed or was cancelled raises the typed Router error here. + result = await handle.get() + + print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Reads COMFY_API_KEY from the environment. +// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +type Result = { candidates: { content: { parts: { text: string }[] } }[] }; +const handle = await comfy.models.submit("vertexai/gemini-3.5-flash", { + contents: [ + { + role: "user", + parts: [ + { + text: "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + generationConfig: { + temperature: 0.7, + maxOutputTokens: 256, + }, +}); +console.log("requestId:", handle.requestId); // with the model ID, all another process needs + +// Poll until the request completes, waiting the Retry-After the server names. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// The same result models.run() returns. A request that failed or was cancelled rejects here. +const result = await handle.get(); +if (result.kind !== "json") throw new Error("expected a JSON result"); + +console.log("text:", result.data.candidates[0].content.parts[0].text); +``` + +```bash cURL +# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" + +# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +

스키마

+ +

입력

+ + + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + + + + + + + + URI 기반 데이터입니다. + + + + URI + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + + + + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 해당 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB + + 형식: `byte` + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 모델이 이 부분의 비디오를 읽는 방식입니다. "AGENTIC"으로 설정하면 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정합니다. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + + + + 텍스트 프롬프트 또는 코드 조각입니다. + + + + 이 부분이 모델의 사고/추론 단계임을 나타냅니다. + + + + 가능한 값: `user`, `model` + + + + 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략할 때 해당 값을 적용하고, 나머지는 모델 자체 동작을 따릅니다. + + + + 이미지 생성 구성 + + + + 생성된 이미지의 가로세로 비율 + + + + 선택 사항입니다. 생성된 이미지의 이미지 출력 형식입니다. + + + + 선택 사항입니다. 출력 이미지의 압축 품질입니다. + + + + 선택 사항입니다. Vertex AI 경로, 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청에서 출력이 저장될 이미지 형식입니다. 여기서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시키고 요청을 전달하기 전에 소문자로 정규화합니다. 그 외 다른 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없으며 이 속성이 있으면 호출 전체를 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되고 출력 형식은 AI Studio가 선택하는 대로 결정됩니다. 모든 경로에서 전송한 값을 가정하지 말고, 받은 응답 파트에서 미디어 유형(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`)을 다시 읽으세요. + + + + 선택 사항입니다. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. + + + + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 약 4자입니다. 100 토큰은 대략 60~80단어에 해당합니다. + + 범위: `16` ~ `65536` + + + + + + + + 시드가 특정 값으로 고정되면 모델은 반복된 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변형이 발생할 수 있습니다. 기본적으로 무작위 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + temperature는 topP와 topK가 적용될 때 발생하는 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 개방적이지 않거나 창의적인 응답이 필요하지 않은 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정론적이지만 약간의 변형은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 반환하는 경우 temperature를 높여 보세요. + + 범위: `0` ~ `2` + + 형식: `float` + + + + 선택 사항입니다. 사고 기능에 대한 구성입니다. 사고란 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + + + + 선택 사항입니다. true이면 모델이 응답에 자신의 사고 내용을 포함합니다. + + + + 선택 사항입니다. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산 내에 머물도록 최선을 다합니다. + + + + 선택 사항입니다. 모델의 사고 수준입니다. + + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + + + + Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중 확률이 가장 높은 토큰입니다. top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개 토큰 중에서 다음 토큰이 선택됩니다. + + 범위: `1` ~ `…` + + + + 지정하면 nucleus 샘플링이 사용됩니다. +Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 것부터( top-K 참조) 가장 낮은 것 순으로 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +무작위성이 더 낮은 응답을 원하면 낮은 값을, 더 무작위적인 응답을 원하면 높은 값을 지정하세요. + + 범위: `0` ~ `1` + + 형식: `float` + + + + 안전하지 않은 콘텐츠를 차단하기 위한 요청별 설정입니다. GenerateContentResponse.candidates에 적용됩니다. + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 가능한 값: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예를 들어 "가능한 한 간결하게 답변하세요" 또는 "응답에 전문 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 역할 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. + + + + 하나의 메시지를 구성하는 순서가 지정된 part 목록입니다. part마다 IANA MIME 유형이 다를 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. + + + + 텍스트 프롬프트 또는 코드 조각입니다. + + + + 메시지를 생성하는 주체의 정체성입니다. 다음 값이 지원됩니다: user: 실제 사람이 보낸 메시지임을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 모델이 생성한 메시지임을 나타냅니다. model 값은 다중 턴 대화 중에 모델의 메시지를 대화에 삽입하는 데 사용됩니다. 다중 턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않을 수 있습니다. + + 가능한 값: `user`, `model` + + + + 시스템이 모델의 지식과 범위 밖의 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호작용할 수 있게 하는 코드 조각입니다. 함수 호출을 참조하세요. + + + + + + + + + + + + + + + + 함수 파라미터의 JSON 스키마 + + + + true이면 생성된 이미지가 클라우드 스토리지에 업로드되고 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. + + + + 비디오 입력의 경우, Duration 형식으로 된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 이 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. + + + + 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + + + 나노초 해상도의 부호 있는 1초 미만 단위입니다. 소수 부분이 있는 음수 초 값이라도 나노초 값은 음수가 아니어야 합니다. + + 범위: `0` ~ `999999999` + + + + 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 범위: `-315576000000` ~ `315576000000` + + + + 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + + + 나노초 해상도의 부호 있는 1초 미만 단위입니다. 소수 부분이 있는 음수 초 값이라도 나노초 값은 음수가 아니어야 합니다. + + 범위: `0` ~ `999999999` + + + + 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 범위: `-315576000000` ~ `315576000000` + + +Router가 `GET /v2/models/vertexai/gemini-3.5-flash/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 대상과 동일한 문서입니다. + +

출력

+ + + + + + + + + + + + + + + + + + + + + + + + + + + 형식: `date` + + + + + + + + + + + + + + + + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + + + + + + + + URI 기반 데이터입니다. + + + + URI + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + + + + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB + + 형식: `byte` + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + + + + 텍스트 프롬프트 또는 코드 스니펫입니다. + + + + 이 부분이 모델의 사고/추론 단계임을 나타냅니다. + + + + 가능한 값: `user`, `model` + + + + + + + + + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. + + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + 응답이 생성된 시점의 타임스탬프입니다. + + + + 응답을 생성하는 데 사용된 모델 버전입니다. + + + + + + + + + + + + + + + + + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률 + + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + 응답의 고유 식별자입니다. + + + + + + + + 출력 전용입니다. 입력에서 캐시된 부분(캐시된 콘텐츠)의 토큰 수입니다. + + + + 응답의 토큰 수입니다. + + + + 모달리티별 후보 토큰의 내역입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 요청의 토큰 수입니다. cachedContent가 설정된 경우에도 이는 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. + + + + 모달리티별 프롬프트 토큰의 내역입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + thoughts 출력에 포함된 토큰 수입니다. + + + + 도구 사용 프롬프트에 포함된 토큰 수입니다. + + + + 모달리티별 도구 사용 프롬프트 토큰의 내역입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 총 토큰 수(프롬프트 + 후보)입니다. + + + + 요청에 사용된 트래픽 유형입니다(예: PROVISIONED_THROUGHPUT). + + +

예시

+ +

입력

+ +```json +{ + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence." + } + ] + } + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256 + } +} +``` + +

출력

+ +```json +{ + "candidates": [ + { + "content": { + "role": "model", + "parts": [ + { + "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep." + } + ] + }, + "finishReason": "STOP" + } + ], + "usageMetadata": { + "promptTokenCount": 18, + "candidatesTokenCount": 24 + } +} +``` +
+ +**모델 ID:** `vertexai/gemini-2.5-pro` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro` + + + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Reads COMFY_API_KEY from the environment. +# The SDK automatically creates an idempotency key and reuses it for automatic retries. +async def main(): + async with AsyncComfy() as client: + result = await client.models.run( + "vertexai/gemini-2.5-pro", + { + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256, }, }, ) @@ -502,75 +1511,294 @@ async def main(): ) print("request_id:", handle.request_id) # with the model ID, all another process needs - # Poll until the request completes, waiting the Retry-After the server names. - async for update in handle.iter_events(): - print(update.status, update.queue_position) + # Poll until the request completes, waiting the Retry-After the server names. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # The provider's own payload, the same value models.run() returns. + # A request that failed or was cancelled raises the typed Router error here. + result = await handle.get() + + print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Reads COMFY_API_KEY from the environment. +// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +type Result = { candidates: { content: { parts: { text: string }[] } }[] }; +const handle = await comfy.models.submit("vertexai/gemini-2.5-pro", { + contents: [ + { + role: "user", + parts: [ + { + text: "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + generationConfig: { + temperature: 0.7, + maxOutputTokens: 256, + }, +}); +console.log("requestId:", handle.requestId); // with the model ID, all another process needs + +// Poll until the request completes, waiting the Retry-After the server names. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// The same result models.run() returns. A request that failed or was cancelled rejects here. +const result = await handle.get(); +if (result.kind !== "json") throw new Error("expected a JSON result"); + +console.log("text:", result.data.candidates[0].content.parts[0].text); +``` + +```bash cURL +# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" + +# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +

스키마

+ +

입력

+ +_필드는 Google이 공개한 API 사양을 따르며, CI에서 해당 사양과 대조해 검사합니다. 이 모델에 대한 Router 자체 스키마는 아직 공개되지 않았으므로 요청은 검증 없이 공급자에게 전달됩니다._ + + + 지금까지의 대화로, 오래된 것부터 나열합니다. 파트는 `text`이거나, 프롬프트와 함께 이미지, 오디오, 비디오를 보내려면 `inlineData`입니다. + + + + 해당 턴의 작성자입니다. + + 가능한 값: `user`, `model` + + + + 해당 턴의 콘텐츠 파트입니다. + + + + 텍스트 파트입니다. + + + + 인라인 미디어 파트입니다. + + + + 미디어 유형입니다. 예: `image/png` + + + + Base64로 인코딩된 미디어 바이트입니다. + + + + 전체 대화에 적용되는 시스템 프롬프트입니다. + + + + + + + + + + + + 샘플링 및 길이 설정입니다. + + + + 샘플링의 무작위성입니다. 기본값은 모델별로 다릅니다. + + 범위: `0`에서 `2`까지 + + + + 누클리어스 샘플링 임계값입니다. 기본값은 모델별로 다릅니다. + + + + Top-k 샘플링 컷오프입니다. 기본값은 모델별로 다릅니다. + + + + 생성되는 토큰 수의 상한입니다. + + + + 재현 가능한 샘플링을 위한 시드입니다. + + + + 생성되면 생성을 종료하는 문자열입니다. + + + + 이를 지원하는 모델에서의 추론 노력 제어입니다. + + + + 가능한 값: `MINIMAL`, `LOW`, `MEDIUM`, `HIGH` + + + + 답변과 함께 모델의 추론을 반환합니다. + + + + 모델이 호출할 수 있는 함수 선언입니다. + + + + + + + + + + + + + + + + 함수 인자에 대한 JSON Schema입니다. + + +

출력

+ +Router는 Google의 네이티브 응답을 그대로 반환합니다. 텍스트는 `candidates[0].content.parts[0].text`에 있습니다. + + + 생성된 후보입니다. 더 요청하지 않는 한 하나입니다. + + + + + + + + 가능한 값: `model` + + + + + + + + 생성된 텍스트입니다. + + + + 모델이 `tools` 중 하나를 호출하기로 선택했을 때 존재합니다. + + + + + + + + + + + + 생성이 중단된 이유입니다: `STOP`, `MAX_TOKENS`, `SAFETY`, ... + + + + 호출에 대한 토큰 집계입니다. + + + + 프롬프트의 토큰 수입니다. + - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. - result = await handle.get() + + 생성된 후보의 토큰 수입니다. + - print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + + 프롬프트 자체가 차단되었을 때 존재합니다. 결과를 읽기 전에 `candidates`가 있는지 확인하세요. `usageMetadata`도 차단된 응답에 나타날 수 있습니다. + -asyncio.run(main()) -``` + + 프롬프트가 차단된 이유입니다. 후보는 반환되지 않으므로 프롬프트를 다시 작성한 후 재시도하세요. -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; + 가능한 값: `SAFETY`, `OTHER`, `BLOCKLIST`, `PROHIBITED_CONTENT`, `IMAGE_SAFETY` + -// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. -type Result = { candidates: { content: { parts: { text: string }[] } }[] }; -const handle = await comfy.models.submit("vertexai/gemini-2.5-pro", { - contents: [ +

예시

+ +

입력

+ +```json +{ + "contents": [ { - role: "user", - parts: [ + "role": "user", + "parts": [ { - text: "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, + "text": "Describe a single red maple leaf on a white background in one sentence." + } + ] + } ], - generationConfig: { - temperature: 0.7, - maxOutputTokens: 256, - }, -}); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs - -// Poll until the request completes, waiting the Retry-After the server names. -for await (const update of handle.events()) { - console.log(update.status, update.queuePosition); + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256 + } } - -// The same result models.run() returns. A request that failed or was cancelled rejects here. -const result = await handle.get(); -if (result.kind !== "json") throw new Error("expected a JSON result"); - -console.log("text:", result.data.candidates[0].content.parts[0].text); ``` -```bash cURL -# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. -curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" - -# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. -REQUEST_ID="" -curl -i https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID/status \ - -H "X-API-Key: $COMFY_API_KEY" +

출력

-# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. -curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID \ - -H "X-API-Key: $COMFY_API_KEY" +```json +{ + "candidates": [ + { + "content": { + "role": "model", + "parts": [ + { + "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep." + } + ] + }, + "finishReason": "STOP" + } + ], + "usageMetadata": { + "promptTokenCount": 18, + "candidatesTokenCount": 24 + } +} ``` - -
-
**모델 ID:** `vertexai/gemini-2.5-flash` @@ -751,476 +1979,182 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash/requests/$REQUEST - - - -## 스키마 - -### 입력 - - - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. - - - - - - - - URI 기반 데이터입니다. - - - - URI - - - - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. - - 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - - - - 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. - - - - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 해당 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB - - 형식: `byte` - - - - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. - - 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - - - - 모델이 이 부분의 비디오를 읽는 방식입니다. "AGENTIC"으로 설정하면 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정합니다. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. - - - - 텍스트 프롬프트 또는 코드 조각입니다. - - - - 이 부분이 모델의 사고/추론 단계임을 나타냅니다. - - - - 가능한 값: `user`, `model` - - - - 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략할 때 해당 값을 적용하고, 나머지는 모델 자체 동작을 따릅니다. - - - - 이미지 생성 구성 - - - - 생성된 이미지의 가로세로 비율 - - - - 선택 사항입니다. 생성된 이미지의 이미지 출력 형식입니다. - - - - 선택 사항입니다. 출력 이미지의 압축 품질입니다. - - - - 선택 사항입니다. Vertex AI 경로, 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청에서 출력이 저장될 이미지 형식입니다. 여기서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시키고 요청을 전달하기 전에 소문자로 정규화합니다. 그 외 다른 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없으며 이 속성이 있으면 호출 전체를 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되고 출력 형식은 AI Studio가 선택하는 대로 결정됩니다. 모든 경로에서 전송한 값을 가정하지 말고, 받은 응답 파트에서 미디어 유형(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`)을 다시 읽으세요. - - - - 선택 사항입니다. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. - - - - 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 약 4자입니다. 100 토큰은 대략 60~80단어에 해당합니다. - - 범위: `16` ~ `65536` - - - - - - - - 시드가 특정 값으로 고정되면 모델은 반복된 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변형이 발생할 수 있습니다. 기본적으로 무작위 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 - - - - - - - - temperature는 topP와 topK가 적용될 때 발생하는 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 개방적이지 않거나 창의적인 응답이 필요하지 않은 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정론적이지만 약간의 변형은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 반환하는 경우 temperature를 높여 보세요. - - 범위: `0` ~ `2` - - 형식: `float` - - - - 선택 사항입니다. 사고 기능에 대한 구성입니다. 사고란 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. - - - - 선택 사항입니다. true이면 모델이 응답에 자신의 사고 내용을 포함합니다. - - - - 선택 사항입니다. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산 내에 머물도록 최선을 다합니다. - - - - 선택 사항입니다. 모델의 사고 수준입니다. - - 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` - - - - Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중 확률이 가장 높은 토큰입니다. top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개 토큰 중에서 다음 토큰이 선택됩니다. - - 범위: `1` ~ `…` - - - - 지정하면 nucleus 샘플링이 사용됩니다. -Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 것부터( top-K 참조) 가장 낮은 것 순으로 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. -무작위성이 더 낮은 응답을 원하면 낮은 값을, 더 무작위적인 응답을 원하면 높은 값을 지정하세요. - 범위: `0` ~ `1` - - 형식: `float` - - - - 안전하지 않은 콘텐츠를 차단하기 위한 요청별 설정입니다. GenerateContentResponse.candidates에 적용됩니다. - - - - 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - - - - 가능한 값: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` - +

스키마

- - 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예를 들어 "가능한 한 간결하게 답변하세요" 또는 "응답에 전문 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 역할 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. - +

입력

- - 하나의 메시지를 구성하는 순서가 지정된 part 목록입니다. part마다 IANA MIME 유형이 다를 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. - +_필드는 Google이 공개한 API 사양을 따르며, CI에서 해당 사양과 대조해 검사합니다. 이 모델에 대한 Router 자체 스키마는 아직 공개되지 않았으므로 요청은 검증 없이 공급자에게 전달됩니다._ - - 텍스트 프롬프트 또는 코드 조각입니다. + + 지금까지의 대화로, 오래된 것부터 나열합니다. 파트는 `text`이거나, 프롬프트와 함께 이미지, 오디오, 비디오를 보내려면 `inlineData`입니다. - - 메시지를 생성하는 주체의 정체성입니다. 다음 값이 지원됩니다: user: 실제 사람이 보낸 메시지임을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 모델이 생성한 메시지임을 나타냅니다. model 값은 다중 턴 대화 중에 모델의 메시지를 대화에 삽입하는 데 사용됩니다. 다중 턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않을 수 있습니다. + + 해당 턴의 작성자입니다. 가능한 값: `user`, `model` - - 시스템이 모델의 지식과 범위 밖의 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호작용할 수 있게 하는 코드 조각입니다. 함수 호출을 참조하세요. + + 해당 턴의 콘텐츠 파트입니다. - - + + 텍스트 파트입니다. - - + + 인라인 미디어 파트입니다. - - + + 미디어 유형입니다. 예: `image/png` - - 함수 파라미터의 JSON 스키마 + + Base64로 인코딩된 미디어 바이트입니다. - - true이면 생성된 이미지가 클라우드 스토리지에 업로드되고 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. + + 전체 대화에 적용되는 시스템 프롬프트입니다. - - 비디오 입력의 경우, Duration 형식으로 된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 이 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. + + - - 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + - - 나노초 해상도의 부호 있는 1초 미만 단위입니다. 소수 부분이 있는 음수 초 값이라도 나노초 값은 음수가 아니어야 합니다. - - 범위: `0` ~ `999999999` + + 샘플링 및 길이 설정입니다. - - 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 샘플링의 무작위성입니다. 기본값은 모델별로 다릅니다. - 범위: `-315576000000` ~ `315576000000` + 범위: `0`에서 `2`까지 - - 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + 누클리어스 샘플링 임계값입니다. 기본값은 모델별로 다릅니다. - - 나노초 해상도의 부호 있는 1초 미만 단위입니다. 소수 부분이 있는 음수 초 값이라도 나노초 값은 음수가 아니어야 합니다. - - 범위: `0` ~ `999999999` + + Top-k 샘플링 컷오프입니다. 기본값은 모델별로 다릅니다. - - 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 생성되는 토큰 수의 상한입니다. + - 범위: `-315576000000` ~ `315576000000` + + 재현 가능한 샘플링을 위한 시드입니다. -Router가 `GET /v2/models/vertexai/gemini-3.1-pro-preview/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 대상과 동일한 문서입니다. + + 생성되면 생성을 종료하는 문자열입니다. + -### 출력 + + 이를 지원하는 모델에서의 추론 노력 제어입니다. + - - - + + 가능한 값: `MINIMAL`, `LOW`, `MEDIUM`, `HIGH` + - - - + + 답변과 함께 모델의 추론을 반환합니다. + - - - + + 모델이 호출할 수 있는 함수 선언입니다. + - + - + - + - + - + - + - - 형식: `date` - + + 함수 인자에 대한 JSON Schema입니다. + - - - +

출력

- - - +Router는 Google의 네이티브 응답을 그대로 반환합니다. 텍스트는 `candidates[0].content.parts[0].text`에 있습니다. - - + + 생성된 후보입니다. 더 요청하지 않는 한 하나입니다. - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. - - - - - URI 기반 데이터입니다. - - - - URI - - - - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. - - 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - - - - 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. - - - - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB - - 형식: `byte` - - - - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. - - 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - - - - 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. - - - - 텍스트 프롬프트 또는 코드 스니펫입니다. - - - - 이 부분이 모델의 사고/추론 단계임을 나타냅니다. - - - 가능한 값: `user`, `model` - - - - + 가능한 값: `model` - + - - 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - - - - 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. - - 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - - - - 응답이 생성된 시점의 타임스탬프입니다. - - - - 응답을 생성하는 데 사용된 모델 버전입니다. - - - - + + 생성된 텍스트입니다. - - + + 모델이 `tools` 중 하나를 호출하기로 선택했을 때 존재합니다. - + - + - - 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - - - - 콘텐츠가 지정된 안전 카테고리를 위반할 확률 - - 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - - - - 응답의 고유 식별자입니다. + + 생성이 중단된 이유입니다: `STOP`, `MAX_TOKENS`, `SAFETY`, ... - - - - - 출력 전용입니다. 입력에서 캐시된 부분(캐시된 콘텐츠)의 토큰 수입니다. - - - - 응답의 토큰 수입니다. - - - - 모달리티별 후보 토큰의 내역입니다. - - - - 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - - 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` - - - - 해당 모달리티의 토큰 수입니다. + 호출에 대한 토큰 집계입니다. - 요청의 토큰 수입니다. cachedContent가 설정된 경우에도 이는 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. - - - - 모달리티별 프롬프트 토큰의 내역입니다. - - - - 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - - 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 프롬프트의 토큰 수입니다. - - 해당 모달리티의 토큰 수입니다. - - - - thoughts 출력에 포함된 토큰 수입니다. - - - - 도구 사용 프롬프트에 포함된 토큰 수입니다. - - - - 모달리티별 도구 사용 프롬프트 토큰의 내역입니다. - - - - 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - - 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + 생성된 후보의 토큰 수입니다. - - 해당 모달리티의 토큰 수입니다. + + 프롬프트 자체가 차단되었을 때 존재합니다. 결과를 읽기 전에 `candidates`가 있는지 확인하세요. `usageMetadata`도 차단된 응답에 나타날 수 있습니다. - - 총 토큰 수(프롬프트 + 후보)입니다. - + + 프롬프트가 차단된 이유입니다. 후보는 반환되지 않으므로 프롬프트를 다시 작성한 후 재시도하세요. - - 요청에 사용된 트래픽 유형입니다(예: PROVISIONED_THROUGHPUT). + 가능한 값: `SAFETY`, `OTHER`, `BLOCKLIST`, `PROHIBITED_CONTENT`, `IMAGE_SAFETY` -## 예시 +

예시

-### 입력 +

입력

```json { @@ -1241,7 +2175,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-pro-preview/openapi.json`에서 } ``` -### 출력 +

출력

```json { @@ -1264,5 +2198,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-pro-preview/openapi.json`에서 } } ``` + + diff --git a/ko/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx b/ko/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx index bec57d7ac3..6fa4f2bb79 100644 --- a/ko/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx +++ b/ko/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router로 Ideogram 4.5 사용하기" description: "Comfy Router를 통해 ideogram/ideogram-4-5 호출하기: endpoint, 요청 형태, Router가 반환하는 응답." sidebarTitle: "Ideogram 4.5" -translationSourceHash: 2cd2cad8 +translationSourceHash: 9c2a625d translationFrom: development/comfy-router/models/ideogram/ideogram-4-5/code.mdx translationBlockHashes: "_intro": 3e988502 "Quick start": c8cd302a - "Schema": ea1fb25c + "Schema": 493d453f "Examples": f5f40ced --- + {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/ideogram/ideogram-4-5.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -147,29 +148,32 @@ curl https://api.comfy.org/v2/models/ideogram/ideogram-4-5/requests/$REQUEST_ID ## 스키마 - ### 입력 + + Precise Edit 전용이며 `image`가 필요합니다. 소스 이미지에서 편집이 수행되는 영역으로, 매우 큰 이미지의 한 부분만 편집하고 나머지는 그대로 둔 채 전체 크기로 반환할 수 있게 합니다. `none`(기본값)은 전체 이미지를 편집합니다. `auto`는 `mask` 주변에 영역을 맞추며 `mask`가 필요합니다. 그 외에는 `y_min,x_min,y_max,x_max`를 네 개의 음수가 아닌 정수 픽셀 경계로 전송하며, `y_max`는 `y_min`보다 크고 `x_max`는 `x_min`보다 커야 하며, 각 변이 최소 256픽셀이고, 가로 세로 비율이 1:6에서 6:1 사이이며, 면적이 최대 4,194,304픽셀이어야 합니다. `image`가 없는 요청에서 `none` 이외의 값은 거부됩니다. `context_window`는 컨텍스트 창 게이트가 활성화된 경우에만 허용됩니다. 활성화되지 않은 경우 `none` 이외의 모든 값은 422와 함께 거부됩니다. + + 생성 후 저작권 감지를 선택적으로 활성화합니다. - 이미지 하나로, 호출자를 대신해 Router가 가져오는 https URL 또는 바이트를 인라인으로 담은 `data:image/;base64,` URI 중 하나입니다. 허용되는 이미지 유형은 png, webp, jpeg이며, 이 집합은 공급자에게 맡기지 않고 resolve 시점에 강제됩니다. svg, gif, avif, tiff는 원인에서 두 단계 떨어진 파트너 오류가 되는 대신, 전송한 이미지를 명시하며 여기에서 거부됩니다. -URL 형식을 선호하세요. base64 페이로드는 대략 4/3로 부풀려지고 전체 요청 본문은 100 MiB로 제한되므로, 인라인 형식은 약 75 MB 소스 이미지에서 한계에 도달합니다. URL은 이를 완전히 피해 갑니다. 이 설명 끝에 명시된 이미지당 및 요청당 미디어 상한은 본문 상한보다 더 엄격하므로, 실제 크기의 이미지라면 먼저 마주치는 것은 이 상한입니다. -URL은 자격 증명 없이 해석(resolve)되어야 합니다. Router는 이를 서버 측에서 가져오며 요청에 호출자 자격 증명을 전혀 보내지 않으므로, 서명이 쿼리 문자열에 있는 presigned URL이 지원되는 형식입니다. `/api/assets/{id}/content` 같은 인증된 엔드포인트는 이미지 대신 Router에 401을 반환합니다. 해당 URL을 직접 요청한 뒤 리다이렉트되는 서명된 URL을 전달하세요. -가져오기는 개방된 인터넷이 아니라 이름이 지정된 호스트 집합으로 제한되며, 동일한 목록이 전송한 URL뿐 아니라 모든 리다이렉트 홉에도 다시 적용됩니다. 따라서 다른 호스트의 URL이나 목록 밖으로 리다이렉트하는 URL은 어떤 공급자와도 접촉하기 전에 거부됩니다. 현재 이 목록에는 Comfy 자체 에셋 전송만 포함됩니다. 즉 `/api/assets/{id}/content`가 리다이렉트하는 형태인, Comfy 에셋 버킷 아래의 서명된 `storage.googleapis.com` URL입니다. 파트너 CDN이나 일반 https 호스트는 목록에 없습니다. -두 가지 확장이 순차 배포 중이며 오늘 기준 둘 다 기본적으로 꺼져 있습니다. 이들은 하나의 전환 뒤에서 함께 제공되고 함께 활성화되므로, 아래의 모든 내용은 아직 기반으로 삼을 대상이 아니라 예정된 것으로 취급하세요. 둘 중 하나에 의존하기 전에 먼저 문의하세요. -첫 번째는 `POST /customers/storage`가 업로드를 서명해 넣는 버킷입니다. 이 롤아웃이 사용자의 환경에 도달할 때까지 해당 엔드포인트의 업로드 URL은 여기에서 거부됩니다. 버킷이 Comfy 자체 소유이고 호스트도 동일한데도 그렇습니다. 따라서 "Comfy에 업로드한 뒤 URL을 전달"하는 방식은 아직 동작하지 않으며, 동작하는 형식은 `/api/assets/{id}/content`가 리다이렉트하는 서명된 URL입니다. -두 번째는 모든 사람에게 한꺼번에 적용되는 것이 아니라 계정별로 활성화됩니다. 이 호스트들 뒤의 버킷이 우리 것이 아니라 사용자의 것이기 때문입니다. 위 전환이 켜져 있더라도 서드파티 인바운드 미디어가 활성화되지 않은 계정은 거부되며, 호스트가 지원되지 않는다는 안내가 아니라 바로 그 문구로 안내를 받습니다. Comfy 담당자에게 계정에 대해 활성화해 달라고 요청하세요. 또한 다음 서드파티 오브젝트 스토리지 호스트를 추가로 허용합니다. 여기서는 버킷이 사용자의 것이며 Router는 이에 대한 소유권을 주장하지 않습니다: Cloudflare R2(`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3(`s3.amazonaws.com` 및 `s3..amazonaws.com`, path-style 또는 `.` 접두사 형식 모두), Azure Blob Storage(`.blob.core.windows.net`), Alibaba Cloud OSS(`.oss-.aliyuncs.com`, `oss-accelerate` 엔드포인트 포함). 이들은 구체적으로 오브젝트 스토리지 엔드포인트입니다. Alibaba Function Compute 트리거처럼 동일한 공급자 도메인의 범용 엔드포인트는 목록에 없으며 거부됩니다. -일치되는 것은 공급자가 아니라 호스트 이름 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아닙니다. 호출자가 각각을 합리적으로 사용할 수 있으므로 세 가지 유사 사례를 분명히 밝힐 필요가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보내도록 안내하지만, 사용자 지정 도메인은 호스트 이름에 R2임을 식별할 정보가 없으므로 Router는 이를 다른 호스트와 구분할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 presign하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 반환되는 거부 메시지에 이와 동일한 형식이 명시되므로 여기까지 와서 읽을 필요는 없습니다. -위의 `` 및 `pub-` 자리 표시자는 일반적으로 사용하게 될 형식을 보여 줄 뿐, 깊이 제한이 아닙니다. 일치는 오브젝트 스토리지 도메인 접미사를 기준으로 하므로, 동일한 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 다만 그로 인해 네임스페이스 자체가 넓어지는 것은 아닙니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. -아래 예시는 형태만 보여 줍니다. 실제 값에는 서명 쿼리 파라미터도 포함되는데, 여기서는 의도적으로 생략했습니다. 게시된 예시는 명세에 영구히 남고, 실제 서명은 유출된 자격 증명인 동시에 더 이상 동작하지 않는 링크이기 때문입니다. -각 이미지는 25 MiB로, 한 요청의 이미지는 총 64 MiB로 제한됩니다. + 이미지 하나를, Router가 호출자를 대신해 가져오는 https URL 또는 바이트를 인라인으로 담은 `data:image/;base64,` URI 중 하나로 지정합니다. 허용되는 이미지 유형은 png, webp, jpeg이며, 이 집합은 공급자에게 맡기지 않고 확인 시점에 강제됩니다. svg, gif, avif, tiff는 원인에서 두 단계 떨어진 파트너 오류가 되는 대신, 보낸 이미지를 지목하며 여기서 거부됩니다. +URL 형식을 선호하세요. base64 페이로드는 대략 4/3로 부풀려지고 전체 요청 본문은 100 MiB로 제한되므로, 인라인 형식은 약 75 MB 소스 이미지 근처에서 상한에 도달합니다. URL은 이 제한을 완전히 우회합니다. 이 설명 끝에 명시된 이미지당 및 요청당 미디어 상한은 본문 상한보다 더 엄격하므로, 실제 크기가 있는 이미지라면 먼저 부딪히는 것은 이 상한입니다. +URL은 귀하의 자격 증명 없이 해석되어야 합니다. Router는 서버 측에서 이를 가져오며 요청에 호출자 자격 증명을 보내지 않으므로, 서명이 쿼리 문자열에 있는 미리 서명된 URL이 지원되는 형식입니다. `/api/assets/{id}/content` 같은 인증된 엔드포인트는 이미지 대신 Router에 401을 반환합니다. 해당 URL을 직접 요청하고, 리디렉션되는 서명된 URL을 전달하세요. +가져오기는 공개 인터넷이 아니라 이름이 지정된 호스트 집합으로 제한되며, 동일한 목록이 보내는 URL뿐 아니라 모든 리디렉션 홉에도 다시 적용됩니다. 따라서 다른 호스트의 URL이나 목록 밖으로 리디렉션되는 URL은 공급자에 연결되기 전에 거부됩니다. 현재 이 목록은 Comfy 자체 에셋 전달만 포함합니다. Comfy 에셋 버킷 아래의 서명된 `storage.googleapis.com` URL이며, 이는 `/api/assets/{id}/content`가 리디렉션하는 형식입니다. 파트너 CDN이나 일반 https 호스트는 목록에 없습니다. +두 가지 확장이 롤아웃 중이며 현재 둘 다 기본적으로 꺼져 있습니다. 두 확장은 하나의 전환 뒤에 함께 제공되고 함께 활성화되므로, 아래의 모든 내용은 아직 기반으로 구축할 대상이 아니라 향후 제공될 내용으로 취급하세요. 둘 중 하나에 의존하기 전에 문의하세요. +첫 번째는 `POST /customers/storage`가 귀하의 업로드에 서명하여 넣는 버킷입니다. 롤아웃이 귀하의 환경에 도달하기 전까지 해당 엔드포인트의 업로드 URL은 버킷이 Comfy 소유이고 호스트가 동일하더라도 여기서 거부됩니다. 따라서 "Comfy에 업로드한 다음 URL을 전달"하는 방식은 아직 작동하지 않으며, 작동하는 형식은 `/api/assets/{id}/content`가 리디렉션하는 서명된 URL입니다. +두 번째는 모든 사람에게 한 번에 적용되는 것이 아니라 계정별로 활성화됩니다. 이러한 호스트 뒤의 버킷은 우리 것이 아니라 귀하의 것이기 때문입니다. 위 전환이 켜져 있더라도 타사 인바운드 미디어가 활성화되지 않은 계정은 거부되며, 호스트가 지원되지 않는다는 말이 아니라 그렇게 거부되었다고 안내받습니다. Comfy 담당자에게 계정에 대해 활성화해 달라고 요청하세요. 또한 이 확장은 버킷이 귀하의 것이고 Router가 소유권을 주장하지 않는 다음 타사 객체 스토리지 호스트를 허용합니다. Cloudflare R2(`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3(`s3.amazonaws.com` 및 `s3..amazonaws.com`, 경로 스타일 또는 `.` 접두사 형식 모두), Azure Blob Storage(`.blob.core.windows.net`), Alibaba Cloud OSS(`.oss-.aliyuncs.com`, `oss-accelerate` 엔드포인트 포함)입니다. 이들은 특히 객체 스토리지 엔드포인트입니다. Alibaba Function Compute 트리거처럼 동일한 공급자 도메인의 범용 엔드포인트는 목록에 없으며 거부됩니다. +일치시키는 것은 공급자가 아니라 호스트 이름 형태입니다. 따라서 위에서 공급자를 명시했다고 해서 해당 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아니며, 호출자가 합리적으로 각각을 가지고 올 수 있는 세 가지 유사 사례를 분명히 밝힐 가치가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한된 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보냅니다. 그러나 사용자 지정 도메인은 호스트 이름에 R2임을 식별하는 내용이 없으므로 Router는 다른 호스트와 구분할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트에 미리 서명하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 돌려받는 거부 메시지에 이러한 동일한 형식이 명시되므로 읽기 위해 여기로 올 필요는 없습니다. +위의 `` 및 `pub-` 자리표시자는 일반적으로 사용하게 될 형식을 보여 줍니다. 깊이 제한이 아닙니다. 일치는 객체 스토리지 도메인 접미사에서 이루어지므로 동일한 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 그것으로 확장되지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. +아래 예시는 형태만 보여 줍니다. 실제 값에는 서명 쿼리 파라미터도 함께 포함되며, 게시된 예시는 사양에 영원히 남고 실제 서명은 유출된 자격 증명이자 작동을 멈추는 링크이므로 여기서는 의도적으로 생략했습니다. +각 이미지는 25 MiB로 제한되며, 한 요청의 이미지는 전체 64 MiB로 제한됩니다. 유일한 예외는 `context_window`를 사용할 수 있는 ideogram/ideogram-4-5 Precise Edit(`image`를 전송하는 호출)입니다. 이 경우 각 이미지는 최대 50 MB(50,000,000바이트) 및 67,108,864픽셀, 한 요청의 이미지는 전체 최대 128 MiB까지 허용됩니다. - 생성 작업을 위한 선택적 소스 이미지입니다. 첫 번째가 기본 소스이고 나머지는 참조입니다. 최대 다섯 개, 마스크를 사용하면 네 개입니다. + 생성 작업을 위한 선택적 소스 이미지입니다. 첫 번째가 기본 소스이고 나머지는 참조입니다. 최대 5개이며, 마스크를 사용하는 경우 4개입니다. @@ -177,50 +181,49 @@ URL은 자격 증명 없이 해석(resolve)되어야 합니다. Router는 이를 - 이미지 한 장으로, 호출자를 대신해 Router가 가져오는 https URL이거나 바이트를 인라인으로 담은 `data:image/;base64,` URI입니다. 허용되는 이미지 유형은 png, webp, jpeg이며, 이 집합은 공급자에게 맡겨지지 않고 resolve 시점에 강제됩니다. svg, gif, avif, tiff는 여기서 거부되며, 원인에서 두 단계 떨어진 파트너 오류가 되는 대신 보내신 이미지를 지목합니다. -URL 형식을 권장합니다. base64 페이로드는 약 4/3로 부풀어 오르고 전체 요청 본문은 100 MiB로 제한되므로, 인라인 형식은 약 75 MB 소스 이미지에서 한계에 도달합니다. URL은 이를 완전히 피할 수 있습니다. 이 설명 끝에 명시된 이미지별 및 요청별 미디어 상한은 본문 상한보다 더 엄격하므로, 실제 크기의 이미지라면 먼저 마주치는 것이 이 상한입니다. -URL은 자격 증명 없이 해석되어야 합니다. Router는 이를 서버 측에서 가져오며 요청에 호출자 자격 증명을 함께 보내지 않으므로, 서명이 쿼리 문자열에 있는 presigned URL이 지원되는 형식입니다. `/api/assets/{id}/content` 같은 인증된 엔드포인트는 이미지 대신 Router에 401을 반환합니다. 해당 URL을 직접 요청하고 리디렉션되는 서명된 URL을 전달하세요. -가져오기는 개방된 인터넷이 아니라 지정된 호스트 집합으로 제한되며, 동일한 목록이 보내는 URL뿐 아니라 모든 리디렉션 단계에도 다시 적용됩니다. 따라서 다른 호스트의 URL이나 목록 밖으로 리디렉션되는 URL은 어떤 공급자에 연결되기 전에 거부됩니다. 현재 이 목록은 Comfy 자체 에셋 전송뿐입니다. Comfy 에셋 버킷 아래의 서명된 `storage.googleapis.com` URL이며, 이는 `/api/assets/{id}/content`가 리디렉션하는 형식입니다. 파트너 CDN이나 일반 https 호스트는 목록에 없습니다. -두 가지 확장이 순차 배포 중이며 오늘 기준으로 둘 다 기본적으로 꺼져 있습니다. 이들은 하나의 전환 뒤에 함께 제공되고 함께 활성화되므로, 아래 내용은 아직 대비해 개발할 대상이 아니라 앞으로 제공될 예정으로 취급하세요. 둘 중 어느 것에 의존하기 전에 먼저 문의하세요. -첫 번째는 `POST /customers/storage`가 업로드를 서명해 넣는 버킷입니다. 롤아웃이 사용자의 환경에 도달할 때까지 해당 엔드포인트의 업로드 URL은 여기서 거부됩니다. 버킷이 Comfy 소유이고 호스트가 동일하더라도 마찬가지입니다. 따라서 "Comfy에 업로드한 다음 URL을 전달"하는 방식은 아직 작동하지 않으며, 작동하는 형식은 `/api/assets/{id}/content`가 리디렉션하는 서명된 URL입니다. -두 번째는 모두에게 한꺼번에가 아니라 계정별로 활성화됩니다. 이 호스트 뒤의 버킷이 우리 것이 아니라 사용자의 것이기 때문입니다. 위 전환이 켜져 있더라도 서드파티 인바운드 미디어가 활성화되지 않은 계정은 거부되며, 호스트가 지원되지 않는다는 안내 대신 그렇게 명시된 메시지를 받습니다. Comfy 담당자에게 계정에 대해 활성화를 요청하세요. 이는 추가로 다음 서드파티 오브젝트 스토리지 호스트를 허용합니다. 이 경우 버킷은 사용자 소유이고 Router는 이에 대한 소유권을 주장하지 않습니다: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` 및 `s3..amazonaws.com`, path-style 또는 `.` 접두사 형식 모두), Azure Blob Storage (`.blob.core.windows.net`), Alibaba Cloud OSS (`.oss-.aliyuncs.com`, `oss-accelerate` 엔드포인트 포함). 이들은 특히 오브젝트 스토리지 엔드포인트입니다. 동일한 공급자 도메인의 범용 엔드포인트, 예를 들어 Alibaba Function Compute 트리거는 목록에 없으며 거부됩니다. -일치 대상은 공급자가 아니라 호스트 이름 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아니며, 호출자가 각각을 합리적으로 사용할 수 있으므로 세 가지 유사 사례를 분명히 밝힐 필요가 있습니다. R2 커스텀 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 커스텀 도메인으로 보냅니다. 그러나 커스텀 도메인은 호스트 이름에 R2임을 식별할 아무것도 담고 있지 않으므로 Router는 이를 다른 호스트와 구분할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 presign하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 돌려받는 거부 메시지에 이와 동일한 형식이 명시되므로, 이를 읽기 위해 여기까지 올 필요는 없습니다. -위의 `` 및 `pub-` 자리 표시자는 일반적으로 사용하게 될 형식을 보여줄 뿐이며, 깊이 제한이 아닙니다. 일치는 오브젝트 스토리지 도메인 접미사를 기준으로 하므로, 동일한 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 그렇다고 해서 넓어지는 것은 네임스페이스 자체가 아닙니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. -아래 예시는 형태만 보여줍니다. 실제 값에는 서명 쿼리 파라미터도 포함되는데, 게시된 예시는 스펙에 영원히 남고 실제 서명은 유출된 자격 증명이자 작동을 멈추는 링크이므로 여기서는 의도적으로 생략했습니다. -각 이미지는 25 MiB로, 한 요청의 이미지는 총 64 MiB로 제한됩니다. + 이미지 하나로, Router가 호출자를 대신해 가져오는 https URL이거나 바이트를 인라인으로 담은 `data:image/;base64,` URI입니다. 허용되는 이미지 유형은 png, webp, jpeg이며, 이 집합은 공급자에게 맡기지 않고 resolve 시점에 강제됩니다. svg, gif, avif 또는 tiff는 원인에서 두 단계 떨어진 파트너 오류가 되는 대신, 전송한 이미지를 지목하며 여기에서 거부됩니다. +URL 형식을 선호하세요. base64 페이로드는 대략 4/3로 팽창하고 전체 요청 본문은 100 MiB로 제한되므로, 인라인 형식은 약 75 MB 소스 이미지에서 한계에 도달합니다. URL은 이를 완전히 우회합니다. 이 설명 끝에 명시된 이미지당 및 요청당 미디어 상한은 본문 상한보다 엄격하므로, 실제 크기의 이미지라면 먼저 마주치는 것은 이 상한입니다. +URL은 귀하의 자격 증명 없이 해석되어야 합니다. Router는 서버 측에서 이를 가져오며 요청에 호출자 자격 증명을 포함하지 않으므로, 서명이 쿼리 문자열에 있는 사전 서명된 URL이 지원되는 형식입니다. `/api/assets/{id}/content`와 같은 인증된 엔드포인트는 이미지 대신 Router에 401을 응답합니다. 해당 URL을 직접 요청하고 리다이렉트되는 서명된 URL을 전달하세요. +가져오기는 개방된 인터넷이 아니라 지정된 호스트 집합으로 제한되며, 동일한 목록이 전송한 URL뿐 아니라 모든 리다이렉트 홉에도 다시 적용됩니다. 따라서 다른 호스트의 URL이나 목록 밖으로 리다이렉트되는 URL은 어떤 공급자와도 접촉하기 전에 거부됩니다. 현재 이 목록은 Comfy 자체 에셋 전달뿐입니다. 즉 Comfy 에셋 버킷 아래의 서명된 `storage.googleapis.com` URL이며, `/api/assets/{id}/content`가 리다이렉트하는 형식입니다. 파트너 CDN이나 일반 https 호스트는 목록에 없습니다. +두 가지 확장이 롤아웃 중이며 오늘날 둘 다 기본적으로 꺼져 있습니다. 이들은 하나의 전환 뒤에 출시되어 함께 활성화되므로, 아래의 모든 내용은 아직 이를 기반으로 구축할 대상이 아니라 곧 제공될 예정으로 취급하세요. 둘 중 하나에 의존하기 전에 문의하세요. +첫 번째는 `POST /customers/storage`가 업로드를 서명해 넣는 버킷입니다. 롤아웃이 귀하의 환경에 도달할 때까지 해당 엔드포인트의 업로드 URL은, 버킷이 Comfy 소유이고 호스트도 동일함에도 불구하고 여기에서 거부됩니다. 따라서 "Comfy에 업로드한 다음 URL을 전달"하는 방식은 아직 작동하지 않으며, 작동하는 형식은 `/api/assets/{id}/content`가 리다이렉트하는 서명된 URL입니다. +두 번째는 모든 사람에게 한꺼번에 적용되는 것이 아니라 계정별로 활성화됩니다. 이 호스트들 뒤의 버킷이 우리 것이 아니라 귀하의 것이기 때문입니다. 위의 전환이 켜져 있더라도, 서드파티 인바운드 미디어가 활성화되지 않은 계정은 거부되며, 호스트가 지원되지 않는다는 안내 대신 그렇게 명시된 안내를 받습니다. Comfy 담당자에게 계정에 대해 활성화를 요청하세요. 또한 다음 서드파티 오브젝트 스토리지 호스트를 허용하며, 여기서는 버킷이 귀하의 것이고 Router는 이에 대해 어떠한 소유권도 주장하지 않습니다: Cloudflare R2(`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3(`s3.amazonaws.com` 및 `s3..amazonaws.com`, 경로 스타일 또는 `.` 접두 형식 모두), Azure Blob Storage(`.blob.core.windows.net`), Alibaba Cloud OSS(`.oss-.aliyuncs.com`, `oss-accelerate` 엔드포인트 포함). 이들은 특히 오브젝트 스토리지 엔드포인트입니다. 동일한 공급자 도메인의 범용 엔드포인트(예: Alibaba Function Compute 트리거)는 목록에 없으며 거부됩니다. +일치되는 것은 공급자가 아니라 호스트 이름 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 해당 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아니며, 호출자가 합리적으로 각각을 사용할 수 있으므로 세 가지 유사 사례를 분명히 밝힐 필요가 있습니다. R2 사용자 정의 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 정의 도메인으로 보내지만, 사용자 정의 도메인은 호스트 이름에 R2임을 식별할 아무것도 담고 있지 않으므로 Router는 이를 다른 호스트와 구별할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 사전 서명하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 반환되는 거부 메시지에 이와 동일한 형식이 명시되므로 여기까지 와서 읽을 필요가 없습니다. +위의 `` 및 `pub-` 자리 표시자는 일반적으로 사용하게 될 형식을 보여줄 뿐이며, 깊이 제한이 아닙니다. 일치는 오브젝트 스토리지 도메인 접미사를 기준으로 하므로, 동일한 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 그것으로 넓어지지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. +아래 예시는 형태만 보여줍니다. 실제 값은 서명 쿼리 파라미터도 함께 가지지만, 게시된 예시는 스펙에 영원히 남고 실제 서명은 유출된 자격 증명이자 작동을 멈추는 링크이므로 여기서는 의도적으로 생략했습니다.각 이미지는 25 MiB로 제한되며, 하나의 요청에서 이미지 전체 합계는 64 MiB로 제한됩니다. 한 가지 예외는 `context_window`를 사용할 수 있는 ideogram/ideogram-4-5 Precise Edit(`image`를 전송하는 호출)이며, 여기서는 각 이미지가 최대 50 MB(50,000,000바이트) 및 67,108,864픽셀, 하나의 요청에서 이미지 전체 합계가 최대 128 MiB까지 허용됩니다. - 반환할 이미지 수입니다. 이미지마다 과금됩니다. + 반환할 이미지 수입니다. 각 이미지마다 과금됩니다. - 범위: `1`부터 `8`까지 + 범위: `1` ~ `8` - 이미지에 대한 지시 또는 설명이며, 1자에서 10,000자까지입니다. + 이미지에 대한 지시 또는 설명이며, 1~10,000자입니다. - 품질 등급이며, 과금 요율이기도 합니다. 소스 이미지가 있는 경우: very_low, low, medium, high (기본값 medium). 소스 이미지가 없는 경우: low, medium, high (기본값 high). 텍스트 기반 이미지 생성 요청의 very_low는 거부됩니다. + 품질 등급이며, 과금 요율이기도 합니다. 소스 이미지가 있는 경우: very_low, low, medium 또는 high(기본값 medium). 소스 이미지가 없는 경우: low, medium 또는 high(기본값 high)이며, 텍스트 기반 이미지 생성 요청에서 very_low는 거부됩니다. 가능한 값: `very_low`, `low`, `medium`, `high` - Precise Edit용 선택적 참조 이미지이며, `image`가 필요합니다. 최대 4장, 마스크 사용 시 3장입니다. + Precise Edit용 선택적 참조 이미지이며, `image`가 필요합니다. 최대 4개, 마스크를 사용하는 경우 최대 3개입니다. 재현 가능한 결과를 위한 시드입니다. - 범위: `0`부터 `2147483647`까지 + 범위: `0` ~ `2147483647` - 생성 전용입니다. 출력 크기입니다. auto(기본값), source(이미지 필요) 또는 WIDTHxHEIGHT입니다. 마스크를 보낼 때는 생략하세요. 둘 다 설정한 요청은 거부됩니다. + 생성 전용입니다. 출력 크기입니다. auto(기본값), source(이미지 필요) 또는 WIDTHxHEIGHT입니다. 마스크를 전송할 때는 생략하세요. 두 가지를 모두 설정한 요청은 거부됩니다. -`GET /v2/models/ideogram/ideogram-4-5/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +Router가 `GET /v2/models/ideogram/ideogram-4-5/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -253,7 +256,7 @@ URL은 자격 증명 없이 해석되어야 합니다. Router는 이를 서버
- 생성에 사용된 시드입니다. + 생성 작업에 사용된 시드입니다. ## 예시 diff --git a/ko/development/comfy-router/models/krea/krea-3/code.mdx b/ko/development/comfy-router/models/krea/krea-3/code.mdx index b455b3e707..4a1cb8eb49 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: 56990dce translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": 9c44fce0 + "Schema": c0a0ccaf "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에 업로드하여 반환된 image_url(multipart form 필드 `file`)은 항상 허용됩니다. 다른 공개 https URL이 허용되는지는 환경에 따라 다릅니다. 허용되지 않는 환경에서는 호스트 app-uploads.krea.ai의 https URL이 아닌 링크는 400으로 거부됩니다. 허용되는 환경에서는 공개 https 이미지 URL이면 허용되며, 형식이 잘못되었거나 https가 아닌 URL은 400으로 거부됩니다(포트가 숫자이지만 범위를 벗어난 URL은 이 검사에서 잡히지 않고 대신 502로 실패할 수 있습니다). 허용되는 환경에서 형식이 올바른 https URL의 경우, 호출자가 고칠 수 있는 참조는 해당 호스트를 명시하며 400으로 거부됩니다. 가져오기 전에 확인했을 때 호스트가 확인되지 않거나 공개적으로 접근할 수 없는 경우, 허용된 횟수를 초과하여 리다이렉트하는 경우, https가 아닌 URL이나 공개적으로 접근할 수 없는 호스트로 리다이렉트하는 경우, 408 또는 429가 아닌 4xx를 반환하는 경우, 이미지가 아닌 경우, 읽을 수 없는 형식의 이미지인 경우, 이미지 크기 헤더가 처음 2 MiB 안에 없는 경우, 또는 선언된 길이가 없거나 청크 인코딩된 응답이 이미지 크기 헤더 전에 끝나는 경우입니다. 가져오는 중 그 밖의 실패는 POST /proxy/krea에서 502 오류로 실패합니다(Comfy Router는 이에 500 internal_error로 응답합니다). 일시적인 DNS, TLS 또는 연결 실패, 타임아웃, 원본의 408, 429, 5xx 또는 기타 200이 아닌 상태, 또는 해당 검사를 통과했지만 가져오기가 연결할 때 확인되지 않거나 공개적으로 접근할 수 없는 호스트입니다. 다른 URL이 허용되지 않는 환경에서는 실제 업로드가 아닌 app-uploads.krea.ai 링크가 5xx 오류로 실패합니다. 허용되는 환경에서는 접근할 수 없는 다른 참조와 마찬가지로 400으로 거부됩니다. 서버가 아직 어느 쪽이 적용되는지 알지 못하는 동안에는 app-uploads.krea.ai 링크가 아닌 호스트의 모든 https URL은 공개 여부와 관계없이 재시도해도 안전한 503 오류로 실패합니다. 텍스트 기반 이미지 생성 시에는 생략합니다. 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..fd7196fb87 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,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). @@ -192,7 +193,7 @@ 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를 사용합니다. @@ -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). @@ -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,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,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,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`에 대한 출력 프레임 위치로, 길이가 같아야 합니다. 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). + 생성된 클립을 반복 재생합니다. 생성 시에만 사용 가능합니다(type video). - ray-3.2 비디오의 출력 해상도입니다. 기본값은 720p입니다. 360p는 초안 등급입니다. HDR에는 720p 또는 1080p가 필요합니다. + ray-3.2 video의 출력 해상도입니다. 기본값은 720p입니다. 360p는 초안 등급입니다. HDR은 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). @@ -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`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 동일한 문서입니다. +`GET /v2/models/luma_2/ray-3.2/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 @@ -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`입니다. @@ -368,7 +369,7 @@ Router가 `GET /v2/models/luma_2/ray-3.2/openapi.json`에서 제공하는 스키 - 미리 서명된 URL (1시간 후 만료) + 사전 서명된 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..646d69a8d4 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를 사용합니다. @@ -193,7 +194,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/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-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,23 +220,23 @@ 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` - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, 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-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,17 +288,17 @@ 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 video의 출력 해상도입니다. 기본값은 720p입니다. 360p는 드래프트 등급입니다. HDR은 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-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시간 후 만료) + 미리 서명된 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..29d79baf7c 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"; @@ -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). @@ -179,7 +180,7 @@ 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를 사용합니다. @@ -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). @@ -219,13 +220,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/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로 전달됩니다. @@ -235,7 +236,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 중 정확히 하나를 제공하세요. @@ -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,29 +288,29 @@ 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가 필요합니다. + ray-3.2 비디오의 출력 해상도입니다. 기본값은 720p입니다. 360p는 초안 등급입니다. HDR에는 720p 또는 1080p가 필요합니다. 가능한 값: `360p`, `540p`, `720p`, `1080p` - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. 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). @@ -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`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 대상과 동일한 문서입니다. +`GET /v2/models/luma_2/uni-1/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 @@ -335,7 +336,7 @@ Router가 `GET /v2/models/luma_2/uni-1/openapi.json`에서 제공하는 스키 - 사람이 읽을 수 있는 실패 설명으로, FAILED 생성에서만 채워집니다. 성공한 경우 `null`입니다. + 사람이 읽을 수 있는 실패 설명이며, 실패한 생성에서만 채워집니다. 성공한 경우에는 `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/openai/gpt-image-1-5/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx index bb52ee0b13..09f1b60095 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 GPT Image 1.5 사용하기" description: "Comfy Router를 통해 openai/gpt-image-1.5를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "GPT Image 1.5" -translationSourceHash: 38ba43fc +translationSourceHash: a1545fc4 translationFrom: development/comfy-router/models/openai/gpt-image-1-5/code.mdx translationBlockHashes: "_intro": 7a84676f "Quick start": f364e3f2 - "Schema": 43008228 + "Schema": 8b660697 "Examples": c73859ec --- + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-1.5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -164,28 +165,27 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-1.5/requests/$REQUEST_ID \
- 편집할 소스 이미지입니다. 이 필드의 존재 여부가 편집 작업을 선택합니다. 텍스트 기반 이미지 생성 시에는 이 필드를 완전히 생략하세요. -모델의 공개된 예시는 이 필드를 생략한 GENERATION 호출입니다. `image`를 추가하는 것이 두 모드 사이의 차이 전부입니다(동일한 엔드포인트, 동일한 모델 ID). 다만 편집 프롬프트는 장면이 아니라 원하는 변경 사항을 설명하므로, 구조적으로 새로 추가되는 것이 이 필드 하나뿐임에도 아래의 편집 본문은 생성 예시와 다르게 읽힙니다. + 편집할 소스 이미지입니다. 이 필드가 있으면 편집 작업이 선택됩니다. 텍스트 기반 이미지 생성 시에는 이 필드를 완전히 생략하세요. +모델의 공개된 예시는 이 필드를 생략한 GENERATION 호출입니다. `image`를 추가하는 것이 두 모드 사이의 차이 전부입니다(동일한 엔드포인트, 동일한 모델 id). 다만 편집 프롬프트는 장면이 아니라 원하는 변경 사항을 설명하므로, 구조적으로 새로 추가되는 것이 이 필드 하나뿐임에도 아래의 편집 본문은 생성 예시와 다르게 읽힙니다. 그대로 복사해 사용할 수 있습니다: `{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`. 페이로드는 축약형이 아니라 완전한 1x1 PNG이며, 이 본문은 Router 자체 요청 검증 테스트에서 허용되는 사례로 고정되어 있습니다. 본인 이미지의 바이트로 바꿔 넣으세요. 이미지 하나 또는 이미지 배열을 받습니다. gpt-image-1 및 이후 모델은 최대 16개까지 받을 수 있으며, Router는 디스패치 전에 이 스키마를 기준으로 이를 강제합니다. - 이미지 하나로, Router가 호출자를 대신해 가져오는 https URL이거나 바이트를 인라인으로 담은 `data:image/;base64,` URI입니다. 허용되는 이미지 형식은 png, webp, jpeg이며, 이 집합은 공급자에게 맡기지 않고 resolve 시점에 강제됩니다. svg, gif, avif, tiff는 원인에서 두 단계 떨어진 파트너 오류가 되는 대신, 보낸 이미지를 지목하며 여기서 거부됩니다. + 이미지 하나를 받습니다. Router가 호출자를 대신해 가져오는 https URL이거나, 바이트를 인라인으로 담은 `data:image/;base64,` URI입니다. 허용되는 이미지 형식은 png, webp, jpeg이며, 이 집합은 공급자에게 맡기지 않고 resolve 시점에 강제됩니다. svg, gif, avif, tiff는 원인에서 두 단계 떨어진 파트너 오류가 되는 대신, 보낸 이미지를 지목하며 여기서 거부됩니다. URL 형식을 권장합니다. base64 페이로드는 약 4/3로 부풀어 오르고 전체 요청 본문은 100 MiB로 제한되므로, 인라인 형식은 약 75 MB 소스 이미지에서 한계에 도달합니다. URL은 이 문제를 완전히 피해 갑니다. 이 설명 끝에 명시된 이미지별 및 요청별 미디어 상한은 본문 상한보다 더 엄격하므로, 어느 정도 실제 크기가 있는 이미지라면 먼저 마주치는 것이 이 상한입니다. URL은 귀하의 자격 증명 없이 접근할 수 있어야 합니다. Router는 서버 측에서 이를 가져오며 요청에 호출자 자격 증명을 포함하지 않으므로, 서명이 쿼리 문자열에 있는 presigned URL이 지원되는 형식입니다. `/api/assets/{id}/content` 같은 인증이 필요한 엔드포인트는 이미지 대신 Router에 401을 반환합니다. 그 URL은 직접 요청하고, 리디렉션되는 서명된 URL을 전달하세요. 가져오기는 개방된 인터넷이 아니라 지정된 호스트 집합으로 제한되며, 동일한 목록이 귀하가 보내는 URL뿐 아니라 모든 리디렉션 단계에도 다시 적용됩니다. 따라서 다른 호스트의 URL이나 목록을 벗어난 곳으로 리디렉션되는 URL은 어떤 공급자에 접촉하기도 전에 거부됩니다. 현재 이 목록은 Comfy 자체 에셋 전달만 포함합니다. 즉 Comfy 에셋 버킷 아래의 서명된 `storage.googleapis.com` URL이며, 이것이 `/api/assets/{id}/content`가 리디렉션해 주는 형식입니다. 파트너 CDN이나 일반 https 호스트는 목록에 없습니다. 두 가지 확장이 순차 배포 중이며 오늘 기준으로 둘 다 기본적으로 꺼져 있습니다. 하나의 전환 뒤에 함께 제공되어 동시에 활성화되므로, 아래의 모든 내용은 아직 대비해 개발할 대상이 아니라 예정된 사항으로 취급하세요. 어느 쪽이든 의존하기 전에 문의하세요. 첫 번째는 `POST /customers/storage`가 업로드를 서명해 넣는 버킷입니다. 배포가 귀하의 환경에 도달할 때까지 해당 엔드포인트의 업로드 URL은 여기서 거부됩니다. 버킷이 Comfy 소유이고 호스트도 동일함에도 그렇습니다. 따라서 "Comfy에 업로드한 뒤 URL을 전달"하는 방식은 아직 작동하지 않으며, 작동하는 형식은 `/api/assets/{id}/content`가 리디렉션하는 서명된 URL입니다. 두 번째는 모든 계정에 한꺼번에 적용되는 것이 아니라 계정별로 활성화됩니다. 이 호스트들 뒤의 버킷이 우리 것이 아니라 귀하의 것이기 때문입니다. 위 전환이 켜져 있더라도 서드파티 인바운드 미디어가 활성화되지 않은 계정은 거부되며, 호스트가 지원되지 않는다는 메시지가 아니라 바로 그 취지의 문구로 안내받습니다. 담당 Comfy 연락처에 계정에 대해 이를 활성화해 달라고 요청하세요. 이 전환은 다음과 같은 서드파티 오브젝트 스토리지 호스트를 추가로 허용합니다. 여기서 버킷은 귀하의 것이며 Router는 이에 대한 소유권을 주장하지 않습니다: Cloudflare R2(`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3(`s3.amazonaws.com` 및 `s3..amazonaws.com`, path-style 또는 `.` 접두사 형식 모두), Azure Blob Storage(`.blob.core.windows.net`), Alibaba Cloud OSS(`.oss-.aliyuncs.com`, `oss-accelerate` 엔드포인트 포함). 이들은 구체적으로 오브젝트 스토리지 엔드포인트입니다. 같은 공급자 도메인의 범용 엔드포인트, 예를 들어 Alibaba Function Compute 트리거는 목록에 없으며 거부됩니다. -일치되는 것은 공급자가 아니라 호스트 이름 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아닙니다. 호출자가 각각을 합리적으로 사용할 수 있으므로 세 가지 유사 사례를 분명히 밝힐 필요가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보내지만, 사용자 지정 도메인은 호스트 이름에 R2임을 나타내는 정보가 없으므로 Router는 이를 다른 호스트와 구별할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 presign하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 거부 응답에도 동일한 형식이 명시되므로 이를 확인하기 위해 이 문서를 찾아올 필요는 없습니다. -위의 ``와 `pub-` 자리 표시자는 일반적으로 사용하게 될 형태를 보여 주는 것이며, 깊이 제한이 아닙니다. 일치는 객체 스토리지 도메인 접미사를 기준으로 이루어지므로, 같은 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 다만 그로 인해 넓어지는 것은 아닌 것이 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. -아래 예시는 형태만 보여 줍니다. 실제 값에는 서명 쿼리 파라미터도 함께 포함되는데, 여기서는 의도적으로 생략했습니다. 공개된 예시는 스펙에 영원히 남고, 실제 서명은 유출된 자격 증명이면서 더 이상 작동하지 않게 되는 링크이기 때문입니다. -각 이미지는 25 MiB로 제한되며, 하나의 요청에 포함된 이미지는 총 64 MiB로 제한됩니다. +일치되는 것은 공급자가 아니라 호스트 이름 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아닙니다. 호출자가 각각을 합리적으로 사용할 수 있으므로 세 가지 유사 사례를 분명히 밝힐 필요가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보내지만, 사용자 지정 도메인은 호스트 이름에 R2임을 나타내는 정보가 없으므로 Router는 이를 다른 호스트와 구별할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 presign하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 거부 응답에도 동일한 형식이 명시되므로 이를 확인하기 위해 이 문서를 찾아올 필요는 없습니다.위의 `` 및 `pub-` 플레이스홀더는 일반적으로 접하게 될 형식을 보여 주며, 깊이 제한이 아닙니다. 일치는 객체 스토리지 도메인 접미사를 기준으로 하므로 동일한 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 그로 인해 넓어지지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. +아래 예시는 형태만 보여 줍니다. 실제 값에는 서명 쿼리 파라미터도 포함되지만, 게시된 예시는 스펙에 영구히 남고 실제 서명은 유출된 자격 증명이자 더 이상 작동하지 않는 링크이기 때문에 여기서는 의도적으로 생략했습니다. +각 이미지는 최대 25 MiB로 제한되며, 한 요청의 이미지는 총 64 MiB로 제한됩니다. 유일한 예외는 `context_window`를 사용할 수 있는 ideogram/ideogram-4-5 Precise Edit(`image`를 보내는 호출)입니다. 이 경우 각 이미지는 최대 50 MB(50,000,000바이트) 및 67,108,864픽셀일 수 있고, 한 요청의 이미지는 총 128 MiB까지 가능합니다. - 실행할 gpt-image 모델. Router가 주소로 지정된 모델 id를 끼워 넣으므로, /v2/models/openai/gpt-image-2로 주소를 지정하는 호출자는 이 값을 보내지 않습니다. + 실행할 gpt-image 모델입니다. Router가 주소 지정된 모델 id를 끼워 넣으므로, /v2/models/openai/gpt-image-2를 주소 지정하는 호출자는 이 필드를 보내지 않습니다. @@ -213,27 +213,27 @@ URL은 귀하의 자격 증명 없이 접근할 수 있어야 합니다. Router - 라이브 스트림과 함께일 때만 의미가 있지만 이 표면은 이를 제공할 수 없습니다. 보내더라도 `stream`은 `false`로 고정됩니다. 생성에서는 `0` 또는 `null`이 아닌 값이면 요청이 `stream: true`도 함께 보내는지와 관계없이 400으로 거부됩니다. `image`를 포함한 요청에서는 이 필드가 전달되지 않고 버려집니다. 생략하세요. + 라이브 스트림과 함께 사용할 때만 의미가 있지만, 이 표면은 이를 제공할 수 없습니다. `stream`은 보내더라도 `false`로 고정됩니다. 생성 요청에서 `0` 또는 `null` 이외의 값은 요청이 `stream: true`도 함께 보내는지와 관계없이 400으로 거부됩니다. `image`를 포함한 요청에서는 이 필드가 전달되지 않고 버려집니다. 생략하세요. 범위: `0` ~ `3` - 생성할 이미지 또는 `image`에 적용할 편집에 대한 텍스트 설명입니다. + 생성할 이미지 또는 `image`에 수행할 편집에 대한 텍스트 설명입니다. - 생성되거나 편집된 이미지의 품질입니다. `xhigh`와 `max`는 gpt-image-2.5-flare와 gpt-image-2.5-sunburst가 추가된 두 등급이며, `standard`와 `hd`는 허용된 어떤 모델도 읽지 않는 dall-e 시대의 표기입니다. + 생성되거나 편집된 이미지의 품질입니다. `xhigh`와 `max`는 gpt-image-2.5-flare 및 gpt-image-2.5-sunburst가 추가된 두 등급이며, `standard`와 `hd`는 어떤 허용된 모델도 인식하지 않는 dall-e 시대의 표기입니다. 가능한 값: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` - 이미지의 크기(예: 1024x1024, 1536x1024, auto) + 이미지 크기(예: 1024x1024, 1536x1024, auto) - 이 필드를 보내는 호출자가 거부되지 않도록 선언되어 있지만 이 표면에서는 무효입니다. Router는 디스패치 전에 이를 `false`로 고정합니다. Router는 `text/event-stream`을 중계하는 대신 제공자 응답을 캡처하기 때문입니다(`image`를 포함한 요청에서는 편집이 이를 포함하지 않고 다시 인코딩되므로 이 필드가 대신 버려집니다). 어떤 Comfy 표면도 gpt-image 부분 이미지 스트리밍을 제공하지 않습니다. v1 `POST /proxy/openai/images/generations` 진입점은 `stream: true`를 400으로 거부하고 요청을 업스트림으로 전달하지 않습니다. 따라서 이 필드를 생략하고 완료된 응답을 하나의 JSON 본문으로 읽으세요. 스트림이 열리지 않으므로 `stream: true`와 1보다 큰 `n`을 결합하는 것에 대한 OpenAI의 제한은 여기서 적용되지 않습니다. `n`은 보낸 그대로 전달됩니다. + 이 필드는 보내는 호출자가 거부되지 않도록 선언되어 있지만, 이 표면에서는 무효입니다. Router는 제공자 응답을 캡처하고 `text/event-stream`을 중계하지 않기 때문에 디스패치 전에 이 필드를 `false`로 고정합니다(`image`를 포함한 요청에서는 편집이 이 필드 없이 다시 인코딩되므로 대신 이 필드가 버려집니다). 어떤 Comfy 표면도 gpt-image 부분 이미지 스트리밍을 제공하지 않습니다. v1 `POST /proxy/openai/images/generations` 진입점은 `stream: true`를 400으로 거부하고 요청을 업스트림으로 전달하지 않습니다. 따라서 이 필드를 생략하고 완료된 응답을 하나의 JSON 본문으로 읽으세요. 스트림이 열리지 않으므로 `stream: true`를 1보다 큰 `n`과 결합하는 것에 대한 OpenAI의 제한은 여기서 적용되지 않습니다. `n`은 보낸 그대로 전달됩니다. diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx index 55c66bbc7c..6d18fe0769 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router에서 GPT Image 2.5 Flare 사용하기" description: "Comfy Router를 통해 openai/gpt-image-2.5-flare를 호출합니다. 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "GPT Image 2.5 Flare" -translationSourceHash: 48fb6d21 +translationSourceHash: e3a1017e translationFrom: development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx translationBlockHashes: "_intro": 1e1ed044 "Quick start": c9749309 "Serving providers": ef0e9384 - "Schema": 122f72c5 + "Schema": a7048d34 "Examples": c73859ec --- @@ -17,6 +17,7 @@ translationBlockHashes: + {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/openai/gpt-image-2.5-flare.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -178,7 +179,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare/requests/$REQUES - 편집할 소스 이미지입니다. 이 필드의 존재 여부가 편집 작업을 선택합니다. 텍스트 기반 이미지 생성에는 이 필드를 완전히 생략하세요. + 편집할 소스 이미지입니다. 이 필드가 있으면 편집 작업이 선택됩니다. 텍스트 기반 이미지 생성에는 이 필드를 완전히 생략하세요. 모델이 공개한 예시는 이 필드를 생략하는 생성 호출입니다. `image`를 추가하는 것이 두 모드 사이의 차이 전부입니다. 엔드포인트도 같고 모델 id도 같습니다. 다만 편집 프롬프트는 장면이 아니라 원하는 변경 사항을 설명하므로, 구조적으로 새로운 필드가 이것 하나뿐인데도 아래 편집 본문은 생성 예시와 다르게 읽힙니다. 이는 출력된 그대로 복사할 수 있습니다. `{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}` 페이로드는 축약형이 아니라 완전한 1x1 PNG이며, 이 본문은 Router 자체의 요청 검증 테스트에서 허용되는 사례로 고정되어 있습니다. 자신의 이미지 바이트로 바꿔 넣으세요. 이미지 하나 또는 그 배열을 받습니다. gpt-image-1 및 이후 모델은 최대 16개까지 받으며, Router는 디스패치 전에 이 스키마를 기준으로 이를 강제합니다. @@ -190,26 +191,26 @@ URL 형식을 선호하세요. base64 페이로드는 대략 4/3로 부풀고 URL은 자격 증명 없이 해석되어야 합니다. Router는 이를 서버 측에서 가져오며 요청에 호출자 자격 증명을 보내지 않으므로, 서명이 쿼리 문자열에 있는 presigned URL이 지원되는 형식입니다. `/api/assets/{id}/content` 같은 인증된 엔드포인트는 이미지 대신 Router에 401을 반환합니다. 그 URL을 직접 요청하고 리다이렉트되는 서명된 URL을 전달하세요. 가져오기는 개방된 인터넷이 아니라 지정된 호스트 집합으로 제한되며, 동일한 목록이 보내는 URL뿐 아니라 모든 리다이렉트 지점에 다시 적용됩니다. 따라서 다른 호스트의 URL이나 목록 밖으로 리다이렉트되는 URL은 어떤 공급자와도 접촉하기 전에 거부됩니다. 현재 이 목록은 Comfy 자체 에셋 전송뿐입니다. 즉 Comfy 에셋 버킷 아래의 서명된 `storage.googleapis.com` URL이며, 이는 `/api/assets/{id}/content`가 리다이렉트해 주는 형식입니다. 파트너 CDN이나 일반 https 호스트는 목록에 없습니다. 두 가지 확장이 순차 배포 중이며 오늘 기준으로 둘 다 기본적으로 꺼져 있습니다. 이들은 하나의 전환 뒤에 함께 제공되고 함께 활성화되므로, 아래의 모든 내용을 아직 대비해 개발할 대상이 아니라 예정된 사항으로 취급하세요. 어느 쪽이든 의존하기 전에 문의하세요. -첫 번째는 `POST /customers/storage`가 업로드를 서명해 넣는 버킷입니다. 롤아웃이 귀하의 환경에 도달할 때까지 해당 엔드포인트의 업로드 URL은 여기에서 거부됩니다. 버킷이 Comfy 자체의 것이고 호스트도 동일한데도 그렇습니다. 따라서 "Comfy에 업로드한 뒤 URL을 전달"하는 방식은 아직 동작하지 않으며, 동작하는 형식은 `/api/assets/{id}/content`가 리다이렉트하는 서명된 URL입니다. -두 번째는 모든 사람에게 한꺼번에가 아니라 계정별로 활성화됩니다. 이 호스트들 뒤의 버킷이 우리 것이 아니라 귀하의 것이기 때문입니다. 위 전환이 켜져 있어도 서드파티 인바운드 미디어가 활성화되지 않은 계정은 거부되며, 호스트가 지원되지 않는다는 대신 바로 그 문구로 그렇게 안내됩니다. Comfy 담당자에게 귀하의 계정에 대해 이를 활성화해 달라고 요청하세요. 또한 버킷이 귀하의 것이고 Router가 이에 대한 소유권을 주장하지 않는 다음 서드파티 오브젝트 스토리지 호스트를 허용합니다. Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (path-style 또는 `.` 접두사 형식의 `s3.amazonaws.com` 및 `s3..amazonaws.com`), Azure Blob Storage (`.blob.core.windows.net`), Alibaba Cloud OSS (`oss-accelerate` 엔드포인트를 포함한 `.oss-.aliyuncs.com`). 이들은 구체적으로 오브젝트 스토리지 엔드포인트입니다. 같은 공급자 도메인의 범용 엔드포인트, 예를 들어 Alibaba Function Compute 트리거는 목록에 없으며 거부됩니다. +첫 번째는 `POST /customers/storage`가 업로드에 서명해 주는 버킷입니다. 롤아웃이 귀하의 환경에 도달할 때까지 해당 엔드포인트의 업로드 URL은 여기에서 거부됩니다. 버킷이 Comfy 자체의 것이고 호스트도 동일한데도 그렇습니다. 따라서 "Comfy에 업로드한 뒤 URL을 전달"하는 방식은 아직 동작하지 않으며, 동작하는 형식은 `/api/assets/{id}/content`가 리다이렉트하는 서명된 URL입니다. +두 번째는 모든 사람에게 한꺼번에가 아니라 계정별로 활성화됩니다. 이 호스트들 뒤의 버킷이 우리 것이 아니라 귀하의 것이기 때문입니다. 위 전환이 켜져 있어도 서드파티 인바운드 미디어가 활성화되지 않은 계정은 거부되며, 호스트가 지원되지 않는다는 대신 바로 그 문구로 그렇게 안내됩니다. Comfy 담당자에게 귀하의 계정에 대해 이를 활성화해 달라고 요청하세요. 또한 버킷이 귀하의 것이고 Router가 이에 대한 소유권을 주장하지 않는 다음 서드파티 오브젝트 스토리지 호스트를 허용합니다. Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (path-style 또는 `.` 접두사 형식의 `s3.amazonaws.com` 및 `s3..amazonaws.com`), Azure Blob Storage (`.blob.core.windows.net`), Alibaba Cloud OSS (`oss-accelerate` 엔드포인트를 포함한 `.oss-.aliyuncs.com`). 이들은 구체적으로 오브젝트 스토리지 엔드포인트입니다. 같은 공급자 도메인의 일반 목적 엔드포인트, 예를 들어 Alibaba Function Compute 트리거는 목록에 없으며 거부됩니다. 일치되는 것은 공급자가 아니라 호스트 이름 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아니며, 호출자가 각각을 합리적으로 접하게 될 수 있으므로 세 가지 유사 사례를 분명히 밝힐 필요가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보내지만, 사용자 지정 도메인은 호스트 이름에 R2임을 식별하는 어떤 것도 담고 있지 않으므로 Router는 이를 다른 호스트와 구분할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 presign하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 돌려받는 거부 메시지가 바로 이 형식들을 명시하므로, 이를 읽기 위해 여기까지 올 필요는 없습니다. -위의 `` 및 `pub-` 자리 표시자는 일반적으로 사용하게 될 형태를 보여 주는 것이며, 깊이 제한이 아닙니다. 일치는 객체 스토리지 도메인 접미사를 기준으로 하므로, 동일한 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 다만 그것으로 인해 네임스페이스 자체가 넓어지는 것은 아닙니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. +위의 `` 및 `pub-` 자리 표시자는 일반적으로 사용하게 될 형태를 보여 주는 것이며, 깊이 제한이 아닙니다. 일치는 오브젝트 스토리지 도메인 접미사를 기준으로 하므로, 동일한 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 다만 그것으로 인해 네임스페이스 자체가 넓어지는 것은 아닙니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. 아래 예시는 형태만 보여 줍니다. 실제 값에는 서명 쿼리 파라미터도 함께 포함되는데, 여기서는 의도적으로 생략했습니다. 공개된 예시는 스펙에 영원히 남고, 실제 서명은 유출된 자격 증명이자 더 이상 작동하지 않는 링크이기 때문입니다. -각 이미지는 25 MiB로, 한 요청의 이미지는 총 64 MiB로 제한됩니다. +각 이미지는 25 MiB로 제한되며, 한 요청의 이미지는 총 64 MiB로 제한됩니다. 유일한 예외는 `context_window`를 사용할 수 있는 ideogram/ideogram-4-5 Precise Edit(`image`를 보내는 호출)입니다. 여기서는 각 이미지가 최대 50 MB(50,000,000바이트) 및 67,108,864픽셀일 수 있고, 한 요청의 이미지는 총 최대 128 MiB일 수 있습니다. - 실행할 gpt-image 모델입니다. Router가 주소 지정된 모델 id를 끼워 넣으므로, /v2/models/openai/gpt-image-2로 주소를 지정하는 호출자는 이를 보내지 않습니다. + 실행할 gpt-image 모델입니다. Router가 주소 지정된 모델 id를 끼워 넣으므로, /v2/models/openai/gpt-image-2를 주소 지정하는 호출자는 이 필드를 보내지 않습니다. - 콘텐츠 검열 설정 + 콘텐츠 모더레이션 설정 가능한 값: `low`, `auto` - 생성할 이미지 수입니다(1-10). + 생성할 이미지 수(1-10). 범위: `1`부터 `10`까지 @@ -227,7 +228,7 @@ URL은 자격 증명 없이 해석되어야 합니다. Router는 이를 서버
- 이 표면이 제공할 수 없는 라이브 스트림과 함께일 때만 의미가 있습니다. `stream`은 보내더라도 `false`로 고정됩니다. 생성 시에는 `0` 또는 `null` 이외의 값이면 `stream: true`를 함께 보내는지와 관계없이 400으로 거부되며, `image`를 포함한 요청에서는 이 필드가 전달되지 않고 버려집니다. 생략하세요. + 라이브 스트림과 함께일 때만 의미가 있지만, 이 표면은 라이브 스트림을 제공할 수 없습니다. `stream`을 보내더라도 `false`로 고정됩니다. 생성 요청에서는 요청이 `stream: true`도 보내는지와 관계없이 `0` 또는 `null`이 아닌 모든 값이 400으로 거부됩니다. `image`를 포함한 요청에서는 이 필드가 전달되지 않고 버려집니다. 이 필드는 생략하세요. 범위: `0`부터 `3`까지 @@ -237,7 +238,7 @@ URL은 자격 증명 없이 해석되어야 합니다. Router는 이를 서버
- 생성 또는 편집된 이미지의 품질입니다. `xhigh`와 `max`는 gpt-image-2.5-flare와 gpt-image-2.5-sunburst가 추가된 두 등급이며, `standard`와 `hd`는 허용된 어떤 모델도 읽지 않는 dall-e 시대의 표기입니다. + 생성되거나 편집된 이미지의 품질입니다. `xhigh`와 `max`는 gpt-image-2.5-flare와 gpt-image-2.5-sunburst가 추가된 두 계층이며, `standard`와 `hd`는 허용된 어떤 모델도 해석하지 않는 dall-e 시대의 표기입니다. 가능한 값: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` @@ -247,7 +248,7 @@ URL은 자격 증명 없이 해석되어야 합니다. Router는 이를 서버
- 이 필드를 보내는 호출자가 거부되지 않도록 선언되어 있지만 이 표면에서는 무효입니다. Router는 디스패치 전에 이를 `false`로 고정합니다. Router는 `text/event-stream`을 중계하는 대신 공급자 응답을 캡처하기 때문입니다(`image`를 포함한 요청에서는 편집이 이를 포함하지 않고 다시 인코딩되므로 이 필드가 대신 버려집니다). 어떤 Comfy 표면도 gpt-image 부분 이미지 스트리밍을 제공하지 않습니다. v1 `POST /proxy/openai/images/generations` 진입점은 `stream: true`를 400으로 거부하고 요청을 업스트림으로 전달하지 않습니다. 따라서 이 필드를 생략하고 완료된 응답을 하나의 JSON 본문으로 읽으세요. 스트림이 열리지 않으므로 `stream: true`와 1보다 큰 `n`을 결합하는 것에 대한 OpenAI의 제한은 여기서 적용되지 않습니다. `n`은 보낸 그대로 전달됩니다. + 이 필드를 보내는 호출자가 거부되지 않도록 선언되었지만, 이 표면에서는 무효입니다. Router는 `text/event-stream`을 중계하지 않고 공급자 응답을 캡처하므로 디스패치 전에 이를 `false`로 고정합니다(`image`를 포함한 요청에서는 편집이 이를 포함하지 않고 다시 인코딩되므로 이 필드가 대신 버려집니다). 어떤 Comfy 표면도 gpt-image 부분 이미지 스트리밍을 제공하지 않습니다. v1 `POST /proxy/openai/images/generations` 진입점은 `stream: true`를 400으로 거부하고 요청을 업스트림으로 전달하지 않습니다. 따라서 이 필드를 생략하고 완료된 응답을 하나의 JSON 본문으로 읽으세요. 스트림이 열리지 않으므로 `stream: true`와 1보다 큰 `n`을 결합하는 것에 대한 OpenAI의 제한은 여기서 적용되지 않습니다. `n`은 보낸 그대로 전달됩니다. diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx index 371e079048..c3e8864b71 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 GPT Image 2.5 Sunburst 사용하기" description: "Comfy Router를 통해 openai/gpt-image-2.5-sunburst를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "GPT Image 2.5 Sunburst" -translationSourceHash: 21e3a50f +translationSourceHash: 89d64476 translationFrom: development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx translationBlockHashes: "_intro": 84874630 "Quick start": 8da85011 "Serving providers": 58af0c87 - "Schema": 8eff0738 + "Schema": 61c5bb52 "Examples": c73859ec --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.5-sunburst.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -186,7 +187,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst/requests/$REQ 이미지 하나로, Router가 호출자를 대신해 가져오는 https URL이거나 바이트를 인라인으로 담은 `data:image/;base64,` URI입니다. 허용되는 이미지 유형은 png, webp, jpeg이며, 이 집합은 공급자에게 맡기지 않고 해석 시점에 강제됩니다. svg, gif, avif, tiff는 원인에서 두 단계 떨어진 파트너 오류가 되는 대신, 보낸 이미지를 지목하며 여기서 거부됩니다. URL 형식을 권장합니다. base64 페이로드는 대략 4/3로 부풀고 전체 요청 본문은 100 MiB로 제한되므로, 인라인 형식은 약 75 MB 소스 이미지에서 한계에 도달합니다. URL은 이를 완전히 피해 갑니다. 이 설명 끝에 명시된 이미지당 및 요청당 미디어 상한은 본문 상한보다 더 엄격하므로, 실제 크기의 이미지라면 먼저 부딪히는 것은 이 상한입니다. -URL은 자격 증명 없이 확인되어야 합니다. Router는 이를 서버 측에서 가져오며 요청에 호출자 자격 증명을 함께 보내지 않습니다. 따라서 서명이 쿼리 문자열에 있는 presigned URL이 지원되는 형식입니다. `/api/assets/{id}/content` 같은 인증이 필요한 엔드포인트는 이미지 대신 Router에 401을 반환합니다. 해당 URL을 직접 요청하고 리다이렉트된 서명 URL을 전달하세요. +URL은 자격 증명 없이 접근할 수 있어야 합니다. Router는 이를 서버 측에서 가져오며 요청에 호출자 자격 증명을 함께 보내지 않습니다. 따라서 서명이 쿼리 문자열에 있는 presigned URL이 지원되는 형식입니다. `/api/assets/{id}/content` 같은 인증이 필요한 엔드포인트는 이미지 대신 Router에 401을 반환합니다. 해당 URL을 직접 요청하고 리다이렉트된 서명 URL을 전달하세요. 가져오기는 공개 인터넷이 아니라 이름이 지정된 호스트 집합으로 제한되며, 같은 목록이 보내는 URL뿐 아니라 모든 리다이렉트 홉에도 다시 적용됩니다. 따라서 다른 호스트의 URL이나 목록 밖으로 리다이렉트되는 URL은 어떤 공급자와도 접촉하기 전에 거부됩니다. 현재 이 목록에는 Comfy 자체의 에셋 전송만 포함됩니다. 즉 Comfy 에셋 버킷 아래의 서명된 `storage.googleapis.com` URL이며, 이것이 `/api/assets/{id}/content`가 리다이렉트하는 형식입니다. 파트너 CDN이나 일반 https 호스트는 목록에 없습니다. 두 가지 확장이 순차 배포 중이며 오늘 기준으로 둘 다 기본적으로 꺼져 있습니다. 이들은 하나의 전환 뒤에 함께 제공되며 함께 활성화되므로, 아래의 모든 내용은 아직 대비해 개발할 대상이 아니라 예정된 사항으로 취급하세요. 둘 중 하나에 의존하기 전에 문의하세요. 첫 번째는 `POST /customers/storage`가 업로드를 서명해 넣는 버킷입니다. 롤아웃이 여러분의 환경에 도달할 때까지 해당 엔드포인트의 업로드 URL은, 버킷이 Comfy 소유이고 호스트도 동일한데도, 여기서 거부됩니다. 따라서 "Comfy에 업로드한 다음 URL을 전달"하는 방식은 아직 동작하지 않으며, 동작하는 형식은 `/api/assets/{id}/content`가 리다이렉트하는 서명 URL입니다. @@ -194,21 +195,21 @@ URL은 자격 증명 없이 확인되어야 합니다. Router는 이를 서버 일치되는 것은 공급자가 아니라 호스트 이름 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아닙니다. 호출자가 각각을 합리적으로 들고 올 수 있으므로, 세 가지 유사 사례를 분명히 밝혀 둘 필요가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보내지만, 사용자 지정 도메인은 호스트 이름에 R2임을 알려 주는 정보가 없으므로 Router는 이를 다른 호스트와 구별할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 presign하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 돌려받는 거부 메시지가 바로 이 형식들을 명시하므로, 이를 읽기 위해 여기까지 올 필요는 없습니다. 위의 `` 및 `pub-` 자리 표시자는 일반적으로 사용하게 되는 형태를 보여 주는 것이며, 깊이 제한이 아닙니다. 매칭은 오브젝트 스토리지 도메인 접미사를 기준으로 하므로, 동일한 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 다만 그것으로 인해 완화되지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. 아래 예시는 형태만 보여 줍니다. 실제 값에는 서명 쿼리 파라미터도 함께 포함되는데, 여기서는 의도적으로 생략했습니다. 게시된 예시는 명세에 영구히 남고, 실제 서명은 유출된 자격 증명이자 작동을 멈추는 링크가 되기 때문입니다. -각 이미지는 25 MiB로 제한되며, 한 요청의 이미지는 총 64 MiB로 제한됩니다. +각 이미지는 25 MiB로 제한되며, 한 요청의 이미지는 총 64 MiB로 제한됩니다. 유일한 예외는 `image`를 보내는 호출인 ideogram/ideogram-4-5 Precise Edit에서 `context_window`를 사용할 수 있는 경우입니다. 이 경우 각 이미지는 최대 50 MB(50,000,000바이트) 및 67,108,864픽셀까지 가능하고, 한 요청의 이미지는 총 128 MiB까지 가능합니다. - 실행할 gpt-image 모델입니다. Router가 주소로 지정된 모델 id를 끼워 넣으므로, /v2/models/openai/gpt-image-2를 주소로 지정하는 호출자는 이 값을 보내지 않습니다. + 실행할 gpt-image 모델입니다. Router는 주소 지정된 모델 id를 끼워 넣으므로, /v2/models/openai/gpt-image-2를 주소 지정하는 호출자는 이를 보내지 않습니다. - 콘텐츠 검열 설정 + 콘텐츠 모더레이션 설정 가능한 값: `low`, `auto` - 생성할 이미지 수(1-10)입니다. + 생성할 이미지 수(1-10). 범위: `1`부터 `10`까지 @@ -220,13 +221,13 @@ URL은 자격 증명 없이 확인되어야 합니다. Router는 이를 서버 - 출력 이미지의 포맷 + 출력 이미지의 형식 가능한 값: `png`, `webp`, `jpeg` - 라이브 스트림과 함께일 때만 의미가 있지만 이 표면은 이를 제공할 수 없습니다. 보내더라도 `stream`은 `false`로 고정됩니다. 생성에서는 `0` 또는 `null`이 아닌 값이면 요청이 `stream: true`도 함께 보내는지와 관계없이 400으로 거부됩니다. `image`를 포함한 요청에서는 이 필드가 전달되지 않고 버려집니다. 생략하세요. + 실시간 스트림과 함께 사용할 때만 의미가 있으며, 이 표면에서는 제공할 수 없습니다. `stream`은 보내더라도 `false`로 고정됩니다. 생성 시 `0` 또는 `null` 이외의 값은 요청이 `stream: true`도 보내는지 여부와 관계없이 400으로 거부됩니다. `image`를 포함한 요청에서는 이 필드가 전달되지 않고 삭제됩니다. 이 필드는 생략하세요. 범위: `0`부터 `3`까지 @@ -242,7 +243,7 @@ URL은 자격 증명 없이 확인되어야 합니다. Router는 이를 서버
- 이미지의 크기(예: 1024x1024, 1536x1024, auto) + 이미지 크기(예: 1024x1024, 1536x1024, auto) diff --git a/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx index 2df64f3cd7..c5200ec4b1 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router에서 GPT Image 2 사용하기" description: "Comfy Router를 통해 openai/gpt-image-2를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "GPT Image 2" -translationSourceHash: 6437f5f1 +translationSourceHash: b9cb8af5 translationFrom: development/comfy-router/models/openai/gpt-image-2/code.mdx translationBlockHashes: "_intro": ff220f7e "Quick start": 7ec2e3b6 "Serving providers": 56df172f - "Schema": 0ebd1b14 + "Schema": 4e6e5e53 "Examples": c73859ec --- @@ -195,7 +195,7 @@ URL은 자격 증명 없이 해석되어야 합니다. Router는 서버 측에 일치되는 것은 공급자가 아니라 호스트명 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용된다는 뜻은 아니며, 호출자가 합리적으로 각각을 가지고 올 수 있으므로 세 가지 유사 사례를 분명히 밝힐 필요가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트명으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보냅니다. 그러나 사용자 지정 도메인은 호스트명에 R2임을 식별할 정보가 없으므로 Router는 다른 호스트와 구분할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 presign하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 반환되는 거부 메시지에 이와 동일한 형식이 명시되므로, 이를 읽기 위해 여기까지 올 필요는 없습니다. 위의 `` 및 `pub-` 자리 표시자는 일반적으로 사용하게 될 형태를 보여줄 뿐이며, 깊이 제한이 아닙니다. 일치는 객체 스토리지 도메인 접미사를 기준으로 이루어지므로, 같은 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 다만 이것으로 넓어지지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. 아래 예시는 형태만 보여줍니다. 실제 값에는 서명 쿼리 파라미터도 함께 포함되는데, 게시된 예시는 스펙에 영원히 남고 실제 서명은 유출된 자격 증명이자 더 이상 작동하지 않는 링크이므로 여기서는 의도적으로 생략했습니다. -각 이미지는 25 MiB로 제한되며, 한 요청의 이미지들은 총 64 MiB로 제한됩니다. +각 이미지는 25 MiB로 제한되며, 한 요청의 이미지들은 총 64 MiB로 제한됩니다. 유일한 예외는 `context_window`를 사용할 수 있는 ideogram/ideogram-4-5 Precise Edit(`image`를 보내는 호출)입니다. 여기서는 각 이미지가 최대 50 MB(50,000,000바이트) 그리고 67,108,864픽셀까지 가능하며, 한 요청의 이미지들은 총 128 MiB까지 가능합니다. diff --git a/ko/development/comfy-router/models/veed/fabric-1-0/code.mdx b/ko/development/comfy-router/models/veed/fabric-1-0/code.mdx index d4c41003b9..da36013731 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..b35f2a20b2 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: a6f99965 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 - "Result assets": 65fc939b + "Pre-flight cost estimates": 5952af3f + "Result assets": 18fe6dad "Per-model input and output schemas": 61c6bde8 - "Schemas": 77cfa4db + "Schemas": 984bd216 --- @@ -27,6 +27,8 @@ translationBlockHashes: + + {/* 생성된 파일: 손으로 편집하지 마십시오. @@ -49,16 +51,16 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 ### `GET /v2/models` -**Comfy Router가 실행할 수 있는 모델 목록을 조회합니다.** +**Comfy Router가 실행할 수 있는 모델을 나열합니다.** -사용 가능한 모델 ID와 과금 정보를 나열합니다. `has_more`가 참인 동안 `next_cursor`를 사용하세요. +사용 가능한 모델 ID와 청구 정보를 나열합니다. `has_more`가 `true`인 동안 `next_cursor`를 사용하세요. **파라미터** - 불투명한 페이지네이션 커서입니다. + 불투명 페이지네이션 커서입니다. - 타입: [`RouterPageCursor`](#routerpagecursor) -- `next_cursor`로 반환되는 불투명 커서, 1–512자 + 유형: [`RouterPageCursor`](#routerpagecursor). `next_cursor`로 반환되는 불투명 커서, 1–512자 @@ -74,59 +76,59 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 **응답** - OK - 모델 카탈로그의 한 페이지입니다. + OK: 모델 카탈로그의 한 페이지입니다. - 본문: [`RouterModelListResponse`](#routermodellistresponse) -- 헤더: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` + 본문: [`RouterModelListResponse`](#routermodellistresponse). 헤더: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - Not Modified - 호출자가 `If-None-Match`로 보낸 `ETag` 이후 페이지가 변경되지 않았습니다. + Not Modified: 호출자가 `If-None-Match`로 보낸 `ETag` 이후 페이지가 변경되지 않았습니다. 헤더: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - 잘못된 요청입니다. 오류 유형과 요청 본문을 확인하세요. + 유효하지 않은 요청입니다. 오류 유형과 요청 본문을 확인하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 자격 증명이 누락되었거나 유효하지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 이 호출자 또는 모델에 대해 요청이 허용되지 않습니다. + 이 호출자 또는 모델에 대해서는 요청이 허용되지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router를 일시적으로 사용할 수 없습니다. 백오프를 적용하여 재시도하세요. + Router를 일시적으로 사용할 수 없습니다. 백오프를 적용해 재시도하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}` -**표준 모델 ID로 파트너 모델 하나의 카탈로그 항목을 조회합니다.** +**정식 모델 ID로 파트너 모델 하나의 카탈로그 항목을 조회합니다.** -전체 카탈로그를 나열하지 않고 모델 하나의 세부 정보를 조회합니다. +전체 카탈로그를 나열하지 않고 한 모델의 세부 정보를 조회합니다. **파라미터** - 표준 `{provider}/{model}` 모델 ID의 공급자 부분입니다. + 정식 `{provider}/{model}` 모델 ID의 공급자 부분입니다. - 유형: [`RouterProviderSegment`](#routerprovidersegment). 영숫자 슬러그(예: `anthropic`), 최대 64자 + 유형: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 - 표준 `{provider}/{model}` 모델 ID의 모델 부분입니다. + 정식 `{provider}/{model}` 모델 ID의 모델 부분입니다. - 유형: [`RouterModelSegment`](#routermodelsegment). 영숫자 슬러그(예: `claude-opus-4-6`), 최대 128자 + 유형: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 @@ -136,13 +138,13 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 **응답** - OK: 모델의 카탈로그 항목입니다. + OK - 모델의 카탈로그 항목입니다. - 본문: [`RouterModelDetail`](#routermodeldetail). 헤더: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` + 본문: [`RouterModelDetail`](#routermodeldetail) -- 헤더: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - 수정되지 않음: 호출자가 `If-None-Match`에 보낸 `ETag` 이후 항목이 변경되지 않았습니다. + Not Modified - 호출자가 `If-None-Match`로 보낸 `ETag` 이후 항목이 변경되지 않았습니다. 헤더: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` @@ -150,257 +152,257 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 자격 증명이 누락되었거나 유효하지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 이 호출자 또는 모델에 대해서는 요청이 허용되지 않습니다. + 이 호출자 또는 모델에 대해서는 해당 요청이 허용되지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 모델 ID를 찾을 수 없습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router를 일시적으로 사용할 수 없습니다. 백오프를 적용해 다시 시도하세요. + Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}` -**표준 모델 ID로 파트너 모델을 동기적으로 실행합니다.** +**정규 모델 ID로 파트너 모델을 동기적으로 실행합니다.** 모델을 실행하고 완료된 결과를 같은 응답에서 받습니다. **파라미터** - 표준 `{provider}/{model}` 모델 ID에서 공급자 부분입니다. + 정규 `{provider}/{model}` 모델 ID의 공급자 부분입니다. - 유형: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 + 유형: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그(예: `anthropic`), 최대 64자 - 표준 `{provider}/{model}` 모델 ID에서 모델 부분입니다. + 정규 `{provider}/{model}` 모델 ID의 모델 부분입니다. - 유형: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 + 유형: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그(예: `claude-opus-4-6`), 최대 128자 - 하나의 논리적 호출을 안전하게 재시도할 수 있게 해 주는, 호출자가 생성한 키입니다. + 하나의 논리적 호출을 안전하게 재시도할 수 있게 해 주는 호출자 생성 키입니다. 1–255자 - 이 모델을 현재 기본값 대신 다른 공급자가 서비스하도록 선택합니다. `fal`, `wavespeed`, `runware`, `higgsfield`가 대체 공급자이며, `GET /v2/models/{provider}/{model}`은 주어진 모델이 이들 중 무엇을 지원하는지 알려줍니다. 거부는 고정된 순서로 검사되며, 앞선 검사는 뒤따르는 검사에 해당하든 아니든 응답합니다. 등록된 공급자가 전혀 아닌, 인식되지 않는 값은 `400`으로 거부됩니다. 다음으로, 본문이 멀티파트 작업(편집)을 선택하는 요청에서 대체 공급자를 지정하면 `detail`이 "this request's `image` selects the edit operation"으로 시작하는 `409`로 거부되지만, 이는 해당 공급자의 이 모델에 대한 번역기가 그 작업을 처리할 수 없을 때만입니다. 미디어를 실제로 처리하는 번역기를 가진 레그는 정상적으로 진행됩니다. 다음으로, bring-your-own-key 자격 증명을 확인한 요청에서는 해당 공급자가 이 모델을 서비스하는지와 무관하게, 대체 공급자를 지정하면 `detail`이 `this request resolved a BYOK credential`로 시작하는 `409`로 거부됩니다(해당 응답 참조). 다음으로, 지정된 공급자 자체의 게이트가 검사되는데, 해당 공급자가 내게 활성화되어 있지 않으면 `error_type: not_enabled`와 함께 `403`으로, 게이트를 평가할 수 없으면 `error_type: service_unavailable`과 함께 `503`으로 거부합니다. 그리고 이 네 가지를 모두 통과한 뒤에야 이 모델에 대한 레그가 없는 실제 공급자가 `error_type: invalid_input`과 함께 `400`으로 거부되며, 이는 인식되지 않는 값과 같은 응답입니다. `fallback_provider`는 bring-your-own-key 요청에서, 본문이 멀티파트 작업을 선택하는 요청에서, 그리고 `strict_mode=true`에서 거부되지 않고 효력이 없습니다. + 이 모델을 현재 기본값 대신 다른 공급자가 처리하도록 선택합니다. `fal`, `wavespeed`, `runware`, `higgsfield`가 대체 공급자이며, `GET /v2/models/{provider}/{model}`은 주어진 모델이 이 중 어떤 공급자를 지원하는지 보고합니다. 거부 사유는 정해진 순서로 검사되며, 앞선 사유는 나중 사유의 해당 여부와 관계없이 응답합니다. 인식할 수 없는 값, 즉 등록된 공급자가 전혀 아닌 값은 `400`으로 거부됩니다. 그다음, 본문이 멀티파트 작업(편집)을 선택하는 요청에서 대체 공급자는 `detail`이 "this request's `image` selects the edit operation"로 시작하는 `409`로 거부되지만, 이는 해당 공급자의 이 모델용 변환기가 그 작업을 처리할 수 없을 때만이며, 변환기가 미디어를 지원하는 경로는 정상적으로 진행됩니다. 그다음, 자체 키(BYOK) 자격 증명이 확인된 요청에서는 해당 공급자가 이 모델을 처리하는지와 무관하게 모든 대체 공급자가 `detail`이 `this request resolved a BYOK credential`로 시작하는 `409`로 거부됩니다(해당 응답 참조). 그다음, 지명된 공급자 자체의 게이트가 적용되며, 해당 공급자가 사용자에게 활성화되어 있지 않으면 `error_type: not_enabled`와 함께 `403`으로, 게이트를 평가할 수 없으면 `error_type: service_unavailable`와 함께 `503`으로 거부합니다. 이 네 가지를 모두 통과한 뒤에야, 이 모델에 대한 경로가 없는 실제 공급자가 `error_type: invalid_input`와 함께 `400`으로 거부되며, 이는 인식할 수 없는 값과 같은 응답입니다. `fallback_provider`는 자체 키 요청, 본문이 멀티파트 작업을 선택하는 요청, 그리고 `strict_mode=true`에서 거부되지 않고 아무 효과도 없습니다. `model_provider`와 함께 사용할 때만 의미가 있습니다. - 기본값: 거짓 + 기본값: False - 첫 시도가 Router 또는 시도한 공급자에 기인하는 이유로 실패했을 때, Router가 이 호출을 모델의 다른 등록 공급자로 재시도할지 여부를 제어합니다. 생략하거나 `false` 이외의 값을 주면 폴백이 켜진 채로 유지되고, `false`는 폴백을 끕니다. 폴백이 성공한 응답에는 `X-Comfy-Router-Fallback-Provider`가 포함됩니다. bring-your-own-key 자격 증명을 확인한 요청에서는 이 파라미터가 무엇을 말하든 폴백을 사용할 수 없습니다. 시도 자체가 이루어지지 않고 첫 실패가 그대로 전달되며, 이는 거부가 아니라 효력이 없는 것입니다. 여기서 `409`가 발생하지는 않습니다. 같은 이유로, 본문이 멀티파트 작업을 선택하는 요청과 `strict_mode=true`에서도 마찬가지입니다. 각각은 호출을 하나의 공급자에 묶어 다른 공급자에 대해 충실히 재생할 수 없으므로, 폴백은 거부되지 않고 그냥 건너뜁니다. 그 `409`로 거부되는 것은 명시적인 `model_provider`뿐이며, 이 무조건적인 건너뜀과 달리 멀티파트 `409`는 번역기가 해당 작업을 처리할 수 없는 레그에만 적용됩니다. + 첫 시도가 Router 또는 시도한 공급자에게 귀속되는 이유로 실패했을 때, Router가 이 호출을 모델의 다른 등록 공급자에 대해 재시도할지 여부를 제어합니다. 생략하거나 `false`가 아닌 값을 지정하면 폴백이 켜진 상태로 유지되고, `false`는 이를 끕니다. 폴백이 성공한 응답에는 `X-Comfy-Router-Fallback-Provider`가 포함됩니다. 자체 키(BYOK) 자격 증명이 확인된 요청에서는 이 파라미터의 값과 무관하게 폴백을 사용할 수 없습니다. 재시도는 그저 수행되지 않고 첫 실패가 그대로 전달되며, 이는 거부가 아니라 아무 효과도 없는 것입니다. 여기서 `409`가 발생하지는 않습니다. 같은 이유로 본문이 멀티파트 작업을 선택하는 요청과 `strict_mode=true`에서도 마찬가지입니다. 각각은 호출을 다른 공급자에 대해 충실히 재현할 수 없는 하나의 공급자에 묶으므로, 폴백은 거부되지 않고 그저 건너뜁니다. 명시적인 `model_provider`만이 그 `409`로 거부되며, 이 무조건적인 건너뜀과 달리 그 멀티파트 `409`는 변환기가 해당 작업을 처리할 수 없는 경로에만 적용됩니다. - 이 모델의 입력 스키마가 선언하지 않은 최상위 요청 본문 필드를 수용하는 대신 거부하도록 선택합니다. 중첩 필드는 검사하지 않으며, 스키마가 선언되지 않은 필드를 허용하거나 작성된 스키마가 없는 모델에서는, 또는 `strict_mode=true`로 보낸 대기 중 제출에서는 아무것도 거부되지 않습니다. + 이 모델의 입력 스키마가 선언하지 않은 최상위 요청 본문 필드를 수용하는 대신 거부하도록 선택합니다. 중첩 필드는 검사하지 않으며, 스키마가 선언되지 않은 필드를 허용하거나 작성된 스키마가 없는 모델에서는 아무것도 거부되지 않고, `strict_mode=true`로 보낸 대기 중 제출에서도 거부되지 않습니다. - 기본값: 거짓 + 기본값: False **요청 본문** `application/json` -- [`RouterModelInput`](#routermodelinput) (필수) -파트너 모델의 기본 JSON 입력입니다. `model_provider`가 없으면 요청은 모델의 기본 공급자에서 네이티브 디스패치로 실행되며, 이 본문은 모델 자체의 네이티브 스키마이고 그대로 전달됩니다(이 경우 `strict_mode`는 의미가 없으며 아무것도 바꾸지 않습니다). `model_provider`가 대체 공급자를 선택하고 `strict_mode=false`(기본값)이면, 본문은 전송되기 전에 해당 공급자의 실제 스키마로 변환됩니다. 정확히 표현할 수 없는 네이티브 필드는 버려지고 응답의 `X-Comfy-Router-Dropped-Params` 헤더를 통해 공개되며, 결코 조용히 처리되지 않습니다. `model_provider`가 대체 공급자를 선택하고 `strict_mode=true`이면 변환이 실행되지 않습니다. 본문은 이 모델의 네이티브 스키마가 아니라 이미 해당 대체 공급자 자체의 실제 스키마여야 하며(`strict_mode` 참조), 그대로 전달됩니다. 본문의 필드 자체가 하나 이상의 작업을 지원하는 모델에서 Router가 어떤 작업을 실행할지도 선택합니다. 편집 가능한 이미지 모델의 경우 입력 이미지를 포함하면 텍스트 기반 이미지 생성에서 이미지 기반 이미지 생성(편집) 작업으로 전환되며, 이 작업은 자체 요율로 과금될 수 있습니다. Seedance 비디오 모델의 경우 `content[].role`이 작업을 선택합니다(첫 프레임 이미지는 이미지 기반 비디오 생성을, 레퍼런스 이미지나 클립은 레퍼런스 기반 비디오 생성을 선택합니다). 네이티브 디스패치에서 Seedance 과금은 역할이 아니라 `content`의 미디어 종류를 따릅니다. 비디오 입력이 하나라도 있는 요청은 비디오 기반 비디오 생성으로 과금되고, 그렇지 않고 이미지가 하나라도 있으면 이미지 기반 비디오 생성으로, 그 외에는 텍스트 기반 비디오 생성으로 과금되며, 단 `draft_task` 항목에서 나온 최종 렌더는 그것이 렌더링하는 Draft의 작업으로 과금됩니다. 일부 모델은 텍스트 기반 비디오 생성과 이미지 기반 비디오 생성에 같은 요율을 부과합니다. `model_provider`가 대체 공급자를 선택하는 경우, 조건이 적용된 각 작업은 해당 공급자 자체의 요율로 과금될 수 있습니다. +파트너 모델의 기본 JSON 입력입니다. `model_provider`가 없으면 요청은 모델의 기본 공급자에서 네이티브 디스패치를 실행하며, 이 본문은 모델 자체의 네이티브 스키마이고 그대로 전달됩니다(이 경우 `strict_mode`는 의미가 없고 아무것도 바꾸지 않습니다). `model_provider`가 대체 공급자를 선택하고 `strict_mode=false`(기본값)인 경우, 본문은 전송되기 이전에 해당 공급자의 실제 스키마로 변환됩니다. 정확히 표현할 수 없는 네이티브 필드는 버려지고 응답의 `X-Comfy-Router-Dropped-Params` 헤더를 통해 알려지며, 결코 조용히 처리되지 않습니다. `model_provider`가 대체 공급자를 선택하고 `strict_mode=true`이면 변환이 실행되지 않습니다. 본문은 이 모델의 네이티브 스키마가 아니라 이미 그 대체 공급자 자체의 실제 스키마여야 하며(`strict_mode` 참조), 그대로 전달됩니다. 본문의 필드 자체가 둘 이상의 작업을 지원하는 모델에서 Router가 실행할 작업을 선택하기도 합니다. 편집 가능한 이미지 모델의 경우 입력 이미지를 포함하면 텍스트 기반 이미지 생성에서 이미지 기반 이미지 생성(편집) 작업으로 전환되며, 이 작업은 별도의 요율로 과금될 수 있습니다. Seedance 비디오 모델의 경우 `content[].role`이 작업을 선택합니다(첫 프레임 이미지는 이미지 기반 비디오 생성을, 레퍼런스 이미지 또는 클립은 레퍼런스 기반 비디오 생성을 선택합니다). 네이티브 디스패치에서 Seedance 과금은 역할이 아니라 `content`의 미디어 종류를 따릅니다. 비디오 입력이 하나라도 있는 요청은 비디오 기반 비디오 생성으로, 그렇지 않고 이미지가 하나라도 있으면 이미지 기반 비디오 생성으로, 그 외에는 텍스트 기반 비디오 생성으로 과금됩니다. 다만 `draft_task` 항목에서 나온 최종 렌더는 그것이 렌더링하는 Draft의 작업으로 과금됩니다. 일부 모델은 텍스트 기반 비디오 생성과 이미지 기반 비디오 생성을 같은 요율로 과금합니다. `model_provider`가 대체 공급자를 선택하는 경우, 조건이 적용된 각 작업은 해당 공급자 자체의 요율로 과금될 수 있습니다. **응답** - OK: `model_provider`가 없거나, `model_provider`가 있으면서 `strict_mode=false`인 경우(기본값이며, 가능하면 이 모델의 네이티브 계약으로 다시 변환하고 변환 실패 시 대체 공급자 자체의 원시 응답으로 폴백합니다. 이는 기록되며 결코 조용히 처리되지 않습니다) 형태는 이 모델 자체의 네이티브 출력입니다. `strict_mode=true`이면 대체 공급자의 응답이 변경 없이 반환됩니다. 파트너가 생성을 바이트로 직접 응답하는 모델의 경우, 본문은 `application/json`이 아니라 파트너 자체의 `Content-Type` 아래에 있는 해당 바이트입니다. 응답 `Content-Type`을 기준으로 분기하고 JSON 문서라고 가정하지 마세요. + OK - `model_provider`가 없거나, `model_provider`가 있고 `strict_mode=false`(기본값, 가능한 경우 이 모델의 네이티브 계약으로 다시 변환되며, 변환에 실패하면 대체 공급자 자체의 원시 응답으로 폴백합니다. 이는 기록되며 결코 조용히 넘어가지 않습니다)인 경우 형태는 이 모델 자체의 네이티브 출력입니다. `strict_mode=true`이면 대체 공급자의 응답이 변경 없이 그대로 반환됩니다. 파트너가 생성을 바이트로 직접 응답하는 모델의 경우, 본문은 `application/json`이 아니라 파트너 자체의 `Content-Type` 아래에 있는 해당 바이트입니다. 응답 `Content-Type`을 기준으로 분기하고 JSON 문서라고 가정하지 마세요. - 본문: [`RouterModelOutput`](#routermodeloutput) 또는 원시 바이트(`*/*`). 헤더: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` + 본문: [`RouterModelOutput`](#routermodeloutput) 또는 원시 바이트 (`*/*`) -- 헤더: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` 잘못된 요청입니다. 오류 유형과 요청 본문을 확인하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `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` 자격 증명이 누락되었거나 유효하지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 않았거나, 모델 자체가 보고하지 않은 이유로 실패했습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 이 호출자 또는 모델에는 요청이 허용되지 않습니다. + 이 호출자 또는 모델에 대해 요청이 허용되지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 모델 ID를 찾을 수 없습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - `X-Comfy-Error-Type`을 확인하세요: `concurrency_limit_exceeded`는 원본 호출이 아직 실행 중이라는 뜻이므로 `Retry-After`를 기다린 뒤 동일한 키를 재사용하세요. `invalid_input`은 새 키가 필요합니다. 이 라우트의 두 가지 `invalid_input` 충돌은 키와 전혀 관련이 없으며 새 키로도 해결되지 않습니다: `model_provider`가 대체 공급자를 지정하는 경우, 요청 본문이 해당 공급자의 이 모델용 변환기가 처리할 수 없는 멀티파트 작업(편집)을 선택하면 거부되며, `detail`은 "this request's `image` selects the edit operation"로 시작합니다. 그리고 그 이후에 검사되는 경우로, 요청이 이미 경로에 있는 공급자의 BYOK 자격 증명을 확인한 경우에는 `detail`이 `this request resolved a BYOK credential`로 시작합니다. `model_provider`를 제거하거나, BYOK 자격 증명 없이 그리고 (멀티파트의 경우) 편집 없이 요청을 보내세요. + `X-Comfy-Error-Type`을 확인하세요. `concurrency_limit_exceeded`는 원본 호출이 아직 실행 중이라는 뜻이므로 `Retry-After`를 기다린 뒤 동일한 키를 재사용하세요. `invalid_input`은 새 키가 필요합니다. 이 경로에서 발생하는 두 가지 `invalid_input` 충돌은 키와 전혀 무관하며 어떤 새 키로도 해결되지 않습니다. `model_provider`가 대체 공급자를 지정한 경우, 요청 본문이 해당 공급자의 이 모델용 번역기가 처리할 수 없는 멀티파트 작업(편집)을 선택하면 거부되며 `detail`은 "this request's `image` selects the edit operation"로 시작합니다. 그리고 그 이후에 확인되는 것으로, 요청이 이미 경로에 있는 공급자에 대한 BYOK(bring-your-own-key) 자격 증명을 확인한 경우에는 `detail`이 `this request resolved a BYOK credential`로 시작합니다. `model_provider`를 제거하거나, BYOK 자격 증명 없이 (멀티파트의 경우) 편집 없이 요청을 보내세요. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After`(`concurrency_limit_exceeded`인 경우) + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded`인 경우) 요청 본문이 너무 큽니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 요청 콘텐츠가 모델의 스키마에 대해 거부되었습니다. + 요청 내용이 모델의 스키마에 대해 거부되었습니다. - 본문: [`RouterValidationErrorResponse`](#routervalidationerrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` + 본문: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - `X-Comfy-Error-Type`을 확인하세요: `concurrency_limit_exceeded`는 진행 중인 호출을 줄이라는 뜻이고, `rate_limited`는 허용량 창을 기다리라는 뜻입니다. + `X-Comfy-Error-Type`을 확인하세요. `concurrency_limit_exceeded`는 진행 중인 호출을 줄이라는 뜻이고, `rate_limited`는 허용 창을 기다리라는 뜻입니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining` - 공급자 자체의 응답을 결과로 변환할 수 없었습니다(`provider_error`). + 공급자 자체의 응답을 결과로 변환할 수 없습니다 (`provider_error`). - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status` Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After`(용량 거부인 경우에만) + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (용량 거부 시에만) 요청이 기한을 초과했습니다. 재시도하기 전에 오류 유형을 확인하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `Retry-After` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `Retry-After` ### `POST /v2/models/{provider}/{model}/estimate` -**실행하지 않고, 실행 전에 모델 호출의 가격을 산정합니다.** +**모델 호출을 실행하기 전에, 실행하지 않고 가격을 산정합니다.** -이 본문을 이 모델에서 실행하는 데 드는 비용을 미국 달러로 사전 추정하여 반환하며, 실제 실행 청구에 사용되는 것과 동일한 요율표를 기준으로 가격이 책정됩니다. 이는 추정치일 뿐 최종 청구 금액이 아닙니다. 실제로 지불하는 금액은 워크스페이스의 사용량 및 청구 기록에 정산된 금액입니다. 본문은 먼저 모델의 입력 스키마에 대해 검증되며, 이는 기본 실행(`strict_mode` 없음, `reject_unknown_fields` 없음)이 검증하는 방식과 같습니다. 따라서 모델 스키마를 통과하지 못하는 본문은 실행 시와 동일하게 여기서도 `422`가 됩니다. 공급자로 아무것도 전달되지 않으며 아무것도 청구되지 않습니다. 이 응답은 가격을 고정하는 것이 아닙니다. `pricing_as_of` 시점에 적용 중인 요율로 가격이 책정되며, 실행은 요율이 적용되는 시점에 유효한 요율로 청구됩니다. 이 기능이 순차 배포되는 동안 이 경로는 `error_type: not_enabled`와 함께 `403`을 응답합니다. +이 모델에서 이 본문을 실행하면 얼마가 들지 미국 달러로 사전 견적하여 반환합니다. 가격은 실행 시 청구에 사용되는 것과 동일한 요율표를 기준으로 산정됩니다(공급업체가 보고한 비용으로 청구되는 모델은 대신 공급업체가 공개한 가격표를 기준으로 견적됩니다). 이는 견적일 뿐 최종 청구가 아닙니다. 실제로 지불하는 금액은 워크스페이스의 사용량 및 결제 기록에 정산된 청구액입니다. 본문은 먼저 모델의 입력 스키마에 대해 검증되며, 이는 기본 실행(`strict_mode` 없음, `reject_unknown_fields` 없음)이 검증하는 방식과 같습니다. 따라서 모델 스키마를 통과하지 못하는 본문은 실행 시와 동일하게 여기서도 `422`입니다. 공급자로 아무것도 전달되지 않으며 비용도 청구되지 않습니다. 이 응답은 가격을 고정하는 것이 아닙니다. `pricing_as_of` 시점에 유효한 요율로 산정되며, 실행은 요율 산정 시점에 유효한 요율로 청구됩니다. 이 기능이 순차 배포되는 동안 이 라우트는 `error_type: not_enabled`와 함께 `403`을 응답합니다. **파라미터** - 정식 `{provider}/{model}` 모델 ID의 소문자 공급자 세그먼트로, 실행 대상 모델을 제공하는 파트너입니다. + 정규 `{provider}/{model}` 모델 ID의 소문자 공급자 세그먼트로, 실행 대상 모델을 보유한 파트너입니다. - 유형: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 + Type: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 - 정식 `{provider}/{model}` 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 내에서 실행할 모델입니다. + 정규 `{provider}/{model}` 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 내에서 실행할 모델입니다. - 유형: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 + Type: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 - 현재 기본값 대신 이 모델을 제공할 대체 공급자를 선택합니다. + 이 모델의 현재 기본값 대신 이 모델을 제공할 대체 공급자를 선택합니다. **요청 본문** `application/json` -- [`RouterModelInput`](#routermodelinput) (필수) -파트너 모델의 네이티브 JSON 입력으로, 동기 경로가 이 모델에 대해 받아들이는 본문과 동일합니다. 기본 실행이 검증하는 방식대로 모델 자체의 입력 스키마에 대해 검증되며(이 경로는 `strict_mode`나 `reject_unknown_fields`를 받지 않습니다), 자체 필드(출력 개수, 입력 이미지가 선택하는 작업)가 무엇의 가격을 책정할지 결정합니다. +파트너 모델의 네이티브 JSON 입력으로, 이 모델에 대해 동기 라우트가 받는 본문과 동일합니다. 기본 실행이 검증하는 방식대로 모델 자체의 입력 스키마에 대해 검증되며(이 라우트는 `strict_mode`나 `reject_unknown_fields`를 받지 않습니다), 가격 산정 대상은 본문 자체의 필드(출력 수, 입력 이미지가 선택하는 작업)에 따라 결정됩니다. **응답** 견적입니다. - 본문: [`RouterCostEstimate`](#routercostestimate) -- 헤더: `X-Comfy-Request-Id` + Body: [`RouterCostEstimate`](#routercostestimate) -- Headers: `X-Comfy-Request-Id` - 잘못된 요청입니다. 오류 유형과 요청 본문을 확인하세요. + 유효하지 않은 요청입니다. 오류 유형과 요청 본문을 확인하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 자격 증명이 누락되었거나 유효하지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 이 호출자 또는 모델에 대해 요청이 허용되지 않습니다. + 이 호출자 또는 모델에 대해 허용되지 않는 요청입니다. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 모델 ID를 찾을 수 없습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 요청 본문이 너무 큽니다. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 추정 요청의 본문이 모델 스키마에 대해 거부되었거나, 경로와 다른 모델을 지정했습니다. + 견적 요청의 본문이 모델 스키마에 대해 거부되었거나, 경로와 다른 모델을 지정했습니다. - 본문: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (용량 거부 시에만) + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (용량 거부 시에만) ### `GET /v2/models/{provider}/{model}/openapi.json` -**파트너 모델 하나의 입력 및 출력 스키마를 OpenAPI 문서로 읽습니다.** +**파트너 모델 하나의 입력 및 출력 스키마를 OpenAPI 문서로 조회합니다.** -모델 하나의 입력 및 출력 스키마를 독립형 OpenAPI 문서로 읽습니다. +모델 하나의 입력 및 출력 스키마를 독립형 OpenAPI 문서로 조회합니다. **파라미터** - 정규 `{provider}/{model}` 모델 ID의 공급자 부분입니다. + 정식 `{provider}/{model}` 모델 ID에서 공급자에 해당하는 부분입니다. - 유형: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그(예: `anthropic`), 최대 64자 + 유형: [`RouterProviderSegment`](#routerprovidersegment). 영숫자 슬러그(예: `anthropic`), 최대 64자 - 정규 `{provider}/{model}` 모델 ID의 모델 부분입니다. + 정식 `{provider}/{model}` 모델 ID에서 모델에 해당하는 부분입니다. - 유형: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그(예: `claude-opus-4-6`), 최대 128자 + 유형: [`RouterModelSegment`](#routermodelsegment). 영숫자 슬러그(예: `claude-opus-4-6`), 최대 128자 @@ -410,13 +412,13 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 **응답** - OK - 모델의 입력 및 출력 스키마를 독립형 OpenAPI 문서로 제공합니다. + OK: 모델의 입력 및 출력 스키마를 독립형 OpenAPI 문서로 제공합니다. - 본문: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- 헤더: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` + 본문: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument). 헤더: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - Not Modified - 호출자가 `If-None-Match`로 보낸 `ETag` 이후 문서가 변경되지 않았습니다. + Not Modified: 호출자가 `If-None-Match`에 보낸 `ETag` 이후 문서가 변경되지 않았습니다. 헤더: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` @@ -424,51 +426,51 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 자격 증명이 누락되었거나 유효하지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 이 호출자 또는 모델에 대해서는 요청이 허용되지 않습니다. + 이 호출자 또는 모델에는 요청이 허용되지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 모델 ID를 찾을 수 없습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router가 요청을 완료할 수 없습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하십시오. + Router를 일시적으로 사용할 수 없습니다. 백오프를 사용하여 재시도하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}/requests` **파트너 모델 실행을 실행 대기열에 제출하고 즉시 반환합니다.** -Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/models/{provider}/{model}`이 이 모델에 대해 받아들이는 것과 동일한 파트너 네이티브 JSON 입력입니다. 즉, 하나의 본문 형태, 모델별 스키마 하나, 두 가지 전달 모드를 가지지만, 이 경로는 결과를 위해 연결을 유지하지 않습니다. 실행을 접수하고 핸들과 함께 `201`로 응답하며, 호출자는 아래 세 가지 조회를 통해 나중에 결과를 수집합니다. +Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/models/{provider}/{model}`이 이 모델에 대해 받아들이는 파트너 네이티브 JSON 입력과 동일합니다. 하나의 본문 형태, 모델별 하나의 스키마, 두 가지 전달 모드가 있습니다. 다만 이 경로는 결과를 위해 연결을 유지하지 않습니다. 실행을 접수하고 핸들과 함께 `201`로 응답하며, 호출자는 아래 세 가지 조회를 통해 나중에 결과를 수집합니다. **파라미터** - 정규 `{provider}/{model}` 모델 ID의 소문자 공급자 세그먼트로, 모델을 실행하는 파트너입니다. + 정규 `{provider}/{model}` 모델 ID의 소문자 공급자 세그먼트입니다. 모델이 실행되는 파트너입니다. - 유형: [`RouterProviderSegment`](#routerprovidersegment), 영숫자 슬러그(예: `anthropic`), 최대 64자 + 유형: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그(예: `anthropic`), 최대 64자 - 정규 `{provider}/{model}` 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 내에서 실행할 모델입니다. + 정규 `{provider}/{model}` 모델 ID의 소문자 모델 세그먼트입니다. 해당 공급자 내에서 실행할 모델입니다. - 유형: [`RouterModelSegment`](#routermodelsegment), 영숫자 슬러그(예: `claude-opus-4-6`), 최대 128자 + 유형: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그(예: `claude-opus-4-6`), 최대 128자 @@ -478,131 +480,130 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod `model_provider`와 함께 사용할 때만 의미가 있습니다. - 기본값: 거짓 + 기본값: False - 하나의 논리적 호출을 재시도해도 안전하게 만드는 호출자 생성 키입니다. + 호출자가 생성하는 키로, 하나의 논리적 호출을 재시도해도 안전하게 만듭니다. - 1~255자 + 1–255자 - 이 모델의 입력 스키마에 선언되지 않은 최상위 요청 본문 필드를 허용하는 대신 거부하도록 선택합니다. 중첩 필드는 검사하지 않으며, 선언되지 않은 필드를 허용하는 스키마를 가졌거나 작성된 스키마가 없는 모델의 경우, 또는 `strict_mode=true`로 전송된 대기열 제출에서는 아무것도 거부하지 않습니다. + 이 모델의 입력 스키마가 선언하지 않은 최상위 요청 본문 필드를 허용하는 대신 거부하도록 선택합니다. 중첩 필드는 검사하지 않으며, 스키마가 선언되지 않은 필드를 허용하거나 작성된 스키마가 없는 모델의 경우, 또는 `strict_mode=true`로 전송된 대기열 제출에서는 아무것도 거부하지 않습니다. - 기본값: 거짓 + 기본값: False **요청 본문** -`application/json`, [`RouterModelInput`](#routermodelinput) (필수) +`application/json` -- [`RouterModelInput`](#routermodelinput) (필수) -파트너 모델의 네이티브 JSON 입력으로, 동기 경로가 이 모델에 대해 받아들이는 본문과 동일하며, 수행할 작업을 선택하고 같은 방식으로 과금됩니다. 본문 자체의 필드가 둘 이상의 작업을 지원하는 모델에서 Router가 실행할 작업을 선택합니다(입력 이미지는 편집 가능한 이미지 모델을 이미지 기반 이미지 생성으로 전환하며, 이는 자체 요율로 과금될 수 있습니다. Seedance의 첫 프레임 이미지는 이미지 기반 비디오 생성을 선택하고, 레퍼런스 이미지나 클립은 레퍼런스 기반 비디오 생성을 선택합니다). 네이티브 디스패치에서 Seedance 요청은 역할이 아니라 `content`의 미디어 종류에 따라 과금됩니다. 비디오 입력이 있으면 비디오 기반 비디오 생성으로, 그렇지 않고 이미지가 있으면 이미지 기반 비디오 생성으로, 그 외에는 텍스트 기반 비디오 생성으로 과금됩니다. 단, `draft_task` 항목의 최종 렌더는 그것이 렌더링하는 Draft의 작업으로 과금되며, 일부 모델은 텍스트 기반 비디오 생성과 이미지 기반 비디오 생성에 같은 요율을 부과합니다. `model_provider`로 대체 공급자를 선택하면 조건화된 각 작업은 해당 공급자의 자체 요율로 과금될 수 있습니다. 동일한 공급자 선택 규약이 디스패치 시 적용됩니다. `model_provider`가 없거나, `model_provider`와 함께 `strict_mode=false`(기본값)인 경우 본문은 모델의 네이티브 문서이며 실행이 접수되기 전에 모델 자체의 입력 스키마에 대해 검증됩니다. 따라서 모델이 거부할 본문은 몇 분 후에 실패하는 대기 중 요청이 아니라 여기에서 `422`가 됩니다. 비엄격 대체 공급자 본문은 디스패치 시 해당 공급자의 실제 스키마로 추가 변환됩니다. `strict_mode=true`인 경우 본문은 이미 대체 공급자 자체의 스키마여야 하며 변경 없이 전달됩니다. 네이티브 스키마 검증은 동기 경로에서와 정확히 마찬가지로 건너뜁니다(`model_provider`와 `strict_mode` 참조). +파트너 모델의 네이티브 JSON 입력으로, 동기 경로가 이 모델에 대해 받아들이는 본문과 동일하며, 수행할 작업을 선택하고 같은 방식으로 과금됩니다. 본문 자체의 필드가 하나 이상의 작업을 지원하는 모델에서 Router가 실행할 작업을 선택합니다(입력 이미지는 편집 가능한 이미지 모델을 이미지 기반 이미지 생성으로 전환하며, 이는 자체 요율로 과금될 수 있습니다. Seedance의 첫 프레임 이미지는 이미지 기반 비디오 생성을 선택하고, 레퍼런스 이미지나 클립은 레퍼런스 기반 비디오 생성을 선택합니다). 네이티브 디스패치에서 Seedance 요청은 역할이 아니라 `content`의 미디어 종류에 따라 과금됩니다. 비디오 입력이 있으면 비디오 기반 비디오 생성으로, 그렇지 않고 이미지가 있으면 이미지 기반 비디오 생성으로, 그것도 아니면 텍스트 기반 비디오 생성으로 과금됩니다. 단, `draft_task` 항목의 최종 렌더는 그것이 렌더링하는 Draft의 작업으로 과금되며, 일부 모델은 텍스트 기반 비디오 생성과 이미지 기반 비디오 생성에 동일한 요율을 청구합니다. `model_provider`로 대체 공급자를 선택하면, 조건이 적용된 각 작업은 해당 공급자 자체의 요율로 과금될 수 있습니다. 동일한 공급자 선택 규약이 디스패치 시에도 적용됩니다. `model_provider`가 없거나, `model_provider`와 함께 `strict_mode=false`(기본값)인 경우, 본문은 모델의 네이티브 문서이며 실행이 접수되기 전에 모델 자체의 입력 스키마에 대해 검증됩니다. 따라서 모델이 거부할 본문은 몇 분 뒤 실패하는 대기 중 요청이 아니라 여기서 `422`가 됩니다. 비엄격 대체 공급자 본문은 디스패치 시 해당 공급자의 실제 스키마로 추가 변환됩니다. `strict_mode=true`인 경우 본문은 이미 대체 공급자 자체의 스키마여야 하며 변경 없이 전달됩니다. 동기 경로에서와 정확히 마찬가지로 네이티브 스키마 검증이 건너뜁니다(`model_provider` 및 `strict_mode` 참고). **응답** - 생성됨, 실행이 실행 대기열에 접수되었습니다. + 생성됨 - 실행이 실행 대기열에 접수되었습니다. - 본문: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse), 헤더: `X-Comfy-Request-Id`, `Idempotent-Replayed` + 본문: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- 헤더: `X-Comfy-Request-Id`, `Idempotent-Replayed` 자격 증명이 누락되었거나 유효하지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse), 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 잘못된 요청입니다. 오류 유형과 요청 본문을 확인하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse), 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 요청 본문이 너무 큽니다. - 본문: [`RouterErrorResponse`](#routererrorresponse), 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 않았거나, 모델 자체가 보고하지 않은 이유로 실패했습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse), 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 이 호출자 또는 모델에 대해 요청이 허용되지 않습니다. 파트너가 생성을 바이트로 직접 응답하는 모델은 아직 대기열에 넣을 수 없으며 `not_enabled`로 거부됩니다. 대신 동기 경로에서 실행하세요. + 이 호출자 또는 모델에 대해 허용되지 않는 요청입니다. 파트너가 생성 결과를 바이트로 직접 응답하는 모델은 아직 대기열에 넣을 수 없으며 `not_enabled`로 거부됩니다. 대신 동기 경로에서 실행하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse), 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 모델 ID를 찾을 수 없습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse), 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - -`X-Comfy-Error-Type`을 확인합니다: `concurrency_limit_exceeded`는 원본 호출이 아직 실행 중이라는 뜻이므로 `Retry-After`만큼 기다린 뒤 동일한 키를 재사용합니다. `invalid_input`은 새 키가 필요합니다. 이 라우트에서 발생하는 두 가지 `invalid_input` 충돌은 키와 전혀 무관하며 어떤 새 키로도 해결되지 않습니다: `model_provider`가 대체 공급자를 지정하는 경우, 요청 본문이 해당 공급자의 이 모델용 변환기가 처리할 수 없는 멀티파트 작업(편집)을 선택하면 거부되며, 이때 `detail`은 "this request's `image` selects the edit operation"으로 시작합니다. 그리고 그 이후에 검사되는 조건으로, 요청이 경로에 있는 공급자에 대한 BYOK(bring-your-own-key) 자격 증명을 이미 확인한 경우에도 거부되며, 이때 `detail`은 `this request resolved a BYOK credential`로 시작합니다. `model_provider`를 제거하거나, BYOK 자격 증명 없이 그리고 (멀티파트의 경우) 편집 없이 요청을 보내세요. +`X-Comfy-Error-Type`을 확인하세요. `concurrency_limit_exceeded`는 원본 호출이 아직 실행 중이라는 뜻이므로 `Retry-After`만큼 기다린 뒤 같은 키를 재사용하세요. `invalid_input`은 새 키가 필요합니다. 이 라우트의 두 가지 `invalid_input` 충돌은 키와 전혀 무관하며 새 키로도 어느 쪽도 해소되지 않습니다. `model_provider`로 대체 공급자를 지정한 경우, 요청 본문이 그 공급자의 이 모델용 변환기가 처리할 수 없는 멀티파트 작업(편집)을 선택하면 거부되며, `detail`은 "this request's `image` selects the edit operation"으로 시작합니다. 그리고 그 이후에 검사되는 것으로, 요청이 경로에 있는 공급자에 대한 BYOK(bring-your-own-key) 자격 증명을 이미 확인한 경우에도 거부되며, `detail`은 `this request resolved a BYOK credential`로 시작합니다. `model_provider`를 제거하거나, BYOK 자격 증명 없이 그리고 (멀티파트의 경우) 편집 없이 요청을 보내세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded`일 때) + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded`인 경우) - 요청 내용이 모델의 스키마에 대해 거부되었습니다. + 요청 내용이 모델의 스키마에 맞지 않아 거부되었습니다. - 본문: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` + 본문: [`RouterValidationErrorResponse`](#routervalidationerrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - `X-Comfy-Error-Type`을 확인하세요. `queue_backlog_full`은 이미 허용된 만큼의 미완료 대기 요청을 보유하고 있다는 뜻이므로, 그중 하나가 완료된 뒤 다시 제출하세요. `rate_limited`는 허용량 윈도우를 기다리라는 뜻입니다. + `X-Comfy-Error-Type`을 확인하세요. `queue_backlog_full`은 허용된 만큼의 미완료 대기 중 요청을 이미 보유하고 있다는 뜻이므로, 그중 하나가 끝난 뒤 다시 제출하세요. `rate_limited`는 허용 창을 기다리라는 뜻입니다. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (용량 거부 시에만) + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (용량 거부의 경우에만) ### `GET /v2/models/{provider}/{model}/requests/{request_id}` **제출된 요청 하나의 결과를 수집합니다.** -수집 엔드포인트입니다. 성공적으로 완료된 요청에 대해 파트너 모델 자체의 네이티브 출력을 반환하며, 이는 같은 모델과 같은 입력에 대해 동기 라우트의 `200`이 담는 내용과 바이트 단위로 동일합니다. 따라서 두 전달 방식은 하나의 결과 형태를 만들어 내고, 호출자는 별도의 파서 없이 두 방식 사이를 오갈 수 있습니다. +수집 엔드포인트입니다. 성공적으로 완료된 요청에 대해서는 파트너 모델 자체의 네이티브 출력을 반환하며, 이는 동일한 모델과 동일한 입력에 대해 동기 라우트의 `200`이 담는 것과 바이트 단위까지 같습니다. 따라서 두 가지 전달 방식이 하나의 결과 형태를 만들고, 호출자는 별도의 파서 없이 두 방식 사이를 오갈 수 있습니다. **파라미터** - 정규 `{provider}/{model}` 모델 ID의 소문자 공급자 세그먼트입니다. 실행 대상 모델을 보유한 파트너입니다. + 정규 `{provider}/{model}` 모델 ID의 소문자 공급자 세그먼트로, 모델이 실행되는 파트너입니다. - 타입: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 + 유형: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 - 정규 `{provider}/{model}` 모델 ID의 소문자 모델 세그먼트입니다. 해당 공급자 안에서 실행할 모델입니다. + 정규 `{provider}/{model}` 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 내에서 실행할 모델입니다. - 타입: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 + 유형: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 - 대상으로 지정할 대기 중 요청입니다. 제출이 본문에서 반환한 `request_id`입니다. + 대상으로 지정할 대기 중 요청으로, 제출 시 본문에서 반환된 `request_id`입니다. - 타입: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 + 유형: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 **응답** - OK. 결과를 만들어 낸 요청, 즉 성공적으로 완료된 요청이거나 기록된 과금과 저장된 결과를 모두 가진 터미널 요청에 대해 저장된 결과를 파트너 자체의 미디어 타입으로 변경 없이 반환합니다. 동기 라우트의 `200`이 반환하는 것과 정확히 같으며, 제출이 수락한 것과 동일한 공급자 선택 계약을 따릅니다. `model_provider`가 없거나, `model_provider`와 함께 `strict_mode=false`(기본값, 가능한 경우 이 모델의 네이티브 계약으로 다시 변환되며, 변환에 실패하면 대체 공급자의 원시 응답으로 폴백하고 이는 기록되며 결코 조용히 넘어가지 않습니다)인 경우 형태는 이 모델 자체의 네이티브 출력입니다. `strict_mode=true`인 경우에는 대체 공급자의 응답이 변경 없이 반환됩니다. 파트너가 생성을 바이트로 직접 응답하는 모델의 경우, 본문은 `application/json`이 아니라 파트너 자체의 `Content-Type` 아래의 해당 바이트입니다. 응답의 `Content-Type`을 기준으로 분기하고 JSON 문서라고 가정하지 마세요. + OK - 결과를 생성한 요청, 즉 성공적으로 완료된 요청이거나 기록된 과금과 저장된 결과를 모두 가진 터미널 요청에 대해 저장된 결과를, 파트너 자체의 미디어 타입으로 변경 없이 반환합니다. 동기 라우트의 `200`이 반환하는 것과 정확히 같으며, 제출이 수락한 것과 동일한 공급자 선택 계약을 따릅니다: `model_provider` 없이, 또는 `model_provider`와 함께 `strict_mode=false`(기본값, 가능한 경우 이 모델의 네이티브 계약으로 다시 변환되고, 변환에 실패하면 대체 공급자의 원시 응답으로 폴백하며 이는 로그에 남고 결코 조용히 넘어가지 않습니다)인 경우 형태는 이 모델 자체의 네이티브 출력입니다. `strict_mode=true`이면 변경되지 않은 대체 공급자의 응답입니다. 파트너가 생성 결과를 바이트로 직접 응답하는 모델의 경우, 본문은 `application/json`이 아니라 파트너 자체의 `Content-Type`을 따르는 해당 바이트입니다. 응답의 `Content-Type`을 기준으로 분기하고 JSON 문서라고 가정하지 마세요. 본문: [`RouterModelOutput`](#routermodeloutput) 또는 원시 바이트 (`*/*`) -- 헤더: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` - Accepted. 요청이 아직 완료되지 않았습니다. + Accepted - 요청이 아직 완료되지 않았습니다. 본문: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- 헤더: `X-Comfy-Request-Id`, `Retry-After` @@ -626,7 +627,7 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod - Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 않았거나, 모델 자체가 보고하지 않은 이유로 실패했습니다. + Router 요청 수준의 실패로, 요청이 모델에 도달하지 않았거나 모델 자체가 보고하지 않은 이유로 실패했습니다. 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -638,20 +639,19 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod - 요청이 해당 작업과 충돌하는 상태에 있습니다. 오류 타입을 확인하세요. + 요청이 작업과 충돌하는 상태에 있습니다. 오류 유형을 확인하세요. 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 요청이 기한을 초과했습니다. 재시도하기 전에 오류 타입을 확인하세요. + 요청이 기한을 초과했습니다. 재시도하기 전에 오류 유형을 확인하세요. 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - - Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 않았거나, 모델 자체가 보고하지 않은 이유로 실패했습니다. + Router 요청 수준의 실패로, 요청이 모델에 도달하지 않았거나 모델 자체가 보고하지 않은 이유로 실패했습니다. 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -660,26 +660,26 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod **제출된 요청 하나의 취소를 요청합니다.** -완료되지 않은 요청을 중지해 달라고 Comfy에 요청합니다. 이는 요청일 뿐 보장이 아니며, `202`는 바로 그 점을 말합니다. `CANCELLATION_REQUESTED`는 요청이 접수되었다는 뜻이지 실행이 중단되었다는 뜻이 아닙니다. 파트너에서 이미 진행 중인 실행은 어쨌든 완료될 수 있으며, 완료된 파트너 생성은 누군가 결과를 수집했는지와 무관하게 과금됩니다. 따라서 실제로 무슨 일이 일어났는지 알아야 하는 호출자는 나중에 상태 엔드포인트를 조회해야 하며, 이때 적용된 취소는 다른 모든 터미널 결과와 마찬가지로 `error_type`을 함께 담은 `COMPLETED`로 표시됩니다. +아직 완료되지 않은 요청을 중지하도록 Comfy에 요청합니다. 이는 요청일 뿐 보장이 아니며, `202`는 바로 그 점을 나타냅니다. `CANCELLATION_REQUESTED`는 요청이 접수되었음을 뜻하며 실행이 중지되었음을 뜻하지 않습니다. 파트너에서 이미 전송 중인 실행은 그대로 완료될 수 있으며, 완료된 파트너 생성은 누구든 수집했는지와 관계없이 과금됩니다. 따라서 실제로 무슨 일이 일어났는지 알아야 하는 호출자는 이후 상태 엔드포인트를 읽어야 하며, 여기서 효력이 발생한 취소는 다른 모든 터미널 결과와 마찬가지로 `error_type`을 포함한 `COMPLETED`로 표시됩니다. **파라미터** - 정식 `{provider}/{model}` 모델 ID의 소문자 공급자 세그먼트입니다. 모델이 실행되는 파트너입니다. + 표준 `{provider}/{model}` 모델 ID의 소문자 공급자 세그먼트로, 모델이 실행되는 파트너입니다. - 유형: [`RouterProviderSegment`](#routerprovidersegment): 영숫자 슬러그(예: `anthropic`), 최대 64자 + 유형: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 - 정식 `{provider}/{model}` 모델 ID의 소문자 모델 세그먼트입니다. 해당 공급자 내에서 실행할 모델입니다. + 표준 `{provider}/{model}` 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 내에서 실행할 모델입니다. - 유형: [`RouterModelSegment`](#routermodelsegment): 영숫자 슬러그(예: `claude-opus-4-6`), 최대 128자 + 유형: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 - 처리할 대기 중 요청입니다. 제출 시 본문에서 반환된 `request_id`입니다. + 대상으로 지정할 대기 중 요청으로, 제출 시 본문에서 반환된 `request_id`입니다. - 유형: [`RouterQueueRequestId`](#routerqueuerequestid): `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 + 유형: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 **응답** @@ -687,73 +687,73 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod 수락됨: `CANCELLATION_REQUESTED`. - 본문: [`RouterQueueCancelResponse`](#routerqueuecancelresponse). 헤더: `X-Comfy-Request-Id` + 본문: [`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- 헤더: `X-Comfy-Request-Id` 충돌: `ALREADY_COMPLETED`. - 본문: [`RouterQueueCancelResponse`](#routerqueuecancelresponse). 헤더: `X-Comfy-Request-Id` + 본문: [`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- 헤더: `X-Comfy-Request-Id` 잘못된 요청입니다. 오류 유형과 요청 본문을 확인하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 자격 증명이 누락되었거나 유효하지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 이 호출자 또는 모델에는 이 요청이 허용되지 않습니다. + 이 호출자 또는 모델에는 요청이 허용되지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 모델 ID를 찾을 수 없습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하세요. + Router를 일시적으로 사용할 수 없습니다. 백오프를 사용해 재시도하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 않았거나 모델 자체가 보고하지 않은 이유로 실패했습니다. + Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 않았거나, 모델 자체가 보고하지 않은 이유로 실패한 경우입니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}/status` **제출된 요청 하나의 실행 대기열 상태를 조회합니다.** -폴링 엔드포인트입니다. 요청의 현재 상태만 응답하며 결과는 절대 담지 않으므로, 클라이언트는 매 폴링마다 출력을 전송받지 않고도 오래 걸리는 생성을 지켜볼 수 있습니다. 결과는 이 응답이 `COMPLETED`일 때 아래의 조회 엔드포인트에서 한 번만 수집합니다. +폴링 엔드포인트입니다. 요청의 현재 상태만 응답하고 결과는 응답하지 않으므로, 클라이언트는 매 폴링마다 출력을 전송받지 않고도 오래 걸리는 생성을 지켜볼 수 있습니다. 결과는 이 응답이 `COMPLETED`를 나타낼 때 아래의 조회에서 한 번만 수집됩니다. **파라미터** - 정규 `{provider}/{model}` 모델 ID의 소문자 공급자 세그먼트로, 모델을 실행하는 파트너입니다. + 정규 `{provider}/{model}` 모델 ID의 소문자 공급자 세그먼트로, 모델을 실행 중인 파트너입니다. 유형: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 - 정규 `{provider}/{model}` 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 안에서 실행할 모델입니다. + 정규 `{provider}/{model}` 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 내에서 실행할 모델입니다. 유형: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 - 대상으로 지정할 대기 중인 요청으로, 제출 시 응답 본문에서 반환된 `request_id`입니다. + 대상으로 지정할 대기 중인 요청으로, 제출 시 본문에서 반환된 `request_id`입니다. 유형: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 @@ -763,46 +763,46 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod OK - 요청의 현재 실행 대기열 상태입니다. - 본문: [`RouterQueueStatusResponse`](#routerqueuestatusresponse). 헤더: `X-Comfy-Request-Id`, `Retry-After`, `X-Comfy-Estimated-Duration-Seconds`, `X-Comfy-Estimated-Duration-P90-Seconds`, `X-Comfy-Estimate-Source` + 본문: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- 헤더: `X-Comfy-Request-Id`, `Retry-After`, `X-Comfy-Credits-Used`, `X-Comfy-Estimated-Duration-Seconds`, `X-Comfy-Estimated-Duration-P90-Seconds`, `X-Comfy-Estimate-Source` 자격 증명이 누락되었거나 유효하지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 이 호출자 또는 모델에 대해서는 요청이 허용되지 않습니다. + 이 호출자 또는 모델에 대해 요청이 허용되지 않습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 모델 ID를 찾을 수 없습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 못했거나, 모델 자체가 보고하지 않은 이유로 실패했습니다. + Router 요청 수준 실패로, 요청이 모델에 도달하지 않았거나 모델 자체가 보고하지 않은 이유로 실패했습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하십시오. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 못했거나, 모델 자체가 보고하지 않은 이유로 실패했습니다. + Router 요청 수준 실패로, 요청이 모델에 도달하지 않았거나 모델 자체가 보고하지 않은 이유로 실패했습니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` -여기의 설명은 간략합니다. 모델 선택, 검증, 재시도, 과금에 대해서는 [Comfy Router API 사용하기](/ko/development/comfy-router/api)를, 헤더 동작에 대해서는 [헤더](/ko/development/comfy-router/headers)를 참고하십시오. +여기의 설명은 간략합니다. 모델 선택, 검증, 재시도, 결제에 대해서는 [Comfy Router API 사용하기](/ko/development/comfy-router/api)를, 헤더 동작에 대해서는 [Headers](/ko/development/comfy-router/headers)를 참조하십시오. ## 오류 버킷 @@ -840,6 +840,7 @@ Router가 요청을 접수한 뒤 완료하지 못한 경우 발생합니다. | `queue_timeout` | 대기 중인 요청이 실행 대기열 타임아웃을 넘겨 대기했지만 결국 승인되지 않았습니다. | | `request_not_found` | `request_id`가 이 모델에서 호출자의 요청 중 어느 것도 가리키지 않습니다. | | `queue_backlog_full` | 호출자에게 이미 실행을 기다리는 대기 중 요청이 너무 많아 이 제출이 거부되었습니다. | +| `result_expired` | 요청은 존재했고 완료되었지만, 그 결과가 더 이상 저장되지 않아 수집 시 반환할 것이 없습니다. | ## 응답 헤더 @@ -967,41 +968,41 @@ Router가 요청을 접수한 뒤 완료하지 못한 경우 발생합니다. 호출자가 아직 시작할 수 있는 고비용 모델 호출 수입니다. `429`에서는 `0`입니다. -## 실행 전 비용 추정 +## 실행 전 비용 예상 -`POST /v2/models/{provider}/{model}/estimate`는 본문을 실행하지 않고 가격을 산정하며, 대기 중 제출(`POST /v2/models/{provider}/{model}/requests`)은 `201` 응답에서 `estimate`와 동일한 [`RouterCostEstimate`](#routercostestimate)를 반환합니다. 둘 다 Comfy가 해당 실행에 청구하는 요율 카드를 기준으로 가격이 산정됩니다. 어느 쪽이 반환하든 모든 수치는 추정치이며 최종 청구액이 아닙니다. 워크스페이스의 사용량 및 청구 기록에 있는 확정 청구액이 최종입니다. 자체 공급자 키로 실행한 경우에는 Comfy가 청구하지 않습니다(아래 참조). 추정 기능이 점진적으로 배포되는 동안에는 이 경로가 `error_type: not_enabled`와 함께 `403`을 응답하고, 제출 응답에서는 `estimate`가 생략됩니다. 카탈로그에는 여전히 가격이 없습니다. +`POST /v2/models/{provider}/{model}/estimate`는 본문을 실행하지 않고 가격을 산정하며, 대기 중 제출(`POST /v2/models/{provider}/{model}/requests`)은 `201` 응답에서 `estimate`와 동일한 [`RouterCostEstimate`](#routercostestimate)를 반환합니다. 두 경우 모두 Comfy가 해당 실행에 청구하는 요율표를 기준으로 가격이 산정됩니다. 단, 공급자가 보고한 비용으로 청구되는 모델은 예외로, 공급자의 공개 가격표를 기준으로 `estimated`로 산정됩니다. 두 응답이 반환하는 모든 금액은 최종 청구액이 아닌 예상치입니다. 최종 청구액은 워크스페이스의 사용량 및 청구 기록에 정산된 금액입니다. 자체 공급자 키로 실행하는 경우 Comfy는 청구하지 않습니다(아래 참조). 예상 기능이 순차 배포되는 동안 이 라우트는 `403`과 `error_type: not_enabled`를 응답하며, 제출 응답에서는 `estimate`가 생략됩니다. 카탈로그에는 여전히 가격이 없습니다. -어떤 금액보다도 `source`를 먼저 확인하세요. 수치가 누락되었다고 해서 무료라는 뜻은 결코 아닙니다. +어떤 금액보다 먼저 `source`를 확인하십시오. 금액이 누락되었다고 해서 무료를 의미하지는 않습니다. -| `source` | 포함하는 항목 | 해석 방법 | +| `source` | 포함 내용 | 해석 방법 | | --- | --- | --- | -| `exact` | `amount`, `amount_cents`, `credits` | `pricing_as_of`의 요율로 이 본문에 대해 청구되는 금액과 같은 추정치입니다. 워크스페이스의 사용량 및 청구 기록에 있는 확정 청구액이 최종입니다. | -| `estimated` | `min_amount`, `max_amount` 및 각각의 `_cents` 형태, `amount` 없음 | 요금이 공급자가 나중에 보고하는 수량에 따라 달라지고 본문이 그 범위를 정하는 추정치입니다. 청구액은 두 경계 사이가 될 것으로 예상되며, 워크스페이스의 사용량 및 청구 기록에 있는 확정 청구액이 최종입니다. | -| `unknown` | `reason`, 수치 없음 | 실행 전에는 가격을 제시할 수 없습니다. 다른 모든 `source` 값은 `unknown`으로 취급하세요. | +| `exact` | `amount`, `amount_cents`, `credits` | `pricing_as_of`의 요율로 이 본문에 대해 청구될 금액과 같은 예상치입니다. 최종 청구액은 워크스페이스의 사용량 및 청구 기록에 정산된 금액입니다. | +| `estimated` | `min_amount`, `max_amount` 및 각각의 `_cents` 형태, `amount` 없음 | 청구액이 공급자가 다시 보고하는 수량에 따라 달라지며 본문이 그 범위를 한정하는 경우의 예상치입니다. 청구액은 그 범위 내일 것으로 예상되며, 최종 청구액은 워크스페이스의 사용량 및 청구 기록에 정산된 금액입니다. | +| `free` | `amount` "0", `amount_cents` 및 `credits` `0` | 요율표가 이 요청을 0으로 산정하므로 예상치는 `0`입니다. 최종 청구액은 워크스페이스의 사용량 및 청구 기록에 정산된 금액입니다. 오직 `free` 견적만 `0`으로 표시됩니다. | +| `unknown` | `reason`, 금액 없음 | 실행 전에는 가격을 제시할 수 없습니다. 다른 모든 `source` 값은 `unknown`으로 취급하십시오. | -`unknown` 추정의 `reason`은 다음 중 하나입니다. +`unknown` 예상치의 `reason`은 다음 중 하나입니다: -- `not_quotable`: Router가 실행 전에 이 호출의 가격을 산정할 수 없습니다. 본문이 범위를 정하지 않은, 공급자가 나중에 보고하는 수량을 기준으로 청구되거나, 본문을 전송된 그대로 가격 산정할 수 없기 때문입니다. 인식되지 않는 `reason`은 모두 `not_quotable`로 취급하세요. -- `unpriced_model`: 요율 카드에 이 요청의 가격이 없습니다. -- `byok`(대기 중 제출 전용): 자체 공급자 키로 실행하므로 Comfy는 이에 대해 아무것도 청구하지 않습니다. -- `pricing_unavailable`(대기 중 제출 전용): 요청이 접수될 때 요율 카드를 읽을 수 없었습니다. 제출은 그대로 수락되며 실행은 평소와 같이 청구됩니다. +- `not_quotable`: 실행 전에는 Router가 이 호출의 가격을 산정할 수 없습니다. 공급자가 다시 보고하는 수량으로 청구되는데 본문이 그 범위를 한정하지 않거나, 본문을 보낸 그대로 가격을 산정할 수 없기 때문입니다. 인식되지 않는 모든 `reason`은 `not_quotable`로 취급하십시오. +- `unpriced_model`: 요율표가 이 요청의 가격을 산정하지 않습니다. +- `byok`(대기 중 제출에만 해당): 실행이 자체 공급자 키를 사용하므로 Comfy는 이에 대해 아무것도 청구하지 않습니다. +- `pricing_unavailable`(대기 중 제출에만 해당): 요청이 접수될 때 요율표를 읽을 수 없었습니다. 제출은 여전히 수락되며 실행은 평소와 같이 청구됩니다. -Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 전 추정이 없는 모델](/ko/development/comfy-router/limitations#사전-견적이-없는-모델)에 나열되어 있습니다. 목록에 없는 모델도 특정 본문에 대해서는 `unknown`을 응답할 수 있으므로, 모든 추정에서 `source`를 확인하세요. +Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 전 예상치가 없는 모델](/ko/development/comfy-router/limitations#사전-견적이-없는-모델)에 나열되어 있습니다. 여기에 나열되지 않은 모델도 특정 본문에 대해서는 `unknown`을 응답할 수 있으므로, 모든 예상치에서 `source`를 확인하십시오. -추정이 실패 시 안전하게 닫히는 지점: +예상치가 실패 시 안전하게 동작하는 지점: -- 수치를 내려면 요율 카드가 필요한데 카드가 로드되지 않았거나 오래된 경우, `/estimate`는 추측 대신 `503`을 응답합니다. 대기 중 제출은 추정 때문에 거부되는 일이 없으며, 대신 `reason: pricing_unavailable`과 함께 `source: unknown`을 포함합니다. 실행 전에 전혀 가격을 산정할 수 없는 호출(`not_quotable`)이나 자체 공급자 키를 사용하는 대기 중 제출(`byok`)은 카드를 읽지 않고 응답하므로, 그 `200`은 카드가 최신인지에 대해 아무것도 말해주지 않습니다. -- `/estimate`는 기본 실행과 마찬가지로 모델 자체의 입력 스키마에 대해 본문을 검증하므로, 모델 스키마를 통과하지 못하는 본문은 실행이 응답했을 것과 동일한 `detail[]` 형태의 동일한 `422`를 받습니다. 가격 산정도 디스패치도 이루어지지 않습니다. -- 대기 중 제출의 멱등 재실행(`Idempotent-Replayed: true`)은 원본 견적이 저장되지 않으므로 `estimate`를 생략합니다. +- 금액 산정에 요율표가 필요한데 요율표가 로드되지 않았거나 오래된 경우, `/estimate`는 추측 대신 `503`을 응답합니다. 대기 중 제출은 예상치 때문에 거부되는 일이 없으며, 대신 `source: unknown`과 `reason: pricing_unavailable`을 담습니다. 실행 전에 전혀 가격을 산정할 수 없는 호출(`not_quotable`)이나 자체 공급자 키를 사용하는 대기 중 제출(`byok`)은 요율표를 읽지 않고 응답하므로, 그 `200` 응답은 요율표가 최신인지에 대해 아무것도 말해주지 않습니다. +- `/estimate`는 기본 실행과 마찬가지로 모델 자체의 입력 스키마에 대해 본문을 검증하므로, 모델 스키마를 통과하지 못하는 본문은 실행이 응답했을 것과 동일한 `detail[]` 형태를 가진 동일한 `422`를 받습니다. 아무것도 가격이 산정되거나 디스패치되지 않습니다. +- 대기 중 제출의 멱등 재생(`Idempotent-Replayed: true`)은 `estimate`를 생략합니다. 원본 견적이 저장되지 않기 때문입니다. -추정의 한계. `200` 수치가 실행이 수락된다거나 정확히 그 금액이 청구된다는 약속은 아닙니다. +예상치의 한계. `200` 응답의 금액은 실행이 수락된다거나 정확히 그 금액이 청구된다는 약속이 아닙니다: -- `/estimate`는 `strict_mode`나 `reject_unknown_fields`를 받지 않으므로 모델의 네이티브 계약만 검사합니다. `strict_mode=true` 실행이 대체 공급자 자체 스키마에서 수락하는 본문이 여기서는 `422`를 받을 수 있고, `reject_unknown_fields=true` 실행이라면 거부했을 선언되지 않은 최상위 필드도 여기서는 가격이 산정됩니다. -- `pricing_as_of`는 요율 카드를 가져온 시점입니다(카드를 읽지 않은 경우에는 추정이 응답된 시점). 이는 가격 고정이 아닙니다. 실행은 요율이 적용되는 시점에 유효한 요율로 청구됩니다. -- `/estimate`는 `model_provider`가 지정한 레그, 또는 네이티브 공급자의 가격을 제시합니다. `fallback_provider`나 `strict_mode` 매개변수는 받지 않습니다. 폴백 재시도가 다른 공급자로 넘어간 동기 실행은 그 공급자의 요율로 청구되며, 추정은 이를 제시하지 않았습니다. 실행 응답의 `X-Comfy-Router-Fallback-Provider`가 그런 일이 있었음을 알려줍니다. 대기 중 제출에는 폴백이 없으므로 그 `estimate`는 실제로 실행되는 레그의 가격을 제시합니다. -- `/estimate`와 대기 중 제출의 `estimate`는 `model_provider` 레그에서 동일한 본문에 대해, 또는 형제 작업에서 실행되는 본문에 대해 약간 다른 문서의 가격을 산정할 수 있습니다. 제출의 `estimate`는 실행이 전송하는 문서를 기준으로 가격이 산정됩니다. -- `/estimate`는 항상 플랫폼 요금을 제시합니다. 자체 공급자 키로 실행한 경우 Comfy는 청구하지 않지만, `/estimate`는 이를 감지하지 못하고 여전히 수치를 반환합니다. `reason: byok`를 응답하는 것은 대기 중 제출뿐입니다. -- 달러는 반올림되지 않은 센트에서 최대 소수점 8자리로 표시되며, 청구 가능한 1센트 미만의 `amount`가 `0`으로 표시되는 일은 없습니다. `credits`는 `round(amount × 211, 2)`로, `X-Comfy-Credits-Used`가 요금에 적용하는 것과 동일한 변환입니다. 따라서 0이 아닌 아주 작은 가격에서 `credits`가 `0`으로 반올림될 수 있습니다. 이것이 중요한 경우에는 `credits`가 아니라 `amount` 또는 `amount_cents`를 기준으로 예산을 세우세요. 해당 헤더는 실행에 대한 사후 수치로 남으며, 잔액은 Comfy 플랫폼에 있습니다. +- `/estimate`는 `strict_mode`나 `reject_unknown_fields`를 받지 않으므로 모델의 기본 계약만 검사합니다. `strict_mode=true` 실행이 대체 공급자 자체 스키마에서 수락하는 본문이 여기서는 `422`를 받을 수 있고, `reject_unknown_fields=true` 실행이 거부할 선언되지 않은 최상위 필드도 여기서는 가격이 산정됩니다. Anthropic Messages 모델은 예외입니다. 해당 스키마는 선언되지 않은 필드를 허용하므로 `reject_unknown_fields=true` 실행도 아무것도 거부하지 않으며, 예상치는 선언되지 않은 최상위 필드 `tools`, `tool_choice`, `temperature`, `top_p`, `top_k`, `stop_sequences`, `metadata`, `thinking` 및 빈 `mcp_servers`에 대해서만 가격을 산정합니다. 그 밖의 선언되지 않은 최상위 필드가 있으면 `reason: not_quotable`과 함께 `unknown`을 응답합니다. +- `pricing_as_of`는 요율표를 가져온 시점이며, 공급자의 공개 가격표에서 가져온 `estimated` 견적의 경우에는 그 가격표를 읽은 날짜입니다(둘 다 읽지 않은 경우에는 예상치를 응답한 시점입니다). 이는 가격 고정이 아닙니다. 실행은 요율이 적용되는 시점에 유효한 요율로 청구됩니다. +- `/estimate`는 `model_provider`가 지정한 레그 또는 기본 공급자의 견적을 제시합니다. `fallback_provider`나 `strict_mode` 매개변수는 받지 않습니다. 폴백 재시도가 다른 공급자에 도달한 동기 실행은 예상치가 제시하지 않았던 그 공급자의 요율로 청구되며, 실행 응답의 `X-Comfy-Router-Fallback-Provider`가 그런 일이 있었음을 알려줍니다. 대기 중 제출에는 폴백이 없으므로 그 `estimate`는 실제 실행되는 레그의 견적을 제시합니다. +- `/estimate`와 대기 중 제출의 `estimate`는 `model_provider` 레그에서 또는 형제 작업에서 실행되는 본문의 경우 동일한 본문에 대해 약간 다른 문서를 가격 산정할 수 있습니다. 제출의 `estimate`는 실행이 전송하는 문서를 기준으로 산정됩니다. +- `/estimate`는 항상 플랫폼 청구액의 견적을 제시합니다. 자체 공급자 키로 실행하면 Comfy는 청구하지 않지만, `/estimate`는 이를 감지하지 못하고 여전히 금액을 반환합니다. `reason: byok`를 응답하는 것은 대기 중 제출뿐입니다.- 달러는 반올림되지 않은 센트 값을 기준으로 소수점 이하 최대 8자리까지 표시되며, 청구 가능한 1센트 미만의 `amount`는 절대 `0`으로 표시되지 않습니다. `credits`는 `round(amount × 211, 2)`이며, 이는 `X-Comfy-Credits-Used`가 청구 금액에 적용하는 것과 동일한 변환입니다. 따라서 매우 작은 0이 아닌 가격에서는 `credits`가 `0`으로 반올림될 수 있습니다. 이 점이 중요할 때는 `credits`가 아니라 `amount` 또는 `amount_cents`를 기준으로 예산을 책정하세요. 해당 헤더는 한 번의 실행에 대한 사후 수치로 남습니다. 잔액은 Comfy 플랫폼에 있습니다. ## 결과 에셋 @@ -1022,6 +1023,8 @@ Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 다른 모델은 공급자 에셋 참조 또는 인라인 바이트를 반환합니다. 공급자 URL은 공급자의 만료 정책을 따르며, 이는 위 수명보다 훨씬 짧을 수 있고 Router 계약에 명시되어 있지 않습니다. +**원본 BytePlus URL(Seedance 2.x, 옵트인).** Comfy가 서버 측에서 옵트인한 워크스페이스의 경우, Seedance 2.x 결과는 복사된 URL 옆에 BytePlus 자체 URL을 `content.upstream_video_url` 및 `content.upstream_last_frame_url`에 담고, `content.upstream_expires_at`도 함께 담습니다. 요청 매개변수는 없으며 기본적으로 옵트인되는 워크스페이스도 없습니다. 이 URL은 생성 이후 24시간 후에 만료되며, BytePlus가 삭제하면 존재하지 않습니다. Seedance 2.5에서는 BytePlus가 각 URL의 다운로드를 100회로 제한하며, Router 자체 복사도 그중 1회를 사용합니다. 각 URL은 해당 객체에 대한 베어러 자격 증명이므로, 이를 보유한 사람은 만료될 때까지 에셋을 다운로드할 수 있습니다. + 복사는 에셋별 최선 노력 방식으로 수행됩니다. 복사 하나가 실패하면 해당 항목은 공급자 참조를 유지합니다. 응답에는 Comfy URL과 공급자 URL이 모두 포함될 수 있으며, 에셋별 복사 상태 필드는 명시적으로 없습니다. 생성은 여전히 성공하며 과금됩니다. 성공적으로 재호스팅된 에셋 하나로 모든 URL의 수명을 추론하지 마세요. 결과가 Comfy 호스팅인지 여부는 완료된 호출을 나중에 해당 `Idempotency-Key` 레코드에서 재생할 수 있는지도 결정합니다. 위의 `Idempotency-Key` 매개변수는 재생할 수 없을 때 재시도에 무엇이 응답되는지 설명합니다. @@ -1034,19 +1037,38 @@ Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 ## 스키마 +### RouterBilledWorkspace + +거부된 호출이 청구했을 지갑으로, `RouterErrorResponse.billed_workspace`에 있습니다. "어느 지갑이 비어 있나?"에 답합니다. 이는 호출자의 UI에서 현재 선택된 워크스페이스가 아닐 수 있으며, 팀 멤버의 개인 자격 증명은 자금이 있는 팀이 열려 있는 동안에도 여기에 자신의 개인 지갑을 표시합니다. `denied_reason`과 함께일 때만 표시됩니다. + +**필드** + + + 클라우드 워크스페이스 id입니다. 레거시 레일에서는 없습니다. + + + + `personal` 또는 `team`. 열린 문자열입니다. 다른 값은 개인으로 취급하세요. + + + + 호출이 클라우드 워크스페이스가 아니라 호출자의 워크스페이스 이전 Metronome 고객에게 청구되는 경우 `legacy`입니다. 해당 고객에는 워크스페이스 id가 없습니다. 클라우드 워크스페이스에는 없습니다. + + ### RouterChargesOnPolicyRejection -이 모델에 대해 콘텐츠 정책 거부가 청구되는지 여부입니다. 알 수 없는 값은 청구될 수 있는 것으로 간주하세요. -유형: `string` +이 모델에서 콘텐츠 정책 거부에 대해 과금되는지 여부입니다. 알 수 없음 값은 과금될 가능성이 있는 것으로 처리하세요. + +Type: `string` ### RouterCostEstimate -이 호출에 드는 비용을 디스패치 이전에, 실행 시 과금되는 것과 동일한 요율표를 기준으로 산정한 사전 견적이며 미국 달러로 표시됩니다. 최종 청구 금액은 아닙니다. 실제로 지불하는 금액은 워크스페이스의 사용량 및 청구 기록에 있는 정산 금액입니다. 실행 이후에 보고되는 `X-Comfy-Credits-Used`는 반올림된 사후 수치이며 영수증이 아닙니다. `source`는 이 숫자를 얼마나 신뢰할 수 있는지 나타냅니다: `exact`는 `amount`를 포함하고, `estimated`는 `min_amount`와 `max_amount`를 포함하며 `amount`는 없고, `unknown`은 둘 다 없이 `reason`을 포함합니다. 누락된 `amount`를 무료로 해석하지 마세요. 가격 고정이 아닙니다. `pricing_as_of`를 참고하세요. +이 호출에 드는 비용을 미국 달러로 미리 산정한 값입니다. 디스패치 이전에, 실행이 청구되는 것과 동일한 요율표(rate card)를 기준으로 가격을 매기며(또는 공급자가 보고하는 비용으로 청구되는 모델의 경우 공급자의 공개 가격표에서 추정합니다). 최종 청구 금액은 아닙니다. 실제로 지불하는 금액은 워크스페이스의 사용량 및 결제 기록에 정산된 청구 금액입니다. 실행 이후에 보고되는 `X-Comfy-Credits-Used`는 반올림된 사후 수치이며 영수증이 아닙니다. `source`는 이 숫자를 얼마나 신뢰할지 나타냅니다. `exact`는 `amount`를 포함하고, `free`는 `amount`가 "0"이며(요율표가 이 요청을 0으로 책정), `estimated`는 `min_amount`와 `max_amount`를 포함하고 `amount`는 없으며, `unknown`은 어느 것도 포함하지 않고 `reason`을 포함합니다. `amount`가 없다고 해서 무료로 해석해서는 안 됩니다. 가격 고정이 아닙니다. `pricing_as_of`를 참고하세요. **필드** - `exact` | `estimated` | `unknown`; 그 외의 값은 `unknown`으로 해석합니다. `exact`와 `estimated`는 모두 견적을 나타내며, 어느 쪽도 최종 청구 금액이 아닙니다. `unknown`은 어떤 금액도 담지 않습니다. + `exact` | `estimated` | `free` | `unknown`이며, 그 밖의 값은 모두 `unknown`으로 해석합니다. `exact`와 `estimated`는 모두 추정치를 나타내며, 어느 쪽도 최종 청구 금액이 아닙니다. `free`는 요율표가 이 요청을 0으로 책정했다는 뜻이므로 `amount`가 "0"입니다. `unknown`은 어떤 수치도 포함하지 않습니다. @@ -1054,173 +1076,187 @@ Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 - 달러를 소수점 문자열로 나타낸 값입니다. 예: "0.04". 소수점 이하 최대 8자리이며 지수 표기를 쓰지 않습니다. 청구 대상이 되는 1센트 미만 가격은 "0"으로 표시되지 않습니다. `source`가 `exact`일 때만 존재합니다. 최종 청구 금액이 아닙니다. 최종 금액은 워크스페이스의 사용량 및 청구 기록에 있는 정산 금액입니다. + 예상 비용을 달러로 나타낸 십진수 문자열입니다(예: "0.04"). 소수점 이하 최대 8자리이며 지수 표기를 사용하지 않습니다. 청구 가능한 1센트 미만 가격은 절대 "0"으로 표시되지 않으며, `free` 견적만 "0"으로 표시됩니다. `source`가 `exact` 또는 `free`일 때만 존재합니다. 최종 청구 금액이 아니며, 최종 금액은 워크스페이스의 사용량 및 결제 기록에 정산된 청구 금액입니다. - 달러 기준 하한값을 소수점 문자열로 나타낸 값입니다. `source`가 `estimated`일 때만 존재합니다. + 추정치의 하한을 달러로 나타낸 십진수 문자열입니다. 이는 추정치일 뿐 보장된 하한이 아닙니다. 예를 들어 공급자가 요청한 것보다 적게 반환하거나(이미지가 없는 경우 등), 추정치가 과거 호출에서 학습한 일반적인 가격이거나, 가격이 요청한 수량에 따라 꾸준히 오르지 않는 경우에는 더 적게 청구될 수 있습니다. `source`가 `estimated`일 때만 존재합니다. - 달러 기준 상한값을 소수점 문자열로 나타낸 값입니다. `source`가 `estimated`일 때만 존재합니다. + 추정치의 상한을 달러로 나타낸 십진수 문자열입니다. 이는 추정치일 뿐 보장된 상한이 아닙니다. 예를 들어 공급자가 요청한 것보다 많이 반환하거나(요청한 것보다 많은 이미지 등), 추정치가 과거 호출에서 학습한 값이거나, 가격이 요청한 수량에 따라 꾸준히 오르지 않는 경우에는 더 많이 청구될 수 있습니다. `source`가 `estimated`일 때만 존재합니다. - 산술 연산에 쓰기 위해 같은 값을 반올림하지 않은 미국 센트 단위로 나타낸 값입니다. `amount`와 함께 존재합니다. + 동일한 수치를 산술 연산용으로 반올림하지 않은 미국 센트 단위로 나타낸 값입니다. `amount`와 함께 존재합니다. double - 반올림하지 않은 미국 센트 단위의 `min_amount`입니다. `min_amount`와 함께 존재합니다. + `min_amount`를 반올림하지 않은 미국 센트 단위로 나타낸 값입니다. `min_amount`와 함께 존재합니다. double - 미국 센트 단위의 `max_amount`입니다. `max_amount`와 함께 존재합니다. + `max_amount`를 미국 센트 단위로 나타낸 값입니다. `max_amount`와 함께 존재합니다. double - 플랫폼 환산율($1 = 211 크레딧)을 사용해 `amount`를 Comfy 크레딧으로 나타낸 값이며 소수점 이하 2자리로 반올림됩니다. `exact` 견적에 대해 `X-Comfy-Credits-Used`가 담게 될 값입니다. 그 헤더는 반올림된 사후 수치이며 영수증이 아닙니다. 워크스페이스의 사용량 및 청구 기록에 있는 정산 금액이 최종 금액입니다. + `amount`를 플랫폼 환산율($1 = 211 크레딧)로 환산한 Comfy 크레딧 값이며 소수점 2자리로 반올림됩니다. `exact` 견적에 대해 `X-Comfy-Credits-Used`가 담을 것으로 예상되는 수치입니다. 이 헤더는 반올림된 사후 수치이며 영수증이 아닙니다. 워크스페이스의 사용량 및 결제 기록에 정산된 청구 금액이 최종입니다. double - 이 견적이 대상으로 하는 공급자 구간입니다. 대기 중 제출에서는 실행될 구간입니다. + 이 견적이 해당하는 공급자 구간입니다. 대기 중 제출의 경우 실행될 구간입니다. - 정식 Comfy Router 모델 ID인 `{provider}/{model}`이며, `POST /v2/models/{provider}/{model}`에서 모델을 지정하는 값과 정확히 같습니다. 따라서 호출자는 다른 것에서 다시 도출할 필요 없이 이 값을 그 경로에 그대로 넣을 수 있습니다. 이 값의 `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 연결한 것이고, `maxLength`는 두 값의 길이 합에 그 구분자를 더한 값입니다. + 정규 Comfy Router 모델 ID로 `{provider}/{model}` 형식입니다. 즉 `POST /v2/models/{provider}/{model}`에서 해당 모델을 가리키는 값과 정확히 같으므로, 호출자는 다른 곳에서 다시 도출할 필요 없이 이 값을 그 경로에 그대로 넣을 수 있습니다. `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 연결한 것이며, `maxLength`는 두 값의 길이 합에 구분자 길이를 더한 값입니다. 유형: [`RouterModelId`](#routermodelid) -- 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 - 이 견적을 산정할 때 사용한 요율표를 가져온 시각입니다. 이 견적은 가격 고정이 아닙니다. 실행은 이 시점이 아니라 요금이 산정되는 시점에 유효한 요율로 청구됩니다. 요율표를 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 요율표로도 산정할 수 없는 `not_quotable` 호출)에는 이 값이 견적이 응답된 시각입니다. + 이 견적을 산정한 요율표를 가져온 시점입니다. 이 추정치는 가격 고정이 아닙니다. 실행은 이 시점이 아니라 실행이 요율 산정되는 시점에 유효한 요율로 청구됩니다. 공급자의 공개 가격표에서 가져온 `estimated` 견적(공급자가 보고하는 비용으로 청구되는 모델)의 경우에는 대신 해당 가격표를 읽은 날짜가 담깁니다. 청구 수량을 그 가격표에서 예측한 뒤 요율표로 가격을 매기는 견적(공급자가 보고하는 크레딧으로 청구되는 모델)의 경우에는 두 날짜 중 이른 날짜가 담깁니다. 어떤 요율표도 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 요율표로도 가격을 매길 수 없는 `not_quotable` 호출)에는 이 값이 견적이 응답된 시점입니다. date-time - `source`가 `unknown`일 때만 존재합니다. `not_quotable`(Router가 실행 전에 이 호출의 가격을 산정할 수 없음. 가격이 공급자가 보고하는 내용에 따라 달라지거나, 요청 본문이 청구 대상 수량을 한정하지 않는 경우), `unpriced_model`(요율표에 이 요청의 가격이 없음), `byok`(대기 중 제출에만 해당: 실행에 사용자의 공급자 키를 사용하므로 Comfy는 이에 대해 아무것도 청구하지 않음), 또는 `pricing_unavailable`(대기 중 제출에만 해당: 요청이 접수될 때 요율표를 읽을 수 없었음. 이는 일시적이며 실행은 평소와 같이 청구됨)입니다. 그 외의 값은 `not_quotable`로 해석합니다. + `source`가 `unknown`일 때만 존재합니다. `not_quotable`은 Router가 이 호출의 가격을 실행 전에 매길 수 없다는 뜻이며(가격이 공급자가 돌려주는 내용에 따라 달라지거나, 요청 본문이 청구 수량을 한정하지 않는 경우), `unpriced_model`은 요율표가 이 요청의 가격을 매기지 않는다는 뜻이고, `byok`은 대기 중 제출에만 해당하며 실행이 사용자의 자체 공급자 키를 사용하므로 Comfy가 청구하는 금액이 없다는 뜻이며, `pricing_unavailable`은 대기 중 제출에만 해당하고 요청이 접수될 때 요율표를 읽을 수 없었다는 뜻입니다(이는 일시적인 상황이며 실행은 평소대로 청구됩니다). 다른 값은 모두 `not_quotable`로 해석합니다. ### RouterErrorResponse -인증, 접근, 모델 조회, 할당량 및 공급자 전송 실패에 대한 오류 본문입니다. +인증, 액세스, 모델 조회, 할당량, 공급자 전송 실패에 대한 오류 본문입니다. **필드** - 사람이 읽을 수 있는 실패 설명이며, 최종 사용자에게 그대로 보여줘도 안전합니다. 기계적으로 파싱되지 않으므로 대신 `error_type`을 기준으로 분기하세요. 지원이 종료된 모델에 대한 `model_not_found`의 경우, 후속 모델이 기록되어 있고 호출자에게 표시된다면 `detail`은 ` was retired on ; use `로 표시되고, 그렇지 않다면 일반적인 제안 목록 대신 ` was retired on `만 표시됩니다. 여기에 명시된 후속 모델은 항상 호출을 다시 지정할 수 있는 활성 카탈로그 ID입니다. 지원 종료 날짜가 아직 미래인 모델은 지원이 종료된 것이 아닙니다. 해당 날짜까지 `GET /v2/models`에 계속 나열되며 계속 실행할 수 있습니다. `detail`의 나머지 부분과 마찬가지로, 이 지원 종료 관련 문구는 표시용이며 호환성 보장이 없습니다. 기계적으로 파싱되지 않는다는 규칙에 대한 문서화된 두 가지 예외가 있습니다. `POST /v2/models/{provider}/{model}`에서 `409`는 `invalid_input` 버킷을 공유하는 서로 무관한 세 가지 조건에 대해 응답되며, 이들을 구분하는 것은 오직 `detail`뿐입니다. "this request's `image` selects the edit operation"으로 시작하는 `detail`은 multipart `model_provider` 거부이고, `this request resolved a BYOK credential`로 시작하는 `detail`은 BYOK `model_provider` 거부입니다. 어느 쪽도 새 `Idempotency-Key`로 해결되지 않습니다. 해당 경로에서 그 밖의 `invalid_input` `409`는 키 충돌입니다. 두 접두사는 모두 안정적인 계약 용어이며 매칭에 사용할 수 있습니다. 그 외 어디에서도 `detail`을 기준으로 분기하는 것은 호환성 보장을 가지지 않습니다. + 실패에 대한 사람이 읽을 수 있는 설명으로, 최종 사용자에게 노출해도 안전합니다. 기계적으로 파싱되지 않습니다. 대신 `error_type`을 기준으로 분기하십시오. 사용 중단된 모델의 `model_not_found`의 경우, 후속 모델이 기록되어 있고 호출자에게 표시되는 경우 `detail`은 ` was retired on ; use `로 표시되며, 그렇지 않은 경우에는 일반적인 제안 목록 대신 ` was retired on `로만 표시됩니다. 여기에 명시된 후속 모델은 항상 호출을 다시 지정할 수 있는 라이브 카탈로그 ID입니다. 서비스 종료 날짜가 아직 미래인 모델은 사용 중단된 것이 아닙니다. 해당 날짜까지 `GET /v2/models`에 계속 나열되며 계속 실행 가능합니다. `detail`의 나머지 부분과 마찬가지로 이 사용 중단 문구는 표시용이며 호환성 보장을 제공하지 않습니다. 기계적으로 파싱되지 않는다는 규칙에 문서화된 두 가지 예외가 있습니다. `POST /v2/models/{provider}/{model}`에서 `409`는 `invalid_input` 버킷을 공유하는 세 가지 무관한 조건에 대해 응답되며, 오직 `detail`만이 이들을 구분합니다. "this request's `image` selects the edit operation"으로 시작하는 `detail`은 multipart `model_provider` 거부이고, "this request resolved a BYOK credential"로 시작하는 `detail`은 BYOK `model_provider` 거부입니다. 둘 다 새 `Idempotency-Key`로도 해소되지 않습니다. 해당 경로에서 다른 모든 `invalid_input` `409`는 키 충돌입니다. 두 접두사는 안정적인 계약 용어이며 매칭할 수 있습니다. 그 밖의 어디에서도 `detail`을 기준으로 분기하는 것은 호환성 보장을 제공하지 않습니다. - Router 실패에 대한 거칠게 분류된 기계 판독 가능 버킷으로, 호출자가 본문을 파싱하지 않고 분기할 수 있도록 `X-Comfy-Error-Type` 응답 헤더에 반영됩니다. 이 집합은 열아홉 개 값으로 닫혀 있습니다: 여섯 개의 요청 수준 버킷 `invalid_input`, `content_policy_violation`, `provider_error`, `provider_timeout`, `insufficient_credits`, `model_not_found`와 전송 수준의 `unauthorized`, `forbidden`, `concurrency_limit_exceeded`, `client_disconnected`, `internal_error`, `deadline_exceeded`, `not_enabled`, `service_unavailable`, `rate_limited`, `cancelled`, `queue_timeout`, `request_not_found`, `queue_backlog_full`입니다. 닫혀 있다는 것은 오늘 문서화된 대로의 집합을 설명하는 것이지 영원히 유지되는 한계가 아닙니다. 집합은 늘어날 것으로 예상되며, 그래서 이것은 의도적으로 `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) - 모델 공급자가 요청을 거부한 이유에 대해 길이가 제한되고 정제된 설명으로, `error_type`이 `invalid_input`이고 `X-Comfy-Upstream-Status`가 공급자의 `4xx` 또는 `2xx`일 때만 존재합니다. 즉, 공급자가 요청을 형식 오류로 거부하면서 그 이유를 밝힌 경우입니다. 보통 이 상태는 `4xx`이며, 거부된 생성을 성공 응답 봉투 안에 담아 보고하는 공급자의 경우 `2xx`입니다 (BytePlus의 실패한 작업 폴링은 HTTP `200`이고 이유가 본문에 담겨 있습니다). 공급자 `5xx`, 전송 실패, 콘텐츠 정책 거부, 그리고 Router가 스스로 제기한 모든 거부를 포함한 다른 모든 실패에서는 존재하지 않습니다. 이는 `X-Comfy-Upstream-Detail` 헤더를 반영합니다. + 모델 공급자가 요청을 거부한 이유에 대해 범위가 제한되고 정제된 설명으로, `error_type`이 `invalid_input`이고 `X-Comfy-Upstream-Status`가 공급자의 `4xx` 또는 `2xx`일 때만 존재합니다. 즉, 공급자가 요청을 잘못된 형식으로 거부하고 그 이유를 밝힌 경우입니다. 보통 그 상태는 `4xx`이며, 성공 봉투 안에서 거부된 생성을 보고하는 공급자의 경우 `2xx`입니다(BytePlus의 실패한 작업 폴링은 HTTP `200`에 사유가 본문에 담깁니다). 다른 모든 실패, 즉 공급자 `5xx`, 전송 실패, 콘텐츠 정책 거부, Router가 자기 자신에 대해 제기한 모든 거부에서는 존재하지 않습니다. `X-Comfy-Upstream-Detail` 헤더를 그대로 반영합니다. - 콘텐츠 정책 거부가 어떤 입력 또는 출력에 관한 것이었는지를 Router 수준의 닫힌 어휘로 나타냅니다: `input`, `output`, `input_text`, `input_image`, `input_video`, `input_audio`, `output_text`, `output_image`, `output_video`, `output_audio`. 공급자가 모달리티를 명시하지 않은 경우에는 단독 `input` / `output` 값이 어느 쪽인지를 나타냅니다. `error_type`이 `content_policy_violation`이고 공급자가 거부된 대상을 기계 판독 가능한 코드로 명시한 경우에만 존재하며, 그렇지 않으면 없습니다. 공급자 텍스트는 절대 아닙니다. 현재 BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI, Wan의 거부와 MiniMax Router의 Nano Banana 레그에서 발생한 Gemini 거부에 대해 명시됩니다. 거부가 어느 쪽에 관한 것인지 밝히지 않는 공급자의 경우 이 필드는 없습니다. 이는 `X-Comfy-Refusal-Subject` 헤더를 반영합니다. + 콘텐츠 정책 거부가 어떤 입력 또는 출력에 관한 것인지를 Router 수준의 닫힌 어휘로 나타냅니다. `input`, `output`, `input_text`, `input_image`, `input_video`, `input_audio`, `output_text`, `output_image`, `output_video`, `output_audio`입니다. 공급자가 모달리티를 명시하지 않은 경우, 값이 `input` / `output`만으로 해당 측을 지칭합니다. `error_type`이 `content_policy_violation`이고 공급자가 거부된 대상을 기계 판독 가능한 코드로 명시한 경우에만 존재하며, 그 외에는 존재하지 않습니다. 공급자 텍스트는 절대 아닙니다. 현재 BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI, Wan의 거부와 MiniMax Router의 Nano Banana 레그의 Gemini 거부에 대해 명시됩니다. 거부가 어느 측에 관한 것인지 밝히지 않는 공급자의 경우 이 값이 존재하지 않습니다. `X-Comfy-Refusal-Subject` 헤더를 그대로 반영합니다. + + + + 파트너 노드 지출 거부에 대한 빌링의 정책 분기로, 청구 대상 지갑이 비어 있으면 `no_funds`, 자금 조회 결과 없이 호출이 거부되면 `unspecified`입니다. `error_type`이 `insufficient_credits`이고 배포가 지갑 정보를 보고하는 경우에만 존재하며, 그 외에는 존재하지 않습니다. 표시 텍스트가 아닌 기계 판독 가능한 코드입니다. `detail`을 표시하고, 이 값을 기준으로 분기하십시오. + + + + 거부된 호출이 청구했을 지갑으로, `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` 헤더에도 전송됩니다. +기계가 읽을 수 있는 Router 오류 카테고리이며, `X-Comfy-Error-Type` 헤더로도 전송됩니다. 유형: `string` ### RouterModelBilling -모델을 호출하기 전에 확인해야 하는 과금 동작입니다. 가격이나 사용량은 포함하지 않습니다. +모델을 호출하기 전에 확인해야 할 청구 동작입니다. 가격이나 사용량은 포함하지 않습니다. **필드** - 이 모델이 콘텐츠 정책을 이유로 거부한 호출이 그럼에도 호출자에게 과금되는지 여부입니다. 공급자마다 다르고, 그 차이는 호출 시점에는 드러나지 않으며, 같은 호출에 대해 오류와 과금을 함께 보게 된 사용자는 미리 알 방법이 없었습니다. 그래서 공급자마다의 통설에 맡기는 대신, 모델별로 호출 전에 명시합니다. + 이 모델이 콘텐츠 정책을 이유로 거부한 호출이 그럼에도 불구하고 호출자에게 청구되는지 여부입니다. 공급자마다 다르며, 그 차이는 호출 시점에 보이지 않습니다. 같은 호출에 대해 오류와 청구를 함께 보는 사용자는 그 사실을 미리 알 방법이 없었습니다. 따라서 공급자별 속설에 맡기지 않고 호출 전에 모델별로 명시합니다. 값이 `yes`이면 동기 경로의 `content_policy_violation` 오류에 `X-Comfy-Credits-Used`가 포함될 수 있습니다. 공급자가 모델이 생성한 출력을 거부했고 Comfy가 해당 거부된 생성에 대한 사용량을 기록한 경우 포함되며, 그 수량을 담습니다. 입력 측 거부, 동일 키 재실행(`Idempotent-Replayed: true`), 그리고 헤더의 소수점 두 자리로 표시하기에 너무 작은 청구에는 포함되지 않습니다. 헤더가 없는 거부는 보고되지 않으며, 그것이 무료였다는 증거도 아닙니다. - 타입: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) + 유형: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) ### RouterModelDetail -하나의 Comfy Router 모델에 대한 모델별 상세 정보입니다. 카탈로그 목록이 해당 모델에 대해 보고하는 모든 항목에 더해, 단일 모델 라우트만 제공하는 모델별 필드까지 포함합니다. +Comfy Router 모델 하나에 대한 모델별 상세 정보입니다. 카탈로그 목록이 해당 모델에 대해 보고하는 모든 항목에 더해, 단일 모델 경로에서만 제공되는 모델별 필드를 포함합니다. -[`RouterModelListEntry`](#routermodellistentry), [`RouterModelDetailFields`](#routermodeldetailfields)로 구성됩니다. +[`RouterModelListEntry`](#routermodellistentry), [`RouterModelDetailFields`](#routermodeldetailfields)를 구성합니다. -타입: `object` +Type: `object` ### RouterModelDetailFields -모델 세부 정보 엔드포인트가 반환하는 선택적 필드입니다. +모델 세부 정보 엔드포인트에서 반환되는 선택적 필드입니다. **필드** - 이 모델의 OpenAPI 문서 URL이며, 입력 및 출력 스키마를 포함합니다. + 입력 및 출력 스키마를 포함한 이 모델의 OpenAPI 문서 URL입니다. HTTPS URL, 예: `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`, 최대 2048자 ### RouterModelId -`POST /v2/models/{provider}/{model}`에 사용되는 모델 ID입니다. +`POST /v2/models/{provider}/{model}`에서 사용되는 모델 ID입니다. -타입: `string`. 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 +유형: `string`. 모델 ID(예: `anthropic/claude-opus-4-6`), 최대 193자 ### RouterModelInput -모델 입력 객체입니다. 필드와 검증 정보는 선택한 모델의 OpenAPI 문서를 참고하세요. +모델 입력 객체입니다. 필드와 검증 정보는 선택된 모델의 OpenAPI 문서를 참조하세요. 타입: `object` ### RouterModelInputSchemaDocument -한 모델의 입력과 출력을 담은 독립형 OpenAPI 문서입니다. +하나의 모델 입력과 출력을 위한 독립형 OpenAPI 문서입니다. -타입: `object` +유형: `object` ### RouterModelListEntry -모델의 ID와 청구 정보. +모델의 ID와 과금 정보입니다. **필드** - 정식 Comfy Router 모델 ID인 `{provider}/{model}`로, `POST /v2/models/{provider}/{model}`에서 모델을 지정하는 값과 정확히 동일합니다. 따라서 호출자는 다른 곳에서 다시 도출할 필요 없이 이 값을 해당 경로에 그대로 넣을 수 있습니다. `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 이어 붙인 것이고, `maxLength`는 두 값의 길이 합에 그 구분자를 더한 값입니다. + 정식 Comfy Router 모델 ID로, `{provider}/{model}` 형식입니다. `POST /v2/models/{provider}/{model}`에서 해당 모델을 지정하는 값과 정확히 동일하므로, 호출자는 다른 곳에서 다시 유도할 필요 없이 이 값을 그 경로에 그대로 삽입할 수 있습니다. `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 결합한 것이며, `maxLength`는 두 값의 길이 합에 해당 구분자를 더한 값입니다. - 타입: [`RouterModelId`](#routermodelid) -- 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 + 유형: [`RouterModelId`](#routermodelid). 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 - 정식 `{provider}/{model}` 모델 ID에서 소문자로 표기되는 `provider` 세그먼트이며, 모델을 지정하는 대상 파트너를 나타냅니다. 호출 라우트의 `provider` 경로 매개변수와 카탈로그 항목의 `provider` 필드가 모두 이 하나의 스키마를 참조하며, 이것이 나열된 ID와 허용되는 ID가 서로 어긋나지 않게 유지합니다. + 정식 `{provider}/{model}` 모델 ID에서 소문자로 표기되는 `provider` 세그먼트로, 모델을 지정하는 대상인 파트너를 가리킵니다. 호출 경로의 `provider` 경로 파라미터와 카탈로그 항목의 `provider` 필드가 모두 이 하나의 스키마를 참조하며, 덕분에 목록에 표시되는 ID와 허용되는 ID가 서로 어긋나지 않습니다. - 타입: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 + 유형: [`RouterProviderSegment`](#routerprovidersegment). 영숫자 슬러그, 예: `anthropic`, 최대 64자 - 정식 `{provider}/{model}` 모델 ID에서 소문자로 표기되는 `model` 세그먼트이며, 해당 공급자 안에서 실행할 모델을 나타냅니다. 호출 라우트의 `model` 경로 매개변수와 카탈로그 항목의 `model` 필드에서 공유되며, `RouterProviderSegment`와 마찬가지로 ID가 어긋나지 않게 하기 위한 것입니다. + 정식 `{provider}/{model}` 모델 ID에서 소문자로 표기되는 `model` 세그먼트로, 해당 공급자 안에서 실행할 모델을 가리킵니다. `RouterProviderSegment`와 동일한 불일치 방지 이유로, 호출 경로의 `model` 경로 파라미터와 카탈로그 항목의 `model` 필드가 이 스키마를 함께 사용합니다. - 타입: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 + 유형: [`RouterModelSegment`](#routermodelsegment). 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 - 호출 전에 호출자가 알아야 하는 모델별 청구 정보이며, 가격이 아닙니다. 사용량과 비용 수치는 여기에 절대 나타나지 않습니다. + 호출 전에 호출자가 알아야 하는 모델별 과금 정보이며, 가격이 아닙니다. 사용량과 비용 수치는 여기에 절대 나타나지 않습니다. - 타입: [`RouterModelBilling`](#routermodelbilling) + 유형: [`RouterModelBilling`](#routermodelbilling) - 이 모델의 `GET /v2/models/{provider}/{model}/openapi.json` 문서에 대한 현재의 강한 `ETag`입니다. 스키마가 변경되지 않은 동안 해당 읽기 요청에 이 값을 `If-None-Match`로 보내면 `304` 응답을 받을 수 있고, 또는 마지막으로 확인한 값과 비교하면 모든 문서를 가져오지 않고도 어떤 모델의 스키마가 변경되었는지 알 수 있습니다. 이 값이 없는 경우는 해당 읽기 요청이 현재 이 호출자에게 `200`으로 응답하지 않는 모든 상황입니다. 스키마 서비스를 사용할 수 없거나, 모델의 문서를 렌더링할 수 없거나, 응답을 만드는 동안 해당 모델이 이 호출자에게 사용 불가 상태가 된 경우입니다. 태그가 없다고 해서 스키마가 변경된 것은 아니므로, 현재 태그를 알려면 모델의 문서를 다시 읽으십시오. + 이 모델의 `GET /v2/models/{provider}/{model}/openapi.json` 문서에 대한 현재의 strong `ETag`입니다. 스키마가 변경되지 않은 동안에는 해당 읽기 요청에 이 값을 `If-None-Match`로 보내 `304`를 받을 수 있고, 지난번에 확인한 값과 비교하면 모든 문서를 가져오지 않고도 어떤 모델의 스키마가 변경되었는지 알 수 있습니다. 이 호출자에 대해 그 시점에 해당 읽기 요청이 `200`을 반환하지 않는 경우에는 값이 존재하지 않습니다. 스키마 서비스를 사용할 수 없거나, 모델 문서를 렌더링할 수 없거나, 응답이 만들어지는 도중에 이 호출자에게 해당 모델이 사용 불가 상태가 된 경우입니다. 태그가 없다고 해서 스키마가 변경된 것은 아니므로, 현재 태그를 확인하려면 모델 문서를 다시 읽어야 합니다. ### RouterModelListResponse @@ -1230,30 +1266,30 @@ Router 모델 카탈로그의 한 페이지입니다. **필드** - 이 페이지의 모델들로, 최대 `limit`개입니다. + 이 페이지에 포함된 모델이며, 최대 `limit`개까지입니다. - 유형: [`RouterModelListEntry`](#routermodellistentry)의 배열 + Type: array of [`RouterModelListEntry`](#routermodellistentry) - 이 페이지 뒤에 다른 페이지가 있는지 여부입니다. 이 값이 참인 동안 계속 순회하세요. 짧거나 빈 `data`로 카탈로그의 끝이라고 추측하지 마세요. + 이 페이지 이후에 또 다른 페이지가 존재하는지 여부입니다. 이 값이 참인 동안 계속 진행하세요. `data`가 짧거나 비어 있다고 해서 카탈로그의 끝이라고 추론해서는 안 됩니다. - Router 목록에 대한 불투명 커서입니다. 서버에서 생성되며 오직 왕복 전달만 됩니다. 즉, 오프셋도 아니고, 모델 ID도 아니고, 정렬되지 않으며, 카탈로그 재구축 간에 안정적이지 않으므로, 이를 파싱하거나 값을 증가시키거나 그것이 나온 순회를 넘어 보관하는 것은 모두 계약 밖입니다. 오프셋이 아니라 커서인 이유는 카탈로그가 움직이는 목록이기 때문입니다. 오프셋 순회는 순회 도중 항목이 추가되거나 제거되면 조용히 항목을 건너뛰거나 반복하며, 호출자는 그런 일이 발생했는지 알 수 없습니다. + Router 목록을 가리키는 불투명 커서입니다. 서버가 생성하며 오직 그대로 되돌려 보내는 용도로만 사용됩니다. 즉, 오프셋도 아니고 모델 ID도 아니며, 정렬된 값도 아니고, 카탈로그가 재구축되면 안정적이지도 않습니다. 따라서 커서를 파싱하거나, 값을 증가시키거나, 커서가 나온 순회 범위를 벗어나 저장하는 것은 모두 계약 범위를 벗어납니다. 오프셋 대신 커서를 쓰는 이유는 카탈로그가 계속 변하는 목록이기 때문입니다. 오프셋 순회는 순회 도중 항목이 추가되거나 삭제되면 조용히 항목을 건너뛰거나 반복하며, 호출자는 그런 일이 발생했는지 알 수 없습니다. - 유형: [`RouterPageCursor`](#routerpagecursor), `next_cursor`로 반환되는 불투명 커서, 1–512자 + Type: [`RouterPageCursor`](#routerpagecursor). `next_cursor`로 반환되는 불투명 커서, 1–512자 - 실제로 제공된 페이지 크기입니다. 최대값을 초과하여 요청한 `limit`은 거부되지 않고 최대값으로 제한되므로, 이 값은 요청한 값보다 작을 수 있습니다. 보낸 값이 아니라 이 값으로 페이지네이션하세요. 그렇지 않으면 받지도 못한 행을 받았다고 가정하게 됩니다. + 실제로 제공된 페이지 크기입니다. 요청한 `limit`이 최댓값을 넘으면 거부되지 않고 최댓값으로 낮춰지므로, 이 값은 요청한 값보다 작을 수 있습니다. 보낸 값이 아니라 이 숫자로 페이지를 넘겨야 합니다. 그렇지 않으면 받지도 못한 행이 있다고 착각하게 됩니다. 1–100 ### RouterModelOutput -모델 결과 객체입니다. 정확한 형태를 확인하려면 선택된 모델의 출력 스키마를 참조하세요. +모델 결과 객체입니다. 정확한 형태는 선택된 모델의 출력 스키마를 참조하세요. 유형: `object` @@ -1261,146 +1297,146 @@ Router 모델 카탈로그의 한 페이지입니다. `{provider}/{model}` 모델 ID에서 모델에 해당하는 부분입니다. -유형: `string` -- 영숫자 슬러그입니다(예: `claude-opus-4-6`). 최대 128자입니다. +타입: `string` -- 영숫자 슬러그(예: `claude-opus-4-6`), 최대 128자 ### RouterPageCursor -불투명한 카탈로그 커서입니다. `cursor`로 변경 없이 그대로 다시 전달하세요. +불투명한 카탈로그 커서입니다. `cursor`로 변경 없이 그대로 전달하세요. -타입: `string` -- `next_cursor`로 반환되는 불투명 커서, 1–512자 +유형: `string` -- `next_cursor`로 반환되는 불투명 커서이며, 1–512자입니다. ### RouterProviderSegment -`{provider}/{model}` 모델 ID에서 공급자 부분입니다. +`{provider}/{model}` 모델 ID에서 공급자에 해당하는 부분입니다. -유형: `string` -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 +Type: `string` -- 영숫자 슬러그(예: `anthropic`), 최대 64자 ### RouterQueueCancelResponse -이 라우트가 처리한 요청을 설명하는 두 상태 코드인 `202`와 `409`에 대한 취소 요청의 응답입니다. 성공 envelope과 오류 envelope을 따로 두지 않고 두 상태 모두에 하나의 body 형태를 사용합니다. 두 경우 모두 취소가 발견한 내용이라는 동일한 진술을 나타내며, 상태 코드마다 다른 타입을 파싱해야 하는 클라이언트가 이런 분리에서 얻는 것은 없기 때문입니다. +이 라우트가 처리한 요청을 설명하는 두 상태, 즉 `202`와 `409`에 대한 취소 요청의 응답입니다. 성공 봉투와 오류 봉투를 따로 두지 않고 두 상태에 하나의 본문 형태를 사용하는 이유는, 둘 다 같은 내용, 즉 취소가 찾아낸 결과를 말하고 있기 때문입니다. 상태 코드마다 다른 타입을 파싱해야 하는 클라이언트는 이런 분리에서 얻는 것이 없습니다. -**필드** +**Fields** - 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고 취소하고 결과를 수집할 때 사용하는 핸들입니다. + 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고 취소하며 결과를 수집할 때 사용하는 핸들입니다. - 타입: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 + Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Up to 36 characters - 이 라우트가 실제로 처리한 요청을 설명하는 두 결과에 대해 취소 요청이 발견한 내용입니다. 두 결과 모두 HTTP 상태 코드에 반영되므로, 클라이언트는 둘 중 어느 것으로도 분기할 수 있습니다. + 이 라우트가 실제로 처리한 요청을 설명하는 두 가지 결과에 대해, 취소 요청이 찾아낸 내용입니다. 두 결과 모두 HTTP 상태로 그대로 반영되므로 클라이언트는 어느 쪽으로 분기해도 됩니다. - 타입: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) + Type: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) ### RouterQueueCancelStatus -취소 요청이 확인한 결과로, 이 라우트가 실제로 처리한 요청을 설명하는 두 가지 결과에 해당합니다. 두 결과 모두 HTTP 상태로 그대로 반영되므로, 클라이언트는 둘 중 어느 쪽을 기준으로 분기해도 됩니다. +취소 요청이 확인한 내용으로, 이 라우트가 실제로 처리한 요청을 설명하는 두 가지 결과에 해당합니다. 두 결과 모두 HTTP 상태에 반영되므로 클라이언트는 둘 중 어느 것을 기준으로도 분기할 수 있습니다. 타입: `string` ### RouterQueuePosition -응답이 생성된 그 순간, 실행 대기열에서 이 요청보다 앞에 있는 요청 수입니다. 0이면 이 요청이 맨 앞에 있습니다. +응답이 만들어진 시점에 실행 대기열에서 이 요청보다 앞에 있는 요청이 몇 개인지 나타냅니다. 0이면 이 요청이 맨 앞에 있다는 뜻입니다. -유형: `integer` -- 최소 0 +타입: `integer` -- 최소 0 ### RouterQueueRequestId -대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고 취소하고 결과를 수집할 때 사용하는 핸들입니다. +대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하거나 취소하거나 결과를 수집할 때 사용하는 핸들입니다. -유형: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 +유형: `string`, `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 ### RouterQueueStatus -대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`과 달리 이것은 닫힌 `enum`입니다. 두 스키마는 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 늘어날 것으로 예상됩니다. 따라서 인식할 수 없는 버킷을 단호하게 거부하는 생성된 클라이언트는 이미 무언가 잘못된 바로 그 시점에 가장 심하게 실패하게 됩니다. 이 스키마는 라이프사이클이며, 나중에 네 번째 상태가 추가되는 라이프사이클은 enum으로 선언되든 아니든 이를 대상으로 작성된 모든 폴링 루프에 호환성을 깨뜨리는 변경입니다. 그래서 enum으로 선언되며, 제약은 클라이언트가 볼 수 있는 곳에 명시됩니다. +대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`과 달리 이 것은 닫힌 `enum`입니다. 두 스키마가 의도적으로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 확장될 것으로 예상됩니다. 따라서 인식되지 않은 버킷을 엄격하게 거부하는 생성된 클라이언트는 무언가 이미 잘못되었을 때 가장 심하게 실패할 것입니다. 이 것은 라이프사이클이며, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되었는지 여부에 관계없이 그것에 대해 작성된 모든 폴링 루프에 대한 호환성을 깨는 변경입니다. 따라서 enum으로 선언되고, 제약 조건은 클라이언트가 볼 수 있는 곳에 명시됩니다. 타입: `string` ### RouterQueueStatusFields -`RouterQueueStatusResponse`에서 URL 블록이 아닌 나머지 절반입니다. 대기 중인 요청 하나의 식별자, 현재 상태, 그리고 그 상태가 터미널이고 실행이 성공하지 못했을 때 그 이유를 나타내는 포괄적 분류입니다. +`RouterQueueStatusResponse`에서 URL 블록을 제외한 나머지 절반입니다. 대기 중인 요청 하나의 식별자, 현재 상태, 그리고 그 상태가 터미널이면서 실행이 성공하지 못했을 때 그 이유를 나타내는 포괄적인 분류입니다. **필드** - 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고 취소하고 결과를 수집할 때 사용하는 핸들입니다. + 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고, 취소하고, 결과를 수집할 때 사용하는 핸들입니다. - 유형: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 + Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 - 대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`과 달리 이것은 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식할 수 없는 분류를 강하게 거부하는 생성된 클라이언트는 무언가가 이미 잘못된 바로 그 순간에 가장 심하게 실패하게 됩니다. 이 스키마는 라이프사이클이고, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되었든 아니든 그에 맞춰 작성된 모든 폴링 루프에 대한 호환성을 깨는 변경입니다. 그래서 enum으로 선언하고, 클라이언트가 볼 수 있는 위치에 제약을 명시합니다. + 대기 중인 Router 요청의 상태입니다. 값은 정확히 세 가지이며, `RouterErrorType`과 달리 이 스키마는 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식하지 못한 분류를 강하게 거부하는 생성된 클라이언트는 이미 무언가 잘못된 상황에서 가장 크게 실패하게 됩니다. 이 스키마는 생명주기이고, 나중에 네 번째 상태가 추가된 생명주기는 enum으로 선언되었든 아니든 그에 맞춰 작성된 모든 폴링 루프에 호환성을 깨뜨리는 변경이 됩니다. 그래서 enum으로 선언하고, 그 제약을 클라이언트가 볼 수 있는 곳에 명시합니다. - 유형: [`RouterQueueStatus`](#routerqueuestatus) + Type: [`RouterQueueStatus`](#routerqueuestatus) - 응답이 구성된 시점에 실행 대기열에서 이 요청보다 앞에 있는 요청이 몇 개인지입니다. 0은 이 요청이 맨 앞에 있음을 의미합니다. + 응답이 구성된 순간에 실행 대기열에서 이 요청보다 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있다는 뜻입니다. - 유형: [`RouterQueuePosition`](#routerqueueposition) -- 최소 0 + Type: [`RouterQueuePosition`](#routerqueueposition) -- 최소 0 - 성공하지 못한 `COMPLETED` 요청에만 존재하며, 결과 조회가 해당 실패를 반환할 때 `X-Comfy-Error-Type`에 붙이는 것과 동일한 포괄적 분류를 담습니다. 성공한 터미널 요청과 실패했거나 취소된 요청을 구분하는 역할을 합니다(둘 모두를 위한 별도의 터미널 상태는 없습니다). 그리고 성공 시에는 null이 아니라 아예 존재하지 않으므로, 존재 여부로 분기하세요. + 성공하지 못한 `COMPLETED` 요청에만 존재하며, 그 실패를 반환할 때 결과 조회가 `X-Comfy-Error-Type`에 붙이는 것과 동일한 포괄적 분류를 담습니다. 이것이 성공한 터미널 요청과 실패하거나 취소된 요청을 구분하는 수단이며, 두 경우 모두를 위한 별도의 터미널 상태는 없습니다. 그리고 성공 시에는 null이 아니라 아예 존재하지 않으므로, 존재 여부로 분기해야 합니다. - 유형: [`RouterErrorType`](#routererrortype) + Type: [`RouterErrorType`](#routererrortype) ### RouterQueueStatusResponse -대기 중인 요청 하나의 현재 상태이며, 제출 시 반환된 것과 동일한 세 개의 URL과 함께 구성됩니다. +대기 중인 요청 하나의 현재 상태로, 제출 시 반환된 것과 동일한 세 개의 URL로 구성됩니다. -구성 요소: [`RouterQueueUrls`](#routerqueueurls), [`RouterQueueStatusFields`](#routerqueuestatusfields). +[`RouterQueueUrls`](#routerqueueurls)와 [`RouterQueueStatusFields`](#routerqueuestatusfields)로 구성됩니다. -타입: `object` +Type: `object` ### RouterQueueSubmitFields -`RouterQueueSubmitResponse`에서 URL 블록이 아닌 나머지 절반: 새 요청의 식별자와 요청이 접수된 순간의 상태입니다. +`RouterQueueSubmitResponse`에서 URL 블록을 제외한 나머지 절반입니다. 새 요청의 식별자와 요청이 접수된 순간의 상태를 담습니다. **필드** - 대기 중인 Router 요청 하나의 식별자로, 호출자가 폴링하고 취소하고 결과를 수집할 때 사용하는 핸들입니다. + 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 이 핸들로 상태를 조회하고, 취소하고, 결과를 수집합니다. - 유형: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 + 타입: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 - 대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`과 달리 이쪽은 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식할 수 없는 분류값을 강하게 거부하는 생성된 클라이언트는 이미 문제가 발생한 바로 그 시점에 가장 심하게 실패하게 됩니다. 이쪽은 라이프사이클이고, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되었든 아니든 그에 맞춰 작성된 모든 폴링 루프에 대한 호환성을 깨는 변경입니다. 그래서 enum으로 선언하고, 제약을 클라이언트가 볼 수 있는 곳에 명시합니다. + 대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`과 달리 이 스키마는 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식할 수 없는 값을 강하게 거부하는 생성된 클라이언트는 무언가가 이미 잘못된 바로 그 시점에 가장 심하게 실패하게 됩니다. 반면 이 값은 생명주기이며, 나중에 네 번째 상태가 추가된 생명주기는 enum으로 선언되었든 아니든 이를 대상으로 작성된 모든 폴링 루프에 breaking change가 됩니다. 그래서 enum으로 선언하고, 제약을 클라이언트가 볼 수 있는 곳에 명시합니다. - 유형: [`RouterQueueStatus`](#routerqueuestatus) + 타입: [`RouterQueueStatus`](#routerqueuestatus) - 응답이 구성된 순간에 실행 대기열에서 이 요청보다 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있습니다. + 응답이 구성된 순간, 실행 대기열에서 이 요청보다 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있습니다. - 유형: [`RouterQueuePosition`](#routerqueueposition) -- 최소 0 + 타입: [`RouterQueuePosition`](#routerqueueposition) -- 최소 0 - 이 요청에 대한 사전 비용 추정치로, 호출자에게 비용 추정이 활성화된 경우 새로 접수될 때 포함됩니다. 이 요청이 고정된 공급자 구간을 제시합니다(실행 대기열에는 폴백 루프가 없으므로 `fallback_provider`가 실제로 실행되는 구간을 바꾸는 일은 없습니다). 수치를 제시할 수 없을 때도 `source: unknown`과 함께 여전히 포함되며, 추정치 때문에 제출이 실패하는 일은 없습니다. 멱등 재실행(`Idempotent-Replayed: true`)에서는 원본 견적이 저장되지 않으므로 생략됩니다. 이는 추정치이며 최종 청구 금액이 아니고 가격 고정도 아닙니다: 실행은 평가될 때 적용되는 요금으로 청구되며, 워크스페이스의 사용량 및 청구 기록에 정산된 청구 금액이 최종입니다. + 이 요청에 대한 사전 비용 추정치로, 호출자에 대해 비용 추정이 활성화된 경우 새로 접수될 때 포함됩니다. 이 요청이 고정된 공급자 구간을 제시합니다(실행 대기열에는 폴백 루프가 없으므로 `fallback_provider`는 실행되는 구간을 바꾸지 않습니다). 수치를 제시할 수 없을 때도 `source: unknown`과 함께 그대로 포함되며, 제출이 추정치 때문에 실패하는 일은 없습니다. 멱등 재생(`Idempotent-Replayed: true`)에서는 생략되는데, 원본 견적이 저장되지 않기 때문입니다. 이는 추정치일 뿐 최종 청구액도, 가격 고정도 아닙니다. 실행은 평가 시점에 적용되는 요율로 청구되며, 워크스페이스의 사용량 및 청구 기록에 정산된 금액이 최종입니다. - 유형: [`RouterCostEstimate`](#routercostestimate) + 타입: [`RouterCostEstimate`](#routercostestimate) ### RouterQueueSubmitResponse -실행이 실행 대기열에 승인될 때 반환되는 핸들로, 요청의 식별자와 상태에 나머지 수명 주기를 가리키는 세 개의 URL을 결합한 것입니다. +실행이 실행 대기열에 수락될 때 반환되는 핸들로, 요청의 ID와 상태에 수명 주기의 나머지 부분을 처리하는 세 개의 URL을 결합한 것입니다. -[`RouterQueueUrls`](#routerqueueurls), [`RouterQueueSubmitFields`](#routerqueuesubmitfields)를 구성합니다. +다음을 구성합니다: [`RouterQueueUrls`](#routerqueueurls), [`RouterQueueSubmitFields`](#routerqueuesubmitfields). -유형: `object` +Type: `object` ### RouterQueueUrls -대기 중인 한 요청의 남은 수명을 처리하는 세 가지 URL입니다. 활성 핸들을 포함하는 모든 응답에서 반환되므로, 클라이언트가 실행 대기열 URL을 직접 조합할 필요가 없습니다. +대기 중인 요청의 나머지 수명 주기를 처리하는 세 개의 URL로, 라이브 핸들을 포함하는 모든 응답에서 반환되므로 클라이언트가 실행 대기열 URL을 직접 구성할 필요가 없습니다. **필드** - 이 요청의 상태 조회를 위한 절대 URL입니다. + 이 요청의 상태 조회에 대한 절대 URL입니다. URI @@ -1419,18 +1455,18 @@ Router 모델 카탈로그의 한 페이지입니다. ### RouterValidationErrorContext -검증에 실패한 규칙에 대해 공급자가 제공한 세부 정보입니다. +공급자가 제공한, 실패한 검증 규칙에 대한 세부 정보입니다. -유형: `object` +Type: `object` ### RouterValidationErrorDetail -필드 수준 검증 실패 하나를 나타냅니다. +필드 수준의 검증 실패 하나를 나타냅니다. **필드** - 문제가 된 필드의 경로이며, 가장 바깥쪽 세그먼트가 먼저 옵니다. 예를 들어 `["body", "image_url"]`, 또는 정수가 배열의 인덱스를 가리키는 `["body", "images", 0]`과 같습니다. + 문제가 된 필드의 경로이며, 가장 바깥쪽 세그먼트가 먼저 옵니다. 예를 들어 `["body", "image_url"]`, 또는 정수가 배열을 인덱싱하는 `["body", "images", 0]`과 같습니다. @@ -1438,33 +1474,33 @@ Router 모델 카탈로그의 한 페이지입니다. - 이 실패에 대한 구체적이고 기계가 읽을 수 있는 이유이며, 공급자로부터 변경 없이 그대로 전달됩니다. 타입이 지정된 SDK 예외 계층이 분기하는 값이 바로 이것이며, 응답 헤더의 `error_type`은 그것의 포괄적인 분류일 뿐입니다. + 이 실패에 대한 구체적이고 기계 판독 가능한 사유로, 공급자로부터 변경 없이 그대로 전달됩니다. 타입이 지정된 SDK 예외 계층이 분기하는 값이 바로 이것이며, 응답 헤더의 `error_type`은 그저 포괄적인 분류일 뿐입니다. - 하나의 `RouterValidationErrorDetail`에 대해 위반된 경계값으로, 공급자로부터 그대로 전달됩니다. 예를 들어 `greater_than`과 함께 오는 `{"limit_value": 8}`, `image_too_small`과 함께 오는 `{"min_width": 512}`, 또는 `file_too_large`와 함께 오는 `{"max_size_bytes": 10485760}`과 같습니다. 키 집합은 공급자와 오류 유형에 따라 다르므로 이는 의도적으로 열린 객체입니다. 이것을 고정된 필드 목록으로 좁히거나 `msg` 문자열에 접어 넣는 것이야말로, 포팅된 통합이 컴파일은 되지만 경계값을 읽던 분기를 조용히 잃게 되는 바로 그 방식입니다. 오류 유형에 경계값이 없으면 이 필드는 생략됩니다. + 하나의 `RouterValidationErrorDetail`에 대해 위반된 경계값으로, 공급자로부터 그대로 전달됩니다. 예를 들어 `greater_than`과 함께 오는 `{"limit_value": 8}`, `image_too_small`과 함께 오는 `{"min_width": 512}`, `file_too_large`와 함께 오는 `{"max_size_bytes": 10485760}`과 같습니다. 키 집합은 공급자와 오류 타입에 따라 다르므로 이 객체는 의도적으로 열린 객체입니다. 고정된 필드 목록으로 좁히거나 `msg` 문자열에 합쳐 버리면, 이식된 통합이 컴파일은 되지만 경계값을 읽던 분기를 조용히 잃게 되는 바로 그 원인이 됩니다. 오류 타입에 경계값이 없으면 생략됩니다. - 유형: [`RouterValidationErrorContext`](#routervalidationerrorcontext) + 타입: [`RouterValidationErrorContext`](#routervalidationerrorcontext) - 문제가 된 입력 값으로, 호출자가 `loc`에서 다시 도출하지 않고도 무엇이 거부되었는지 볼 수 있도록 그대로 되돌려 전달됩니다. 문자열, 숫자, 논리값, 배열, 객체 또는 null 등 모든 JSON 타입이므로, 이 스키마는 객체로 좁히지 않고 의도적으로 타입 없이 둡니다. 공급자가 입력을 되돌려 전달하지 않으면 이 필드는 생략됩니다. + 문제가 된 입력 값으로, 호출자가 `loc`에서 다시 도출하지 않고도 무엇이 거부되었는지 확인할 수 있도록 그대로 되돌려 전달됩니다. 문자열, 숫자, 논리값, 배열, 객체, null 등 모든 JSON 타입을 담을 수 있으므로, 이 스키마는 객체로 좁히지 않고 의도적으로 타입을 지정하지 않았습니다. 공급자가 입력을 그대로 되돌려주지 않으면 생략됩니다. - 유형: [`RouterValidationErrorInput`](#routervalidationerrorinput) + 타입: [`RouterValidationErrorInput`](#routervalidationerrorinput) ### RouterValidationErrorInput -공급자가 포함하는 경우의 거부된 입력 값입니다. +거부된 입력 값입니다. 공급자가 이 값을 포함하는 경우에 제공됩니다. ### RouterValidationErrorResponse -`422` 검증 오류 본문입니다. 카테고리는 `X-Comfy-Error-Type`을 확인하세요. +`422` 검증 오류 본문입니다. 카테고리는 `X-Comfy-Error-Type`에서 확인하세요. **필드** - 요청에서 발견된 모든 검증 실패 항목으로, 문제가 있는 필드마다 하나의 항목이 대응합니다. + 요청에서 발견된 모든 검증 실패 항목으로, 문제가 있는 필드마다 하나의 항목이 대응됩니다. 유형: [`RouterValidationErrorDetail`](#routervalidationerrordetail)의 배열 diff --git a/ko/tutorials/video/minimax/minimax-h3-fastvideo.mdx b/ko/tutorials/video/minimax/minimax-h3-fastvideo.mdx index 21741f66bc..9636c4c751 100644 --- a/ko/tutorials/video/minimax/minimax-h3-fastvideo.mdx +++ b/ko/tutorials/video/minimax/minimax-h3-fastvideo.mdx @@ -2,7 +2,7 @@ title: "FastVideo FastH3: ComfyUI 워크플로 예제" description: "FastVideo FastH3는 ComfyUI에서 8 샘플링 스텝으로 동기화 오디오가 포함된 MiniMax H3 비디오를 생성합니다. 텍스트 기반 및 첫/마지막 프레임 워크플로를 지원합니다." sidebarTitle: "FastVideo FastH3" -translationSourceHash: 7cbe9703 +translationSourceHash: cb542dfa translationFrom: tutorials/video/minimax/minimax-h3-fastvideo.mdx translationBlockHashes: "_intro": 096c332e @@ -10,9 +10,10 @@ translationBlockHashes: "FastH3 Text to Video": 1c4cb909 "FastH3 Image to Video": ec7d82bf "Model downloads": b88037db - "Workflow structure notes": 0542b184 + "Workflow structure notes": 8f5d2153 --- + [FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2)는 FastVideo 팀이 MiniMax H3를 DMD2로 증류한 체크포인트로, 베이스 모델의 전체 스케줄 대신 **8 샘플링 스텝**으로 네이티브 동기화 오디오가 포함된 비디오를 생성합니다. H3의 텍스트 인코더, 비디오 VAE, 오디오 VAE를 그대로 사용하므로 출력 설정은 베이스 모델과 동일하면서 샘플링만 크게 단축됩니다. FastH3 프리뷰는 Nuva Lab 및 NVIDIA FastGen 팀과 협력하여 개발되었습니다. 증류에 대한 자세한 내용은 [FastH3 발표 블로그](https://haoailab.com/blogs/fasth3-preview/)를 참고하세요. ComfyUI에는 8스텝 V2 체크포인트가 포함되어 있으며, Comfy-Org가 [FastVideo-FastH3-Comfy](https://huggingface.co/FastVideo/FastVideo-FastH3-Comfy) 저장소에 재패키징했습니다. @@ -131,13 +132,13 @@ ComfyUI/ │ └── minimax_h3_audio_vae_fp32.safetensors ``` -## 워크플로우 구조 노트 +## 워크플로 구조 노트 -두 FastH3 워크플로우는 베이스 H3 구성과 다음 노드를 공유하며, 증류 관련 설정이 추가되어 있습니다: +두 FastH3 워크플로는 베이스 H3 구성과 다음 노드를 공유하며, 증류 관련 설정이 적용됩니다: -- **BlockSparseAttention**: Video Sparse Attention(VSA)을 `keep_percent` 10으로, 스케줄의 20% 지점부터 실행하여 품질을 유지하면서 어텐션 비용을 줄입니다 +- **BlockSparseAttention**: `keep_percent` 10으로 Video Sparse Attention(VSA)을 스케줄의 20% 지점부터 실행하여, 품질을 유지하면서 어텐션 비용을 줄입니다 - **MiniMaxH3SigmaShift**: 증류 스케줄에 맞는 H3 시그마 시프트(비디오 10, 오디오 3)를 적용합니다 -- **ComfyMathExpression**: 길이 입력을 24fps의 17k+5 그리드에서 유효한 프레임 `length`로 변환합니다 -- **샘플러**: `res_multistep` 샘플러, `simple` 스케줄러, 8스텝 +- **ComfyMathExpression**: 재생 시간 입력을 24fps의 17k+5 그리드에서 유효한 프레임 `length`로 변환합니다 +- **샘플러**: `simple` 스케줄러를 사용하는 `res_multistep` 샘플러, 8스텝 -FastH3 가중치에는 `to_gate_compress` 게이트 레이어가 있고, VSA의 거친 브랜치가 이를 읽습니다. 베이스 H3 체크포인트에는 없습니다. 비교하려면 **Model Sparse Attention** 노드의 `method`를 `sol-attn`으로 두고 시드를 고정하세요. `sol-attn`은 대응 가중치가 필요 없고 어떤 H3 체크포인트에서든 설정한 `tau` 값으로 동작합니다. +FastH3 가중치에는 `to_gate_compress` 게이트 레이어가 있으며, VSA가 이를 거친 브랜치에 사용합니다. 베이스 H3 체크포인트에는 이 레이어가 없습니다. 방법을 비교하려면 **Model Sparse Attention** 노드에서 `method`를 `sol-attn`으로 설정하고 동일한 시드를 유지하세요. `sol-attn`은 대응 가중치가 필요 없으며, 어떤 H3 체크포인트에서든 설정한 `tau`로 동작합니다. diff --git a/ko/tutorials/video/minimax/minimax-h3-prompt-guide.mdx b/ko/tutorials/video/minimax/minimax-h3-prompt-guide.mdx index e45e85a9bc..65f9ade5f0 100644 --- a/ko/tutorials/video/minimax/minimax-h3-prompt-guide.mdx +++ b/ko/tutorials/video/minimax/minimax-h3-prompt-guide.mdx @@ -2,17 +2,18 @@ title: "ComfyUI MiniMax H3 프롬프트 가이드: 공식 가이드, 팁, 프롬프트 임베딩" description: "ComfyUI에서 더 나은 MiniMax H3 프롬프트 작성하기: MiniMax 공식 프롬프트 작성 가이드, 일반 프롬프트 팁, 대사와 화자 규칙, 스타일 임베딩." sidebarTitle: "프롬프트 가이드" -translationSourceHash: 0d858ae8 +translationSourceHash: 0f1ded35 translationFrom: tutorials/video/minimax/minimax-h3-prompt-guide.mdx translationBlockHashes: "_intro": da22cc9d "Official guides": 3d762c67 - "General tips": 91822299 + "General tips": fab4ad35 "Shots and cuts": 8184dae6 "Dialogue and speakers": 4985438e "Prompt embeddings": 9c899169 --- + H3는 하나의 멀티모달 프롬프트에 샷, 카메라, 대사, SFX를 담습니다. 이 페이지는 공식 가이드, 워크플로 공통 팁, 샷/대사 규칙, 스타일 임베딩을 모읍니다. ## 공식 가이드 @@ -26,7 +27,7 @@ H3는 하나의 멀티모달 프롬프트에 샷, 카메라, 대사, SFX를 담 ## 일반 팁 -I2VA는 고정 이미지 정렬 줄, 빈 줄, 본문 필드. FL2VA/L2VA는 각 정렬 줄; T2VA는 필드부터: +I2VA는 고정된 이미지 정렬 줄, 빈 줄, 그다음 본문 필드로 시작합니다. FL2VA/L2VA는 자체 정렬 줄을 사용하고, T2VA는 필드에서 바로 시작합니다: ```text integrated_multimodal_description: [Shot 1] ... @@ -34,19 +35,19 @@ overall_soundscape: ... non_diegetic_music: ... ``` -프롬프트는**영어**; 대사/가사 ``; 화면 텍스트 원문. +프롬프트는 **영어**로 작성하세요. 대사/가사는 `` 태그 안에, 화면 텍스트는 원래 언어 그대로 정확히 씁니다. -1. **장면 우선**: 전체 후 `integrated_multimodal_description` `[Shot 1]` 샷 -2. **한 블록**: 샷, 카메라, 오디오 -3. **해상도**: 16:9 네이티브 **1344×768**; **32** 배수 -4. **길이**: `length` 24fps 프레임(기본 **124** ≈ 5s), **17k+5** 스냅 -5. **화면 텍스트**: 영어 큰따옴표·원문(예 `A red neon sign reading "营业中"`); 대사 `` -6. **R2V 오디오 마커**: `fully_copy`, `partially_copy`, `reference`, `weak_reference`(공식 ref 표) -7. **오디오 필드**: `overall_soundscape` 환경/SFX/비언어(1–4문; 진짜 무음만 `N/A`). 대사·다이제틱 음악은 샷 안. `non_diegetic_music` 스코어만(1–3문; 없으면 `N/A`) -8. **네거티브 없음**: `BasicGuider` `cfg` 1, 네거티브 분기 없음. 금지 목록 역효과; 나타낼 것을 쓰거나 R2V 유지 필드 -9. **참조 시트(R2V)**: 한 이미지 다패널; 별도 ``(`` 안만 쓰지 말 것), 샷에서 패널 지정(예 `` 정면 전신) +1. **장면 우선**: 전체 장면을 먼저 쓰고, 그다음 `integrated_multimodal_description`의 `[Shot 1]` 안에 시간별 샷을 씁니다 +2. **하나의 블록**: 샷, 카메라, 오디오를 함께 씁니다 +3. **해상도**: 16:9에서 네이티브 **1344×768**; **32**의 배수 +4. **길이**: `length`는 24fps 기준 프레임 수(기본 **124** ≈ 5s)이며 **17k+5**에 맞춰집니다 +5. **화면 텍스트**: 문자열마다 영어 큰따옴표로, 원문 그대로(예: `A red neon sign reading "营业中"`). 대사는 큰따옴표가 아니라 ``를 씁니다 +6. **R2V 오디오 마커**: 유지 분석에서 각 오디오 참조를 `fully_copy`, `partially_copy`, `reference`, `weak_reference` 중 하나로 표시해 클립이 사용되는 방식과 일치시키세요(공식 ref 가이드 표 참고) +7. **오디오 필드**: `overall_soundscape` = 앰비언스/SFX/비언어(1–4문장; 완전히 무음일 때만 `N/A`). 대사와 다이제틱 음악은 샷 안에 남깁니다. `non_diegetic_music` = 스코어만(1–3문장; 없으면 `N/A`). 원치 않는 발화가 나타나면 두 필드를 모두 명시적으로 채우세요 +8. **네거티브 없음**: `BasicGuider`는 네거티브 분기 없이 `cfg` 1로 실행됩니다. 금지 목록은 원치 않는 개념을 추가합니다. 나타나야 할 것을 서술하세요(또는 R2V 유지 필드 `fully_preserved`, `partially_preserved` 등 사용) +9. **참조 시트(R2V)**: 하나의 이미지에 여러 패널을 담을 수 있습니다. 시트에 자체 ``을 부여하고(`` 안에만 두지 말 것), 패널을 설명하며, 샷에서 패널을 지정하세요(예: ``의 정면 전신). 패널을 명확히 라벨링하세요 -워크플로별 태그는 각 워크플로 페이지. +워크플로별 태그와 컨트롤은 각 워크플로 페이지에 있습니다. ## 샷과 컷 diff --git a/zh/development/api-development/sdks.mdx b/zh/development/api-development/sdks.mdx index dffa890068..ee5410768b 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"; @@ -114,7 +115,7 @@ await job.getOutputs("9")[0].toFile("out.png"); |---|---|---| | **Comfy Cloud** | `https://cloud.comfy.org`(默认) | 必填 | | **Comfy API 部署** | `https://.run.comfy.app` | 必填 | -| **您自己的 ComfyUI** | `http://127.0.0.1:8189`(本地代理) | 默认无。可选静态 bearer 令牌 | +| **您自己的 ComfyUI** | `http://127.0.0.1:8189`(本地代理) | 默认不需要。可选静态 bearer 令牌 | 基础 URL 来自 `COMFY_BASE_URL` 环境变量,而不是构造函数参数: @@ -123,7 +124,7 @@ export COMFY_BASE_URL="https://.run.comfy.app" # Comfy API 部署 export COMFY_BASE_URL="http://127.0.0.1:8189" # 自托管代理 ``` -客户端每次构造时都会读取该变量,它必须是 `http(s)` URL,未设置或为空则默认为 Comfy Cloud。因此客户端本身在所有环境下都是相同的: +每次构造客户端时都会读取该变量,它必须是 `http(s)` URL;未设置或留空即表示使用 Comfy Cloud。因此客户端本身在所有环境下都是相同的: ```python Python @@ -144,7 +145,7 @@ const client = new Comfy({ apiKey: "comfyui-..." }); 开箱即用。创建 [API 密钥](/zh/development/api-development/getting-an-api-key) 并将其传递给客户端。 - API 访问需要付费的 Comfy Cloud 订阅。免费层级不包含此权限。一次可以运行多少个任务取决于您的层级。请参阅[并发限制](/zh/development/deploy/cloud-usage#并发限制)。 + API 访问需要付费的 Comfy Cloud 订阅。免费层级不包含此功能。同时可运行的任务数量取决于您的订阅层级。请参阅[并发限制](/zh/development/deploy/cloud-usage#并发限制)。 diff --git a/zh/development/cloud/api-reference.mdx b/zh/development/cloud/api-reference.mdx index c2908985e9..6cc5ad7111 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..e55adef975 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: 235802c5 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": cf6e2050 + "Models without a pre-flight estimate": 495bdb2b + "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- @@ -27,6 +27,7 @@ translationBlockHashes: + Router 通过一次同步 HTTP 调用运行合作伙伴模型,或通过一个已排队的请求运行:你提交请求,稍后再收集结果。当你的应用能够等待一个已完成的结果,或稍后收集结果,并且能够处理模型自身的输入和输出字段时,就使用它。 ## Router 支持的功能 @@ -47,11 +48,11 @@ Router 通过一次同步 HTTP 调用运行合作伙伴模型,或通过一个 同步路由在模型运行期间会一直保持连接;对于异步提供商,Router 会提交任务并在内部轮询。排队式投递(提交、获取 `request_id`、轮询、收集)则是另一种选择:参见[队列投递](/zh/development/comfy-router/queue)。它的作用域限定在凭据所属的工作区内,因此需要使用在你的 Comfy 工作区中创建的密钥。没有工作区的传统密钥、自带密钥的请求,或队列无法运行的模型,都会在提交路由上返回 `403` 和 `not_enabled`。两种模式都不提供回调或 webhook。 -如果你的请求无法保持打开足够长的时间,就把它放入队列。当你需要使用提供商自己的提交与轮询控制时,请使用[合作伙伴代理](#router-并不覆盖每个合作伙伴操作)。 +如果你的请求无法保持打开足够长的时间,就把它放入队列。当你需要使用提供商自己的提交与轮询控制时,请使用[合作伙伴代理](#router-并不覆盖每一项合作伙伴操作)。 目前有四个模型仅支持同步方式,若将它们提交到队列,会被以 `403` / `not_enabled` 拒绝:`elevenlabs/eleven_sfx_v2`、`elevenlabs/eleven_v3`、`elevenlabs/eleven_v4` 和 `elevenlabs/eleven_v4_turbo`。它们返回的是原始音频字节,而不是 JSON 结果文档,队列投递无处存储这些内容。请在同步路由上运行它们,该路由会正常返回这些字节。 -LTX v1 的文生视频和图生视频操作出于同样的原因返回原始视频字节,队列投递同样无法存储它们,但它们只能通过位于 `/proxy/ltx/v1/…` 的[合作伙伴代理](#router-并不覆盖每个合作伙伴操作)访问,而不能通过 Router 模型 ID 访问:每个 `ltx/*` 目录模型都会解析为可排队的 v2 提交与轮询操作。 +LTX v1 的文生视频和图生视频操作出于同样的原因返回原始视频字节,队列投递同样无法存储它们,但它们只能通过位于 `/proxy/ltx/v1/…` 的[合作伙伴代理](#router-并不覆盖每一项合作伙伴操作)访问,而不能通过 Router 模型 ID 访问:每个 `ltx/*` 目录模型都会解析为可排队的 v2 提交与轮询操作。 ## 调用会在服务器截止时间被中断 @@ -102,9 +103,9 @@ Router 只返回最终响应,不提供流式 token、服务器发送事件、 响应中可能包含提供商的用量或成本字段,但它们并不代表通用的 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,36 +115,40 @@ 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` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`, `ideogram/p-image-ideogram` - **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` -- **luma**: `luma/photon-1`, `luma/photon-flash-1`, `luma/ray-2`, `luma/ray-flash-2` +- **luma**: `luma/photon-1`, `luma/photon-flash-1` - **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` - **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 */} -## Router 并不覆盖每个合作伙伴操作 +对 `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 规范](/zh/router-openapi.yaml) 为准;支持情况因提供商而异。 + +### Krea 3 参考图像:先上传,或使用公共 https URL -Router 运行模型。文件上传、账户读取、资产管理、流式传输以及提供商任务控制可能需要位于 `/proxy/…` 下的合作伙伴代理路由,这些路由处在 Router 之外,Router 的契约也不涵盖它们。Router 自身对外提供的接口以 [Comfy Router 规范](/router-openapi.yaml) 为准;支持情况因提供商而异。 +在 `krea/krea-3` 的 `image_urls` 中,由 `POST /proxy/krea/assets` 返回的 `image_url`(即 `https://app-uploads.krea.ai/...` 形式的 URL)始终会被接受。其他链接是否被接受取决于环境;在 api.comfy.org 上,目前是接受的。 -### Krea 3 的参考图像必须先上传 +- **在接受其他链接的环境中**,任何公共 `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..7972639186 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: 71f7e7b3 translationFrom: development/comfy-router/litellm.mdx translationBlockHashes: "_intro": 1ddb0d0a "Configure the pass-through": 380c3ae3 - "How spend is recorded": f852c18c + "How spend is recorded": 4a9dcb84 "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 @@ -91,22 +92,23 @@ X-Litellm-Response-Cost: 0.0592417062 X-Litellm-Total-Tokens: 0 ``` -`X-Comfy-Credits-Used` 是该次运行以 Comfy 积分表示的价格,四舍五入到两位小数。`X-Litellm-Response-Cost` 是同一价格由未舍入的积分数量换算成的美元金额,因此用显示的积分数除以换算比率,结果可能与它在最后几位上有所不同。响应头名称不区分大小写,所以 LiteLLM 会将其读取为 `x-litellm-response-cost`。LiteLLM 会原样记录它,并用它替代你的 `cost_per_request`。`x-litellm-total-tokens` 始终为 `0`,因为媒体类运行不按 token 计量。 +`X-Comfy-Credits-Used` 是该次运行以 Comfy 积分表示的价格,四舍五入到两位小数。`X-Litellm-Response-Cost` 是将同一价格从未舍入的积分数量换算成美元后得到的金额,因此用显示的积分数除以换算比率,所得结果可能在最后几位上与之不同。响应头名称不区分大小写,所以 LiteLLM 会将其读取为 `x-litellm-response-cost`。LiteLLM 会原样记录它,并用它替代你的 `cost_per_request`。`x-litellm-total-tokens` 始终为 `0`,因为媒体类运行不按 token 计量。 与 `X-Comfy-Credits-Used` 一样,该响应头报告的是价格,而不是已结算的扣费。请以[工作区计费](https://platform.comfy.org)为准核对,而不是以 LiteLLM 的合计为准。 ### 不报告成本的运行 -有些运行不会携带 `x-litellm-response-cost`。它与 `X-Comfy-Credits-Used` 在相同的情况下缺失: +有些运行不会携带 `x-litellm-response-cost`。在大多数这类情况下,`X-Comfy-Credits-Used` 也会缺失: -- 使用你自己的提供商密钥计费、而不是计入你的 Comfy 积分的运行 +- 使用你自己的提供商密钥计费、而不是从你的 Comfy 积分中扣费的运行 - 尚未列入 Router 会报告每次运行积分价格的模型列表中的模型。该列表较为保守,有些提供商完全不在其中 - 未进入 Comfy 计费环节的扣费 -- 错误响应 -当 Router 针对使用相同 `Idempotency-Key` 的重试(通过代理发送时为 `x-pass-Idempotency-Key`)重放已存储的结果时,该响应头也会缺失。该重试不会再次计费,因此这次重放不会第二次报告该次运行的确切成本。出于同样的原因,排队运行的结果收集中只有一次会携带该响应头,即该次运行的价格被记录后的第一次收集;再次收集同一结果仍会返回 `X-Comfy-Credits-Used`,但不会返回 `x-litellm-response-cost`。 +有一种情况不同:错误响应。来自 `billing.charges_on_policy_rejection` 为 `yes` 的模型的同步 `content_policy_violation`,可以携带 `X-Comfy-Credits-Used`,其中包含 Comfy 为被拒绝的生成记录的使用量;即便如此,它也绝不会携带 `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..6b606ef215 100644 --- a/zh/development/comfy-router/models.mdx +++ b/zh/development/comfy-router/models.mdx @@ -2,18 +2,18 @@ title: "Comfy Router 模型" sidebarTitle: "所有模型" description: "Comfy Router 提供的全部模型,按提供方分组,并列出每个模型的输入和输出模态。" -translationSourceHash: f12be9e4 +translationSourceHash: d2265d41 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 9b1b4039 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 "BytePlus": 0ff87da0 "Elevenlabs": 7d6dbcc6 - "fal": 00f4c6b2 + "fal": 63e65674 "Freepik": 51b8af46 "Gemini Interactions": ca46b908 "Google": 4932820b @@ -23,12 +23,12 @@ translationBlockHashes: "Kling": 3002befa "Krea": 16b83e5e "LTX": 32595bf9 - "Luma": 37a12a19 + "Luma": 8cd2a7ce "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)。 @@ -53,7 +54,7 @@ translationBlockHashes: ## 按输出查找 - + - [SwitchX](/zh/development/comfy-router/models/beeble/switchx/code):`beeble/switchx` - [FLUX 3 Video](/zh/development/comfy-router/models/black-forest-labs/flux-3-video/code):`bfl/flux-3-video` @@ -89,8 +90,6 @@ translationBlockHashes: - [LTX 2.5 Fast](/zh/development/comfy-router/models/ltx/ltx-2-5-fast/code):`ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/zh/development/comfy-router/models/ltx/ltx-2-5-pro/code):`ltx/ltx-2-5-pro` - [Ray 3.2](/zh/development/comfy-router/models/luma_2/ray-3-2/code):`luma_2/ray-3.2` -- [Ray 2](/zh/development/comfy-router/models/luma/ray-2/code):`luma/ray-2` -- [Ray Flash 2](/zh/development/comfy-router/models/luma/ray-flash-2/code):`luma/ray-flash-2` - [MiniMax H3](/zh/development/comfy-router/models/minimax/minimax-h3/code):`minimax/minimax-h3` - [Image To Video](/zh/development/comfy-router/models/moonvalley/image-to-video/code):`moonvalley/image-to-video` - [Text To Video](/zh/development/comfy-router/models/moonvalley/text-to-video/code):`moonvalley/text-to-video` @@ -106,8 +105,7 @@ 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` -- [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` +- [Video Background Removal](/zh/development/comfy-router/models/veed/video-background-removal/code):`veed/video-background-removal`- [Veo 3.1 Fast Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code):`veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-generate-001/code):`veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code):`veo/veo-3.1-lite-generate-001` - [HappyHorse 1.0 I2V](/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code):`wan/happyhorse-1.0-i2v` @@ -135,7 +133,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` @@ -160,9 +158,7 @@ translationBlockHashes: - [图像编辑:重新打光](/zh/development/comfy-router/models/bria/image-edit-relight/code):`bria/image-edit-relight` - [图像编辑:引导式移除背景](/zh/development/comfy-router/models/bria/image-edit-remove-background-guided/code):`bria/image-edit-remove-background-guided` - [图像编辑:移除背景](/zh/development/comfy-router/models/bria/image-edit-remove-background/code):`bria/image-edit-remove-background` -- [图像编辑:替换背景](/zh/development/comfy-router/models/bria/image-edit-replace-background/code):`bria/image-edit-replace-background` -- [图像编辑:按文本替换对象](/zh/development/comfy-router/models/bria/image-edit-replace-object-by-text/code):`bria/image-edit-replace-object-by-text` -- [图像编辑:Reseason](/zh/development/comfy-router/models/bria/image-edit-reseason/code):`bria/image-edit-reseason` +- [图像编辑:替换背景](/zh/development/comfy-router/models/bria/image-edit-replace-background/code):`bria/image-edit-replace-background`- [图像编辑:Reseason](/zh/development/comfy-router/models/bria/image-edit-reseason/code):`bria/image-edit-reseason` - [图像编辑:修复](/zh/development/comfy-router/models/bria/image-edit-restore/code):`bria/image-edit-restore` - [图像](/zh/development/comfy-router/models/bria/image/code):`bria/image` - [Seedream 4.0 250828](/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code):`byteplus/seedream-4-0-250828` @@ -198,7 +194,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` @@ -213,9 +208,7 @@ translationBlockHashes: - [Recraft V4.1 Utility Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code):`recraft/recraftv4_1_utility_vector` - [Recraft V4.1 Utility](/zh/development/comfy-router/models/recraft/recraftv4-1-utility/code):`recraft/recraftv4_1_utility` - [Recraft V4.1 Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-vector/code):`recraft/recraftv4_1_vector` -- [Recraft V4.1](/zh/development/comfy-router/models/recraft/recraftv4-1/code):`recraft/recraftv4_1` -- [Recraft V4 Pro](/zh/development/comfy-router/models/recraft/recraftv4-pro/code):`recraft/recraftv4_pro` -- [Recraft V4 Styles Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code):`recraft/recraftv4_styles_pro_vector` +- [Recraft V4.1](/zh/development/comfy-router/models/recraft/recraftv4-1/code):`recraft/recraftv4_1`- [Recraft V4 Styles Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code):`recraft/recraftv4_styles_pro_vector` - [Recraft V4 Styles Pro](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro/code):`recraft/recraftv4_styles_pro` - [Recraft V4 Styles Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-vector/code):`recraft/recraftv4_styles_vector` - [Recraft V4 Styles](/zh/development/comfy-router/models/recraft/recraftv4-styles/code):`recraft/recraftv4_styles` @@ -270,13 +263,14 @@ translationBlockHashes: - [Wan 2.6 I2V](/zh/development/comfy-router/models/wan/wan2-6-i2v/code):`wan/wan2.6-i2v` - [Wan 2.6 R2V](/zh/development/comfy-router/models/wan/wan2-6-r2v/code):`wan/wan2.6-r2v` - [Wan 2.6 T2V](/zh/development/comfy-router/models/wan/wan2-6-t2v/code):`wan/wan2.6-t2v` -- [Wan 2.7 I2V](/zh/development/comfy-router/models/wan/wan2-7-i2v/code):`wan/wan2.7-i2v` + +- [Wan 2.7 I2V](/zh/development/comfy-router/models/wan/wan2-7-i2v/code):`wan/wan2.7-i2v` - [Wan 2.7 T2V](/zh/development/comfy-router/models/wan/wan2-7-t2v/code):`wan/wan2.7-t2v` - [Wan 3.0 Video Prime](/zh/development/comfy-router/models/wan/wan3-0-video-prime/code):`wan/wan3.0-video-prime` - [Wan 3.0 Video](/zh/development/comfy-router/models/wan/wan3-0-video/code):`wan/wan3.0-video` - + - [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 +284,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 +313,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` @@ -332,11 +325,7 @@ translationBlockHashes: - [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` -- [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 6 Sol](/zh/development/comfy-router/models/openai/gpt-6-sol/code):`openai/gpt-6-sol`- [o3](/zh/development/comfy-router/models/openai/o3/code):`openai/o3` - [Chat Completions](/zh/development/comfy-router/models/openrouter/chat-completions/code):`openrouter/chat-completions` @@ -448,7 +437,7 @@ translationBlockHashes: | [Crystal Upscaler](/zh/development/comfy-router/models/fal/crystal-upscaler/code) | `fal/crystal-upscaler` | 图像 | 图像 | | [Crystal Video Upscaler](/zh/development/comfy-router/models/fal/crystal-video-upscaler/code) | `fal/crystal-video-upscaler` | 视频 | 视频 | | [FLUX 3 Max](/zh/development/comfy-router/models/fal/flux-3-max/code) | `fal/flux-3-max` | 文本、图像 | 视频 + 音频 | -| [H3 Max Turbo](/zh/development/comfy-router/models/fal/h3-max-turbo/code) | `fal/h3-max-turbo` | 文本、图像 | 视频 + 音频 | +| [H3 Max Turbo](/zh/development/comfy-router/models/fal/h3-max-turbo/code) | `fal/h3-max-turbo` | 文本、图像、视频、音频 | 视频 + 音频 | | [H3 Max](/zh/development/comfy-router/models/fal/h3-max/code) | `fal/h3-max` | 文本、图像、视频、音频 | 视频 + 音频 | | [Patina](/zh/development/comfy-router/models/fal/patina/code) | `fal/patina` | 图像 | 图像 | @@ -543,8 +532,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` | 文本 | 图像 | -| [Ray 2](/zh/development/comfy-router/models/luma/ray-2/code) | `luma/ray-2` | 文本, 图像 | 视频 | -| [Ray Flash 2](/zh/development/comfy-router/models/luma/ray-flash-2/code) | `luma/ray-flash-2` | 文本, 图像 | 视频 | ## Luma 2 @@ -583,30 +570,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/black-forest-labs/flux-video-upscale/code.mdx b/zh/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx index c5872803d7..363488a65d 100644 --- a/zh/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx +++ b/zh/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx @@ -2,16 +2,17 @@ title: "通过 Comfy Router 使用 FLUX Video Upscale" description: "使用 Python、TypeScript 和 cURL 代码片段,通过 Comfy Router 以 HTTP 方式调用 FLUX Video Upscale 对视频进行放大,并说明请求字段与结果结构" sidebarTitle: "FLUX Video Upscale" -translationSourceHash: 0b09f0ee +translationSourceHash: 37a8dde1 translationFrom: development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx translationBlockHashes: "_intro": cf804f5f "Quick start": b745a238 - "Schema": 4675f835 + "Schema": c0dca73f "Examples": d1ffa3d6 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -170,7 +171,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - 要放大的视频,可以是 HTTP(S) URL 或 base64 编码的 MP4。来源素材最长 20 秒且不超过 50MB。 + 要放大的视频,可以是 HTTP(S) URL 或 base64 编码的 MP4。来源素材最长 20 秒、不超过 50MB,且每帧不超过 2560x1440(3.7 兆像素);来源更大时,请先缩小再提交。 @@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - 输出相对于来源分辨率的缩放倍数。输出会保留来源的宽高比,并限制在每帧约 14.4 兆像素以内,因此非常大的来源素材放大倍数会小于请求的值。 + 输出相对于来源分辨率的缩放倍数。输出会保留来源的宽高比,并限制在每帧约 14.4 兆像素以内,因此非常大的来源素材放大倍数会小于请求的值。没有分辨率选项;若要以 2K(2560x1440)或 4K(3840x2160)为目标,请用目标高度除以来源高度。720p 的来源在 2 时达到 2K,在 3 时达到 4K;1080p 的来源在 2 时达到 4K,但无法达到 2K,需要 1.33。 范围:`1.5` 到 `3` 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..3e1f36af84 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" 之一。 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index b41516a4fd..4ddd53b499 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,19 +2,20 @@ title: "使用 Dreamina Seedance 2.0 260128 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-260128:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 98890ddf +translationSourceHash: 9604ca27 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 5c27d10f + "Schema": 6c5da06a "Examples": 641c458b --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/dreamina-seedance-2-0-260128.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -196,7 +197,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque ### 输入 - 本次生成任务结果的回调通知地址 + 已忽略。仅为兼容 BytePlus 的请求结构而接受,但在提交任务前会被移除,因此不会发送任何回调;请改为轮询任务状态接口获取结果。 格式:`uri` @@ -206,23 +207,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持纯音频输入。 - 音频网址、Base64 编码或资产 ID。 -音频网址:音频的公开网址(wav、mp3)。 -Base64:格式为 data:audio/\;base64,\ -资产 ID:格式为 asset://\ + 音频 URL、Base64 编码或资产 ID。 +音频 URL:音频的公开 URL(wav, mp3)。 +Base64:格式 data:audio/\;base64,\ +资产 ID:格式 asset://\ - 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用该 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些参数。分辨率默认为且仅支持 1080p。 + 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、duration、ratio、seed、generate_audio 和 omni_reference_task_type;不要再次发送这些内容。resolution 默认为且仅支持 1080p。 - 使用 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 + 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 @@ -231,9 +232,9 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片网址:请确保图片网址可访问。 -Base64 编码的内容:格式必须为 data:image/\;base64,\ -资产 ID:格式为 asset://\ +图片 URL:确保图像 URL 可访问。 +Base64 编码内容:格式必须为 data:image/\;base64,\ +资产 ID:格式 asset://\ @@ -242,36 +243,33 @@ Base64 编码的内容:格式必须为 data:image/\;base64,\ 对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 模型输入的文本信息。包含文本提示词和可选参数。 + 模型的输入文本信息。包括文本提示词和可选参数。 -文本提示词(必填):使用中文和英文字符描述要生成的视频。 +文本提示词(必填):使用中英文字符描述要生成的视频。 参数(可选):在文本提示词后添加 --[parameters] 以控制视频规格: -- --resolution(--rs):480p、720p、1080p(默认:720p) -- --ratio(--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) -- --duration(--dur):3-12 秒(默认:5) -- --framepersecond(--fps):24(默认:24) -- --watermark(--wm):true/false(默认:false) -- --seed(--seed):-1 至 2^32-1(默认:-1) -- --camerafixed(--cf):true/false(默认:false) +- --resolution (--rs): 480p, 720p, 1080p(默认:720p) +- --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive(默认:16:9 或 adaptive) +- --duration (--dur): 3-12 秒(默认:5) +- --framepersecond (--fps): 24(默认:24) +- --watermark (--wm): true/false(默认:false) +- --seed (--seed): -1 到 2^32-1(默认:-1) +- --camerafixed (--cf): true/false(默认:false) 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 侧的保护性限制,并非 BytePlus 的约束。BytePlus 未公布文本长度限制,在测试中接受了 40,000 个字符(2026-09-17)。 -它按字符计数而非字节,因此多字节的提示词在传输时可能达到该数值的数倍。它约束的是这一个字段,而不是整个请求: -`content` 是一个数组,整体文档受每次请求的体积上限约束。实施该限制的界面是 -Comfy Router(/v2/models/byteplus/\{model});直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器给出响应。 -该值设置得远高于真实流量,因此它绝不会对真实提示词做出判定:如果调用方需要更多,可以提高该值。 +Comfy 侧的保护措施,并非 BytePlus 的限制。BytePlus 未公布文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符而非字节计数,因此多字节提示词在传输时可能达到该大小的数倍。它只限制这一个字段,而不是整个请求:`content` 是数组,真正限制整个文档的是每个请求的正文大小上限。执行该限制的是 Comfy Router (/v2/models/byteplus/\{model});直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器响应。该值设置得远高于真实流量,因此它不会对真实提示词进行判定;如果调用方需要更多,请调高该值。 输入内容的类型 - 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -279,108 +277,123 @@ Comfy Router(/v2/models/byteplus/\{model});直接调用 v1 /proxy 时, - 视频网址或资产 ID。 -视频网址:视频的公开网址(mp4、mov)。 -资产 ID:格式为 asset://\ + 视频 URL 或资产 ID。 +视频 URL:视频的公开 URL(mp4, mov)。 +资产 ID:格式 asset://\ - 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;分辨率必须为 480p。 + 仅 Seedance 2.5。生成 480p Draft 视频;resolution 必须为 480p。 将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 视频时长(秒)。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 - 范围:`2` 至 `30` + 范围:`2` 到 `30` - 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值(秒)。默认 172800(48h)。范围:[3600, 259200]。 - 范围:`3600` 至 `259200` + 范围:`3600` 到 `259200` Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 true:模型输出带同步音频的视频。 false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 +对于支持该参数的模型,提供商会将已生成的音轨与视频分开进行内容检查;此处的拒绝会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本可以接受的输入,这种拒绝可能会间歇性出现。如果发生这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求尚无法标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接调用 v1 的 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供该值:代理会拒绝任何其他值,若省略该值则返回 400。它不在本结构的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接向 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起的 v1 调用必须提供它:代理会以 400 拒绝任何其他值以及省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 - 仅 Seedance 2.5 支持。输出视频的容器格式。mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅适用于 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`、`mov` + 可选值:`mp4`,`mov` 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会沿用首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 +Seedance 2.5 首帧 / 首末帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可选值:`16:9`,`4:3`,`1:1`,`3:4`,`9:16`,`21:9`,`9:21`,`adaptive` 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可选值:`480p`,`720p`,`1080p`,`4k` 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将该参数设置为 true 后,你可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false:不返回已生成视频的最后一帧图像。 +true: 返回已生成视频的最后一帧图像。将该参数设置为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +false: 不返回已生成视频的最后一帧图像。 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 - 范围:`-1` 至 `4294967295` + 范围:`-1` 到 `4294967295` - 处理所用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可选值:`default`,`flex` - 已生成视频是否包含水印。 + 已生成的视频是否包含水印。 -由 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前 Router 用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 - 视频生成任务完成后返回的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时包含其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处其他所有字段均来自 BytePlus 本身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在之后轮询到的成功文档可能不带 `content` 字段,或该字段为 null。 + 视频生成任务完成后的输出,其中包含输出视频的下载 URL,以及当 BytePlus 返回最后一帧时该帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储上;此处的其他所有字段都是 BytePlus 自己的。可为空:BytePlus 会在任务之后 24 小时清除这些 URL,而之后轮询一个已成功的文档时,可能遇到 `content` 缺失或为 null。 - 生成视频最后一帧的下载 URL,在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定类型,只有在两者都失败时才回退为 `image/jpeg`。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的缓存中重放,因此之后的轮询可能返回一个仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种方式,链接都会过期,因此请下载该帧,而不要保存 URL。 + 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定其类型,而 `image/jpeg` 只是两者都失败时的最后回退手段。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时有效期为 24 小时,并从 23 小时备忘记录中重放,所以之后的轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段改为保留 BytePlus 自己的 URL,BytePlus 会在任务之后 24 小时清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是存储 URL。 - 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时提供。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,请参阅顶层的 `output_format` 字段。Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 中时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,请参阅顶层 `output_format` 字段,Router 会读取两者中存在的那个。 + + + + 上游 URL 停止工作的 RFC 3339 时间:最早签名时间加上这些 URL 自身携带的有效期,当存在 `updated_at` 时,它绝不晚于任务的 `updated_at` 加 24 小时(即 BytePlus 文档中说明的 URL 有效期);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时才出现;当两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + + Format: `date-time` + + + + BytePlus 自己的最后一帧下载 URL,会与重新托管的 `last_frame_url` 一起逐字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,一旦 BytePlus 清除它就会缺失,并且在 `upstream_expires_at` 之前是持有者凭证。 + + + + BytePlus 自己的输出视频下载 URL,会与重新托管的 `video_url` 一起逐字节原样返回。仅对由 Comfy 已在服务器端选择加入的工作区轮询的 Seedance 2.x 任务存在(没有请求参数);对其他所有情况都缺失,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥);一旦 BytePlus 在生成后 24 小时清除其 URL,也会缺失。它是对象存储预签名 URL,因此是持有者凭证:任何持有它的人都可以在过期前下载视频,所以请将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次由 Router 自己的重新托管操作消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的缓存中重放,因此之后的轮询可能返回一个仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除该 URL,并且在某些模型上将其下载次数上限设为 100 次。无论哪种方式,链接都会过期,因此请下载该视频,而不要保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时有效期为 24 小时,并从 23 小时备忘记录中重放,所以之后的轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段改为保留 BytePlus 自己的 URL,BytePlus 会在任务之后 24 小时清除它,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是存储 URL。 - 任务创建的时间。该值为 UNIX 时间戳(秒)。 + 任务创建时间。该值为以秒为单位的 UNIX 时间戳。 - 生成视频的时长(秒)。声明为数字而非整数,是因为 BytePlus 在这点上并不一致:观察到视频任务返回整秒数,而 BytePlus 的其他同类接口会报告小数时长,因此客户端不能假定其为整数值。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的时长,单位为秒。声明为数字而不是整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同类接口报告小数时长,因此客户端不得假定该值为整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 @@ -388,7 +401,7 @@ false:不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示因内容策略而被拒绝。同一系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证失败和提供商失败。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略系列,但不会覆盖传输层失败。 + 上游 ModelArk 错误代码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个错误码家族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他代码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略家族,而不会覆盖传输故障。 @@ -404,31 +417,31 @@ false:不返回已生成视频的最后一帧图像。 - 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回:这正是 Seedance 视频任务查询返回它的位置。这是 BytePlus 自有字段,原样转发。 + 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是由此返回该字段。这是 BytePlus 自有字段,原样转发。 - 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 - 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 格式:`int64` - 任务的状态 + 任务状态 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - 任务最后更新的时间。该值为 UNIX 时间戳(秒)。 + 任务最后更新的时间。该值为 UNIX 时间戳,单位为秒。 - 该请求的 token 用量 + 请求的 token 用量 @@ -436,7 +449,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数,默认为 0。因此,total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认为 0。因此,total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 25f2608e22..e3b70a93fc 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,17 +2,18 @@ title: "使用 Comfy Router 调用 Dreamina Seedance 2.0 Fast 260128" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-fast-260128:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: acad6428 +translationSourceHash: b02c6ed1 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": a00368da + "Schema": e03c503a "Examples": 7714eccd --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -181,7 +182,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### 输入 - 本次生成任务结果的回调通知地址 + 会被忽略。为兼容 BytePlus 的请求结构而接受,但在任务提交之前会被移除,因此不会发送任何回调;请改为轮询任务状态路由来获取结果。 格式:`uri` @@ -191,23 +192,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须包含至少 1 个图像或视频;Seedance 2.5 支持纯音频输入。 - 音频 URL、Base64 编码或资产 ID。 -音频 URL:音频的公开 URL(wav、mp3)。 + 音频网址、Base64 编码或资产 ID。 +音频网址:音频的公开网址(wav、mp3)。 Base64:格式为 data:audio/\;base64,\ 资产 ID:格式为 asset://\ - 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次提交这些内容。分辨率默认为且仅支持 1080p。 + 仅 Seedance 2.5 适用。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、duration、ratio、seed、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为且仅支持 1080p。 - 创建 Draft 视频(`draft` 设为 true)时返回的任务 ID。 + 在 `draft` 设置为 true 的情况下创建 Draft 视频时返回的任务 ID。 @@ -216,45 +217,37 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图像 URL:请确保图像 URL 可访问。 +图片网址:请确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ 内容项的角色/位置。 -对于图像:first_frame、last_frame 或 reference_image。 -对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 -对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +图像:first_frame、last_frame 或 reference_image。 +视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 可选值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 供模型使用的输入文本信息。包括文本提示词和可选参数。 + 供模型使用的输入文本信息。包含文本提示词和可选参数。 文本提示词(必填):使用中英文字符描述要生成的视频。 -参数(可选):在文本提示词后添加 --[parameters] 以控制视频规格: -- --resolution (--rs):480p、720p、1080p(默认:720p) -- --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) -- --duration (--dur):3-12 秒(默认:5) -- --framepersecond (--fps):24(默认:24) -- --watermark (--wm):true/false(默认:false) -- --seed (--seed):-1 到 2^32-1(默认:-1) -- --camerafixed (--cf):true/false(默认:false) - -示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -Comfy 侧的护栏限制,而非 BytePlus 的约束。BytePlus 未公布 -文本长度限制,且在测试(2026-09-17)中接受了 40,000 个字符。 -它按字符计数,而非字节,因此多字节提示词在传输时可能是 -该大小的数倍。它约束的是这一个字段,而不是请求本身: -`content` 是一个数组,整个文档受每个请求的请求体限制约束。 -Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; -在直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器来响应。 -其设置远高于真实流量,因此绝不会对真实提示词做出裁决。如果调用方 -需要更多,可以调高它。 +参数(可选):在文本提示词之后添加 --[parameters] 以控制视频规格: +- --resolution (--rs):480p、720p、1080p(默认值:720p) +- --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认值:16:9 或 adaptive) +- --duration (--dur):3-12 秒(默认值:5) +- --framepersecond (--fps):24(默认值:24) +- --watermark (--wm):true/false(默认值:false) +- --seed (--seed):-1 到 2^32-1(默认值:-1) +- --camerafixed (--cf):true/false(默认值:false) + +示例:“A beautiful landscape --ratio 16:9 --resolution 720p --duration 5” + +这是 Comfy 侧的防护措施,而非 BytePlus 的限制。BytePlus 未公布文本长度上限,并在测试中接受了 40,000 个字符(2026-09-17)。它按字符而非字节计数,因此一个多字节的提示词在传输时可能达到该大小的数倍。它约束的是这一个字段,而不是整个请求:`content` 是一个数组,整个文档由每个请求的请求体上限来约束。执行该限制的是 Comfy Router(/v2/models/byteplus/\{model});在直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器应答。该上限设置得远高于真实流量,因此它从不对真实的提示词作出裁决:如果调用方需要更多,可以提高该值。 @@ -268,116 +261,130 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; - 视频 URL 或资产 ID。 -视频 URL:视频的公开 URL(mp4、mov)。 + 视频网址或资产 ID。 +视频网址:视频的公开网址(mp4、mov)。 资产 ID:格式为 asset://\ - 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5 适用。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - 视频时长(秒)。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 范围:`2` 到 `30` - 任务超时阈值(秒)。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值,单位为秒。默认值为 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true:模型输出带有同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 +true: 模型输出带同步音频的视频。 +false: 模型输出无声视频。在支持该功能的模型上,生成的音轨会由提供商与视频分开进行内容检查;如果此处被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本接受的输入,这种拒绝可能间歇性出现。如果发生这种情况,请为静音视频发送 `false`;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其标识为 `refusal_subject: output_audio`(已排队请求尚无法标识它)。Seedance 2.5 的最终渲染会从它的 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接以 v1 调用 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供它,代理会拒绝任何其他值,若省略则以 400 拒绝。它不在此模式的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方可省略。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接向 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时,必须提供它;代理会以 400 拒绝任何其他值以及省略它的请求。它不在此 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段中填充它,因此 Router 调用方会省略它。 - 仅 Seedance 2.5。输出视频的容器格式。mp4:通用容器(H.264/AAC,yuv420p),兼容性广泛且文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅限 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件更大。 - 可选值:`mp4`、`mov` + 可能的值:`mp4`、`mov` - 已生成视频的宽高比例。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认值:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会沿用首帧的宽高比例,因此只接受 `adaptive`(或省略该字段);若指定具体比例,会在派发前以 400 拒绝。Seedance 2.0 在这些模式下可以接受具体比例。 + 已生成视频的比例。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认值:adaptive。 +Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的比例,因此仅接受 `adaptive`(或省略该字段);具体比例会在派发前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认值:720p。Seedance 1.0 pro 与 pro-fast 默认值:1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认值:720p。Seedance 1.0 pro 和 pro-fast 默认值:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` - 是否返回已生成视频的尾帧图像。 -true:返回已生成视频的尾帧图像。将该参数设为 true 之后,可通过调用查询视频生成任务信息来获取尾帧图像。尾帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用该参数可以生成多个连续的视频:将前一个已生成视频的尾帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 -false:不返回已生成视频的尾帧图像。 + 是否返回已生成视频的最后一帧图像。 +true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +false: 不返回已生成视频的最后一帧图像。 - 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 + 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。 范围:`-1` 到 `4294967295` - 用于处理的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可能的值:`default`、`flex` 已生成视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。 +根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前验证调用所依据的同一份文档。 ### 输出 - 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里其他所有字段都是 BytePlus 自有的。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,此后轮询到的 succeeded 文档可能缺失 `content` 或其为 null。 + 视频生成任务完成后得到的输出,包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里的其他字段都是 BytePlus 自己的。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,之后轮询到的成功文档可能不带 `content`,或其为 null。 - 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据该 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任何字节,并根据上游的 Content-Type 或内容嗅探来判定其类型,只有在两者都失败时才以 `image/jpeg` 作为最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写该字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时签名有效期为 24 小时,并从 23 小时的备忘缓存中重放,所以稍后的一次轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后将其清除。无论哪种情况,链接都会过期,因此请下载该帧,而不要只保存 URL。 + 已生成视频最后一帧的下载 URL,仅在请求设置了 `return_last_frame` 时返回。不要根据该 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定类型,`image/jpeg` 只是两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写该字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从一条 23 小时的缓存记录中重放,因此更晚的轮询可能拿到只剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它。无论哪种方式链接都会过期,因此请下载该帧,而不要存储 URL。 - 已生成视频的容器格式(mp4 或 mov),在 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段,Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时提供。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段,Router 会读取两者中存在的那一个。 + + + + 上游 URL 失效的 RFC 3339 时间:由这些 URL 自身携带的最早签名时间加有效期得出,当 `updated_at` 存在时不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档记载的 URL 生存期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时才存在,当两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生存期无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并排逐字节返回,适用条款与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即不存在,并且在 `upstream_expires_at` 之前属于 bearer 凭证。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并排逐字节返回。仅当任务是由 Comfy 在服务端选择加入的工作区轮询的 Seedance 2.x 任务时才存在(没有请求参数);对其他所有情况都不存在,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在生成 24 小时后 BytePlus 清除其 URL 后也不存在。它是一个预签名的对象存储 URL,因此是一种 bearer 凭证:任何持有它的人都能在它过期前下载视频,所以要像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写该字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时签名有效期为 24 小时,并从 23 小时的备忘缓存中重放,所以稍后的一次轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后将其清除,并且在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要只保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写该字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从一条 23 小时的缓存记录中重放,因此更晚的轮询可能拿到只剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上将其限制为 100 次下载。无论哪种方式链接都会过期,因此请下载视频,而不要存储 URL。 - 任务的创建时间。该值为 UNIX 时间戳,单位为秒。 + 任务创建的时间。该值为 UNIX 时间戳,单位为秒。 - 已生成视频的时长,单位为秒。声明为 number 而不是 integer,是因为 BytePlus 在这一点上并不一致:视频任务曾观察到返回整数秒,而同类的 BytePlus 接口会报告小数时长,因此客户端不能假定它是整数值。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这方面并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他同级接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 - 错误信息。任务成功时返回 null。任务失败时返回错误信息。 + 错误信息。如果任务成功,返回 null。如果任务失败,则返回错误信息。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一族系可以带以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略族系,而不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一个族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放的字符串,而非枚举:其他错误码描述验证失败和提供商失败。Router 会在 HTTP 400 错误封装和 HTTP 200 失败任务响应中识别策略族,但不会覆盖传输层失败。 @@ -389,19 +396,19 @@ false:不返回已生成视频的尾帧图像。 - 任务所用模型的名称和版本 + 任务所使用的模型名称和版本 - 已生成视频的容器格式(mp4 或 mov),作为 `content` 的同级字段在顶层返回:Seedance 视频任务查询就是在这里返回它的。这是 BytePlus 自有字段,原样转发。 + 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询会在此处返回该字段。BytePlus 自有字段,原样转发。 - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务中返回并原样转发。 - 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 任务实际使用的生成种子。BytePlus 自有字段,在成功的视频任务中返回并原样转发。 格式:`int64` @@ -409,7 +416,7 @@ false:不返回已生成视频的尾帧图像。 任务状态 - 可选值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` @@ -425,7 +432,7 @@ false:不返回已生成视频的尾帧图像。 - 对于视频生成模型,输入 token 数量不予计算,默认为 0。因此 total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认值为 0。因此,total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 64e063d836..a931a5b8a5 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,17 +2,18 @@ title: "通过 Comfy Router 使用 Dreamina Seedance 2.0 Mini" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-mini:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 69d38df7 +translationSourceHash: 28c5c053 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 2279819f + "Schema": 3c26a330 "Examples": db01067e --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/dreamina-seedance-2-0-mini.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -181,7 +182,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 输入 - 本次生成任务结果的回调通知地址 + 忽略。为兼容 BytePlus 请求结构而接受,但在提交任务前会被移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。 格式:`uri` @@ -191,7 +192,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须包含至少 1 张图像或视频;Seedance 2.5 支持纯音频输入。 @@ -202,12 +203,12 @@ Base64:格式为 data:audio/\;base64,\ - 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用该 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。分辨率默认为且仅支持 1080p。 + 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送它们。resolution 默认为且仅支持 1080p。 - 创建 Draft 视频(`draft` 设为 true)时返回的任务 ID。 + 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 @@ -215,8 +216,8 @@ Base64:格式为 data:audio/\;base64,\ - 用于图生视频的图像内容(当 type 为 "image_url" 时) -图片 URL:请确保该图片网址可访问。 + 用于图生视频生成的图像内容(当 type 为 "image_url" 时) +图片网址:请确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ @@ -224,18 +225,18 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 内容项的角色/位置。 对于图像:first_frame、last_frame 或 reference_image。 -对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持)。 -对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持)。 +对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可选值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 模型的输入文本信息。包含文本提示词和可选参数。 + 供模型使用的输入文本信息。包括文本提示词和可选参数。 -文本提示词(必填):使用中英文字符描述要生成的视频。 +文本提示词(必填):使用中文和英文字符描述要生成的视频。 -参数(可选):在文本提示词后添加 --[parameters] 来控制视频规格: +参数(可选):在文本提示词后添加 --[parameters] 以控制视频规格: - --resolution (--rs):480p、720p、1080p(默认:720p) - --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) - --duration (--dur):3-12 秒(默认:5) @@ -246,13 +247,20 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -这是 Comfy 侧的护栏,并非 BytePlus 的限制。BytePlus 未公布文本长度上限,且在测试(2026-09-17)中接受了 40,000 个字符。它统计的是字符而非字节,因此多字节提示词在传输时可能达到该数值的若干倍。它限制的是这一个字段,而不是整个请求:`content` 是一个数组,约束整个文档的是每个请求的请求体上限。执行该限制的是 Comfy Router(/v2/models/byteplus/\{model});在直接进行 v1 /proxy 调用时,则由 BytePlus 自身的校验器负责响应。该值被设置得远高于真实流量,因此它永远不会对真实提示词做出判定。如果调用方需要更多,可以提高该值。 +Comfy 侧护栏,不是 BytePlus 的限制。BytePlus 未发布 +文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符而不是字节计数,因此多字节提示词在传输时可能达到 +此大小的数倍。它限制的是这一个字段,而不是请求: +`content` 是数组,而整个文档受每请求正文限制约束。 +Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; +在直接调用 v1 /proxy 时,则由 BytePlus 自己的验证器应答。 +设置得远高于真实流量,以便它永远不会裁决真正的提示词。如果调用方需要更多,请提高该值。 输入内容的类型 - 可选值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -266,8 +274,8 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 放入 `draft_task` 内容项中,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5。生成 480p Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 @@ -283,32 +291,32 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true:模型输出带同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 + 由 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 +true: 模型输出带有同步音频的视频。 +false: 模型输出无声视频。在支持该功能的模型上,已生成的音频轨道由提供商与视频分开进行内容审核;若音频被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本接受的输入,也可能间歇性出现。若发生这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其命名为 `refusal_subject: output_audio`(排队中的请求尚无法识别它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接对 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时,必须提供该字段:代理会以 400 拒绝任何其他值,以及未提供该字段的请求。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方无需提供。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接向 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时,必须提供它:代理会拒绝任何其他值并返回 400,省略该值时也会返回 400。它不在此 schema 的 `required` 列表中,因为 Comfy Router 会从 `/v2/models/byteplus/\{model}` 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 - 仅 Seedance 2.5 支持。输出视频的封装格式。mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 可选值:`mp4`、`mov` - 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认值:adaptive。 -Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 + 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧/首尾帧生成:输出遵循首帧的宽高比,因此仅接受 `adaptive`(或省略该字段);具体比例会在调度前被拒绝并返回 400。Seedance 2.0 在这些模式下接受具体比例。 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认值:720p。Seedance 1.0 pro 与 pro-fast 默认值:1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 可选值:`480p`、`720p`、`1080p`、`4k` @@ -316,8 +324,8 @@ Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的宽高比,因此 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将此参数设为 true 之后,您可以通过调用查询视频生成任务信息接口获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续的视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续的视频。 -false:不返回已生成视频的最后一帧图像。 +true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +false: 不返回已生成视频的最后一帧图像。 @@ -327,7 +335,7 @@ false:不返回已生成视频的最后一帧图像。 - 处理所用的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 可选值:`default`、`flex` @@ -336,32 +344,46 @@ false:不返回已生成视频的最后一帧图像。 已生成视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` 上提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的是同一份文档。 +根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` 提供的 schema 生成,此文档也是它在请求到达提供商之前校验调用时所依据的同一文档。 ### 输出 - 视频生成任务完成后返回的输出内容,其中包含输出视频的下载 URL,以及 BytePlus 返回时附带的末帧下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处的其他所有字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在那之后轮询一个已成功的文档,其 `content` 可能缺失或为 null。 + 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL;当 BytePlus 返回最后一帧时,还包含最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储;这里的其他所有字段均来自 BytePlus 本身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,而在此之后轮询已成功的文档时,`content` 可能缺失或为 null。 - 已生成视频末帧的下载 URL,仅在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将末帧记录为 PNG,Router 会把收到的任何字节重新托管,并根据上游的 Content-Type 或内容嗅探来确定其类型,只有当两者都失败时才会最后退回到 `image/jpeg`。Router 会将末帧重新托管到 Comfy 存储上并重写此字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL(签发时按 24 小时签名,但从 23 小时的备忘录中回放,因此之后的轮询可能返回一个仅剩一小时有效期的 URL)。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载末帧,而不要保存 URL。 + 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧指定为 PNG,Router 会重新托管其收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定其类型,只有当两者都失败时,`image/jpeg` 才作为最后的回退。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长为 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,因此较晚的轮询可能返回仅剩一小时有效期的 URL。如果无法执行重新托管,该字段会改为保留 BytePlus 自己的 URL;BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种情况,链接都会过期,因此请下载该帧,而不是保存 URL。 - 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时返回。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段;Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时提供。Seedance 模型更常将其作为 `content` 的顶层同级字段返回(见顶层 `output_format` 字段),Router 会读取两者中存在的那个。 + + + + 上游 URL 停止工作的时间,采用 RFC 3339 格式:URL 自身携带的最早签名时间加有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档给出的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时提供,当两个来源都未给出时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 一起逐字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即不再提供,并且在 `upstream_expires_at` 之前是持有者凭证。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一起逐字节原样返回。仅当轮询 Seedance 2.x 任务的工作区已在服务器端由 Comfy 选择加入时才提供(没有请求参数);对其他所有情况均不提供,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且一旦 BytePlus 在生成 24 小时后清除其 URL,也会不再提供。它是预签名对象存储 URL,因此也是持有者凭证:任何持有它的人都能在过期前下载视频,所以请像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并重写此字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL(签发时按 24 小时签名,但从 23 小时的备忘录中回放,因此之后的轮询可能返回一个仅剩一小时有效期的 URL)。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它,并且某些模型上该 URL 最多只允许 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长为 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,因此较晚的轮询可能返回仅剩一小时有效期的 URL。如果无法执行重新托管,该字段会改为保留 BytePlus 自己的 URL;BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是保存 URL。 - 任务的创建时间。该值为 UNIX 时间戳,单位为秒。 + 任务创建时间。该值是 UNIX 时间戳,单位为秒。 - 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这一点上并不一致:视频任务曾被观察到返回整数秒,而同属 BytePlus 的其他接口则报告带小数的时长,因此客户端不能假定其为整数值。这是 BytePlus 的自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的时长,单位为秒。声明为数字而非整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同级接口会反馈小数时长,因此客户端不得假定该值为整数。BytePlus 自己的字段,在已成功的视频任务上返回,并原样转发。 @@ -369,47 +391,46 @@ false:不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一族错误可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误响应体和 HTTP 200 失败任务响应中识别策略族,且不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 标识内容策略拒绝。某个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是开放字符串,而非枚举:其他错误码用于描述验证与提供商失败。Router 能在 HTTP 400 错误封装和 HTTP 200 失败任务响应中识别策略系列,但不会覆盖传输失败。 报错信息 - - 视频生成任务的 ID +视频生成任务的 ID - 任务所用模型的名称和版本 + 该任务使用的模型名称及版本 - 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,这正是 Seedance 视频任务查询返回它的位置。BytePlus 的自有字段,原样转发。 + 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的兄弟字段返回,Seedance 视频任务查询即在此处返回该字段。这是 BytePlus 自有字段,原样透传。 - 已生成视频的分辨率,例如 `1080p`。BytePlus 的自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,原样透传。 - 该任务实际使用的生成种子。BytePlus 的自有字段,在成功的视频任务中返回并原样转发。 + 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,原样透传。 - 格式: `int64` + 格式:`int64` - 任务状态 + 任务的状态 - 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 可能的值:`queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - 任务的最后更新时间。该值为 UNIX 时间戳,单位为秒。 + 任务最后更新的时间。该值为 UNIX 时间戳,单位为秒。 - 该请求的 token 用量 + 本次请求的 token 用量 @@ -417,7 +438,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认为 0。因此,total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认为 0。因此 total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 9b6d4ea687..6b83dea46c 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,18 +2,19 @@ title: "使用 Dreamina Seedance 2.5 260628 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-5-260628:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 9a342bd4 +translationSourceHash: 07fd9c64 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0467a987 + "Schema": 0a76af44 "Examples": 5465695b --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -194,17 +195,17 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 输入 - 本次生成任务结果的回调通知地址 + 已忽略。为兼容 BytePlus 的请求形状而接受,但在提交任务之前就会被移除,因此永远不会发送回调;请改为轮询任务状态路由来获取结果。 格式:`uri` - 模型生成视频的输入内容 + 供模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0 和 2.0 fast、2.0 mini 支持音频输入。Seedance 2.0 和 2.0 fast、2.0 mini 不能单独使用音频,必须至少包含 1 张图像或 1 段视频;Seedance 2.5 支持纯音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 与 2.0 mini 不能仅使用音频,必须包含至少 1 个图像或视频;Seedance 2.5 支持仅音频输入。 @@ -215,12 +216,12 @@ Base64:格式为 data:audio/\;base64,\ - 仅 Seedance 2.5。要渲染为最终视频的草稿任务。它必须是唯一的内容项。 -最终视频会复用草稿任务的提示词、输入资产、时长、比例、种子、generate_audio 以及 omni_reference_task_type;请勿再次发送这些内容。分辨率默认为且仅支持 1080p。 + 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。分辨率默认为且仅支持 1080p。 - 创建草稿视频时(`draft` 设置为 true)返回的任务 ID。 + 使用 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 @@ -229,7 +230,7 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图像 URL:请确保该图像 URL 可访问。 +图片网址:请确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ @@ -237,41 +238,46 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 内容项的角色/位置。 对于图像:first_frame、last_frame 或 reference_image。 -对于视频:reference_video(仅 Seedance 2.5、2.0 和 2.0 fast、2.0 mini)。 -对于音频:reference_audio(仅 Seedance 2.5、2.0 和 2.0 fast、2.0 mini)。 +对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 +对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 - 可选值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 模型的输入文本信息。包含文本提示词和可选参数。 + 供模型使用的输入文本信息。包含文本提示词和可选参数。 -文本提示词(必填):使用中英文字符描述要生成的视频。 +文本提示词(必填):使用中文和英文字符描述要生成的视频。 -参数(可选):在文本提示词后添加 --[参数] 以控制视频规格: -- --resolution (--rs):480p、720p、1080p(默认:720p) -- --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) -- --duration (--dur):3-12 秒(默认:5) -- --framepersecond (--fps):24(默认:24) -- --watermark (--wm):true/false(默认:false) -- --seed (--seed):-1 到 2^32-1(默认:-1) -- --camerafixed (--cf):true/false(默认:false) +参数(可选):在文本提示词之后添加 --[parameters] 以控制视频规格: +- --resolution(--rs):480p、720p、1080p(默认:720p) +- --ratio(--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) +- --duration(--dur):3-12 秒(默认:5) +- --framepersecond(--fps):24(默认:24) +- --watermark(--wm):true/false(默认:false) +- --seed(--seed):-1 到 2^32-1(默认:-1) +- --camerafixed(--cf):true/false(默认:false) 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -这是 Comfy 侧的保护性限制,并非 BytePlus 的约束。BytePlus 未公布文本长度限制,测试中接受了 40,000 个字符(2026-09-17)。 -它统计的是字符而非字节,因此多字节提示词在传输时可能达到该大小的数倍。它限制的是这一个字段,而不是整个请求: -`content` 是一个数组,整个文档受每请求正文限制的约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;而在直接的 v1 /proxy 调用中,由 BytePlus 自己的校验器负责处理。该值设置得远高于真实流量,因此绝不会对真实提示词做出裁定。如果调用方需要更多,请提高该值。 +这是 Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布 +文本长度限制,并且在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符而非字节计数,因此多字节提示词在网络传输时可能达到该值的 +数倍。它限定的是这一个字段,而不是整个请求: +`content` 是数组,整个文档由每请求的请求体上限来限定。 +执行该限制的是 Comfy Router(/v2/models/byteplus/\{model}); +若直接调用 v1 /proxy,则由 BytePlus 自己的校验器给出答复。 +该值设置得远高于真实流量,因此它永远不会裁决真实的提示词;如果调用方需要更多,可以提高该值。 输入内容的类型 - 可选值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 输入视频对象。仅 Seedance 2.5、2.0 和 2.0 fast、2.0 mini 支持视频输入。 + 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持视频输入。 @@ -281,60 +287,58 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 仅 Seedance 2.5。生成 480p 草稿视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项即可渲染最终的 1080p 视频。草稿任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 +在 `draft_task` 内容项中传入返回的任务 ID,以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 - 视频时长(秒)。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0 和 2.0 fast、2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 与 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 范围:`2` 到 `30` - 任务超时阈值(秒)。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true:模型输出带同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 + 由 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 +true:模型输出带有同步音频的视频。 +false:模型输出无声视频。在支持此功能的模型上,生成的音轨会由提供商与视频分开进行内容检查;若此处被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频不同,对于提供商原本会接受的输入,这种拒绝可能间歇性出现。若发生这种情况,请发送 `false` 以生成无声视频;仅当被拒绝的模态是音频时,这样做才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求尚不会标识这一点)。Seedance 2.5 的最终渲染会继承其 Draft 任务的 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接对 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时必须提供它:代理会拒绝任何其他值以及省略的值,并返回 400。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方可以省略。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接对 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时必须提供它:代理会拒绝任何其他值以及省略该值的情况,并返回 400。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 - 仅 Seedance 2.5。输出视频的容器格式。 - -mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅限 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`、`mov` + 可能的值:`mp4`, `mov` - 已生成视频的宽高比。Seedance 2.0 与 2.0 fast、2.0 mini、1.5 pro 默认值:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);若指定具体比例,会在派发之前以 400 拒绝。在这些模式下,Seedance 2.0 接受具体比例。 + 已生成视频的宽高比。Seedance 2.0、2.0 fast、2.0 mini 和 1.5 pro 的默认值:adaptive。 +Seedance 2.5 的首帧/首尾帧生成:输出会遵循首帧的宽高比,因此仅接受 `adaptive`(或省略该字段);具体比例会在调度前被拒绝并返回 400。Seedance 2.0 在这些模式下接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 视频分辨率。Seedance 2.5、2.0 与 2.0 fast、2.0 mini、1.5 pro、1.0 lite 默认值:720p。Seedance 1.0 pro 与 pro-fast 默认值:1080p。 -注意:Seedance 2.0 与 2.0 fast、2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro 和 1.0 lite 的默认值:720p。Seedance 1.0 pro 和 pro-fast 的默认值:1080p。 +注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`, `720p`, `1080p`, `4k` 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将该参数设为 true 后,你可以通过查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false:不返回已生成视频的最后一帧图像。 +true: 返回已生成视频的最后一帧图像。将此参数设为 true 后,可以通过调用“查询视频生成任务信息”来获取最后一帧图像。该最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不含水印。使用此参数可以生成多个连续视频:将先前生成的视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +false: 不返回已生成视频的最后一帧图像。 @@ -344,49 +348,63 @@ false:不返回已生成视频的最后一帧图像。 - 用于处理的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可能的值:`default`, `flex` - 已生成的视频是否包含水印。 + 已生成视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` 提供的 schema 生成,请求到达提供商之前,Router 校验调用时使用的也是同一份文档。 +根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` 提供的 schema 生成,该 schema 也是它在请求到达提供商之前用于校验调用的同一文档。 ### 输出 - 视频生成任务完成后返回的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处的其他所有字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此之后轮询到的已成功文档可能不带 `content` 或将其置为 null。 + 视频生成任务已完成后的输出,包含输出视频的下载 URL,以及 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储;这里的其他字段均由 BytePlus 提供。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在此之后轮询已成功的文档时,`content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL,仅在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定其类型,`image/jpeg` 只是两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是有效的 Comfy 签名 URL,最长有效 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以后续轮询返回的 URL 可能只剩不到一小时的有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不要保存 URL。 + 已生成视频最后一帧的下载 URL,在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管其收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定类型,而 `image/jpeg` 仅在两者都失败时作为最后的兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是由 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时缓存中重放,因此之后的轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会改为保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种方式,链接都会过期,因此请下载该帧,而不是存储 URL。 - 已生成视频的容器格式(mp4 或 mov),前提是 BytePlus 将其嵌套在 `content` 内。Seedance 模型更常将它作为 `content` 的顶层同级字段返回,请参见顶层 `output_format` 字段,Router 会读取两者中存在的那一个。 + 当 BytePlus 将其嵌套在 `content` 内时,表示已生成视频的容器格式(mp4 或 mov)。Seedance 模型更常将其作为 `content` 的顶层同级字段返回;请参阅顶层的 `output_format` 字段。Router 会读取两者中存在的那个。 + + + + RFC 3339 时间,表示上游 URL 停止工作的时间:最早的签名时间加上这些 URL 自身携带的有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生存期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时才提供,当两个来源都未给出时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列逐字节返回,适用条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即不存在,并且在 `upstream_expires_at` 之前是一种 bearer 凭证。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列逐字节返回。仅当 Seedance 2.x 任务由 Comfy 已在服务器端选择加入的工作区轮询时才提供(没有请求参数);其他所有情况下均不存在,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名的对象存储 URL,因此是一种 bearer 凭证:任何持有它的人都可以在它过期前下载视频,所以请像对待机密一样对待它。它会在 `upstream_expires_at` 过期,在 Seedance 2.5 上 BytePlus 将其限制为最多 100 次下载,其中一次会被 Router 自己的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是有效的 Comfy 签名 URL,最长有效 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以后续轮询返回的 URL 可能只剩不到一小时的有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上将下载次数限制为 100 次。无论哪种情况,链接都会过期,因此请下载视频,而不要保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是由 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时缓存中重放,因此之后的轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会改为保留 BytePlus 自己的 URL;BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上将下载次数限制为 100 次。无论哪种方式,链接都会过期,因此请下载视频,而不是存储 URL。 - 任务创建的时间。该值为以秒为单位的 UNIX 时间戳。 + 任务创建的时间。该值为 UNIX 时间戳,单位为秒。 - 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这点上并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他并列接口会报告带小数的时长,因此客户端不能假定它一定是整数值。这是 BytePlus 自有字段,在视频任务成功时返回并原样转发。 + 已生成视频的时长,单位为秒。声明为数字而非整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而其他 BytePlus 接口会报告小数时长,因此客户端不得假定该值为整数。这是 BytePlus 自己的字段,在已成功的视频任务上返回并原样转发。 - 错误信息。如果任务成功,返回 null。如果任务失败,则返回错误信息。 + 错误信息。如果任务成功,则返回 null。如果任务失败,则返回错误信息。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一系列的错误码可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证和提供商故障。Router 会识别 HTTP 400 错误响应和 HTTP 200 失败任务响应中的策略系列,但不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。一个系列可能带有以点号分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商失败。Router 会在 HTTP 400 错误响应封装和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输失败。 @@ -398,19 +416,19 @@ false:不返回已生成视频的最后一帧图像。 - 任务所用模型的名称和版本 + 任务所使用的模型名称与版本 - 已生成视频的容器格式(mp4 或 mov),作为 `content` 的同级字段在顶层返回,Seedance 视频任务查询正是这样返回它的。这是 BytePlus 自有字段,原样转发。 + 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回。Seedance 视频任务查询正是在此位置返回该字段。该字段为 BytePlus 自有字段,原样透传。 - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在视频任务成功时返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 - 任务实际使用的生成种子。这是 BytePlus 自有字段,在视频任务成功时返回并原样转发。 + 该任务实际使用的生成种子。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 格式:`int64` @@ -422,7 +440,7 @@ false:不返回已生成视频的最后一帧图像。 - 任务最后更新的时间。该值为以秒为单位的 UNIX 时间戳。 + 任务最后更新的时间。该值为 UNIX 时间戳,单位为秒。 @@ -434,7 +452,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,其默认值为 0。因此 total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,其默认值为 0。因此,total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 86c4fbc675..daeb9c06c5 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,17 +2,18 @@ title: "将 Seedance 1.0 Pro 250528 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-250528:endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 084b73ac +translationSourceHash: 450bbe6e translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": af62a34c + "Schema": fc979e05 "Examples": 815d621e --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-250528.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -181,33 +182,33 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 输入 - 本次生成任务结果的回调通知地址 + 已忽略。为兼容 BytePlus 的请求结构而接受该字段,但在任务提交前会将其移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。 - 格式: `uri` + 格式:`uri` - 模型生成视频所用的输入内容 + 模型用于生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能仅使用音频,必须至少包含 1 张图像或 1 段视频;Seedance 2.5 支持纯音频输入。 音频 URL、Base64 编码或资产 ID。 -音频 URL:音频的公开网址(wav、mp3)。 +音频 URL:音频的公开 URL(wav、mp3)。 Base64:格式为 data:audio/\;base64,\ 资产 ID:格式为 asset://\ - 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的 prompt、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type,请勿再次提交这些内容。resolution 默认为 1080p,且仅支持 1080p。 + 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些参数。resolution 默认为且仅支持 1080p。 - 当 Draft 视频以 `draft` 设置为 true 创建时返回的任务 ID。 + 使用 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 @@ -216,7 +217,7 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片网址:请确保图片网址可访问。 +图片 URL:请确保图片 URL 可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ @@ -224,8 +225,8 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 内容项的角色/位置。 对于图像:first_frame、last_frame 或 reference_image。 -对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 -对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持)。 +对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持)。 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` @@ -235,23 +236,26 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 文本提示词(必填):使用中英文字符描述要生成的视频。 -参数(可选):在文本提示词之后添加 --[参数] 以控制视频规格: -- --resolution (--rs):480p、720p、1080p(默认:720p) -- --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) -- --duration (--dur):3-12 秒(默认:5) -- --framepersecond (--fps):24(默认:24) -- --watermark (--wm):true/false(默认:false) -- --seed (--seed):-1 到 2^32-1(默认:-1) -- --camerafixed (--cf):true/false(默认:false) +参数(可选):在文本提示词后添加 --[parameters] 以控制视频规格: +- --resolution(--rs):480p、720p、1080p(默认:720p) +- --ratio(--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) +- --duration(--dur):3 至 12 秒(默认:5) +- --framepersecond(--fps):24(默认:24) +- --watermark(--wm):true/false(默认:false) +- --seed(--seed):-1 至 2^32-1(默认:-1) +- --camerafixed(--cf):true/false(默认:false) 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -这是 Comfy 侧的保护限制,而非 BytePlus 的约束。BytePlus 未公布文本长度限制,并且在测试中(2026-09-17)接受了 40,000 个字符。 -它按字符计数,而非按字节,因此多字节提示词在传输时可能达到该数值的数倍。它约束的只是这一个字段,而非整个请求: -`content` 是一个数组,整个文档受每次请求的请求体大小限制约束。执行该限制的入口是 -Comfy Router(/v2/models/byteplus/\{model});在直接调用 v1 /proxy 时,则由 BytePlus 自身的验证器 -作出响应。该值设置得远高于实际流量,因此它绝不会对真实提示词进行裁定。如果调用方需要更大的值, -可以提高它。 +这是 Comfy 侧的防护限制,而非 BytePlus 的约束。BytePlus 未公布 +文本长度上限,并在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符而非字节计数,因此多字节提示词在传输途中的大小可能达到 +该限制的数倍。它只约束这一个字段,而非整个请求: +`content` 是数组,而单请求的正文大小限制才约束整个文档。 +Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; +在直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器作出响应。 +该值设置得远高于真实流量,因此它永远不会裁定真实提示词,如果调用方 +需要更多,可以提高该限制。 @@ -266,99 +270,113 @@ Comfy Router(/v2/models/byteplus/\{model});在直接调用 v1 /proxy 时 视频 URL 或资产 ID。 -视频 URL:视频的公开网址(mp4、mov)。 +视频 URL:视频的公开 URL(mp4、mov)。 资产 ID:格式为 asset://\ - 仅 Seedance 2.5。生成 480p 的 Draft 视频;resolution 必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 - 范围:`2` 到 `30` + 范围:`2` 至 `30` 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 - 范围:`3600` 到 `259200` + 范围:`3600` 至 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持此参数。生成的视频是否包含与画面同步的音频。 -true:模型输出带同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 + Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 +是:模型输出带同步音频的视频。 +否:模型输出无声视频。在支持该功能的模型上,生成的音轨会由提供商与视频分开进行内容审核;若音频未通过审核,会被报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对于提供商在其他方面可以接受的输入,这种拒绝可能是间歇性的。如果出现这种情况,请传入 `false` 以获取无声视频;仅当音频是被拒绝的模态时这才会起作用,同步的 Router 响应会将其标记为 `refusal_subject: output_audio`(排队中的请求尚无法识别出这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接调用 v1 接口 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供该参数:代理会以 400 拒绝任何其他值以及省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接对 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时 MUST 提供该字段,代理会以 400 拒绝任何其他取值以及缺省该字段的请求。它 NOT 在本 Schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。 - 仅 Seedance 2.5。输出视频的容器格式。mp4:通用容器(H.264/AAC,yuv420p),兼容性广且文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),色彩精度高,适合后期制作;文件大小更大。 + 仅适用于 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可能的值: `mp4`, `mov` + 可选值:`mp4`、`mov` - 已生成视频的比例。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认为:adaptive。 -Seedance 2.5 首帧/首尾帧生成:输出会跟随首帧的比例,因此仅接受 `adaptive`(或省略该字段);具体的比例会在派发前以 400 拒绝。在这些模式下,Seedance 2.0 接受具体的比例。 + 已生成视频的宽高比。Seedance 2.0、2.0 fast 与 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧 / 首尾帧生成:输出会跟随首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前以 400 拒绝。在这些模式下,Seedance 2.0 接受具体比例。 - 可能的值: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认为:720p。Seedance 1.0 pro 与 pro-fast 默认为:1080p。 -注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 与 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 与 pro-fast 默认:1080p。 +注意:Seedance 2.0、2.0 fast 与 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 - 可能的值: `480p`, `720p`, `1080p`, `4k` + 可选值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将此参数设置为 true 后,您可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false:不返回已生成视频的最后一帧图像。 +true: 返回已生成视频的最后一帧图像。将该参数设为 true 后,你可以通过调用“查询视频生成任务信息”获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 +false: 不返回已生成视频的最后一帧图像。 - 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。 + 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 - 范围: `-1` 到 `4294967295` + 范围:`-1` 到 `4294967295` - 用于处理的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 处理所用的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 - 可能的值: `default`, `flex` + 可选值:`default`、`flex` - 已生成视频是否包含水印。 + 已生成的视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` 提供的 schema 生成,与它在请求到达提供商之前用于校验调用的文档相同。 +生成自 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` 提供的 Schema,与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 - 视频生成任务完成后返回的输出内容,包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里的其他所有字段均来自 BytePlus 自身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在此之后轮询到的成功文档可能缺少 `content` 或其为 null。 + 视频生成任务完成后的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回的情况下,其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 均被重新托管到 Comfy 存储上;此处的其他所有字段均为 BytePlus 自有字段。可为空:BytePlus 在任务完成 24 小时后清除这些 URL,因此此后轮询一个已成功的文档时,`content` 可能缺失或为 null。 - 生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定其类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写该字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时;签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后的轮询可能返回一个只剩一小时有效期的链接。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后将其清除。无论哪种情况,链接都会过期,因此请下载该帧,而不要存储 URL。 + 生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任何字节,并根据上游的 Content-Type 或内容嗅探来确定类型,而 `image/jpeg` 只是两者都失败时的最终回退。Router 将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是一个 Comfy 签名的 URL,有效期最长 24 小时。该 URL 在签发时按 24 小时签名,并从 23 小时的备忘中重放,因此之后的轮询返回的 URL 可能仅剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种情况,链接都会过期,因此请下载该帧,而不要存储 URL。 - 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,请参见顶层的 `output_format` 字段;Router 会读取两者中存在的那个。 + 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 中时提供。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段。Router 会读取两者中存在的那个。 + + + + RFC 3339 时间,表示上游 URL 失效的时间:取 URL 自身携带的最早签名时间加有效期,当 `updated_at` 存在时,不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档中记载的 URL 生命周期);否则取任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时提供,当两个来源都未给出时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列按原样返回,其条款与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,在 BytePlus 清除后缺失,并且在 `upstream_expires_at` 之前属于持有者凭证。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列按原样返回。仅当任务由 Comfy 在服务器端已选择加入的工作区轮询 Seedance 2.x 任务时才提供(没有请求参数);对其他所有情况均缺失,包括解析不到任何工作区的凭证(例如未绑定到工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名的对象存储 URL,因此属于持有者凭证:任何持有它的人都可以在过期前下载视频,因此请将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写该字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时;签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后的轮询可能返回一个只剩一小时有效期的链接。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后将其清除,并且某些模型上最多允许 100 次下载。无论哪种情况,链接都会过期,因此请下载该视频,而不要存储 URL。 + 输出视频的下载 URL。Router 将视频重新托管到 Comfy 存储并重写此字段,因此它通常是一个 Comfy 签名的 URL,有效期最长 24 小时。该 URL 在签发时按 24 小时签名,并从 23 小时的备忘中重放,因此之后的轮询返回的 URL 可能仅剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要存储 URL。 @@ -366,7 +384,7 @@ false:不返回已生成视频的最后一帧图像。 - 生成视频的时长,单位为秒。之所以声明为 number 而不是 integer,是因为 BytePlus 对此并不一致:观察到视频任务返回整数秒,而同属 BytePlus 的其他接口会返回小数时长,因此客户端不应假定其为整数值。该字段属于 BytePlus 自身,在成功的视频任务中返回并原样转发。 + 生成视频的时长,单位为秒。声明为数字而非整数,是因为 BytePlus 在此并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同类接口会报告带小数的时长,因此客户端不能假定该值为整数。这是 BytePlus 自有字段,在已完成的视频任务上返回并原样转发。 @@ -374,31 +392,31 @@ false:不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某一错误族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放式字符串,而非枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误响应和 HTTP 200 任务失败响应中识别策略错误族,且不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。一个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略系列,但不会覆盖传输故障。 报错信息 - +```mdx 视频生成任务的 ID - 该任务所用模型的名称和版本 + 该任务所使用的模型名称和版本 - 生成视频的容器格式(mp4 或 mov),作为 `content` 的同级字段在顶层返回,Seedance 视频任务查询就是在这里返回它的。该字段属于 BytePlus 自身,原样转发。 + 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此处返回该字段。这是 BytePlus 的自有字段,原样转发。 - 生成视频的分辨率,例如 `1080p`。该字段属于 BytePlus 自身,在成功的视频任务中返回并原样转发。 + 生成视频的分辨率,例如 `1080p`。这是 BytePlus 的自有字段,在成功的视频任务中返回,并原样转发。 - 该任务实际使用的生成种子。该字段属于 BytePlus 自身,在成功的视频任务中返回并原样转发。 + 该任务实际使用的生成种子。这是 BytePlus 的自有字段,在成功的视频任务中返回,并原样转发。 格式:`int64` @@ -410,11 +428,11 @@ false:不返回已生成视频的最后一帧图像。 - 任务最后一次更新的时间。该值为 UNIX 时间戳,单位为秒。 + 任务最后更新的时间。该值为 UNIX 时间戳,单位为秒。 - 该请求的 token 使用量 + 本次请求的 token 用量 @@ -422,7 +440,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认为 0。因此 total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认值为 0。因此 total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 355b348247..573d9a16e9 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,17 +2,18 @@ title: "使用 Comfy Router 调用 Seedance 1.0 Pro Fast 251015" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-fast-251015:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 600f57b4 +translationSourceHash: 43683424 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 1df5b053 + "Schema": a882b2d8 "Examples": 1469ab97 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/seedance-1-0-pro-fast-251015.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -181,33 +182,33 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### 输入 - 本次生成任务结果的回调通知地址 + 已忽略。为兼容 BytePlus 请求结构而接受此字段,但会在提交任务前将其移除,因此永远不会发送回调;请改为轮询任务状态接口获取结果。 格式:`uri` - 模型用于生成视频的输入内容 + 模型生成视频所用的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能仅使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 音频 URL、Base64 编码或资产 ID。 音频 URL:音频的公开 URL(wav、mp3)。 -Base64:格式为 data:audio/\;base64,\ -资产 ID:格式为 asset://\ +Base64:格式 data:audio/\;base64,\ +资产 ID:格式 asset://\ - 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些参数。resolution 默认为且仅支持 1080p。 + 仅限 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为 1080p,且仅支持 1080p。 - 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 + 将 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 @@ -215,10 +216,10 @@ Base64:格式为 data:audio/\;base64,\ - 用于图生视频的图像内容(当 type 为 "image_url" 时) -图片网址:请确保该图片网址可访问。 + 用于图生视频生成的图像内容(当 type 为 "image_url" 时) +图片网址:请确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式为 asset://\ +资产 ID:格式 asset://\ @@ -227,32 +228,32 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可选值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 模型的输入文本信息。包含文本提示词和可选参数。 + 模型的输入文本信息。包括文本提示词和可选参数。 文本提示词(必填):使用中英文字符描述要生成的视频。 -参数(可选):在文本提示词之后添加 --[parameters] 以控制视频规格: -- --resolution (--rs):480p、720p、1080p(默认:720p) -- --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) -- --duration (--dur):3-12 秒(默认:5) -- --framepersecond (--fps):24(默认:24) -- --watermark (--wm):true/false(默认:false) -- --seed (--seed):-1 到 2^32-1(默认:-1) -- --camerafixed (--cf):true/false(默认:false) +参数(可选):在文本提示词后添加 --[parameters] 以控制视频规格: +- --resolution (--rs): 480p、720p、1080p(默认:720p) +- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) +- --duration (--dur): 3-12 秒(默认:5) +- --framepersecond (--fps): 24(默认:24) +- --watermark (--wm): true/false(默认:false) +- --seed (--seed): -1 到 2^32-1(默认:-1) +- --camerafixed (--cf): true/false(默认:false) 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -这是 Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本长度限制,在测试中接受了 40,000 个字符(2026-09-17)。它统计的是字符数而非字节数,因此多字节提示词在网络传输时可能达到该大小的数倍。它限制的是这一个字段,而不是整个请求:`content` 是一个数组,整个文档受每请求正文大小限制约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口;而直接进行 v1 /proxy 调用时,由 BytePlus 自己的校验器负责答复。该值设置得远高于真实流量,因此它永远不会裁决真实的提示词。如果调用方需要更多,可以提高该值。 +Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。它按字符而非字节计数,因此多字节提示词在传输时可能达到该大小的数倍。它限制的是这一个字段,而不是整个请求:`content` 是一个数组,而每个请求的请求体上限才限制整个文档。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器负责应答。该值设置得远高于真实流量,因此绝不会对真实提示词作出裁决;如果调用方需要更多,可提高该值。 输入内容的类型 - 可选值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -262,12 +263,12 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 视频 URL 或资产 ID。 视频 URL:视频的公开 URL(mp4、mov)。 -资产 ID:格式为 asset://\ +资产 ID:格式 asset://\ - 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 + 仅限 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 @@ -284,76 +285,90 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true:模型输出带有同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 +true: 模型输出带同步音频的视频。 +false: 模型输出无声视频。在支持该功能的模型上,提供商会对生成的音轨与视频分开进行内容审核;如果音轨被拒绝,会报告为 `content_policy_violation`,并且由于每次运行音频都不同,对于提供商原本接受的输入,这种拒绝可能间歇性出现。如果发生这种情况,请为静音视频发送 `false`;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其命名为 `refusal_subject: output_audio`(排队中的请求尚不会标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为使用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接对 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时,必须提供该值:代理会拒绝任何其他值,省略时也会返回 400。它不在本架构的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方可以省略。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接向 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时必须提供它:代理会以 400 拒绝任何其他值以及省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填入它,因此 Router 调用方会省略它。 - 仅 Seedance 2.5。输出视频的容器格式。mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅限 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC、yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM、yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`、`mov` + 可能的值:`mp4`、`mov` - 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认值:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会遵循首帧的宽高比,因此仅接受 `adaptive`(或省略该字段);传入具体比例会在派发前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 + 已生成视频的比例。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的比例,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认值:720p。Seedance 1.0 pro 与 pro-fast 默认值:1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将该参数设置为 true 后,可通过调用“查询视频生成任务信息”获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false:不返回已生成视频的最后一帧图像。 +true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +false: 不返回已生成视频的最后一帧图像。 - 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 + 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。 - 范围:`-1` 至 `4294967295` + 范围:`-1` 到 `4294967295` - 处理所用的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可能的值:`default`、`flex` 已生成视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` 提供的 schema 生成,与请求到达提供商之前用于校验调用的文档完全一致。 +根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` 提供的 schema 生成,该文档也是 Router 在请求到达提供商之前校验调用时所依据的同一文档。 ### 输出 - 视频生成任务完成后返回的输出内容,包含输出视频的下载 URL,以及在 BytePlus 返回时该视频最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里其他所有字段都来自 BytePlus。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此之后轮询一个已成功的文档时,`content` 可能缺失或为 null。 + 视频生成任务完成后返回的输出,包含输出视频的下载 URL,以及在 BytePlus 提供时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处的其他每个字段都来自 BytePlus 本身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,此后轮询到的成功文档中 `content` 可能缺失或为 null。 - 生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据该 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任何字节,并根据上游的 Content-Type 或内容嗅探来判断其类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储上并改写该字段,因此它通常是 Comfy 签名 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以后续轮询返回的 URL 可能只剩不到一小时的有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是保存 URL。 + 已生成视频最后一帧的下载 URL,在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它实际收到的任何字节,并根据上游的 Content-Type 或内容探测来确定其类型,只有当两者都失败时,`image/jpeg` 才作为最后的兜底。Router 会将最后一帧重新托管到 Comfy 存储上并重写此字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它。无论哪种方式,链接都会过期,因此请下载该帧,而不是保存 URL。 - 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时返回。Seedance 模型更常将它作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段。Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),在 BytePlus 将其嵌套在 `content` 中时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段,Router 会读取两者中存在的那一个。 + + + + 上游 URL 停止工作的 RFC 3339 时间:即 URL 本身携带的最早签名时间加有效期,当任务的 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现,当两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列逐字节返回,条款与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前属于持有者凭证。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列逐字节返回。仅在由 Comfy 已在服务器端选择加入的工作区轮询 Seedance 2.x 任务时出现(没有请求参数);对其他所有人均缺失,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是一个预签名的对象存储 URL,因此属于持有者凭证:任何持有它的人都能在过期前下载该视频,所以请像对待机密一样对待它。它在 `upstream_expires_at` 时过期,并且在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并改写该字段,因此它通常是 Comfy 签名 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以后续轮询返回的 URL 可能只剩不到一小时的有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载该视频,而不是保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并重写此字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种方式,链接都会过期,因此请下载视频,而不是保存 URL。 @@ -361,7 +376,7 @@ false:不返回已生成视频的最后一帧图像。 - 生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这一点上并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他同类接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务中返回并原样转发。 + 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这一点上并不一致:视频任务曾被观察到返回整秒,而同系列的其他 BytePlus 接口会上报带小数的时长,因此客户端不得假定它是整数值。该字段属于 BytePlus 自身,在成功的视频任务上返回并原样转发。 @@ -369,7 +384,7 @@ false:不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个错误族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是开放字符串,而非枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略族,且不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一族错误可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,不是枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别内容策略族,但不会覆盖传输层面的故障。 @@ -381,19 +396,19 @@ false:不返回已生成视频的最后一帧图像。 - 任务所用模型的名称和版本 + 该任务所使用的模型的名称和版本 - 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询即在此处返回它。这是 BytePlus 自己的字段,原样转发。 + 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此位置返回该字段。BytePlus 自有字段,原样透传。 - 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自己的字段,在成功的视频任务中返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务中返回,原样透传。 - 任务实际使用的生成种子。这是 BytePlus 自己的字段,在成功的视频任务中返回并原样转发。 + 该任务实际使用的生成种子。BytePlus 自有字段,在成功的视频任务中返回,原样透传。 格式:`int64` @@ -409,7 +424,7 @@ false:不返回已生成视频的最后一帧图像。 - 该请求的 token 使用量 + 本次请求的 token 用量 @@ -417,7 +432,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认为 0。因此,total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数,默认为 0。因此 total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 7c9c1cb63b..59e3abf8fa 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,17 +2,18 @@ title: "通过 Comfy Router 使用 Seedance 1.5 Pro 251215" description: "通过 Comfy Router 调用 byteplus/seedance-1-5-pro-251215:endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 13f3fe20 +translationSourceHash: 1d016721 translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 6d6d6ec1 + "Schema": 35f3b5dc "Examples": 7e73ac5c --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/seedance-1-5-pro-251215.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -181,7 +182,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ ### 输入 - 本次生成任务结果的回调通知地址 + 已忽略。为兼容 BytePlus 请求结构而接受,但在任务提交前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 格式:`uri` @@ -191,23 +192,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 张图像或 1 段视频;Seedance 2.5 支持纯音频输入。 - 音频网址、Base64 编码或资产 ID。 -音频网址:音频的公开网址(wav、mp3)。 + 音频 URL、Base64 编码或资产 ID。 +音频 URL:音频的公开 URL(wav、mp3)。 Base64:格式为 data:audio/\;base64,\ 资产 ID:格式为 asset://\ - 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用该 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type,请勿再次提交它们。resolution 默认为 1080p,且仅支持 1080p。 + 仅 Seedance 2.5。要作为最终视频渲染的草稿任务。它必须是唯一的内容项。 +最终视频会复用草稿任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为 1080p,且仅支持 1080p。 - 使用 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 + 当 `draft` 设置为 true 创建草稿视频时返回的任务 ID。 @@ -227,15 +228,15 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可选值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 模型的输入文本信息。包含文本提示词和可选参数。 + 供模型使用的输入文本信息。包含文本提示词和可选参数。 文本提示词(必填):使用中英文字符描述要生成的视频。 -参数(可选):在文本提示词之后添加 --[parameters] 以控制视频规格: +参数(可选):在文本提示词后添加 --[parameters] 以控制视频规格: - --resolution (--rs):480p、720p、1080p(默认:720p) - --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) - --duration (--dur):3-12 秒(默认:5) @@ -246,13 +247,16 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 侧护栏,而非 BytePlus 的限制。BytePlus 未公布文本长度限制,在测试中接受了 40,000 个字符(2026-09-17)。它统计的是字符而非字节,因此多字节提示词在传输时可能达到该数值的数倍。它约束的是这一个字段,而不是整个请求:`content` 是数组,真正约束整个文档的是每请求的 body 限制。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;在直接调用 v1 /proxy 时,则由 BytePlus 自身的校验器应答。该值设置得远高于真实流量,因此绝不会对真实提示词作出裁决。如果调用方需要更多,可以提高它。 +这是 Comfy 侧的护栏,而非 BytePlus 的约束。BytePlus 未公布文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符而非字节计数,因此多字节提示词在传输时可能达到该大小的数倍。它限制的是这一个字段,而不是整个请求: +`content` 是数组,而整个文档由单次请求的正文限制来约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; +直接调用 v1 /proxy 时,则改由 BytePlus 自己的验证器应答。将该值设置得远高于真实流量,因此它永远不会裁决真实提示词;如果调用方需要更多,可以提高该值。 输入内容的类型 - 可选值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -260,55 +264,56 @@ Comfy 侧护栏,而非 BytePlus 的限制。BytePlus 未公布文本长度限 - 视频网址或资产 ID。 -视频网址:视频的公开网址(mp4、mov)。 + 视频 URL 或资产 ID。 +视频 URL:视频的公开 URL(mp4、mov)。 资产 ID:格式为 asset://\ - 仅 Seedance 2.5。生成 480p 的 Draft 视频;resolution 必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5。生成 480p 草稿视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。草稿任务 ID 的有效期为 7 天。 - 视频时长(秒)。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + 视频时长,以秒为单位。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 - 范围:`2` 到 `30` + 范围:`2` 至 `30` - 任务超时阈值(秒)。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值,以秒为单位。默认 172800(48h)。范围:[3600, 259200]。 - 范围:`3600` 到 `259200` + 范围:`3600` 至 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true:模型输出带同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 + 支持该参数的模型为 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro。生成的视频是否包含与画面同步的音频。 +true: 模型输出带同步音频的视频。 +false: 模型输出无声视频。 +对于支持该功能的模型,已生成的音频轨道会由提供商与视频分开进行内容检查;此处的拒绝会报告为 `content_policy_violation`,并且由于每次运行的音频不同,对于提供商原本接受的输入,这种拒绝可能间歇性出现。如果发生这种情况,请为无声视频发送 `false`;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其命名为 `refusal_subject: output_audio`(排队中的请求尚无法识别它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为使用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接调用 v1 的 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供它,代理会拒绝任何其他值,未提供时同样返回 400。它不在本 Schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方可以省略。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 以及 dreamina-seedance-2-5-260628。直接向 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起的 v1 调用必须提供它:代理会拒绝任何其他值以及省略该字段的情况,并返回 400。它并不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 - 仅 Seedance 2.5。输出视频的容器格式。mp4:通用容器(H.264/AAC、yuv420p),兼容性广,文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM、yuv444p),色彩精度高,适合后期制作;但文件大小更大。 + 仅限 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 可选值:`mp4`、`mov` - 已生成视频的比例。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会跟随首帧的比例,因此只接受 `adaptive`(或省略该字段);若传入具体比例,会在派发前以 400 拒绝。Seedance 2.0 在这些模式下可接受具体比例。 + 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧 / 首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在调度前被拒绝并返回 400。Seedance 2.0 在这些模式下接受具体比例。 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 与 pro-fast 默认:1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 可选值:`480p`、`720p`、`1080p`、`4k` @@ -316,18 +321,18 @@ Seedance 2.5 首帧 / 首尾帧生成:输出会跟随首帧的比例,因此 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将该参数设为 true 后,你可以通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用该参数可以生成多个连续的视频:将上一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续的视频。 -false:不返回已生成视频的最后一帧图像。 +true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用“查询视频生成任务信息”获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的第一帧,从而快速生成多个连续视频。 +false: 不返回已生成视频的最后一帧图像。 - 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 + 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。 范围:`-1` 到 `4294967295` - 处理所用的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 可选值:`default`、`flex` @@ -336,64 +341,77 @@ false:不返回已生成视频的最后一帧图像。 已生成视频是否包含水印。 -该文档由 Router 在 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` 提供的 schema 生成,它也是请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前它用于验证调用的文档相同。 ### 输出 - 视频生成任务完成后返回的输出,其中包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储上;此处的其他所有字段均由 BytePlus 提供。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在之后轮询一个已成功的文档时,其 `content` 可能缺失或为 null。 + 视频生成任务完成后的输出,包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储;此处的其他所有字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务结束 24 小时后清除这些 URL,届时再轮询一个已成功的文档,其 `content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL,当请求中设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任何字节,并根据上游 Content-Type 或内容嗅探确定类型,而 `image/jpeg` 只是两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储上并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中回放,因此后续轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,此字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种方式链接都会过期,因此请下载该帧,而不要存储 URL。 + 生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管其收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定类型,`image/jpeg` 只是在两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,所以它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,因此后续轮询可能返回一个仅剩一小时有效期的 URL。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务结束 24 小时后清除它。无论哪种方式,链接都会过期,因此请下载该帧,而不是存储 URL。 - 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 中时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回(参见顶层 `output_format` 字段),Router 会读取二者中存在的那个。 + 生成视频的容器格式(mp4 或 mov),前提是 BytePlus 将其嵌套在 `content` 中。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段,Router 会读取两者中存在的那个。 + + + + 上游 URL 停止工作的 RFC 3339 时间:最早签名时间加上 URL 自身携带的有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现;当两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列逐字节返回,条款与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后会缺失,并且在 `upstream_expires_at` 之前都是持有者凭证。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列逐字节返回。仅对由 Comfy 在服务器端已选择加入的工作区轮询的 Seedance 2.x 任务出现(没有请求参数);对其他所有情况均不出现,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥);并且在 BytePlus 于生成 24 小时后清除其 URL 后也不出现。它是预签名的对象存储 URL,因此也是持有者凭证:任何持有它的人都能在过期前下载视频,所以请像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中回放,因此后续轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,此字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上将下载次数上限设为 100 次。无论哪种方式链接都会过期,因此请下载视频,而不要存储 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,所以它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,因此后续轮询可能返回一个仅剩一小时有效期的 URL。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种方式,链接都会过期,因此请下载视频,而不是存储 URL。 - 任务创建的时间。该值为 UNIX 时间戳,以秒为单位。 + 任务创建时间。该值为 UNIX 时间戳,单位为秒。 - 已生成视频的时长,以秒为单位。之所以声明为 number 而不是 integer,是因为 BytePlus 对此并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他同类接口会报告带小数的时长,因此客户端不应假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务中返回,并原样转发。 + 生成视频的时长,单位为秒。声明为数字而不是整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而其他 BytePlus 接口会报告小数时长,因此客户端不得假定其为整数值。这是 BytePlus 自有字段,在成功的视频任务上返回并原样转发。 - 错误信息。如果任务成功,则返回 null。如果任务失败,则返回错误信息。 + 错误信息。如果任务成功,则返回 null;如果任务失败,则返回错误信息。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一族系可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略族系,而不会覆盖传输层故障。 + 上游 ModelArk 错误代码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,不是枚举:其他代码描述验证和提供商故障。Router 会在 HTTP 400 错误响应包和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输失败。 报错信息 - - 视频生成任务的 ID +The ID of the video generation task - 任务所用模型的名称和版本 + 任务所使用的模型名称和版本 - 已生成视频的容器格式(mp4 或 mov),作为 `content` 的同级字段在顶层返回:Seedance 视频任务查询即在此处返回它。这是 BytePlus 自己的字段,原样转发。 + 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询就是在这里返回该字段。BytePlus 自有字段,原样转发。 - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自己的字段,在成功的视频任务中返回,并原样转发。 + 生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务中返回并原样转发。 - 任务实际使用的生成种子。这是 BytePlus 自己的字段,在成功的视频任务中返回,并原样转发。 + 任务实际使用的生成种子。BytePlus 自有字段,在成功的视频任务中返回并原样转发。 格式:`int64` @@ -401,15 +419,15 @@ false:不返回已生成视频的最后一帧图像。 任务的状态 - 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 可能的值:`queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - 任务最后更新的时间。该值为 UNIX 时间戳,以秒为单位。 + 任务最后更新的时间。该值为 UNIX 时间戳,单位为秒。 - 请求的 token 用量 + 请求的 token 使用量 diff --git a/zh/development/comfy-router/models/fal/h3-max-turbo/code.mdx b/zh/development/comfy-router/models/fal/h3-max-turbo/code.mdx index 38cdc7e6f0..4f1db03bb3 100644 --- a/zh/development/comfy-router/models/fal/h3-max-turbo/code.mdx +++ b/zh/development/comfy-router/models/fal/h3-max-turbo/code.mdx @@ -2,23 +2,22 @@ title: "将 H3 Max Turbo 与 Comfy Router 搭配使用" description: "通过 Comfy Router 调用 fal/h3-max-turbo:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "H3 Max Turbo" -translationSourceHash: 77aca164 +translationSourceHash: d670af32 translationFrom: development/comfy-router/models/fal/h3-max-turbo/code.mdx translationBlockHashes: - "_intro": 3932e8e2 + "_intro": 7c031ba1 "Quick start": 37ecc981 "Schema": fa803ecb "Examples": 53e0f9d0 --- - {/* GENERATED FILE. Generated from router-schemas/fal/h3-max-turbo.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; 由 Comfy Router 从 fal 提供的 `fal/h3-max-turbo` API 参考文档。 -**输入:** 文本, 图像 · **输出:** 视频 + 音频 +**输入:** 文本、图像、视频、音频 · **输出:** 视频 + 音频 ## 快速开始 diff --git a/zh/development/comfy-router/models/google/gemini/code.mdx b/zh/development/comfy-router/models/google/gemini/code.mdx index 944ed016e7..3e453395b1 100644 --- a/zh/development/comfy-router/models/google/gemini/code.mdx +++ b/zh/development/comfy-router/models/google/gemini/code.mdx @@ -2,33 +2,21 @@ title: "通过 Comfy Router 使用 Google Gemini" description: "通过 Comfy Router 以 HTTP 方式调用 Google Gemini 文本模型的 Python、TypeScript 和 cURL 代码片段,以及请求字段和返回结果的结构" sidebarTitle: "Google Gemini" -translationSourceHash: 5e4f183f +translationSourceHash: ccf669d3 translationFrom: development/comfy-router/models/google/gemini/code.mdx -translationBlockHashes: - "_intro": 10922fe1 - "Quick start": 933ea7f2 - "Schema": e3abcc1c - "Examples": 4bb73c12 --- - - - - - {/* 已生成文件。请编辑本目录中的 code.yaml 并运行 `pnpm code-pages:gen`。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; Google Gemini 的 API 参考。Google Gemini 是 Google 的多模态文本模型系列,在 Flash 和 Pro 各层级中覆盖从快速起草到深度推理的各类场景。 -**输入:** 文本, 图像, 音频, 视频 · **输出:** 文本 - ## 快速开始 在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建一个密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段则是通过原始 HTTP 发出的同一调用。 -选择你想要调用的模型。这些模型共用同一套请求和响应结构,下文会统一说明一次。 +选择你要调用的模型。下面的全部内容,从代码片段到 Schema 和示例,都随你的选择而定。 @@ -210,220 +198,1242 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview/requests/$R - - -**模型 ID:** `vertexai/gemini-3.5-flash` -**端点:** `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash` +

Schema

- - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy +

输入

-# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. -async def main(): - async with AsyncComfy() as client: - result = await client.models.run( - "vertexai/gemini-3.5-flash", - { - "contents": [ - { - "role": "user", - "parts": [ - { - "text": "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - "generationConfig": { - "temperature": 0.7, - "maxOutputTokens": 256, - }, - }, - ) + + 与模型当前对话的内容。对于单轮查询,这是一个单独的实例;对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + - print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + + + -asyncio.run(main()) -``` + + 基于 URI 的数据。 + -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; + + URI + -// Reads COMFY_API_KEY from the environment. -// The SDK automatically creates an idempotency key and reuses it for automatic retries. -type Result = { candidates: { content: { parts: { text: string }[] } }[] }; -const result = await comfy.models.run("vertexai/gemini-3.5-flash", { - contents: [ - { - role: "user", - parts: [ - { - text: "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - generationConfig: { - temperature: 0.7, - maxOutputTokens: 256, - }, -}); -if (result.kind !== "json") throw new Error("expected a JSON result"); + + data 或 fileUri 字段中指定文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为 1 小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 -console.log("text:", result.data.candidates[0].content.parts[0].text); -``` + 可选值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + -```bash cURL -curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" -``` -
-
- -将相同的请求体发送到 `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests`。Router 会在运行被受理后立即返回 `201` 和 `request_id`,结果就绪后即可从本进程或其他进程收集。[队列投递](/zh/development/comfy-router/queue)详细介绍了状态查询、取消和结果收集。 + + 以原始字节形式提供的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,最多可以通过 inlineData 指定 3000 张图像。 + - -```python Python -import asyncio -from comfy_sdk import AsyncComfy + + 要在提示中以内联方式包含的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB -# Reads COMFY_API_KEY from the environment. -# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. -async def main(): - async with AsyncComfy() as client: - handle = await client.models.submit( - "vertexai/gemini-3.5-flash", - { - "contents": [ - { - "role": "user", - "parts": [ - { - "text": "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - "generationConfig": { - "temperature": 0.7, - "maxOutputTokens": 256, - }, - }, - ) - print("request_id:", handle.request_id) # with the model ID, all another process needs + 格式:`byte` + - # Poll until the request completes, waiting the Retry-After the server names. - async for update in handle.iter_events(): - print(update.status, update.queue_position) + + data 或 fileUri 字段中指定文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为 1 小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. - result = await handle.get() + 可选值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + - print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + + 模型读取此部分视频的方式。设置为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是按固定速率进行帧采样。省略则使用默认的固定速率采样。支持 gemini-3.7-flash 及更新的 Flash 模型。 + -asyncio.run(main()) -``` + + 文本提示或代码片段。 + -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; + + 表示此部分是模型的一个思考/推理步骤。 + -// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. -type Result = { candidates: { content: { parts: { text: string }[] } }[] }; -const handle = await comfy.models.submit("vertexai/gemini-3.5-flash", { - contents: [ - { - role: "user", - parts: [ - { - text: "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - generationConfig: { - temperature: 0.7, - maxOutputTokens: 256, - }, -}); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs + + 可选值:`user`、`model` + -// Poll until the request completes, waiting the Retry-After the server names. -for await (const update of handle.events()) { - console.log(update.status, update.queuePosition); -} + + 生成过程的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时会应用该默认值,其余字段则回退到模型自身的行为。 + -// The same result models.run() returns. A request that failed or was cancelled rejects here. -const result = await handle.get(); -if (result.kind !== "json") throw new Error("expected a JSON result"); + + 图像生成的配置 + -console.log("text:", result.data.candidates[0].content.parts[0].text); -``` + + 已生成图像的宽高比 + -```bash cURL -# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. -curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" + + 可选。已生成图像的图像输出格式。 + -# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. -REQUEST_ID="" -curl -i https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID/status \ - -H "X-API-Key: $COMFY_API_KEY" + + 可选。输出图像的压缩质量。 + -# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. -curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID \ - -H "X-API-Key: $COMFY_API_KEY" -``` - - -
-
- -**模型 ID:** `vertexai/gemini-2.5-pro` + + 可选。在 Vertex AI 路径(即由 Comfy 自身凭证提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求)上,输出应保存为的图像格式。这些路径上接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在请求被转发之前统一转为小写;任何其他值都会被拒绝,并返回 400 错误且指明该字段。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是个例外:该上游没有此属性,一旦请求中包含它就会拒绝整个调用,因此该字段会从请求中移除,而不是被采用或被拒绝,输出格式由 AI Studio 自行决定。在所有路径上,都应从你收到的响应部分中读回媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时读取 `fileData.mimeType`),而不要假设你发送的值就是最终结果。 + -**端点:** `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro` + + 可选。指定已生成图像的尺寸。支持的值为 1K、2K、4K。如果未指定,模型将使用默认值 1K。 + - - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy + + 响应中可生成的 token 最大数量。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60-80 个单词。 -# Reads COMFY_API_KEY from the environment. -# The SDK automatically creates an idempotency key and reuses it for automatic retries. -async def main(): - async with AsyncComfy() as client: - result = await client.models.run( - "vertexai/gemini-2.5-pro", - { - "contents": [ - { - "role": "user", - "parts": [ - { - "text": "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, - ], - "generationConfig": { - "temperature": 0.7, - "maxOutputTokens": 256, - }, + 范围:`16` 到 `65536` + + + + + + + + 当 seed 固定为特定值时,模型会尽力对重复请求给出相同的响应。不保证输出具有确定性。此外,即使使用相同的 seed 值,更改模型或参数设置(例如 temperature)也可能导致响应发生变化。默认情况下,会使用随机 seed 值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + + + + + + + + temperature 用于在生成响应期间进行采样,采样发生在应用 topP 和 topK 时。temperature 控制 token 选择过程中的随机程度。较低的温度适合需要较少开放性回答或创造性回答的提示,而较高的温度可以带来更多样或更有创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示的响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于通用、过于简短,或者模型给出了回退响应,请尝试提高 temperature + + 范围:`0` 到 `2` + + 格式:`float` + + + + 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤,从而生成更高质量响应的过程。 + + + + 可选。如果为 true,模型将在响应中包含其思考内容。 + + + + 可选。模型思考过程的 token 预算。模型将尽力保持在此预算范围内。 + + + + 可选。模型的思考级别。 + + 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + + + + Top-K 会改变模型选择输出 token 的方式。top-K 为 1 表示下一个被选中的 token 是模型词表中所有 token 里概率最高的那个。top-K 为 3 表示借助 temperature 从 3 个概率最高的 token 中选择下一个 token。 + + 范围:`1` 到 `…` + + + + 如果指定,则使用核采样。 +Top-P 会改变模型选择输出 token 的方式。token 会从概率最高(参见 top-K)到最低依次选出,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,那么模型会借助 temperature 选择 A 或 B 作为下一个 token,并排除 C 作为候选。 +指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 + + 范围:`0` 到 `1` + + 格式:`float` + + + + 用于阻止不安全内容的按请求设置。在 GenerateContentResponse.candidates 上强制执行。 + + + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 可能的值:`OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` + + + + 用于引导模型获得更好表现的指令。例如,"尽可能简洁地回答"或"不要在回复中使用技术术语"。这些文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,不会影响模型的表现。注意:parts 中只应使用文本,且每个 part 中的内容应位于单独的段落。 + + + + 构成单条消息的有序 part 列表。不同的 part 可以具有不同的 IANA MIME 类型。有关输入的限制(例如最大 token 数量或图像数量),请参阅 Google 模型页面上的模型规格。 + + + + 文本提示或代码片段。 + + + + 创建消息的实体的身份。支持以下值:user:表示该消息由真实的人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,model 值用于将来自模型的消息插入对话。对于非多轮对话,此字段可以留空或不设置。 + + 可能的值:`user`、`model` + + + + 一段代码,使系统能够与外部系统交互,以执行超出模型知识和范围之外的一个操作或一组操作。请参阅函数调用。 + + + + + + + + + + + + + + + + 函数参数的 JSON schema + + + + 若为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 会在 24 小时后过期。 + + + + 对于视频输入,表示视频在 Duration 格式下的起始和结束偏移量。例如,要指定一段从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。只有当视频数据以 inlineData 或 fileData 形式呈现时,才应指定该元数据。 + + + + 表示视频时间轴位置上的时长偏移量。 + + + + 以纳秒为精度的带符号秒的小数部分。带小数的负秒值,其 nanos 值仍必须为非负。 + + Range: `0` 到 `999999999` + + + + 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + + Range: `-315576000000` 到 `315576000000` + + + + 表示视频时间轴位置上的时长偏移量。 + + + + 以纳秒为精度的带符号秒的小数部分。带小数的负秒值,其 nanos 值仍必须为非负。 + + Range: `0` 到 `999999999` + + + + 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + + Range: `-315576000000` 到 `315576000000` + + +根据 Router 在 `GET /v2/models/vertexai/gemini-3.1-pro-preview/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前用于校验调用的同一份文档。 + +

输出

+ + + + + + + + + + + + + + + + + + + + + + + + + + + 格式:`date` + + + + + + + + + + + + + + + + 与模型进行的当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 + + + + + + + + 基于 URI 的数据。 + + + + URI + + + + data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,最多可以通过 inlineData 指定 3000 张图像。 + + + + 以内联方式包含在提示中的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + + 格式:`byte` + + + + data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定检查哪些片段,而不是采用固定速率的帧采样。省略则使用默认的固定速率采样。支持 gemini-3.7-flash 及更新的 Flash 模型。 + + + + 文本提示或代码片段。 + + + + 表示此部分为模型的思考/推理步骤。 + + + + 可能的值:`user`、`model` + + + + + + + + + + + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 内容违反指定安全类别的概率 + + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 响应创建时的时间戳。 + + + + 用于生成响应的模型版本。 + + + + + + + + + + + + + + + + + + + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 内容违反指定安全类别的概率 + + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 响应的唯一标识符。 + + + + + + + + 仅限输出。输入中缓存部分(缓存内容)的 token 数量。 + + + + 响应中的 token 数量。 + + + + 按模态划分的候选 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + 请求中的 token 数量。设置 cachedContent 后,这仍是有效的提示总大小,也就是说其中包含缓存内容中的 token 数量。 + + + + 按模态划分的提示 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + thoughts 输出中存在的 token 数量。 + + + + 工具使用提示中存在的 token 数量。 + + + + 按模态划分的工具使用提示 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + token 总数(提示 + 候选)。 + + + + 请求使用的流量类型(例如 PROVISIONED_THROUGHPUT)。 + + +

示例

+ +

输入

+ +```json +{ + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence." + } + ] + } + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256 + } +} +``` + +

输出

+ +```json +{ + "candidates": [ + { + "content": { + "role": "model", + "parts": [ + { + "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep." + } + ] + }, + "finishReason": "STOP" + } + ], + "usageMetadata": { + "promptTokenCount": 18, + "candidatesTokenCount": 24 + } +} +``` +
+ +**模型 ID:** `vertexai/gemini-3.5-flash` + +**端点:** `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash` + + + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Reads COMFY_API_KEY from the environment. +# The SDK automatically creates an idempotency key and reuses it for automatic retries. +async def main(): + async with AsyncComfy() as client: + result = await client.models.run( + "vertexai/gemini-3.5-flash", + { + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256, + }, + }, + ) + + print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Reads COMFY_API_KEY from the environment. +// The SDK automatically creates an idempotency key and reuses it for automatic retries. +type Result = { candidates: { content: { parts: { text: string }[] } }[] }; +const result = await comfy.models.run("vertexai/gemini-3.5-flash", { + contents: [ + { + role: "user", + parts: [ + { + text: "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + generationConfig: { + temperature: 0.7, + maxOutputTokens: 256, + }, +}); +if (result.kind !== "json") throw new Error("expected a JSON result"); + +console.log("text:", result.data.candidates[0].content.parts[0].text); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" +``` + + + +将相同的请求体发送到 `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests`。Router 会在运行被受理后立即返回 `201` 和 `request_id`,结果就绪后即可从本进程或其他进程收集。[队列投递](/zh/development/comfy-router/queue)详细介绍了状态查询、取消和结果收集。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Reads COMFY_API_KEY from the environment. +# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-3.5-flash", + { + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256, + }, + }, + ) + print("request_id:", handle.request_id) # with the model ID, all another process needs + + # Poll until the request completes, waiting the Retry-After the server names. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # The provider's own payload, the same value models.run() returns. + # A request that failed or was cancelled raises the typed Router error here. + result = await handle.get() + + print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Reads COMFY_API_KEY from the environment. +// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +type Result = { candidates: { content: { parts: { text: string }[] } }[] }; +const handle = await comfy.models.submit("vertexai/gemini-3.5-flash", { + contents: [ + { + role: "user", + parts: [ + { + text: "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + generationConfig: { + temperature: 0.7, + maxOutputTokens: 256, + }, +}); +console.log("requestId:", handle.requestId); // with the model ID, all another process needs + +// Poll until the request completes, waiting the Retry-After the server names. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// The same result models.run() returns. A request that failed or was cancelled rejects here. +const result = await handle.get(); +if (result.kind !== "json") throw new Error("expected a JSON result"); + +console.log("text:", result.data.candidates[0].content.parts[0].text); +``` + +```bash cURL +# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" + +# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +

Schema

+ +

输入

+ + + 与模型当前对话的内容。对于单轮查询,这是一个单独的实例;对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + + + + + + + + 基于 URI 的数据。 + + + + URI + + + + data 或 fileUri 字段中指定文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为 1 小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 + + 可选值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 以原始字节形式提供的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,最多可以通过 inlineData 指定 3000 张图像。 + + + + 要在提示中以内联方式包含的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + + 格式:`byte` + + + + data 或 fileUri 字段中指定文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为 1 小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 + + 可选值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 模型读取此部分视频的方式。设置为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是按固定速率进行帧采样。省略则使用默认的固定速率采样。支持 gemini-3.7-flash 及更新的 Flash 模型。 + + + + 文本提示或代码片段。 + + + + 表示此部分是模型的一个思考/推理步骤。 + + + + 可选值:`user`、`model` + + + + 生成过程的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时会应用该默认值,其余字段则回退到模型自身的行为。 + + + + 图像生成的配置 + + + + 已生成图像的宽高比 + + + + 可选。已生成图像的图像输出格式。 + + + + 可选。输出图像的压缩质量。 + + + + 可选。在 Vertex AI 路径(即由 Comfy 自身凭证提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求)上,输出应保存为的图像格式。这些路径上接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在请求被转发之前统一转为小写;任何其他值都会被拒绝,并返回 400 错误且指明该字段。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是个例外:该上游没有此属性,一旦请求中包含它就会拒绝整个调用,因此该字段会从请求中移除,而不是被采用或被拒绝,输出格式由 AI Studio 自行决定。在所有路径上,都应从你收到的响应部分中读回媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时读取 `fileData.mimeType`),而不要假设你发送的值就是最终结果。 + + + + 可选。指定已生成图像的尺寸。支持的值为 1K、2K、4K。如果未指定,模型将使用默认值 1K。 + + + + 响应中可生成的 token 最大数量。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60-80 个单词。 + + 范围:`16` 到 `65536` + + + + + + + + 当 seed 固定为特定值时,模型会尽力对重复请求给出相同的响应。不保证输出具有确定性。此外,即使使用相同的 seed 值,更改模型或参数设置(例如 temperature)也可能导致响应发生变化。默认情况下,会使用随机 seed 值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + + + + + + + + temperature 用于在生成响应期间进行采样,采样发生在应用 topP 和 topK 时。temperature 控制 token 选择过程中的随机程度。较低的温度适合需要较少开放性回答或创造性回答的提示,而较高的温度可以带来更多样或更有创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示的响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于通用、过于简短,或者模型给出了回退响应,请尝试提高 temperature + + 范围:`0` 到 `2` + + 格式:`float` + + + + 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤,从而生成更高质量响应的过程。 + + + + 可选。如果为 true,模型将在响应中包含其思考内容。 + + + + 可选。模型思考过程的 token 预算。模型将尽力保持在此预算范围内。 + + + + 可选。模型的思考级别。 + + 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + + + + Top-K 会改变模型选择输出 token 的方式。top-K 为 1 表示下一个被选中的 token 是模型词表中所有 token 里概率最高的那个。top-K 为 3 表示借助 temperature 从 3 个概率最高的 token 中选择下一个 token。 + + 范围:`1` 到 `…` + + + + 如果指定,则使用核采样。 +Top-P 会改变模型选择输出 token 的方式。token 会从概率最高(参见 top-K)到最低依次选出,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,那么模型会借助 temperature 选择 A 或 B 作为下一个 token,并排除 C 作为候选。 +指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 + + 范围:`0` 到 `1` + + 格式:`float` + + + + 用于阻止不安全内容的按请求设置。在 GenerateContentResponse.candidates 上强制执行。 + + + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 可能的值:`OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` + + + + 用于引导模型获得更好表现的指令。例如,"尽可能简洁地回答"或"不要在回复中使用技术术语"。这些文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,不会影响模型的表现。注意:parts 中只应使用文本,且每个 part 中的内容应位于单独的段落。 + + + + 构成单条消息的有序 part 列表。不同的 part 可以具有不同的 IANA MIME 类型。有关输入的限制(例如最大 token 数量或图像数量),请参阅 Google 模型页面上的模型规格。 + + + + 文本提示或代码片段。 + + + + 创建消息的实体的身份。支持以下值:user:表示该消息由真实的人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,model 值用于将来自模型的消息插入对话。对于非多轮对话,此字段可以留空或不设置。 + + 可能的值:`user`、`model` + + + + 一段代码,使系统能够与外部系统交互,以执行超出模型知识和范围之外的一个操作或一组操作。请参阅函数调用。 + + + + + + + + + + + + + + + + 函数参数的 JSON schema + + + + 若为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 会在 24 小时后过期。 + + + + 对于视频输入,表示视频在 Duration 格式下的起始和结束偏移量。例如,要指定一段从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。只有当视频数据以 inlineData 或 fileData 形式呈现时,才应指定该元数据。 + + + + 表示视频时间轴位置上的时长偏移量。 + + + + 以纳秒为精度的带符号秒的小数部分。带小数的负秒值,其 nanos 值仍必须为非负。 + + Range: `0` 到 `999999999` + + + + 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + + Range: `-315576000000` 到 `315576000000` + + + + 表示视频时间轴位置上的时长偏移量。 + + + + 以纳秒为精度的带符号秒的小数部分。带小数的负秒值,其 nanos 值仍必须为非负。 + + Range: `0` 到 `999999999` + + + + 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + + Range: `-315576000000` 到 `315576000000` + + +根据 Router 在 `GET /v2/models/vertexai/gemini-3.5-flash/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前用于校验调用的同一份文档。 + +

输出

+ + + + + + + + + + + + + + + + + + + + + + + + + + + 格式:`date` + + + + + + + + + + + + + + + + 与模型进行的当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 + + + + + + + + 基于 URI 的数据。 + + + + URI + + + + data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,最多可以通过 inlineData 指定 3000 张图像。 + + + + 以内联方式包含在提示中的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + + 格式:`byte` + + + + data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定检查哪些片段,而不是采用固定速率的帧采样。省略则使用默认的固定速率采样。支持 gemini-3.7-flash 及更新的 Flash 模型。 + + + + 文本提示或代码片段。 + + + + 表示此部分为模型的思考/推理步骤。 + + + + 可能的值:`user`、`model` + + + + + + + + + + + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 内容违反指定安全类别的概率 + + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 响应创建时的时间戳。 + + + + 用于生成响应的模型版本。 + + + + + + + + + + + + + + + + + + + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 内容违反指定安全类别的概率 + + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 响应的唯一标识符。 + + + + + + + + 仅限输出。输入中缓存部分(缓存内容)的 token 数量。 + + + + 响应中的 token 数量。 + + + + 按模态划分的候选 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + 请求中的 token 数量。设置 cachedContent 后,这仍是有效的提示总大小,也就是说其中包含缓存内容中的 token 数量。 + + + + 按模态划分的提示 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + thoughts 输出中存在的 token 数量。 + + + + 工具使用提示中存在的 token 数量。 + + + + 按模态划分的工具使用提示 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + token 总数(提示 + 候选)。 + + + + 请求使用的流量类型(例如 PROVISIONED_THROUGHPUT)。 + + +

示例

+ +

输入

+ +```json +{ + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence." + } + ] + } + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256 + } +} +``` + +

输出

+ +```json +{ + "candidates": [ + { + "content": { + "role": "model", + "parts": [ + { + "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep." + } + ] + }, + "finishReason": "STOP" + } + ], + "usageMetadata": { + "promptTokenCount": 18, + "candidatesTokenCount": 24 + } +} +``` +
+ +**模型 ID:** `vertexai/gemini-2.5-pro` + +**端点:** `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro` + + + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Reads COMFY_API_KEY from the environment. +# The SDK automatically creates an idempotency key and reuses it for automatic retries. +async def main(): + async with AsyncComfy() as client: + result = await client.models.run( + "vertexai/gemini-2.5-pro", + { + "contents": [ + { + "role": "user", + "parts": [ + { + "text": "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256, + }, }, ) @@ -501,75 +1511,294 @@ async def main(): ) print("request_id:", handle.request_id) # with the model ID, all another process needs - # Poll until the request completes, waiting the Retry-After the server names. - async for update in handle.iter_events(): - print(update.status, update.queue_position) + # Poll until the request completes, waiting the Retry-After the server names. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # The provider's own payload, the same value models.run() returns. + # A request that failed or was cancelled raises the typed Router error here. + result = await handle.get() + + print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Reads COMFY_API_KEY from the environment. +// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. +type Result = { candidates: { content: { parts: { text: string }[] } }[] }; +const handle = await comfy.models.submit("vertexai/gemini-2.5-pro", { + contents: [ + { + role: "user", + parts: [ + { + text: "Describe a single red maple leaf on a white background in one sentence.", + }, + ], + }, + ], + generationConfig: { + temperature: 0.7, + maxOutputTokens: 256, + }, +}); +console.log("requestId:", handle.requestId); // with the model ID, all another process needs + +// Poll until the request completes, waiting the Retry-After the server names. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// The same result models.run() returns. A request that failed or was cancelled rejects here. +const result = await handle.get(); +if (result.kind !== "json") throw new Error("expected a JSON result"); + +console.log("text:", result.data.candidates[0].content.parts[0].text); +``` + +```bash cURL +# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. +curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" + +# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. +curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +

Schema

+ +

输入

+ +_这些字段遵循 Google 公布的 API 规范,并在 CI 中对照该规范进行校验。Router 针对此模型自身的 Schema 尚未发布,因此请求会未经校验直接转发给提供商。_ + + + 目前为止的对话内容,按从最旧到最新的顺序排列。part 可以是 `text`,也可以是 `inlineData`,用于在提示词之外一并发送图像、音频或视频。 + + + + 该轮对话的作者。 + + 可选值:`user`、`model` + + + + 该轮对话的内容部分。 + + + + 文本部分。 + + + + 内联媒体部分。 + + + + 媒体类型,例如 `image/png`。 + + + + Base64 编码的媒体字节。 + + + + 应用于整个对话的系统提示词。 + + + + + + + + + + + + 采样与长度设置。 + + + + 采样的随机性。默认值因模型而异。 + + 范围:`0` 到 `2` + + + + 核采样阈值。默认值因模型而异。 + + + + Top-k 采样截断值。默认值因模型而异。 + + + + 已生成 token 数量的上限。 + + + + 用于可复现采样的种子。 + + + + 一旦生成就会终止生成的字符串。 + + + + 在支持该功能的模型上控制推理投入。 + + + + 可选值:`MINIMAL`、`LOW`、`MEDIUM`、`HIGH` + + + + 在返回答案的同时返回模型的推理过程。 + + + + 模型可以调用的函数声明。 + + + + + + + + + + + + + + + + 该函数参数的 JSON Schema。 + + +

输出

+ +Router 会原样返回 Google 的原生响应。文本位于 `candidates[0].content.parts[0].text`。 + + + 已生成的候选;除非你要求更多,否则只有一个。 + + + + + + + + 可选值:`model` + + + + + + + + 已生成的文本。 + + + + 当模型选择调用你的某个 `tools` 时出现。 + + + + + + + + + + + + 生成停止的原因:`STOP`、`MAX_TOKENS`、`SAFETY` 等。 + + + + 本次调用的 token 统计。 + - # The provider's own payload, the same value models.run() returns. - # A request that failed or was cancelled raises the typed Router error here. - result = await handle.get() + + 提示词中的 token 数量。 + - print("text:", result["candidates"][0]["content"]["parts"][0]["text"]) + + 已生成候选中的 token 数量。 + -asyncio.run(main()) -``` + + 当提示词本身被拦截时出现。在读取结果之前,请先检查 `candidates` 是否存在;被拦截的响应中也可能出现 `usageMetadata`。 + -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; + + 提示词被拦截的原因。此时不会返回任何候选;请重新表述提示词后重试。 -// Reads COMFY_API_KEY from the environment. -// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries. -type Result = { candidates: { content: { parts: { text: string }[] } }[] }; -const handle = await comfy.models.submit("vertexai/gemini-2.5-pro", { - contents: [ + 可选值:`SAFETY`、`OTHER`、`BLOCKLIST`、`PROHIBITED_CONTENT`、`IMAGE_SAFETY` + + +

示例

+ +

输入

+ +```json +{ + "contents": [ { - role: "user", - parts: [ + "role": "user", + "parts": [ { - text: "Describe a single red maple leaf on a white background in one sentence.", - }, - ], - }, + "text": "Describe a single red maple leaf on a white background in one sentence." + } + ] + } ], - generationConfig: { - temperature: 0.7, - maxOutputTokens: 256, - }, -}); -console.log("requestId:", handle.requestId); // with the model ID, all another process needs - -// Poll until the request completes, waiting the Retry-After the server names. -for await (const update of handle.events()) { - console.log(update.status, update.queuePosition); + "generationConfig": { + "temperature": 0.7, + "maxOutputTokens": 256 + } } - -// The same result models.run() returns. A request that failed or was cancelled rejects here. -const result = await handle.get(); -if (result.kind !== "json") throw new Error("expected a JSON result"); - -console.log("text:", result.data.candidates[0].content.parts[0].text); ``` -```bash cURL -# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url. -curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}" - -# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names. -REQUEST_ID="" -curl -i https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID/status \ - -H "X-API-Key: $COMFY_API_KEY" +

输出

-# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running. -curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID \ - -H "X-API-Key: $COMFY_API_KEY" +```json +{ + "candidates": [ + { + "content": { + "role": "model", + "parts": [ + { + "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep." + } + ] + }, + "finishReason": "STOP" + } + ], + "usageMetadata": { + "promptTokenCount": 18, + "candidatesTokenCount": 24 + } +} ``` - -
-
**模型 ID:** `vertexai/gemini-2.5-flash` @@ -750,476 +1979,182 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash/requests/$REQUEST - - - -## Schema - -### 输入 - - - 与模型当前对话的内容。对于单轮查询,这是一个单独的实例;对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 - - - - - - - - 基于 URI 的数据。 - - - - URI - - - - data 或 fileUri 字段中指定文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为 1 小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - - 可选值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - - - 以原始字节形式提供的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,最多可以通过 inlineData 指定 3000 张图像。 - - - - 要在提示中以内联方式包含的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB - - 格式:`byte` - - - - data 或 fileUri 字段中指定文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为 1 小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - - 可选值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - - - - 模型读取此部分视频的方式。设置为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是按固定速率进行帧采样。省略则使用默认的固定速率采样。支持 gemini-3.7-flash 及更新的 Flash 模型。 - - - - 文本提示或代码片段。 - - - - 表示此部分是模型的一个思考/推理步骤。 - - - - 可选值:`user`、`model` - - - - 生成过程的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时会应用该默认值,其余字段则回退到模型自身的行为。 - - - - 图像生成的配置 - - - - 已生成图像的宽高比 - - - - 可选。已生成图像的图像输出格式。 - - - - 可选。输出图像的压缩质量。 - - - - 可选。在 Vertex AI 路径(即由 Comfy 自身凭证提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求)上,输出应保存为的图像格式。这些路径上接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在请求被转发之前统一转为小写;任何其他值都会被拒绝,并返回 400 错误且指明该字段。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是个例外:该上游没有此属性,一旦请求中包含它就会拒绝整个调用,因此该字段会从请求中移除,而不是被采用或被拒绝,输出格式由 AI Studio 自行决定。在所有路径上,都应从你收到的响应部分中读回媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时读取 `fileData.mimeType`),而不要假设你发送的值就是最终结果。 - - - - 可选。指定已生成图像的尺寸。支持的值为 1K、2K、4K。如果未指定,模型将使用默认值 1K。 - - - - 响应中可生成的 token 最大数量。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60-80 个单词。 - - 范围:`16` 到 `65536` - - - - - - - - 当 seed 固定为特定值时,模型会尽力对重复请求给出相同的响应。不保证输出具有确定性。此外,即使使用相同的 seed 值,更改模型或参数设置(例如 temperature)也可能导致响应发生变化。默认情况下,会使用随机 seed 值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 - - - - - - - - temperature 用于在生成响应期间进行采样,采样发生在应用 topP 和 topK 时。temperature 控制 token 选择过程中的随机程度。较低的温度适合需要较少开放性回答或创造性回答的提示,而较高的温度可以带来更多样或更有创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示的响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于通用、过于简短,或者模型给出了回退响应,请尝试提高 temperature - - 范围:`0` 到 `2` - - 格式:`float` - - - - 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤,从而生成更高质量响应的过程。 - - - - 可选。如果为 true,模型将在响应中包含其思考内容。 - - - - 可选。模型思考过程的 token 预算。模型将尽力保持在此预算范围内。 - - - - 可选。模型的思考级别。 - - 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` - - - - Top-K 会改变模型选择输出 token 的方式。top-K 为 1 表示下一个被选中的 token 是模型词表中所有 token 里概率最高的那个。top-K 为 3 表示借助 temperature 从 3 个概率最高的 token 中选择下一个 token。 - - 范围:`1` 到 `…` - - - - 如果指定,则使用核采样。 -Top-P 会改变模型选择输出 token 的方式。token 会从概率最高(参见 top-K)到最低依次选出,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,那么模型会借助 temperature 选择 A 或 B 作为下一个 token,并排除 C 作为候选。 -指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 - - 范围:`0` 到 `1` +

Schema

- 格式:`float` -
- - - 用于阻止不安全内容的按请求设置。在 GenerateContentResponse.candidates 上强制执行。 - +

输入

- - 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - +_这些字段遵循 Google 公布的 API 规范,并在 CI 中对照该规范进行校验。Router 针对此模型自身的 Schema 尚未发布,因此请求会未经校验直接转发给提供商。_ - - 可能的值:`OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` + + 目前为止的对话内容,按从最旧到最新的顺序排列。part 可以是 `text`,也可以是 `inlineData`,用于在提示词之外一并发送图像、音频或视频。 - - 用于引导模型获得更好表现的指令。例如,"尽可能简洁地回答"或"不要在回复中使用技术术语"。这些文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,不会影响模型的表现。注意:parts 中只应使用文本,且每个 part 中的内容应位于单独的段落。 + + 该轮对话的作者。 + + 可选值:`user`、`model` - - 构成单条消息的有序 part 列表。不同的 part 可以具有不同的 IANA MIME 类型。有关输入的限制(例如最大 token 数量或图像数量),请参阅 Google 模型页面上的模型规格。 + + 该轮对话的内容部分。 - - 文本提示或代码片段。 + + 文本部分。 - - 创建消息的实体的身份。支持以下值:user:表示该消息由真实的人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,model 值用于将来自模型的消息插入对话。对于非多轮对话,此字段可以留空或不设置。 + + 内联媒体部分。 + - 可能的值:`user`、`model` + + 媒体类型,例如 `image/png`。 - - 一段代码,使系统能够与外部系统交互,以执行超出模型知识和范围之外的一个操作或一组操作。请参阅函数调用。 + + Base64 编码的媒体字节。 - - + + 应用于整个对话的系统提示词。 - + - + - - 函数参数的 JSON schema + + 采样与长度设置。 - - 若为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 会在 24 小时后过期。 - + + 采样的随机性。默认值因模型而异。 - - 对于视频输入,表示视频在 Duration 格式下的起始和结束偏移量。例如,要指定一段从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。只有当视频数据以 inlineData 或 fileData 形式呈现时,才应指定该元数据。 + 范围:`0` 到 `2` - - 表示视频时间轴位置上的时长偏移量。 + + 核采样阈值。默认值因模型而异。 - - 以纳秒为精度的带符号秒的小数部分。带小数的负秒值,其 nanos 值仍必须为非负。 - - Range: `0` 到 `999999999` + + Top-k 采样截断值。默认值因模型而异。 - - 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 - - Range: `-315576000000` 到 `315576000000` + + 已生成 token 数量的上限。 - - 表示视频时间轴位置上的时长偏移量。 + + 用于可复现采样的种子。 - - 以纳秒为精度的带符号秒的小数部分。带小数的负秒值,其 nanos 值仍必须为非负。 - - Range: `0` 到 `999999999` + + 一旦生成就会终止生成的字符串。 - - 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 - - Range: `-315576000000` 到 `315576000000` + + 在支持该功能的模型上控制推理投入。 -根据 Router 在 `GET /v2/models/vertexai/gemini-3.1-pro-preview/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前用于校验调用的同一份文档。 - -### 输出 - - - - + + 可选值:`MINIMAL`、`LOW`、`MEDIUM`、`HIGH` + - - - + + 在返回答案的同时返回模型的推理过程。 + - - - + + 模型可以调用的函数声明。 + - + - + - + - + - + - + - - 格式:`date` - + + 该函数参数的 JSON Schema。 + - - - +

输出

- - - +Router 会原样返回 Google 的原生响应。文本位于 `candidates[0].content.parts[0].text`。 - - + + 已生成的候选;除非你要求更多,否则只有一个。 - 与模型进行的当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 - - - - - 基于 URI 的数据。 - - - - URI - - - - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - - 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - - - - 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,最多可以通过 inlineData 指定 3000 张图像。 - - - - 以内联方式包含在提示中的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB - - 格式:`byte` - - - - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - - 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - - - - 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定检查哪些片段,而不是采用固定速率的帧采样。省略则使用默认的固定速率采样。支持 gemini-3.7-flash 及更新的 Flash 模型。 - - - - 文本提示或代码片段。 - - - - 表示此部分为模型的思考/推理步骤。 - - - 可能的值:`user`、`model` - - - - + 可选值:`model` - + - - 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - - - - 内容违反指定安全类别的概率 - - 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` - - - - 响应创建时的时间戳。 - - - - 用于生成响应的模型版本。 - - - - + + 已生成的文本。 - - + + 当模型选择调用你的某个 `tools` 时出现。 - + - + - - 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - - - - 内容违反指定安全类别的概率 - - 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` - - - - 响应的唯一标识符。 + + 生成停止的原因:`STOP`、`MAX_TOKENS`、`SAFETY` 等。 - - - - - 仅限输出。输入中缓存部分(缓存内容)的 token 数量。 - - - - 响应中的 token 数量。 - - - - 按模态划分的候选 token 明细。 - - - - 输入或输出内容的模态类型。 - - 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` - - - - 给定模态的 token 数量。 + 本次调用的 token 统计。 - 请求中的 token 数量。设置 cachedContent 后,这仍是有效的提示总大小,也就是说其中包含缓存内容中的 token 数量。 - - - - 按模态划分的提示 token 明细。 - - - - 输入或输出内容的模态类型。 - - 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + 提示词中的 token 数量。 - - 给定模态的 token 数量。 - - - - thoughts 输出中存在的 token 数量。 - - - - 工具使用提示中存在的 token 数量。 - - - - 按模态划分的工具使用提示 token 明细。 - - - - 输入或输出内容的模态类型。 - - 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + 已生成候选中的 token 数量。 - - 给定模态的 token 数量。 + + 当提示词本身被拦截时出现。在读取结果之前,请先检查 `candidates` 是否存在;被拦截的响应中也可能出现 `usageMetadata`。 - - token 总数(提示 + 候选)。 - + + 提示词被拦截的原因。此时不会返回任何候选;请重新表述提示词后重试。 - - 请求使用的流量类型(例如 PROVISIONED_THROUGHPUT)。 + 可选值:`SAFETY`、`OTHER`、`BLOCKLIST`、`PROHIBITED_CONTENT`、`IMAGE_SAFETY` -## 示例 +

示例

-### 输入 +

输入

```json { @@ -1240,7 +2175,7 @@ Top-P 会改变模型选择输出 token 的方式。token 会从概率最高( } ``` -### 输出 +

输出

```json { @@ -1263,5 +2198,7 @@ Top-P 会改变模型选择输出 token 的方式。token 会从概率最高( } } ``` + + diff --git a/zh/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx b/zh/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx index 48d23657cf..2a5a40a57e 100644 --- a/zh/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx +++ b/zh/development/comfy-router/models/ideogram/ideogram-4-5/code.mdx @@ -2,14 +2,15 @@ title: "将 Ideogram 4.5 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 ideogram/ideogram-4-5:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Ideogram 4.5" -translationSourceHash: 2cd2cad8 +translationSourceHash: 9c2a625d translationFrom: development/comfy-router/models/ideogram/ideogram-4-5/code.mdx translationBlockHashes: "_intro": 3e988502 "Quick start": c8cd302a - "Schema": ea1fb25c + "Schema": 493d453f "Examples": f5f40ced --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/ideogram/ideogram-4-5.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -147,51 +148,53 @@ curl https://api.comfy.org/v2/models/ideogram/ideogram-4-5/requests/$REQUEST_ID ## Schema - ### 输入 + + 仅适用于 Precise Edit;需要 `image`。编辑所作用的源图像区域,因此可以在超大图像的一处进行编辑,然后以完整尺寸返回图像,其余部分保持不变。`none`(默认值)会编辑整张图像。`auto` 会围绕 `mask` 适配出一个区域,并且需要提供 `mask`。否则请发送 `y_min,x_min,y_max,x_max`,以四个非负整数像素边界表示,其中 `y_max` 大于 `y_min` 且 `x_max` 大于 `x_min`,每边至少 256 像素,宽高比在 1:6 与 6:1 之间,面积至多 4,194,304 像素。不带 `image` 的请求若使用 `none` 以外的值,会被拒绝。`context_window` 仅在上下文窗口门控启用时才会被接受;在未启用的情况下,任何 `none` 以外的值都会以 422 被拒绝。 + + 选择启用生成后的版权检测。 - 一张图像,可以是 Router 代表调用方获取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。接受的图像类型为 png、webp 和 jpeg,该集合在解析时即强制执行,而不是留给提供商决定:svg、gif、avif 或 tiff 会在这里被拒绝,并指明你发送的图像,而不会变成距离根因两跳之外的合作伙伴错误。 -优先使用 URL 形式。base64 载荷大约膨胀到 4/3,而整个请求体上限为 100 MiB,因此内联形式的上限约为 75 MB 的来源图像;URL 则完全绕开了这一点。本描述末尾给出的单张图像与单次请求的媒体上限比请求体上限更严格,因此对于任何有实际大小的图像,你首先遇到的都是它们。 -该 URL 必须无需你的凭证即可解析。Router 在服务器端获取它,并且不会随请求发送任何调用方凭证,因此受支持的形式是预签名 URL(签名位于查询字符串中的 URL)。诸如 `/api/assets/{id}/content` 这类需要认证的端点会向 Router 返回 401 而不是图像;请自行请求该 URL,并传入它重定向到的已签名 URL。 -获取范围被限定在一组指定的主机内,而不是整个开放互联网;同一列表会同时应用于你发送的 URL 以及每一次重定向跳转,因此在联系任何提供商之前,位于其他主机的 URL,或者重定向到列表之外主机的 URL,都会被拒绝。目前该列表仅包含 Comfy 自己的资产分发:Comfy 资产桶下已签名的 `storage.googleapis.com` URL,也就是 `/api/assets/{id}/content` 重定向你到的形式。合作伙伴 CDN 或普通 https 主机都不在列表中。 -有两项放宽正在逐步推出,且目前两者都默认关闭。它们由同一个切换开关控制并一起启用,因此请把下面的所有内容视为即将推出的功能,而不是现在就可以依赖的东西:在使用其中任何一项之前请先询问。 -第一项是 `POST /customers/storage` 为你的上传签名的桶。在推出到达你的环境之前,来自该端点的上传 URL 会在这里被拒绝,即使该桶是 Comfy 自己的、主机也相同:因此“上传到 Comfy,再传入 URL”目前并不奏效,可行的形式是 `/api/assets/{id}/content` 重定向到的已签名 URL。 -第二项是按账户启用,而不是一次性对所有人启用,因为这些主机背后的桶属于你而不是我们:即使上面的切换开关已打开,尚未启用第三方入站媒体的账户仍会被拒绝,并且给出的提示正是这句话,而不是告诉你主机不受支持。请联系你的 Comfy 对接人,为你的账户启用它。它额外允许以下第三方对象存储主机,这些主机背后的桶属于你,Router 不对其主张任何所属权:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 以及 `s3..amazonaws.com`,path-style 或带 `.` 前缀的形式均可)、Azure Blob Storage(`.blob.core.windows.net`)和 Alibaba Cloud OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些特指对象存储端点:同一提供商域名上的通用端点,例如阿里云函数计算的触发器,不在列表中,会被拒绝。 -匹配的是主机名形式,而不是提供商:因此上面提到某个提供商,并不代表该提供商能签发的每个 URL 都会被接受;有三种容易混淆的情况值得直接说明,因为调用方完全可能带着其中任何一种前来。R2 自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为有限速的调试主机名,并改为把生产流量指向自定义域名;但自定义域名的主机名中没有任何信息表明它是 R2,Router 无法将其与其他主机区分开,因而会拒绝它。请对 `.r2.cloudflarestorage.com` 端点预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 dualstack 端点(`s3.dualstack..amazonaws.com`)同样不被接受,请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)也不被接受,请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些相同的形式,因此不必专门来这里查看。 -上面的 `` 和 `pub-` 占位符展示的是你通常会用的形式,它们并不是层级深度的限制。匹配针对的是对象存储域名后缀,因此同一命名空间下更深的名字(`a.b.pub-.r2.dev`)同样会被接受。这并未放宽命名空间本身:后缀仍然必须是所列出的后缀之一。 -下面的示例只展示形式:真实的值还带有签名查询参数,此处有意省略,因为已发布的示例会永远留在规范中,而真实的签名既会泄露凭证,也是一个会失效的链接。 -每张图像上限为 25 MiB,单次请求的图像总量上限为 64 MiB。 + 一张图像,可以是 Router 代表调用方获取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。接受的图像类型为 png、webp 和 jpeg,并且该集合在解析时即强制执行,而不是留给提供商处理:svg、gif、avif 或 tiff 会在这里被拒绝,并指明你发送的图像,而不是变成距根因两跳的合作伙伴错误。 +优先使用 URL 形式。base64 载荷大约会膨胀 4/3,而整个请求体的上限为 100 MiB,因此内联形式的上限接近 75 MB 的源图像;URL 则完全避开这一点。本描述末尾列出的单图像和单请求媒体上限比请求体上限更严格,因此对于任何实际尺寸的图像,你会先碰到这些上限。 +该 URL 必须在不使用你的凭据的情况下解析。Router 在服务器端获取它,并且不会随请求发送调用方凭据,因此支持的形式是预签名 URL,即签名位于查询字符串中的 URL。像 `/api/assets/{id}/content` 这样的已认证端点会向 Router 返回 401,而不是返回图像;请自行请求该 URL,并传入它重定向到的已签名 URL。 +获取范围限于一组指定主机,而不是整个开放互联网,并且同一列表不仅应用于你发送的 URL,也会重新应用于每一次重定向跳转:因此,位于任何其他主机的 URL,或重定向到列表之外的 URL,都会在联系任何提供商之前被拒绝。目前该列表仅包含 Comfy 自己的资产分发:Comfy 资产桶下已签名的 `storage.googleapis.com` URL,这正是 `/api/assets/{id}/content` 重定向到的形式。合作伙伴 CDN 或普通 https 主机不在列表中。 +两项放宽正在逐步推出,且目前都默认关闭。它们通过同一个切换发布并一起启用,因此请将以下所有内容视为即将推出,而不是现在就可以依据其进行开发:在依赖其中任何一项之前,请先询问。 +第一项是 `POST /customers/storage` 将你的上传签名到的那个桶。在推广到达你的环境之前,来自该端点的上传 URL 会在此处被拒绝,即使该桶属于 Comfy 自己且主机相同:因此,“上传到 Comfy,然后传入 URL”目前并不起作用,可行的形式是 `/api/assets/{id}/content` 重定向到的已签名 URL。 +第二项按账户启用,而不是一次性对所有人启用,因为这些主机背后的桶属于你而不是我们:即使上面的切换已打开,未启用第三方入站媒体的账户也会被拒绝,并且会明确告知这一点,而不是告知该主机不受支持。请联系你的 Comfy 联系人,为你的账户启用它。它还会额外允许以下第三方对象存储主机,这些主机上的桶属于你,Router 不对其主张归属:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,可采用路径样式或带 `.` 前缀的形式)、Azure Blob Storage(`.blob.core.windows.net`)和 Alibaba Cloud OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些明确是对象存储端点:同一提供商域名上的常规端点,例如 Alibaba Function Compute 触发器,不在列表中,并会被拒绝。 +匹配的是主机名形式,而不是提供商:因此上面提到某个提供商,并不意味着该提供商能签发的每个 URL 都会被接受,而且有三种接近但不匹配的形式值得直接说明,因为调用方完全可能提交其中任意一种。R2 自定义域(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为限速的调试主机名,并把生产流量改为指向自定义域;但自定义域的主机名中没有任何可标识其为 R2 的信息,因此 Router 无法将其与任何其他主机区分开来,并会拒绝它:请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 双栈端点(`s3.dualstack..amazonaws.com`)也不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)也不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些相同的形式,因此你不必回到这里阅读它们。 +上面的 `` 和 `pub-` 占位符展示了你通常会提交的形式;它们并不限制层级深度。匹配依据是对象存储域名后缀,因此同一命名空间下更深的名称(`a.b.pub-.r2.dev`)也会被接受。这不会放宽命名空间本身:后缀仍然必须是所列出的后缀之一。 +下面的示例仅展示形式:真实值还会带有签名查询参数,这里有意省略,因为已发布的示例会永远留在规范中,而真实签名既是泄露的凭据,也是会失效的链接。 +每张图像上限为 25 MiB,单个请求中的图像总计上限为 64 MiB。唯一例外是 ideogram/ideogram-4-5 Precise Edit(即发送 `image` 的调用),此时 `context_window` 可用:每张图像最大可达 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求中的图像总计最大可达 128 MiB。 - 生成操作的可选来源图像。第一张是主要来源,其余为参考图。最多五张,带遮罩时最多四张。 + 用于生成操作的可选源图像。第一张是主来源,其余是参考图像。最多五张,或在使用遮罩时最多四张。 - 仅用于生成。用于文生图的提示词重写。支持的值为 auto、on 和 off。默认为 auto。 + 仅适用于生成。用于文生图的提示词重写。支持的值为 auto、on 和 off。默认值为 auto。 - 单张图像,可以是 Router 代表调用方获取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。接受的图像类型为 png、webp 和 jpeg,并且该集合在解析时即被强制校验,而不是交由提供商处理:svg、gif、avif 或 tiff 会在此处被拒绝,并指明你发送的图像,而不是变成与原因相隔两跳的合作伙伴错误。 -优先使用 URL 形式。base64 负载大约膨胀 4/3,整个请求体上限为 100 MiB,因此内联形式对应的来源图像上限约为 75 MB;URL 则完全避开这一限制。本描述末尾说明的每张图像和每请求媒体上限比请求体上限更严格,因此对于任何实际大小的图像,你会先遇到它们。 -该 URL 必须在不使用你的凭证的情况下可解析。Router 在服务器端获取它,并且请求中不发送调用方凭证,因此预签名 URL(其签名位于查询字符串中)是受支持的形式。诸如 `/api/assets/{id}/content` 这类需要认证的端点会向 Router 返回 401 而不是图像;请自行请求该 URL,并传递它重定向到的已签名 URL。 -获取仅限于一组具名主机,而不是开放互联网,并且同一列表会重新应用于你发送的 URL 以及每个重定向跳;因此任何其他主机上的 URL,或重定向离开该列表的 URL,都会在联系任何提供商之前被拒绝。目前该列表仅包含 Comfy 自身的资产分发:Comfy 资产桶下的已签名 `storage.googleapis.com` URL,这正是 `/api/assets/{id}/content` 重定向你前往的形式。合作伙伴 CDN 或普通 https 主机不在该列表上。 -两项放宽正在逐步推出,并且目前默认均处于关闭状态。它们通过一个开关发布并一起启用,因此请将以下所有内容视为即将推出,而不是现在就可以依赖的功能:在依赖其中任何一项之前请先询问。 -第一项是 `POST /customers/storage` 将你的上传签名到的桶。在推出到达你的环境之前,来自该端点的上传 URL 会在此处被拒绝,即使该桶属于 Comfy 自身且主机相同:因此“上传到 Comfy,然后传递 URL”尚不可行,可行的形式是 `/api/assets/{id}/content` 重定向到的已签名 URL。 -第二项是按账户启用,而不是一次为所有人启用,因为这些主机背后的桶是你的而不是我们的:即使上面的开关已打开,未启用第三方入站媒体的账户仍会被拒绝,并会收到这样的说明,而不是被告知不支持该主机。请让你的 Comfy 联系人为此账户启用它。它还额外接受这些第三方对象存储主机,其中桶属于你,Router 不对其提出所有权主张:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,路径样式或 `.` 前缀形式均可)、Azure Blob Storage(`.blob.core.windows.net`)以及阿里云 OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些具体是对象存储端点:同一提供商域上的常规用途端点,例如阿里云函数计算触发器,不在列表上并会被拒绝。 -匹配的是主机名形式,而不是提供商:因此在上文提及某个提供商,并不意味着该提供商可以签发的每个 URL 都会被接受,而三个近似情况值得直接说明,因为调用方可能合理地带着其中任何一个到来。R2 自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为限速的调试主机名,并将生产流量指向自定义域名,但自定义域名的域名中不包含任何标识其为 R2 的信息,因此 Router 无法将其与任何其他主机区分开来并拒绝它:请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 双栈端点(`s3.dualstack..amazonaws.com`)也不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)同样不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些相同的形式,因此你不必来这里阅读它们。 -上面的 `` 和 `pub-` 占位符展示了你通常会使用的形式;它们不是深度限制。匹配基于对象存储域后缀,因此同一命名空间下的更深层名称(`a.b.pub-.r2.dev`)也会被接受。这不会放宽命名空间本身:后缀仍然必须是所列之一。 -下面的示例仅展示形状:真实值还带有签名查询参数,这里故意省略,因为已发布的示例会永远留在规范中,而真实签名既是泄露的凭证,也是会失效的链接。 -每张图像上限为 25 MiB,单个请求的图像总计上限为 64 MiB。 + 一张图像,形式可以是 Router 代表调用方获取的 https URL,也可以是携带内联字节的 `data:image/;base64,` URI。接受的图像类型为 png、webp 和 jpeg,并且该集合会在解析时强制校验,而不是留给提供商处理;svg、gif、avif 或 tiff 会在这里被拒绝,并指明你发送的图像,而不是变成在离原因两步之外才出现的合作伙伴错误。 +优先使用 URL 形式。base64 载荷大约会膨胀 4/3,而整个请求体上限为 100 MiB,因此内联形式的上限约为 75 MB 的源图像;URL 则完全绕开这一点。本描述末尾所述的每张图像与每个请求的媒体上限比请求体上限更严格,因此对于任何实际尺寸的图像,你会先遇到它们。 +该 URL 必须在不携带你的凭证的情况下完成解析。Router 会在服务器端获取它,并且不会随请求发送任何调用方凭证,因此受支持的形式是预签名 URL,即签名位于查询字符串中的 URL。诸如 `/api/assets/{id}/content` 这类需要认证的端点会向 Router 返回 401,而不是返回图像;请自行请求该 URL,并传入它重定向到的已签名 URL。 +获取操作被限制在一组指定的主机内,而不是开放互联网,并且同一列表会重新应用于你发送的 URL 以及每一次重定向跳转;因此,任何其他主机上的 URL,或会重定向到列表之外的 URL,都会在联系任何提供商之前被拒绝。目前该列表仅包含 Comfy 自己的资产分发:Comfy 资产存储桶下已签名的 `storage.googleapis.com` URL,也就是 `/api/assets/{id}/content` 会将你重定向到的形式。合作伙伴 CDN 或普通 https 主机不在该列表中。 +两项放宽正在陆续推出,而且目前默认都处于关闭状态。它们由同一个切换开关控制并一起启用,因此请将下面所有内容视为即将推出,而不要现在就基于它进行开发;在依赖其中任何一项之前请先咨询。 +第一项是 `POST /customers/storage` 为你的上传签名后写入的存储桶。在推出覆盖到你的环境之前,来自该端点的上传 URL 在此会被拒绝,即使该存储桶属于 Comfy 自己且主机相同也是如此;因此“先上传到 Comfy,再传入 URL”的方式目前还不可用,而可用的形式是 `/api/assets/{id}/content` 重定向到的已签名 URL。 +第二项是按账户启用,而不是一次性对所有人生效,因为这些主机背后的存储桶属于你而不是我们:即使上面的切换开关已打开,未启用第三方入站媒体的账户仍会被拒绝,并会明确告知这一点,而不是告知该主机不受支持。请联系你的 Comfy 联系人,为你的账户启用它。它还会额外允许以下第三方对象存储主机,这些主机中的存储桶属于你,Router 不对其主张所有权:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,采用路径式或带 `.` 前缀的形式均可)、Azure Blob Storage(`.blob.core.windows.net`)以及 Alibaba Cloud OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些明确是对象存储端点:同一提供商域名下的通用端点,例如阿里云函数计算触发器,不在该列表中,会被拒绝。 +匹配的是主机名形式,而不是提供商;因此,上面列出某个提供商并不意味着该提供商能够签发的每个 URL 都会被接受,并且有三种近似但不受支持的形式值得直接说明,因为调用方完全可能带着其中任何一种形式到来。R2 自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为限速的调试主机名,并改为将生产流量指向自定义域名;但自定义域名的主机名中没有任何信息能标识它是 R2,因此 Router 无法将其与任何其他主机区分开来,并会拒绝它。请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 双栈端点(`s3.dualstack..amazonaws.com`)也不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)同样不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些相同形式,因此你不必特意来到这里查看它们。 +上面的 `` 和 `pub-` 占位符展示的是你通常会采用的形式;它们不是深度限制。匹配依据是对象存储域名后缀,因此同一命名空间下更深的名称(`a.b.pub-.r2.dev`)也会被接受。但这不会放宽命名空间本身,后缀仍必须是所列之一。 +下面的示例仅展示形状:真实值还会携带签名查询参数,这里有意省略了这些参数,因为已发布的示例会永远留在规范中,而真实签名既是被泄露的凭证,也是会失效的链接。每张图像上限为 25 MiB,单个请求的图像总量上限为 64 MiB。唯一的例外是 ideogram/ideogram-4-5 Precise Edit(即发送 `image` 的调用),此时 `context_window` 可用:在该情况下每张图像最大可达 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求的图像总量上限为 128 MiB。 - 要返回的图像数量。每张图像都会计费。 + 要返回的图像数量。每张都会计费。 范围:`1` 到 `8` @@ -201,13 +204,13 @@ curl https://api.comfy.org/v2/models/ideogram/ideogram-4-5/requests/$REQUEST_ID
- 质量层级,同时也是计费费率。有来源图像时:very_low、low、medium 或 high(默认 medium)。无来源图像时:low、medium 或 high(默认 high);在文生图请求中使用 very_low 会被拒绝。 + 质量档位,同时也是计费费率。有来源图像时:very_low、low、medium 或 high(默认 medium)。无来源图像时:low、medium 或 high(默认 high);文生图请求中的 very_low 会被拒绝。 - 可能的值:`very_low`、`low`、`medium`、`high` + 可选值:`very_low`、`low`、`medium`、`high` - 用于 Precise Edit 的可选参考图像;需要 `image`。最多四张,带有遮罩时为三张。 + Precise Edit 的可选参考图像;需要 `image`。最多四张,带遮罩时最多三张。 @@ -217,10 +220,10 @@ curl https://api.comfy.org/v2/models/ideogram/ideogram-4-5/requests/$REQUEST_ID - 仅用于生成。输出尺寸。`auto`(默认)、`source`(需要提供图像)或 `WIDTHxHEIGHT`。发送遮罩时请省略该项;同时设置两者的请求会被拒绝。 + 仅生成时可用。输出尺寸。auto(默认)、source(需要图像)或 WIDTHxHEIGHT。发送遮罩时请省略此项;同时设置两者的请求会被拒绝。 -由 Router 在 `GET /v2/models/ideogram/ideogram-4-5/openapi.json` 提供的 schema 生成,它也是请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/ideogram/ideogram-4-5/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用来校验调用的同一份文档。 ### 输出 @@ -229,7 +232,7 @@ curl https://api.comfy.org/v2/models/ideogram/ideogram-4-5/requests/$REQUEST_ID
- 表示该图像是否被认为 true安全的。请仅使用此值为 true 的图像。 + 指示图像是否被视为安全。仅使用此值为 true 的图像。 @@ -249,11 +252,11 @@ curl https://api.comfy.org/v2/models/ideogram/ideogram-4-5/requests/$REQUEST_ID - 本次生成的标识符。 + 生成任务的标识符。 - 用于本次生成的种子。 + 用于该次生成的种子。 ## 示例 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..f620c67b11 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: 56990dce translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": 9c44fce0 + "Schema": c0a0ccaf "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 拒绝(端口为数字但超出范围的 URL 不会被此检查捕获,可能反而以 502 失败)。在这种情况下,对于格式正确的 https URL,调用方可以修复的引用会被以 400 拒绝并指明其主机:在抓取之前检查时,其主机无法解析或无法公开访问;它重定向的次数超过允许值、重定向到不是 https 的 URL,或重定向到无法公开访问的主机;它返回 408 或 429 以外的 4xx;它不是图像;它是无法读取格式的图像;它的图像尺寸头不在前 2 MiB 之内;或者未声明长度或使用分块编码的响应在其图像尺寸头之前就结束了。抓取它的任何其他失败都会使 POST /proxy/krea 以 502 错误失败(Comfy Router 以 500 internal_error 应答):临时的 DNS、TLS 或连接失败,超时,源站返回 408、429、5xx 或其他非 200 状态,或者通过了该检查但在抓取连接时无法解析或无法公开访问的主机。在不接受其他 URL 的环境中,不是实时上传的 app-uploads.krea.ai 链接会以 5xx 错误失败;在接受的环境中,它会像任何其他不可达的引用一样被以 400 拒绝。当服务器尚未确定适用哪种情况时,任何主机不是 app-uploads.krea.ai 链接的 https URL(无论是否公共)都会以 503 错误失败,该错误可以安全重试。文生图时省略。 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..1283b00f7e 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"; @@ -166,9 +167,9 @@ 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` @@ -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)。 @@ -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,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。 - 可能的值:`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)。 @@ -306,11 +307,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/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 中的恰好一个。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、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 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -356,7 +357,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 使用的模型 + 所使用的模型 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..6fa5afefbd 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,7 +154,7 @@ 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` @@ -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,7 +226,7 @@ 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。 @@ -235,7 +236,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 中的一个。 @@ -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 中会被拒绝。 @@ -263,7 +264,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - `keyframes` 的输出帧位置,长度相同;5s 时为 0–120,10s 时为 0–240。原样转发。 + `keyframes` 的输出帧位置,长度与 `keyframes` 相同;5s 时为 0–120,10s 时为 0–240。会原样转发。 @@ -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,17 +288,17 @@ 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 中的一个。 @@ -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` 提供的 schema 生成,该文档也是 Router 在请求到达提供商之前用于校验调用的同一份文档。 +本页内容根据 Router 在 `GET /v2/models/luma_2/uni-1-max/openapi.json` 提供的 schema 生成,该文档也是在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -329,13 +330,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 供程序化处理的机器可读失败代码 + 用于程序化处理的机器可读失败代码 可能的值:`content_moderated`、`generation_failed`、`budget_exhausted`、`output_not_found` - 人类可读的失败描述,仅在生成状态为 FAILED 时填充。成功时为 `null`。 + 人类可读的失败描述,仅在生成状态为 FAILED 时填充。生成成功时为 `null`。 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..f9c564caea 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"; @@ -153,13 +154,13 @@ 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` - 用于风格/内容引导的参考图像。类型为 '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 视频的输出分辨率。默认为 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 搜索接地 + 启用网络搜索增强 -由 Router 在 `GET /v2/models/luma_2/uni-1/openapi.json` 提供并据此生成的 schema,与它在请求到达提供商之前校验调用时所使用的是同一份文档。 +根据 Router 在 `GET /v2/models/luma_2/uni-1/openapi.json` 提供的 schema 生成,该 schema 与 Router 在请求到达提供商之前用于校验调用的文档相同。 ### 输出 @@ -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`。 + 人类可读的失败描述,仅在生成处于失败状态时填充。生成成功时为 `null`。 @@ -347,15 +348,15 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 生成的输出条目 + 一条已生成的输出条目 - 媒体类型(例如 image) + 媒体类型(例如图像) - 预签名 URL(1 小时有效) + 预签名 URL(1 小时有效期) diff --git a/zh/development/comfy-router/models/openai/gpt-image-1-5/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-1-5/code.mdx index 1090634211..561bd8a5d7 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-1-5/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-1-5/code.mdx @@ -2,12 +2,12 @@ title: "将 GPT Image 1.5 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 openai/gpt-image-1.5:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "GPT Image 1.5" -translationSourceHash: 38ba43fc +translationSourceHash: a1545fc4 translationFrom: development/comfy-router/models/openai/gpt-image-1-5/code.mdx translationBlockHashes: "_intro": 7a84676f "Quick start": f364e3f2 - "Schema": 43008228 + "Schema": 8b660697 "Examples": c73859ec --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-1.5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -159,40 +160,42 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-1.5/requests/$REQUEST_ID \ ### 输入 - 背景透明度。`auto` 由模型自行选择。 + 背景透明度。`auto` 让模型自行选择。 - 可选值:`transparent`、`opaque`、`auto` + 可能的值:`transparent`、`opaque`、`auto` - 要编辑的来源图像。此字段是否出现即决定选择编辑操作:若要文生图,请完全省略该字段。 -模型公布的示例是生成调用,其中省略了此字段。添加 `image` 就是两种模式之间的全部差异,端点相同、模型 ID 也相同;唯一的区别是编辑提示词描述的是你想要的更改而不是场景,因此下面的编辑请求体读起来与生成示例不同,尽管在结构上只有这一个字段是新增的。 -它可以原封不动地照抄使用:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`,其中的 payload 是一个完整的 1x1 PNG,并非缩写,而且这个请求体在 Router 自身的请求验证测试中被固定为可接受的用例。请替换为你自己图像的字节。 -接受单张图像或由它们组成的数组;gpt-image-1 及更高版本最多接受 16 张,Router 会在派发前依据此 schema 强制执行该限制。 + 要编辑的来源图像。此字段存在即选择编辑操作:完全省略它则进行文生图生成。 +模型发布的示例是生成调用,其中省略了此字段。添加 `image` 就是两种模式之间的全部差异:相同端点、相同模型 ID;只不过编辑提示描述的是你想要的更改而不是场景,因此下面的编辑请求体读起来与生成示例不同,即使从结构上看只有此字段是新增的。 +可以完全按原样复制:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`。载荷是完整的 1x1 PNG,不是缩略形式,并且此请求体在 Router 自身的请求验证测试中被固定为已接受用例。请替换为你自己图像的字节。 +接受一张图像或一个图像数组;gpt-image-1 及更高版本最多接受 16 张,Router 会在派发前根据此 schema 强制执行。 - 一张图像,既可以是 Router 代表调用方抓取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。接受的图像类型为 png、webp 和 jpeg,该集合在解析时就会被强制执行,而不是交由提供商处理:svg、gif、avif 或 tiff 会在这里被拒绝,并指出你发送的是哪张图像,而不是在两跳之外变成一个远离起因的合作伙伴错误。 -优先使用 URL 形式。base64 payload 大约会膨胀 4/3,而整个请求体上限为 100 MiB,因此内联形式的上限约为 75 MB 的来源图像;使用 URL 则完全避开这一问题。本描述末尾说明的单张图像与单次请求的媒体上限比请求体上限更严格,因此对于任何实际大小的图像,你会先触及这些上限。 -该 URL 必须无需你的凭证即可解析。Router 会在服务器端抓取它,且请求中不携带任何调用方凭证,因此支持的形式是预签名 URL,也就是签名位于查询字符串中的那种。诸如 `/api/assets/{id}/content` 这类需要认证的端点会向 Router 返回 401 而不是图像;请你自己请求该 URL,并传入它重定向到的已签名 URL。 -抓取范围被限定在一组指名的主机上,而不是整个开放互联网,并且同一份列表会重新应用到每一次重定向跳转以及你发送的 URL 上:因此位于任何其他主机上的 URL,或重定向到列表之外主机的 URL,都会在任何提供商被联系之前被拒绝。目前该列表仅包含 Comfy 自身的资产交付:Comfy 资产桶下已签名的 `storage.googleapis.com` URL,这正是 `/api/assets/{id}/content` 重定向你到达的形式。合作伙伴 CDN 或普通 https 主机不在该列表上。 -有两项放宽正在逐步推出,目前两者默认均处于关闭状态。它们通过同一个切换项发布并一起启用,因此请把下面所有内容视为即将推出,而不是现在就据此开发:在依赖其中任何一项之前请先咨询。 -第一项是 `POST /customers/storage` 为你上传签名所用的桶。在推出到达你的环境之前,来自该端点的上传 URL 会在这里被拒绝,即便该桶属于 Comfy 自身且主机也相同,因此“上传到 Comfy,再传入 URL”目前并不奏效,而可行的形式是 `/api/assets/{id}/content` 重定向到的已签名 URL。 -第二项是按账户启用,而不是对所有账户同时开放,因为这些主机背后的桶属于你而不是我们:即便上面的切换项已打开,未启用第三方入站媒体的账户仍会被拒绝,并且返回的提示就是这些字眼,而不是告诉你该主机不受支持。请联系你的 Comfy 对接人为此账户启用。它还会额外允许以下第三方对象存储主机,这些主机的桶属于你,Router 不对其主张所属权:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,路径式或带 `.` 前缀的形式均可)、Azure Blob Storage(`.blob.core.windows.net`)以及阿里云 OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些专门是对象存储端点:同一提供商域名上的常规端点,例如阿里云函数计算触发器,不在该列表上,会被拒绝。 -匹配的是主机名的形式,而不是提供商:因此上面提到某个提供商,并不意味着该提供商能签发的每个 URL 都会被接受,而有三种近似情况值得直接说明,因为调用方完全可能带着其中任何一种出现。R2 自定义域(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为限速的调试主机名,并让生产流量改指自定义域,但自定义域的主机名中没有任何能标识它是 R2 的信息,因此 Router 无法把它与其他任何主机区分开来,只能拒绝它;请对 `.r2.cloudflarestorage.com` 端点做预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 dualstack 端点(`s3.dualstack..amazonaws.com`)同样不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)也不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息中会列出这些相同的形式,因此你不必到这里来阅读它们。 -上面的 `` 和 `pub-` 占位符展示的是你通常会传入的形式,它们并不是深度限制。匹配针对的是对象存储的域名后缀,因此同一命名空间下更深层的名称(`a.b.pub-.r2.dev`)同样会被接受。这并不会放宽命名空间本身:后缀仍然必须是所列出的后缀之一。 -下面的示例只展示形状:真实值还会带上签名查询参数,这里刻意省略了这些参数,因为发布出去的示例会永远留在规范中,而真实签名既是泄露的凭据,也是一个会失效的链接。 -每张图像上限为 25 MiB,单个请求的图像总计上限为 64 MiB。 + 一张图像,可以是 Router 代表调用方抓取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。可接受的图像类型为 png、webp 和 jpeg,并且该集合会在解析时强制执行,而不是留给提供商:svg、gif、avif 或 tiff 会在此被拒绝,并指出你发送的图像,而不是在距离原因两跳之遥的地方变成合作伙伴错误。 +优先使用 URL 形式。base64 载荷大约会膨胀 4/3,而整个请求体上限为 100 MiB,因此内联形式的上限接近 75 MB 的源图像;URL 则完全避开这一点。本描述末尾说明的每张图像和每个请求的媒体上限比请求体上限更严格,因此对于任何实际尺寸的图像,你会先遇到这些上限。 +URL 必须无需你的凭证即可解析。Router 会在服务器端抓取它,并且不会随请求发送调用方凭证,因此受支持的形式是预签名 URL,即签名位于查询字符串中的 URL。诸如 `/api/assets/{id}/content` 这类需要认证的端点会向 Router 返回 401,而不是图像;请自行请求该 URL,并传入它重定向到的签名 URL。 +抓取范围仅限于一组指定主机,而不是开放互联网,同一列表会重新应用于你发送的 URL 以及每一次重定向跳:因此,任何其他主机上的 URL,或一个会重定向到列表之外的 URL,都会在联系任何提供商之前被拒绝。目前该列表仅包含 Comfy 自己的资产分发:Comfy 资产存储桶下已签名的 `storage.googleapis.com` URL,也就是 `/api/assets/{id}/content` 重定向你前往的形式。合作伙伴 CDN 或普通 https 主机不在列表中。 +两项放宽正在逐步推出,并且当前默认都关闭。它们通过一个切换项发布并一起启用,因此请将下面所有内容视为即将推出,而不是现在就可以作为开发依据的内容:在依赖其中任何一项之前请先询问。 +第一项是存储桶:`POST /customers/storage` 会将你的上传签名到该存储桶。在推广到达你的环境之前,来自该端点的上传 URL 会在此被拒绝,即使该存储桶是 Comfy 自己的,且主机也是同一个,因此“先上传到 Comfy,再传入 URL”目前不可行,可行的形式是 `/api/assets/{id}/content` 重定向到的签名 URL。 +第二项按账户启用,而不是一次面向所有人启用,因为这些主机背后的存储桶属于你而不是我们:即使上面的切换项已打开,未启用第三方入站媒体的账户也会被拒绝,并会用这些措辞告知,而不是告知该主机不受支持。请联系你的 Comfy 联系人,为你的账户启用它。它还会接纳以下第三方对象存储主机;这些主机背后的存储桶属于你,Router 不主张其归属:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,采用路径样式或 `.` 前缀形式)、Azure Blob Storage(`.blob.core.windows.net`)以及 Alibaba Cloud OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些具体是对象存储端点:同一提供商域上的通用端点,例如 Alibaba Function Compute 触发器,不在列表中,会被拒绝。 +匹配的是主机名形式,而不是提供商:因此,上面列出一个提供商并不意味着该提供商可以签发的每个 URL 都会被接受,并且有三种近似但不符合的形式值得直接说明,因为调用方确实可能带着其中每一种形式到来。R2 自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为受速率限制的调试主机名,并改为将生产流量指向自定义域名,但自定义域名的主机名中没有任何信息能将其标识为 R2,因此 Router 无法将其与任何其他主机区分开,会予以拒绝:请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 双栈端点(`s3.dualstack..amazonaws.com`)也不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)同样不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些相同形式,因此你不必回到这里查看它们。 +上面的 `` 和 `pub-` 占位符展示的是你通常会用到的形式,它们并不构成深度限制。匹配依据是对象存储的域名后缀,因此同一命名空间下更深的名称(`a.b.pub-.r2.dev`)也会被接受。但这并不会放宽命名空间本身:后缀仍然必须是所列出的其中之一。 + +下面的示例只展示形状:真实值还会携带签名查询参数,这里有意省略,因为公开的示例会永远留在规范中,而真实的签名既是被泄露的凭据,也会变成一条失效的链接。 + +每张图像上限为 25 MiB,单个请求的图像总计上限为 64 MiB。唯一的例外是 ideogram/ideogram-4-5 Precise Edit(发送 `image` 且 `context_window` 可用的调用):其中每张图像最大可达 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求的图像总计最大可达 128 MiB。 - 要运行的 gpt-image 模型。Router 会把所寻址的模型 id 拼接进来,因此寻址 `/v2/models/openai/gpt-image-2` 的调用方不会发送该字段。 + 要运行的 gpt-image 模型。Router 会把所寻址的模型 id 拼接进去,因此寻址 /v2/models/openai/gpt-image-2 的调用方无需发送此字段。 内容审核设置 - 可选值:`low`、`auto` + 可能的值:`low`、`auto` @@ -210,38 +213,38 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-1.5/requests/$REQUEST_ID \ 输出图像的格式 - 可选值:`png`、`webp`、`jpeg` + 可能的值:`png`、`webp`、`jpeg` - 仅在配合实时流时才有意义,而本接口无法提供实时流:即使你发送了 `stream`,它也会被固定为 `false`。在生成请求中,任何不是 `0` 或 `null` 的值都会被以 400 拒绝,无论该请求是否同时发送 `stream: true`;在携带 `image` 的请求中,该字段会被丢弃而不是被转发。请省略它。 + 仅在配合实时流时才有意义,而本接口无法提供实时流:即使你发送 `stream`,它也会被固定为 `false`。在生成类请求中,任何不是 `0` 或 `null` 的值都会被拒绝并返回 400,无论该请求是否同时发送了 `stream: true`;而在携带 `image` 的请求中,该字段会被丢弃而不会转发。请省略此字段。 范围:`0` 到 `3` - 要生成的图像的文字描述,或要对 `image` 执行的编辑的描述。 + 对要生成的图像的文字描述,或要对 `image` 执行的编辑操作的文字描述。 - 已生成或已编辑图像的质量。`xhigh` 和 `max` 是为 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 新增的两个档位;`standard` 和 `hd` 是 dall-e 时代的写法,没有任何被接纳的模型会读取它们。 + 生成或编辑后图像的质量。`xhigh` 和 `max` 是为 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 新增的两个档位;`standard` 和 `hd` 是 dall-e 时代的拼写,任何已收录的模型都不会读取。 - 可选值:`auto`、`low`、`medium`、`high`、`xhigh`、`max`、`standard`、`hd` + 可能的值:`auto`、`low`、`medium`、`high`、`xhigh`、`max`、`standard`、`hd` - 图像的尺寸(例如 1024x1024、1536x1024、auto) + 图像尺寸(例如 1024x1024、1536x1024、auto) - 声明该字段是为了让发送它的调用方不被拒绝,但它在当前接口上是无效的:Router 会在派发之前将其固定为 `false`,因为它捕获的是提供商响应,而不是转发 `text/event-stream`(携带 `image` 的请求则会丢弃该字段,因为编辑结果会在不包含它的情况下重新编码)。没有任何 Comfy 接口提供 gpt-image 的部分图像流式传输:v1 `POST /proxy/openai/images/generations` 入口会以 400 拒绝 `stream: true`,并且绝不会把请求转发到上游,因此请省略该字段,将已完成响应作为单个 JSON 主体读取。由于流从未开启,OpenAI 关于将 `stream: true` 与大于 1 的 `n` 组合使用的限制在这里并不适用;`n` 会按发送的内容原样转发。 + 声明此字段是为了让发送它的调用方不被拒绝,但它在当前接口上是无效的:Router 会在分发前将其固定为 `false`,因为 Router 捕获的是提供商响应,而不是中继 `text/event-stream`(携带 `image` 的请求会改为丢弃该字段,因为编辑结果会在不带该字段的情况下重新编码)。没有任何 Comfy 接口提供 gpt-image 的部分图像流式传输:v1 的 `POST /proxy/openai/images/generations` 入口会以 400 拒绝 `stream: true`,且绝不会把请求转发到上游,因此请省略该字段,并将完成后的响应作为单个 JSON 响应体读取。由于流从不会开启,OpenAI 关于将 `stream: true` 与大于 1 的 `n` 组合使用的限制在此并不适用;`n` 会按发送时的值转发。 - 用于终端用户监测的唯一标识符 + 用于终端用户监控的唯一标识符 -由 Router 在 `GET /v2/models/openai/gpt-image-1.5/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 +本文档依据 Router 在 `GET /v2/models/openai/gpt-image-1.5/openapi.json` 处提供的 schema 生成,该文档与 Router 在请求到达提供商之前用于校验调用的文档相同。 ### 输出 @@ -302,25 +305,25 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-1.5/requests/$REQUEST_ID \ - 已生成图像的背景是 `opaque` 还是 `transparent`,以 OpenAI 为本次生成解析的结果为准。请求参数默认值为 `auto`,因此未固定该参数的调用方可以由此得知实际生成的是哪一种。 + 生成图像的背景是 `opaque` 还是 `transparent`,即 OpenAI 为本次生成解析出的结果。请求参数默认为 `auto`,因此未固定该参数的调用方可以在这里得知实际生成的是哪一种。 - 生成完成时的 Unix 时间戳,以秒为单位。它是 OpenAI 在图像生成响应中声明为 REQUIRED 的唯一成员,因此只要由 OpenAI 生成就一定存在;而在任何 alt 后端 id 上由 fal、pika、wavespeed 或 runware 提供的响应会完全省略它,与其他四个已解析参数成员一样。声明为 `int64`,是因为当前的纪元值已经足够接近 2^31,若不加格式说明,`integer` 在许多 SDK 生成器中会生成 32 位字段。 + 生成完成时的 Unix 时间戳,单位为秒。它是 OpenAI 在图像生成响应中声明为 REQUIRED 的唯一成员,因此只要由 OpenAI 生成,该字段就会出现;对于任何 alt-backed id,由 fal、pika、wavespeed 或 runware 提供的响应则会完全省略它,就像其他四个已解析参数成员一样。声明为 `int64`,是因为当前纪元的数值已足够接近 2^31,未指定格式的 `integer` 会在许多 SDK 生成器中生成 32 位字段。 格式:`int64` - `data[].b64_json` 中字节的编码格式:`png`、`webp` 或 `jpeg`。它是 OpenAI 实际编码所用的格式,即发送了请求中的 `output_format` 时采用该值,未发送时为 `png`,因此解码器可以据此判断,而不必再从请求中推导格式。 + `data[].b64_json` 中字节的编码格式,即 `png`、`webp` 或 `jpeg`。这是 OpenAI 实际编码使用的格式:如果请求中发送了 `output_format`,则为该值;如果未发送,则为 `png`。因此解码器可以直接依据它,而不必从请求中重新推导格式。 - 本次生成实际运行的质量档位:OpenAI 会报告 `low`、`medium`、`high`、`xhigh` 或 `max` 之一。它是已解析的档位,而不是对请求的回显;请求自身的 `quality` 默认值为 `auto`。 + 生成实际运行时所使用的质量层级:OpenAI 会报告 `low`、`medium`、`high`、`xhigh` 或 `max` 之一。这是 RESOLVED 后的层级,而不是对请求的回显;请求自身的 `quality` 默认为 `auto`。 - 本次生成实际运行的像素尺寸,格式为 `x`。它是已解析的尺寸:请求中的 `size` 默认值为 `auto`,并且明确接受 `auto`,因此这里是唯一报告实际所用尺寸的地方。 + 生成实际运行时所使用的像素尺寸,格式为 `x`。这是 RESOLVED 后的尺寸:请求的 `size` 默认为 `auto` 且明确接受 `auto`,因此这里是唯一报告实际所用尺寸的地方。 ## 示例 diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx index 5eebf281c9..1c94664975 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx @@ -2,13 +2,13 @@ title: "将 GPT Image 2.5 Flare 与 Comfy Router 搭配使用" description: "通过 Comfy Router 调用 openai/gpt-image-2.5-flare:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "GPT Image 2.5 Flare" -translationSourceHash: 48fb6d21 +translationSourceHash: e3a1017e translationFrom: development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx translationBlockHashes: "_intro": 1e1ed044 "Quick start": c9749309 "Serving providers": ef0e9384 - "Schema": 122f72c5 + "Schema": a7048d34 "Examples": c73859ec --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/openai/gpt-image-2.5-flare.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -171,37 +172,34 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare/requests/$REQUES ### 输入 - 背景透明度。`auto` 表示由模型自行选择。 + 背景透明度。`auto` 让模型自行选择。 可选值:`transparent`、`opaque`、`auto` - 要编辑的来源图像。存在此字段即选择编辑操作;若要执行文生图生成,则完全省略此字段。 -模型公开的示例是生成调用,其中省略了此字段。添加 `image` 就是两种模式之间的全部差异(相同的端点、相同的模型 id),只不过编辑提示词描述的是你想要的更改,而不是场景,因此下面的编辑请求体读起来与生成示例不同,尽管结构上新增的只有这一个字段。 -它可以完全按所印内容原样复制:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`。其中 payload 是一个完整的 1x1 PNG,而不是缩写,并且该请求体在 Router 自身的请求验证测试中被固定为可接受的用例。请替换为你自己图像的字节。 -接受一张图像或其数组;gpt-image-1 及后续版本最多接受 16 张,Router 会在分发前根据此 schema 强制执行该限制。 + 要编辑的来源图像。此字段的存在即选择了编辑操作:文生图生成时请完全省略它。 +模型公布的示例是生成调用,它省略了此字段。添加 `image` 就是两种模式之间的全部差异:端点相同,模型 id 相同;只不过编辑提示词描述的是你想要的更改而非场景,因此下面的编辑请求体读起来与生成示例不同,尽管从结构上讲只有这个字段是新增的。 +它可按原样直接复制:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`。这里的负载是一个完整的 1x1 PNG,并非缩写,而且这个请求体在 Router 自身的请求验证测试中被固定为一个被接受的用例。替换成你自己图像的字节即可。 +接受单张图像或图像数组;gpt-image-1 及更高版本最多接受 16 张,Router 会在派发之前依据此 schema 强制执行。 - 单张图像,可以是 Router 代调用方抓取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。接受的图像类型为 png、webp 和 jpeg,该集合在解析时即被强制执行,而不是交由提供商决定:svg、gif、avif 或 tiff 会在此处被拒绝,并指明你发送的那张图像,而不会变成距原因两跳之外的合作伙伴错误。 -优先使用 URL 形式。base64 payload 大约会膨胀到 4/3,而整个请求体上限为 100 MiB,因此内联形式对来源图像的上限约为 75 MB;使用 URL 则可完全避开这一点。本描述末尾所述的每张图像与每次请求的媒体上限比请求体上限更严格,因此对于任何实际大小的图像,你首先遇到的会是这些上限。 -该 URL 必须在无需你的凭证的情况下可解析。Router 在服务器端抓取它,并且不会随请求发送任何调用方凭证,因此受支持的形式是预签名 URL,即签名位于查询字符串中的 URL。诸如 `/api/assets/{id}/content` 这样需要认证的端点会向 Router 返回 401 而不是图像;请自行请求该 URL,并传入它重定向到的已签名 URL。 -抓取仅限于一组命名的主机,而不是开放的互联网,并且同一份列表会重新应用于每一个重定向跳转以及你发送的 URL,因此在任何其他主机上的 URL,或者会重定向到列表之外的主机,都会在联系任何提供商之前被拒绝。目前该列表仅包含 Comfy 自身的资产交付:Comfy 资产桶下的已签名 `storage.googleapis.com` URL,也就是 `/api/assets/{id}/content` 将你重定向到的形式。合作伙伴 CDN 或普通的 https 主机不在此列表中。 -有两项放宽正在逐步推出,并且目前默认均为关闭状态。它们位于同一个切换开关之后并一同启用,因此请将以下内容视为即将推出,而不是现在就可以针对其进行开发:在依赖其中任何一项之前请先询问。 -第一项是 `POST /customers/storage` 为你的上传签名写入的桶。在推出到达你的环境之前,来自该端点的上传 URL 会在此处被拒绝,即使该桶是 Comfy 自己的、主机也相同,因此“上传到 Comfy,然后传入该 URL”目前并不可行,可行的形式是 `/api/assets/{id}/content` 重定向到的已签名 URL。 -第二项是按帐户启用,而不是一次性对所有人生效,因为这些主机背后的桶属于你而不是我们:即使上面的开关已打开,未启用第三方入站媒体的帐户仍会被拒绝,并且会以这些措辞告知,而不是告知该主机不受支持。请联系你的 Comfy 对接人以在你的帐户上启用它。它还会接纳以下第三方对象存储主机,这些主机上的桶属于你,Router 对其不作任何所属声明:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,路径样式或带 `.` 前缀的形式均可)、Azure Blob Storage(`.blob.core.windows.net`)以及阿里云 OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些具体是对象存储端点:同一提供商域上的通用端点,例如阿里云函数计算触发器,不在列表中,会被拒绝。 -匹配的是主机名形式,而不是提供商,因此上面提到某个提供商并不意味着该提供商能发出的每个 URL 都被接受;有三种近似情形值得明确指出,因为调用方完全可能以其中每一种形式到来。R2 自定义域(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为受速率限制的调试主机名,并建议生产流量改用自定义域,但自定义域的主机名中没有任何内容表明它属于 R2,因此 Router 无法将其与其他任何主机区分开来,只会拒绝它:请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 dualstack 端点(`s3.dualstack..amazonaws.com`)同样不被接受,请使用普通的区域端点。Azure Blob 的备用 DNS 区(`.z.blob.storage.azure.net`)也不被接受,请使用 `.blob.core.windows.net`。你收到的拒绝信息会指明这些相同的形式,因此你不必来这里阅读它们。 -上面的 `` 和 `pub-` 占位符展示的是你通常会传入的形式;它们并不是对深度的限制。匹配针对的是对象存储的域名后缀,因此同一命名空间下更深的名称(`a.b.pub-.r2.dev`)同样会被接受。但命名空间本身并不会因此放宽:后缀仍必须是所列出的后缀之一。 - -下面的示例只展示形状:真实的值还会携带签名查询参数,这里有意省略,因为发布出来的示例会永远留在规范中,而真实的签名既是被泄露的凭据,也是一个会失效的链接。 - -每张图像的上限为 25 MiB,单个请求中的图像总量上限为 64 MiB。 + 单张图像,可以是 Router 代表调用方获取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。接受的图像类型为 png、webp 和 jpeg,该集合在解析时强制执行,而不是留给提供商处理:svg、gif、avif 或 tiff 会在此处被拒绝,并指出你发送的图像,而不是在离原因两跳之外变成合作伙伴错误。 +优先使用 URL 形式。base64 负载大约会膨胀至 4/3,而整个请求体被限制在 100 MiB,因此内联形式的上限约为 75 MB 的来源图像;URL 则完全绕开这一点。本描述末尾声明的单张图像和单次请求的媒体上限比请求体上限更严格,所以对于任何实际尺寸的图像,你首先会遇到的是它们。 +该 URL 必须在不携带你的凭据的情况下也能解析。Router 在服务器端获取它,并且不会随请求发送任何调用方凭据,因此支持的是预签名 URL,即签名位于查询字符串中的 URL。像 `/api/assets/{id}/content` 这样的认证端点会向 Router 返回 401 而不是图像;请自行请求该 URL,然后传入它重定向到的已签名 URL。 +获取仅限一组具名的主机,而不是开放的互联网,而且相同的列表会重新应用于每一个重定向跳转以及你发送的 URL:因此,位于任何其他主机上的 URL,或者重定向离开该列表的 URL,都会在联系任何提供商之前被拒绝。目前该列表仅为 Comfy 自己的资产交付:Comfy 资产桶下的已签名 `storage.googleapis.com` URL,也就是 `/api/assets/{id}/content` 重定向你到的形式。合作伙伴 CDN 或普通的 https 主机不在该列表上。 +两项放宽正在逐步推出,目前两者默认都处于关闭状态。它们位于同一个切换开关之后并一起启用,因此请将下面的一切视为即将推出,而不是现在就可以依赖的东西:在依赖其中任何一项之前请先询问。 +第一项是 `POST /customers/storage` 将你的上传签名到的桶。在推出到达你的环境之前,来自该端点的上传 URL 会在此处被拒绝,即使该桶是 Comfy 自己的,且主机也相同:所以“上传到 Comfy,然后传入 URL”目前还不行,可行的形式是 `/api/assets/{id}/content` 重定向到的已签名 URL。 +第二项是按账户启用,而不是一次性对所有人启用,因为这些主机背后的桶是你的而非我们的:即使上面的开关已打开,尚未启用第三方入站媒体的账户也会被拒绝,并且会用这些原话告知,而不是告知主机不受支持。请联系你的 Comfy 联系人,为你的账户启用它。它还会额外接受以下第三方对象存储主机,其中桶是你的,Router 对其不作任何所属声明:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,可以是路径风格或 `.` 前缀形式)、Azure Blob Storage(`.blob.core.windows.net`)以及阿里云 OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些具体是对象存储端点:同一提供商域名上的通用端点,例如阿里云函数计算触发器,不在列表上,会被拒绝。 +匹配的是主机名形式,而不是提供商:所以在上文点名某个提供商,并不意味着该提供商能签发的每个 URL 都会被接受,有三个近似情形值得直接说明,因为调用方有理由会带来其中的每一个。R2 自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为受速率限制的调试主机名,并将生产流量指向自定义域名,但自定义域名的主机名中没有任何能标识其为 R2 的信息,因此 Router 无法将其与任何其他主机区分开,会予以拒绝:请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 dualstack 端点(`s3.dualstack..amazonaws.com`)也不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)同样不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些相同的形式,因此你不必到这里来阅读它们。 +上面的 `` 和 `pub-` 占位符展示了通常传入的形式;它们不是深度限制。匹配依据是对象存储域名后缀,因此同一命名空间下更深层的名称(`a.b.pub-.r2.dev`)也会被接受。不会因此放宽的是命名空间本身:后缀仍必须是所列后缀之一。 +下面的示例仅展示形状:真实值还会携带签名查询参数,这里有意省略了这些参数,因为已发布的示例会永久留在规范中,而真实签名既是被泄露的凭据,也是会失效的链接。 +每张图像上限为 25 MiB,单个请求中的图像总量上限为 64 MiB。唯一的例外是 ideogram/ideogram-4-5 Precise Edit(会发送 `image` 的调用),其中 `context_window` 可用:此时每张图像最大可为 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求中的图像总量最大可为 128 MiB。 - - 要运行的 gpt-image 模型。Router 会把所寻址的模型 id 拼接进来,因此寻址 /v2/models/openai/gpt-image-2 的调用方不会发送该字段。 + 要运行的 gpt-image 模型。Router 会将所寻址的模型 ID 拼接进去,因此寻址 /v2/models/openai/gpt-image-2 的调用方无需发送此字段。 @@ -229,34 +227,34 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare/requests/$REQUES - 仅在配合实时流时才有意义,而本接口无法提供实时流:即使你发送了 `stream`,它也会被固定为 `false`。在生成请求中,任何不是 `0` 或 `null` 的值都会被以 400 拒绝,无论该请求是否同时发送 `stream: true`;在携带 `image` 的请求中,该字段会被丢弃,而不是被转发。请省略该字段。 + 仅在与实时流配合时才有意义,而此接口无法提供实时流:即使你发送了 `stream`,它也会被固定为 `false`。在生成请求中,除 `0` 或 `null` 以外的任何值都会被以 400 拒绝,无论请求是否同时发送 `stream: true`;在携带 `image` 的请求中,该字段会被丢弃而不会转发。请省略它。 范围:`0` 到 `3` - 要生成的图像或要对 `image` 所做编辑的文本描述。 + 用于描述要生成的图像,或描述要对 `image` 进行的编辑的文本。 - 已生成或已编辑图像的质量。`xhigh` 和 `max` 是新增 gpt-image-2.5-flare 与 gpt-image-2.5-sunburst 时所针对的两个档位;`standard` 和 `hd` 是 dall-e 时代的写法,没有任何已准入的模型会读取它们。 + 生成或编辑后图像的质量。`xhigh` 和 `max` 是新增 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 时所针对的两个层级;`standard` 和 `hd` 是 dall-e 时代的拼写,任何已接纳的模型都不会读取。 可能的值:`auto`、`low`、`medium`、`high`、`xhigh`、`max`、`standard`、`hd` - 图像的尺寸(例如 1024x1024、1536x1024、auto) + 图像尺寸(例如 1024x1024、1536x1024、auto) - 声明该字段是为了让发送它的调用方不被拒绝,但它在接口上是惰性的(INERT):Router 会在分发之前将其固定为 `false`,因为它捕获的是提供商的响应,而不是转发 `text/event-stream`(携带 `image` 的请求则会改为丢弃该字段,因为编辑会在不包含该字段的情况下重新编码)。没有任何 Comfy 接口提供 gpt-image 的部分图像流式传输:v1 的 `POST /proxy/openai/images/generations` 入口会以 400 拒绝 `stream: true`,并且绝不会把请求转发到上游,因此请省略该字段,并将已完成的响应作为一个 JSON 主体来读取。由于流从未打开,OpenAI 关于将 `stream: true` 与大于 1 的 `n` 组合使用的限制在这里并不适用;`n` 会按发送时的原样转发。 + 声明此字段是为了让发送它的调用方不会被拒绝,但此接口上该字段是无效的:Router 会在分发前将其固定为 `false`,因为它捕获提供商响应,而不是转发 `text/event-stream`(携带 `image` 的请求则会丢弃该字段,因为编辑结果会在不带该字段的情况下重新编码)。没有 Comfy 接口提供 gpt-image 部分图像流式传输:v1 `POST /proxy/openai/images/generations` 入口会以 400 拒绝 `stream: true`,并且永远不会将请求转发到上游,因此请省略该字段,并将已完成的响应作为一个 JSON 正文读取。由于流从未打开,OpenAI 关于将 `stream: true` 与大于 1 的 `n` 结合使用的限制在这里不适用;`n` 会按发送原样转发。 用于最终用户监控的唯一标识符 -由 Router 在 `GET /v2/models/openai/gpt-image-2.5-flare/openapi.json` 提供的 schema 生成,这也是在请求到达提供商之前它用来校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/openai/gpt-image-2.5-flare/openapi.json` 提供的 schema 生成,该 schema 与它在请求到达提供商之前用于验证调用的文档相同。 ### 输出 @@ -269,7 +267,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare/requests/$REQUES - 修订后的提示词 + 改写后的提示词 @@ -317,25 +315,25 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare/requests/$REQUES - 已生成图像的背景是 `opaque` 还是 `transparent`,即 OpenAI 为本次生成解析出的结果。该请求参数默认为 `auto`,因此没有将它固定下来的调用方可以在这里得知实际生成的是哪一种。 + 生成的图像背景是 `opaque` 还是 `transparent`,以 OpenAI 在本次生成中解析的结果为准。请求参数默认值为 `auto`,因此未将其固定下来的调用方可以在此得知实际生成的是哪一种。 - 生成完成时的 Unix 时间戳,单位为秒。它是 OpenAI 在图像生成响应中声明为 REQUIRED(必填)的唯一成员,因此只要生产者是 OpenAI 就一定会出现;而在任何 alt 后端的 id 上,由 fal、pika、wavespeed 或 runware 提供的响应会完全省略它,与另外四个已解析参数成员一样。声明为 `int64`,因为当今的 epoch 值已足够接近 2^31,未格式化的 `integer` 在许多 SDK 生成器中会生成 32 位字段。 + 本次生成完成时的 Unix 时间戳(单位为秒)。它是 OpenAI 在图像生成响应中声明为 REQUIRED 的唯一成员,因此只要由 OpenAI 生成,该字段就一定会出现;而在任何由备用服务支撑的 ID 上,由 fal、pika、wavespeed 或 runware 提供的响应会完全省略它,与其他四个已解析参数成员一样。声明为 `int64`,是因为当下的 epoch 数值与 2^31 足够接近,未指定格式的 `integer` 会让许多 SDK 生成器产生 32 位字段。 - 格式: `int64` + 格式:`int64` - `data[].b64_json` 中字节的编码格式,可为 `png`、`webp` 或 `jpeg`。它是 OpenAI 实际完成编码所用的格式:发送了请求的 `output_format` 时即为该值,未发送时为 `png`,因此解码器可以直接依据它,而不必从请求中重新推导格式。 + `data[].b64_json` 中字节的编码格式,取值为 `png`、`webp` 或 `jpeg`。它是 OpenAI 实际编码所用的格式:若请求中指定了 `output_format` 则为该值,未指定则为 `png`。因此解码器可以直接依据它,而不必再从请求中重新推导格式。 - 本次生成实际运行的质量层级:OpenAI 会报告 `low`、`medium`、`high`、`xhigh` 或 `max` 之一。它是已解析(RESOLVED)的层级,而不是对请求的回显,请求自身的 `quality` 默认为 `auto`。 + 本次生成实际使用的质量档位,OpenAI 会报告 `low`、`medium`、`high`、`xhigh` 或 `max` 之一。这是已解析后的档位,并非对请求的回显,因为请求自身的 `quality` 默认值为 `auto`。 - 本次生成实际运行的像素尺寸,格式为 `x`。它是已解析(RESOLVED)的尺寸:请求的 `size` 默认为 `auto` 且明确接受 `auto`,因此这里是唯一会报告实际所用尺寸的地方。 + 本次生成实际使用的像素尺寸,格式为 `x`。这是已解析后的尺寸:请求中的 `size` 默认值为 `auto`,并且明确允许 `auto`,因此这里是唯一报告实际所用尺寸的地方。 ## 示例 diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx index c35bc0e02b..e7b608429a 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx @@ -2,13 +2,13 @@ title: "通过 Comfy Router 使用 GPT Image 2.5 Sunburst" description: "通过 Comfy Router 调用 openai/gpt-image-2.5-sunburst:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "GPT Image 2.5 Sunburst" -translationSourceHash: 21e3a50f +translationSourceHash: 89d64476 translationFrom: development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx translationBlockHashes: "_intro": 84874630 "Quick start": 8da85011 "Serving providers": 58af0c87 - "Schema": 8eff0738 + "Schema": 61c5bb52 "Examples": c73859ec --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.5-sunburst.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -177,28 +178,31 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst/requests/$REQ - 要编辑的来源图像。该字段是否出现即决定是否选用编辑操作:完全省略它,就是文生图生成。 -模型公布的示例是生成调用,其中省略了该字段。添加 `image` 就是两种模式之间的全部差异:端点相同、模型 id 相同;区别仅在于编辑提示词描述的是你想要的改动而不是场景,因此下面给出的编辑请求体读起来与生成示例不同,尽管结构上新增的只有这一个字段。 -它可以按打印出来的样子直接复制:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`;其中的 payload 是一张完整的 1x1 PNG,并不是缩写形式,而且该请求体在 Router 自身的请求验证测试中被固定为一个被接受的用例。请替换为你自己图像的字节。 -可接受单张图像或图像数组;gpt-image-1 及之后的模型最多接受 16 张,Router 会在派发之前依据此 schema 强制执行该上限。 + 要编辑的来源图像。此字段一旦存在即选择编辑操作:文生图生成请完全省略该字段。 +模型公布的示例是生成调用,其中省略了该字段。添加 `image` 就是两种模式之间的全部差异:相同的端点、相同的模型 ID。区别在于编辑提示词描述的是你想要的更改,而不是场景,因此下面的编辑请求体与生成示例读起来不同,尽管在结构上只有这个字段是新增的。 +它可以按原样复制:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`。该载荷是一个完整的 1x1 PNG,并非缩写,并且这个请求体已被固定为 Router 自身请求验证测试中的一个通过用例。请替换为你自己图像的字节。 +接受一张图像或其数组;gpt-image-1 及更高版本最多接受 16 张,Router 会在分发之前依据此 schema 强制执行该限制。 - 一张图像,可以是 Router 代表调用方抓取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。可接受的图像类型为 png、webp 和 jpeg,这一集合在解析时就强制执行,而不是留给提供商;svg、gif、avif 或 tiff 会在这里被拒绝,并指明你发送的图像,而不会变成距离根因两个跳转的合作伙伴错误。 -优先使用 URL 形式。base64 payload 大约会膨胀 4/3,而整个请求体上限为 100 MiB,因此内联形式在来源图像接近 75 MB 时就会触顶;URL 则完全避开这一点。本描述末尾给出的单张图像与单次请求的媒体上限比请求体上限更严格,所以对于任何有实际体积的图像,你先遇到的会是它们。 -该 URL 必须在不使用你的凭据的情况下完成解析。Router 在服务器端抓取它,并且不会随请求发送任何调用方凭据,因此受支持的形式是预签名 URL,即签名位于查询字符串中的 URL。诸如 `/api/assets/{id}/content` 这类需要认证的端点会向 Router 返回 401 而不是图像;请你自己请求该 URL,然后传它重定向到的签名 URL。 -抓取被限制在一组具名主机之内,而不是整个开放互联网;同一份列表会重新应用于你发送的 URL,也会应用于每一次重定向跳转;因此位于其他任何主机上的 URL,或者重定向到列表之外的主机,都会在联系任何提供商之前就被拒绝。目前该列表仅包含 Comfy 自己的资产分发:Comfy 资产桶下的签名 `storage.googleapis.com` URL,也就是 `/api/assets/{id}/content` 将你重定向到的形式。合作伙伴 CDN 或普通的 https 主机不在该列表上。 -有两项放宽正在逐步推出,并且二者今天默认都是关闭的。它们位于同一个切换开关之后并一起启用,因此请把下面的一切视为即将推出,而不是现在就可以依据它来构建的东西;在依赖其中任何一项之前请先询问。 -第一项是 `POST /customers/storage` 为你的上传签发到的桶。在推出覆盖到你的环境之前,来自该端点的上传 URL 会在这里被拒绝,即使该桶属于 Comfy 自己、主机也是同一个;因此“先上传到 Comfy,再传 URL”目前并不奏效,可行的形式是 `/api/assets/{id}/content` 重定向到的签名 URL。 -第二项是按账户启用的,而不是一次性对所有人启用,因为这些主机背后的桶属于你而不是我们:即使上面的开关已经打开,未启用第三方入站媒体的账户仍会被拒绝,并且收到的提示就是这句话,而不是被告知主机不受支持。请联系你的 Comfy 对接人,为你的账户启用它。它还会额外允许以下第三方对象存储主机,在这些主机上桶属于你,Router 不对其主张所属权:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 以及 `s3..amazonaws.com`,路径式或带 `.` 前缀的形式均可)、Azure Blob Storage(`.blob.core.windows.net`)和阿里云 OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些具体是对象存储端点:同一提供商域名上的通用端点,例如阿里云函数计算的触发器,不在该列表上,会被拒绝。 -匹配的是主机名形式,而不是提供商;因此上面提到某个提供商,并不意味着该提供商能签发的每个 URL 都会被接受,其中有三个近似形式值得直接说明,因为调用方很可能带着其中的每一个前来。R2 的自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为有限速的调试主机名,并把生产流量引向自定义域名,但自定义域名的主机名中没有任何能表明它是 R2 的信息,因此 Router 无法把它与其他主机区分开来,只能拒绝;请对 `.r2.cloudflarestorage.com` 端点进行预签名,或者使用 `pub-.r2.dev` 形式。S3 的 IPv6 dualstack 端点(`s3.dualstack..amazonaws.com`)同样不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)也不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些相同的形式,因此你不必特意来这里阅读它们。 -上方的 `` 和 `pub-` 占位符展示的是你通常会用到的形式,它们并不是对深度的限制。匹配针对的是对象存储域名后缀,因此同一命名空间下更深的名称(`a.b.pub-.r2.dev`)也会被接受。但这并不会放宽命名空间本身:后缀仍然必须是所列出的后缀之一。 -下面的示例仅展示形状:真实值还会携带签名查询参数,这里有意省略了它们,因为已发布的示例会永久留在规范中,而真实签名既是被泄露的凭据,也是一条会失效的链接。 -每张图像上限为 25 MiB,单个请求的图像总量上限为 64 MiB。 + 一张图像,可以是 Router 代表调用方抓取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。可接受的图像类型为 png、webp 和 jpeg,该集合在解析阶段强制执行,而不是留给提供商处理:svg、gif、avif 或 tiff 会在此处被拒绝,并指明你发送的图像,而不会在距离原因两个环节之外变成合作伙伴错误。 +优先使用 URL 形式。base64 载荷会膨胀约 4/3,而整个请求体上限为 100 MiB,因此内联形式的上限约为 75 MB 的来源图像;URL 则完全绕过这一点。本描述末尾所述的每张图像和每次请求的媒体上限比请求体上限更严格,因此对于任何实际尺寸的图像,你会先遇到这些上限。 +该 URL 必须在不使用你的凭证的情况下即可解析。Router 在服务器端抓取它,且请求中不携带任何调用方凭证,因此预签名 URL(签名位于查询字符串中的 URL)才是受支持的形式。诸如 `/api/assets/{id}/content` 之类的需认证端点会向 Router 返回 401,而不是图像;请自行请求该 URL,并传入它重定向到的已签名 URL。 +抓取仅限于一组具名主机,而非开放的互联网,并且同一份列表会重新应用于每一次重定向跳转以及你发送的 URL,因此位于任何其他主机的 URL,或重定向到列表之外的主机,都会在联系任何提供商之前被拒绝。目前该列表仅包含 Comfy 自己的资产分发:Comfy 资产存储桶下已签名的 `storage.googleapis.com` URL,这正是 `/api/assets/{id}/content` 重定向你前往的形式。合作伙伴 CDN 或普通 https 主机不在该列表中。 +两项放宽正在逐步推出,且目前都默认关闭。它们由同一个切换控制并一同启用,因此请将以下所有内容视为即将推出,而不是现在就可以依赖的东西:在依赖其中任何一项之前请先询问。 +第一项是 `POST /customers/storage` 将你的上传签名到其中的存储桶。在推出到达你的环境之前,来自该端点的上传 URL 会在此处被拒绝,即使该存储桶属于 Comfy 且主机相同也是如此,因此“先上传到 Comfy,再传入 URL”目前尚不可行,可行的形式是 `/api/assets/{id}/content` 重定向到的已签名 URL。 +第二项是按账号启用,而不是一次性对所有人启用,因为这些主机背后的存储桶属于你而非我们:即使上面的切换已开启,未启用第三方入站媒体的账号也会被拒绝,并且会用这些措辞告知,而不是告知主机不受支持。请联系你的 Comfy 联系人,为你的账号启用它。它还会额外允许以下第三方对象存储主机,这些主机的存储桶属于你,Router 不对其主张任何所属权:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,采用路径风格或带 `.` 前缀的形式)、Azure Blob Storage(`.blob.core.windows.net`)以及阿里云 OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些具体是对象存储端点:同一提供商域名下的通用端点,例如阿里云函数计算触发器,不在列表中,会被拒绝。 +匹配的是主机名形式,而不是提供商,因此上面列出某个提供商并不意味着该提供商能签发的每个 URL 都会被接受,有三个近似但不符合的情况值得直接说明,因为调用方有可能合理地带着其中任何一个前来。R2 的自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为受速率限制的调试主机名,并把生产流量指向自定义域名,但自定义域名的主机名中不含任何可标识其为 R2 的信息,因此 Router 无法将其与任何其他主机区分开,会拒绝它:请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 dualstack 端点(`s3.dualstack..amazonaws.com`)同样不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)也不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些同样的形式,因此你不必回到这里查看它们。 +上面的 `` 和 `pub-` 占位符展示的是你通常传入的形式;它们并不是深度限制。匹配依据是对象存储的域后缀,因此同一命名空间下更深层的名称(`a.b.pub-.r2.dev`)也会被接受。这并不会放宽命名空间本身:后缀仍必须是所列出的之一。 + +下面的示例仅展示形状:真实值还会携带签名查询参数,这里有意省略它们,因为已发布的示例会永远留在规范中,而真实签名既是被泄露的凭据,也是一个会失效的链接。 + +每张图像上限为 25 MiB,单个请求的图像总计上限为 64 MiB。唯一例外是 ideogram/ideogram-4-5 Precise Edit(发送 `image` 的调用),其中 `context_window` 可用:此时每张图像最高可达 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求的图像总计最高可达 128 MiB。 + - 要运行的 gpt-image 模型。Router 会拼接所寻址的模型 id,因此调用方在寻址 /v2/models/openai/gpt-image-2 时不会发送该字段。 + 要运行的 gpt-image 模型。Router 会拼入所寻址的模型 ID,因此调用方寻址 /v2/models/openai/gpt-image-2 时不会发送该字段。 @@ -226,34 +230,34 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst/requests/$REQ - 仅在与实时流一起使用时才有意义,而本接口无法提供实时流:即使你发送了 `stream`,它也会被置为 `false`。在生成请求中,任何不是 `0` 或 `null` 的值都会以 400 被拒绝,无论该请求是否同时发送 `stream: true`;对于携带 `image` 的请求,该字段会被丢弃而不是转发。请省略它。 + 仅在与实时流配合时才有意义,而此接口无法提供实时流:即使你发送 `stream`,它也会被置为 `false`。在生成请求中,任何不是 `0` 或 `null` 的值都会被以 400 拒绝,无论请求是否同时发送 `stream: true`;在携带 `image` 的请求中,该字段会被丢弃而不是转发。请省略它。 范围:`0` 到 `3` - 要生成的图像的文本描述,或要对 `image` 所做的编辑的文本描述。 + 用于描述要生成的图像,或要对 `image` 进行的编辑的文本。 - 生成或编辑后图像的质量。`xhigh` 和 `max` 是 gpt-image-2.5-flare 与 gpt-image-2.5-sunburst 新增支持的两个档位;`standard` 和 `hd` 是 dall-e 时代的写法,没有任何已接纳的模型会读取它们。 + 生成或编辑后图像的质量。`xhigh` 和 `max` 是新增 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 时针对的两个层级;`standard` 和 `hd` 是 dall-e 时代的拼写,任何已接纳的模型都不会读取。 可能的值:`auto`、`low`、`medium`、`high`、`xhigh`、`max`、`standard`、`hd` - 图像的尺寸(例如 1024x1024、1536x1024、auto) + 图像尺寸(例如 1024x1024、1536x1024、auto) - 声明该字段,是为了让发送它的调用方不会被拒绝,但它在当前接口上是无效的:Router 会在分发之前将其置为 `false`,因为它捕获的是提供商响应,而不是转发 `text/event-stream`(携带 `image` 的请求则会丢弃该字段,因为编辑会在没有它的情况下重新编码)。没有任何 Comfy 接口提供 gpt-image 部分图像流式传输:v1 的 `POST /proxy/openai/images/generations` 入口会以 400 拒绝 `stream: true`,并且绝不会将该请求转发到上游,因此请省略该字段,将已完成的响应作为单个 JSON 正文读取。由于流从未打开,OpenAI 关于将 `stream: true` 与大于 1 的 `n` 组合使用的限制在这里并不适用;`n` 会按发送时的值转发。 + 声明该字段是为了让发送它的调用方不会被拒绝,但它在当前接口上是无作用的:Router 会在分发前将其置为 `false`,因为它捕获提供商响应,而不是转发 `text/event-stream`(携带 `image` 的请求会改为丢弃该字段,因为编辑会在不带该字段的情况下重新编码)。没有任何 Comfy 接口提供 gpt-image 的部分图像流式传输:v1 `POST /proxy/openai/images/generations` 入口会用 400 拒绝 `stream: true`,并且绝不会将请求转发到上游,因此请省略该字段,并将已完成的响应当作一个 JSON 主体读取。由于流始终不会打开,OpenAI 关于将 `stream: true` 与大于 1 的 `n` 组合使用的限制在这里不适用;`n` 会按原样转发。 用于最终用户监控的唯一标识符 -由 Router 在 `GET /v2/models/openai/gpt-image-2.5-sunburst/openapi.json` 提供的 schema 生成,它也是请求到达提供商之前用于校验调用的同一份文档。 +该内容生成自 Router 在 `GET /v2/models/openai/gpt-image-2.5-sunburst/openapi.json` 提供的 schema,也就是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -314,25 +318,25 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst/requests/$REQ - 已生成图像的背景是 `opaque` 还是 `transparent`,以 OpenAI 在本次生成中解析的结果为准。该请求参数默认为 `auto`,因此未固定该参数的调用方可以在这里得知实际生成的是哪一种。 + 已生成图像的背景是 `opaque` 还是 `transparent`,以 OpenAI 为本次生成解析的结果为准。请求参数默认为 `auto`,因此未固定该参数的调用方可以在这里得知实际生成的是哪一种。 - 生成完成时的 Unix 时间戳(以秒为单位)。它是 OpenAI 在图像生成响应中声明为必填的唯一成员,因此只要生产者是 OpenAI,它就会出现;在任意 alt 支撑的 id 上,由 fal、pika、wavespeed 或 runware 提供的响应会完全省略它,就像其他四个已解析参数成员一样。声明为 `int64`,因为当今的 epoch 值已足够接近 2^31,未做格式限定的 `integer` 会在许多 SDK 生成器中产生 32 位字段。 + 生成为已完成状态时的 Unix 时间戳(秒)。它是 OpenAI 在图像生成响应中声明为必填的唯一成员,因此只要生产者是 OpenAI,它就会出现;而在任何基于备用提供方的 id 上,由 fal、pika、wavespeed 或 runware 提供的响应都会完全省略它,与其他四个已解析参数成员一样。声明为 `int64` 是因为当前纪元的数值已足够接近 2^31,未格式化时 `integer` 会让许多 SDK 生成器生成 32 位字段。 格式:`int64` - `data[].b64_json` 中字节的编码:`png`、`webp` 或 `jpeg`。它是 OpenAI 实际编码所用的格式,即发送了请求的 `output_format` 时为该值,未发送时为 `png`,因此解码器可以直接依据它,而不必从请求中重新推导格式。 + `data[].b64_json` 中字节的编码,取值为 `png`、`webp` 或 `jpeg`。它是 OpenAI 实际编码所用的格式:发送了请求的 `output_format` 时就是该值,未发送时则为 `png`,因此解码器可以直接依据它,而不必从请求中重新推导格式。 - 生成实际运行时所处的质量档位:OpenAI 会报告 `low`、`medium`、`high`、`xhigh` 或 `max` 之一。它是已解析的档位,而不是对请求的回显,请求自身的 `quality` 默认为 `auto`。 + 生成实际运行所用的质量档位,OpenAI 会报告 `low`、`medium`、`high`、`xhigh` 或 `max` 之一。它是解析后的档位,而不是对请求的回显,因为请求自身的 `quality` 默认为 `auto`。 - 生成实际运行时的像素尺寸,格式为 `x`。它是已解析的尺寸:请求的 `size` 默认为 `auto`,并且显式接受 `auto`,因此这里是唯一报告实际使用尺寸的地方。 + 生成实际运行所用的像素尺寸,格式为 `x`。它是解析后的尺寸:请求的 `size` 默认为 `auto` 且明确接受 `auto`,因此这里才是实际所用尺寸的唯一报告位置。 ## 示例 diff --git a/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx index 76a34a3944..050962e024 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -2,13 +2,13 @@ title: "将 GPT Image 2 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 openai/gpt-image-2:端点、请求结构,以及 Router 返回的响应。" sidebarTitle: "GPT Image 2" -translationSourceHash: 6437f5f1 +translationSourceHash: b9cb8af5 translationFrom: development/comfy-router/models/openai/gpt-image-2/code.mdx translationBlockHashes: "_intro": ff220f7e "Quick start": 7ec2e3b6 "Serving providers": 56df172f - "Schema": 0ebd1b14 + "Schema": 4e6e5e53 "Examples": c73859ec --- @@ -16,6 +16,8 @@ translationBlockHashes: + + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -195,7 +197,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2/requests/$REQUEST_ID \ 匹配的是主机名形式,而不是提供商。因此上面提到某个提供商,并不意味着该提供商能签发的每个 URL 都会被接受;有三个近似但不通过的情形值得直接说明,因为调用方很有可能会带着其中任何一个过来。R2 的自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为受速率限制的调试主机名,并让生产流量改用自定义域名,但自定义域名的主机名中没有任何可识别其为 R2 的信息,所以 Router 无法将它与其他任何主机区分开来,从而拒绝它。请对 `.r2.cloudflarestorage.com` 端点做预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 dualstack 端点(`s3.dualstack..amazonaws.com`)也不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)同样不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息中会点明这些相同的形式,因此不必特地来这里查阅。 上面的 `` 和 `pub-` 占位符展示的是你通常会带来的形式;它们并不是对深度的限制。匹配依据的是对象存储的域名后缀,因此同一命名空间下更深的名称(`a.b.pub-.r2.dev`)也会被接受。但由此并未放宽的是命名空间本身:后缀仍必须是所列出的后缀之一。 下面的示例只展示形状:真实的值还会携带签名查询参数,这里有意省略了它们,因为已发布的示例会永远留在规范中,而真实的签名既是被泄露的凭据,也是一个会失效的链接。 -每张图像的上限为 25 MiB,单个请求的图像总计上限为 64 MiB。 +每张图像的上限为 25 MiB,单个请求的图像总计上限为 64 MiB。唯一的例外是 ideogram/ideogram-4-5 Precise Edit(发送 `image` 的调用)在可用 `context_window` 时:那里每张图像最大可达 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求的图像总计最大可达 128 MiB。 diff --git a/zh/development/comfy-router/models/veed/fabric-1-0/code.mdx b/zh/development/comfy-router/models/veed/fabric-1-0/code.mdx index 33bf55a00e..5901f8e255 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..c800871f45 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..6062255945 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: a6f99965 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 - "Result assets": 65fc939b + "Pre-flight cost estimates": 5952af3f + "Result assets": 18fe6dad "Per-model input and output schemas": 61c6bde8 - "Schemas": 77cfa4db + "Schemas": 984bd216 --- @@ -27,6 +27,7 @@ translationBlockHashes: + {/* 生成的文件:请勿手动编辑。 @@ -48,16 +49,16 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 ### `GET /v2/models` -**列出 Comfy Router 可运行的模型。** +**列出 Comfy Router 可以运行的模型。** -列出可用的模型 ID 和计费信息。当 `has_more` 为 true 时使用 `next_cursor`。 +列出可用的模型 ID 和计费信息。当 `has_more` 为 `true` 时,使用 `next_cursor`。 **参数** - 不透明分页游标。 + 不透明的分页游标。 - 类型:[`RouterPageCursor`](#routerpagecursor)。作为 `next_cursor` 返回的不透明游标,长度为 1–512 个字符 + 类型:[`RouterPageCursor`](#routerpagecursor) -- 作为 `next_cursor` 返回的不透明游标,1–512 个字符 @@ -73,13 +74,13 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 **响应** - 成功:模型目录中的一页。 + OK - 模型目录中的一页。 - 响应体:[`RouterModelListResponse`](#routermodellistresponse);响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` + 响应体:[`RouterModelListResponse`](#routermodellistresponse) -- 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` - 未修改:页面未发生变化,仍与调用方在 `If-None-Match` 中发送的 `ETag` 所对应的版本一致。 + Not Modified - 自调用方在 `If-None-Match` 中发送的 `ETag` 以来,该页面没有变化。 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` @@ -87,304 +88,304 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 请求无效。请检查错误类型和请求体。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 凭证缺失或无效。 + 凭据缺失或无效。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 该调用方或模型不允许此请求。 + 该调用方或模型不允许发起此请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 暂时不可用。请采用退避策略重试。 + Router 暂时不可用。请退避后重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}` -**按规范模型 ID 读取单个合作伙伴模型的目录条目。** +**按规范模型 ID 读取单个合作伙伴模型的产品目录条目。** 无需列出完整目录即可读取单个模型的详情。 **参数** - 规范模型 ID `{provider}/{model}` 中的提供商部分。 + 规范 `{provider}/{model}` 模型 ID 中的提供商部分。 - 类型:[`RouterProviderSegment`](#routerprovidersegment)。字母数字 slug,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment) —— 字母数字标识符,例如 `anthropic`,最多 64 个字符 - 规范模型 ID `{provider}/{model}` 中的模型部分。 + 规范 `{provider}/{model}` 模型 ID 中的模型部分。 - 类型:[`RouterModelSegment`](#routermodelsegment)。字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment) —— 字母数字标识符,例如 `claude-opus-4-6`,最多 128 个字符 - 调用方从先前的 `200` 响应中持有的 `ETag`。 + 调用方从之前的 `200` 响应中持有的 `ETag`。 **响应** - OK:该模型的目录条目。 + OK —— 该模型的产品目录条目。 - 响应体:[`RouterModelDetail`](#routermodeldetail)。响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` + 响应体:[`RouterModelDetail`](#routermodeldetail) —— 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` - 未修改:自调用方在 `If-None-Match` 中发送 `ETag` 以来,该条目没有变化。 + Not Modified —— 自调用方在 `If-None-Match` 中发送的 `ETag` 对应版本以来,该条目未发生更改。 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` - 凭证缺失或无效。 + 凭据缺失或无效。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 该调用方或模型不允许发起此请求。 + 该调用方或该模型无权执行此请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 暂时不可用。请使用退避策略重试。 + Router 暂时不可用。请退避重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}` **按规范模型 ID 同步运行合作伙伴模型。** -运行模型,并在同一个响应中收到已完成的结果。 +运行模型,并在同一个响应中收到其已完成的结果。 **参数** - 规范 `{provider}/{model}` 模型 ID 中的提供商部分。 + 规范 `{provider}/{model}` 模型 ID 中表示提供商的部分。 - 类型:[`RouterProviderSegment`](#routerprovidersegment) —— 字母数字 slug,例如 `anthropic`,最长 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment) -- 字母数字 slug,例如 `anthropic`,最长 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中的模型部分。 + 规范 `{provider}/{model}` 模型 ID 中表示模型的部分。 - 类型:[`RouterModelSegment`](#routermodelsegment) —— 字母数字 slug,例如 `claude-opus-4-6`,最长 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment) -- 字母数字 slug,例如 `claude-opus-4-6`,最长 128 个字符 - 由调用方生成的键,用于安全地重试同一次逻辑调用。 + 由调用方生成的密钥,使重试一次逻辑调用变得安全。 - 1 至 255 个字符 + 1–255 个字符 - 选择一个替代提供商来提供该模型,而不是使用其当前默认提供商;`fal`、`wavespeed`、`runware` 和 `higgsfield` 是可选替代项,`GET /v2/models/{provider}/{model}` 会报告某个模型支持其中的哪些。其拒绝按固定顺序检查,靠前的拒绝无论靠后的拒绝是否成立都会直接作答:无法识别的值(根本不是已注册的提供商)会以 `400` 拒绝;然后,在请求体选择 multipart 操作(编辑)的请求上,替代提供商会以 `409` 拒绝,`detail` 以 "this request's `image` selects the edit operation" 开头,但仅当该提供商针对此模型的转换器无法提供该操作时才会如此(若该线路的转换器确实支持该媒体,则正常继续);然后,在已解析出自带密钥(BYOK)凭据的请求上,任何替代提供商都会以 `409` 拒绝,`detail` 以 `this request resolved a BYOK credential` 开头(参见该响应),无论该提供商是否提供此模型;然后是所指定提供商自身的准入校验,当该提供商未对你开启时以 `403` 及 `error_type: not_enabled` 拒绝,当无法评估该准入校验时以 `503` 及 `error_type: service_unavailable` 拒绝;只有越过以上四项后,一个真实但不具备此模型线路的提供商才会以 `400` 及 `error_type: invalid_input` 拒绝,与无法识别的值的答复相同。在自带密钥请求、请求体选择 multipart 操作的请求以及 `strict_mode=true` 下,`fallback_provider` 是惰性的,而不会被拒绝。 + 选择另一个提供商来服务此模型,而不是其当前默认提供商;`fal`、`wavespeed`、`runware` 和 `higgsfield` 是备选提供商,`GET /v2/models/{provider}/{model}` 会报告某个模型支持其中哪些。它的各种拒绝按固定顺序检查,靠前的拒绝无论靠后的拒绝是否成立都会生效:无法识别的值(根本不是已注册的提供商)会被拒绝并返回 `400`;随后,若请求体选择了 multipart 操作(编辑)而指定了备选提供商,则会被拒绝并返回 `409`,其 `detail` 以“this request's `image` selects the edit operation”开头,但仅当该提供商针对此模型的转换器无法服务该操作时才会如此,若某条 leg 的转换器确实携带该媒体,则会正常继续;接下来,若请求解析出了自带密钥(bring-your-own-key)凭据,则任何备选提供商都会被拒绝并返回 `409`,其 `detail` 以 `this request resolved a BYOK credential` 开头(见该响应),无论该提供商是否服务此模型;再接下来是该具名提供商自身的准入检查:当该提供商未为你开启时,会拒绝并返回 `403` 与 `error_type: not_enabled`,当无法评估该检查时,会拒绝并返回 `503` 与 `error_type: service_unavailable`;只有通过以上全部四项之后,真实提供商若对此模型没有 leg,才会被拒绝并返回 `400` 与 `error_type: invalid_input`,与无法识别的值得到相同的应答。在自带密钥请求上、在请求体选择 multipart 操作的请求上以及在 `strict_mode=true` 下,`fallback_provider` 是不生效,而不是被拒绝。 - 仅在配合 `model_provider` 时才有意义。 + 只有与 `model_provider` 一起使用时才有意义。 - 默认值:False + 默认值:否 - 控制当首次尝试因可归因于 Router 或所尝试提供商的原因失败时,Router 是否对该模型的其他已注册提供商重试此调用。省略,或设为 `false` 以外的任何值,都会保持回退开启;`false` 将其关闭。成功的回退响应会带有 `X-Comfy-Router-Fallback-Provider`。在已解析出自带密钥凭据的请求上,无论此参数如何设置,回退都不可用:尝试根本不会发起,首次失败会原样返回给你,这属于惰性而非拒绝:不会由此产生 `409`。出于同样的原因,在请求体选择 multipart 操作的请求上以及 `strict_mode=true` 下也同样如此:这两种情况都会把调用绑定到某个无法在另一个提供商上忠实重放的提供商,因此回退只是被跳过,而不是被拒绝。只有显式指定 `model_provider` 才会以该 `409` 拒绝,而且与这种无条件的跳过不同,它的 multipart `409` 仅适用于转换器无法提供该操作的线路。 + 控制当首次尝试因归因于 Router 或所尝试提供商的原因而失败时,Router 是否针对该模型的另一个已注册提供商重试此调用。省略该参数,或使用除 `false` 之外的任何值,都会保持回退开启;`false` 会将其关闭。成功回退的响应会带有 `X-Comfy-Router-Fallback-Provider`。在解析出了自带密钥凭据的请求上,无论此参数说什么,回退都不可用:根本不会进行该尝试,首次失败会原样返回给你,这属于不生效,而不是被拒绝:这里不会产生任何 `409`。出于同样的原因,在请求体选择 multipart 操作的请求上以及在 `strict_mode=true` 下也是如此:每一种情况都会把调用绑定到一个无法在另一个提供商上忠实重放的提供商,因此回退只是被跳过,而不是被拒绝。只有显式指定 `model_provider` 才会被以该 `409` 拒绝,而且与这种无条件跳过不同,其 multipart 的 `409` 仅适用于转换器无法服务该操作的 leg。 - 选择拒绝此模型输入 schema 未声明的顶层请求体字段,而不是接受它;嵌套字段不做检查,而对于 schema 允许未声明字段或没有已编写 schema 的模型,或者在以 `strict_mode=true` 发送的已执行提交上,都不会拒绝任何内容。 + 选择拒绝此模型输入 schema 未声明的顶层请求体字段,而不是接受它;嵌套字段不会被检查,对于 schema 允许未声明字段或没有编写 schema 的模型,以及在以 `strict_mode=true` 发送的已执行提交上,都不会拒绝任何内容。 - 默认值:False + 默认值:否 **请求体** -`application/json` —— [`RouterModelInput`](#routermodelinput)(必填) +`application/json` -- [`RouterModelInput`](#routermodelinput)(必填) -合作伙伴模型的原生 JSON 输入。没有 `model_provider` 时,请求会在模型的默认提供商上执行原生分发,此请求体即为模型自身的原生 schema,原样转发(`strict_mode` 在此处无意义,不会改变任何内容)。当 `model_provider` 选择替代提供商且 `strict_mode=false`(默认值)时,请求体会在发送前被转换为该提供商的实际 schema:任何无法精确表达的原生字段都会被丢弃,并通过响应的 `X-Comfy-Router-Dropped-Params` 头披露,绝不会静默丢弃。当 `model_provider` 选择替代提供商且 `strict_mode=true` 时,不会执行任何转换:请求体必须已经是该替代提供商自身的实际 schema,而不是此模型的原生 schema(参见 `strict_mode`),并会被原样转发。请求体自身的字段也决定 Router 在支持多种操作的模型上运行哪种操作:对于可编辑的图像模型,包含输入图像会将其从文生图切换为图生图(编辑)操作,该操作可能按其自身的费率计费;对于 Seedance 视频模型,`content[].role` 决定操作(首帧图像选择图生视频,参考图像或片段选择参考生视频)。在原生分发下,Seedance 计费依据 `content` 中的媒体类型而非角色:含任何视频输入的请求按视频转视频计费,否则含任何图像的按图生视频计费,否则按文生视频计费,但由 `draft_task` 项产生的最终渲染会按其渲染的 Draft 的操作计费;有些模型对文生视频和图生视频收取相同费率。当 `model_provider` 选择替代提供商时,每种带条件的操作可能会按该提供商自身的费率计费。 +合作伙伴模型的原生 JSON 输入。不带 `model_provider` 时,请求会在模型的默认提供商上执行原生分发,此请求体就是模型自身的原生 schema,原样转发(此时 `strict_mode` 没有意义,也不会带来任何改变)。当 `model_provider` 选择备选提供商且 `strict_mode=false`(默认值)时,请求体会在发送之前被转换为该提供商的真实 schema:任何无法精确表达的原生字段都会被丢弃,并通过响应的 `X-Comfy-Router-Dropped-Params` 头予以披露,绝不会静默丢弃。当 `model_provider` 选择备选提供商且 `strict_mode=true` 时不执行任何转换:请求体必须已经是该备选提供商自身的真实 schema,而不是此模型的原生 schema(参见 `strict_mode`),并会原样转发。请求体自身的字段还会选择 Router 在支持多种操作的模型上运行哪种操作:对于可编辑的图像模型,包含一张输入图像会将其从文生图切换为图生图(编辑)操作,该操作可能按自己的费率计费;对于 Seedance 视频模型,`content[].role` 选择操作(首帧图像选择图生视频,参考图像或参考片段选择参考生视频)。在原生分发下,Seedance 的计费依据 `content` 中的媒体类型而非角色:任何包含视频输入的请求按视频转视频计费,否则包含任何图像的请求按图生视频计费,否则按文生视频计费;例外是来自 `draft_task` 项的最终渲染,按其所渲染 Draft 的操作计费;某些模型对文生视频和图生视频收取相同费率。当 `model_provider` 选择备选提供商时,每种带条件的操作可能会按该提供商自己的费率计费。 **响应** - OK - 不带 `model_provider`,或带 `model_provider` 且 `strict_mode=false`(默认值;在可能时转换回该模型的原生契约,若转换失败则回退到备选提供商自身的原始响应,失败会被记录日志,绝不会静默处理)时,形状为该模型自身的原生输出;当 `strict_mode=true` 时,则原样返回备选提供商的响应。对于合作伙伴直接以字节形式应答生成的模型,响应体是这些字节,并采用合作伙伴自己的 `Content-Type` 而非 `application/json`;请根据响应的 `Content-Type` 分支处理,不要假定返回的是 JSON 文档。 + OK - 不带 `model_provider`,或带 `model_provider` 且 `strict_mode=false`(默认值,在可能时转换回本模型的原生契约,转换失败时回退到备用提供商自己的原始响应,会记录日志,绝不静默)时,形状是本模型自己的原生输出;当 `strict_mode=true` 时,则原样返回备用提供商的响应。对于由合作伙伴直接以字节形式返回生成结果的模型,响应体就是这些字节,使用合作伙伴自己的 `Content-Type` 而不是 `application/json`;请根据响应的 `Content-Type` 分支处理,不要假定它是一个 JSON 文档。 - Body: [`RouterModelOutput`](#routermodeloutput) 或原始字节(`*/*`) -- Headers: `X-Comfy-Request-Id`、`X-Content-Type-Options`、`X-Comfy-Router-Fallback-Provider`、`X-Comfy-Router-Provider`、`X-Comfy-Router-Dropped-Params`、`X-Comfy-Credits-Used`、`Idempotent-Replayed`、`X-Committed-Spend-Limit`、`X-Committed-Spend-Current`、`X-Committed-Spend-Remaining` + 响应体:[`RouterModelOutput`](#routermodeloutput) 或原始字节(`*/*`) -- 响应头:`X-Comfy-Request-Id`、`X-Content-Type-Options`、`X-Comfy-Router-Fallback-Provider`、`X-Comfy-Router-Provider`、`X-Comfy-Router-Dropped-Params`、`X-Comfy-Credits-Used`、`Idempotent-Replayed`、`X-Committed-Spend-Limit`、`X-Committed-Spend-Current`、`X-Committed-Spend-Remaining` 请求无效。请检查错误类型和请求体。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `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` - 凭证缺失或无效。 + 凭据缺失或无效。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 请求层面的失败 - 请求从未到达模型,或因模型自身未反馈的原因而失败。 + Router 请求级别的失败:请求从未到达模型,或者因模型自身未反馈的原因而失败。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 该调用方或该模型不允许此请求。 + 该调用方或模型不允许执行此请求。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 请检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 后复用同一个 key;`invalid_input` 则需要一个新的 key。此路由上的两种 `invalid_input` 冲突都完全与 key 无关,且任何新 key 都无法消除其中任何一种:当请求体选择的是某个多部分操作(编辑),而该提供商针对此模型的转换器无法处理时,指定备选提供商的 `model_provider` 会被拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;以及在此之后检查的,当请求已经为路径中的提供商解析出自备密钥(BYOK)凭证时会被拒绝,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或不带 BYOK 凭证发送请求,并且(对于多部分的情况)不带编辑操作。 + 检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 并复用同一个 key;`invalid_input` 则要求使用新的 key。此路由上有两种 `invalid_input` 冲突与 key 完全无关,任何新 key 都无法消除:当请求体选择的是该提供商针对此模型的转换器无法处理的多部分操作(编辑)时,用 `model_provider` 指定备用提供商会遭到拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;之后还会检查另一种情况:请求已经为路径中的提供商解析出自带密钥(BYOK)凭据,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭据,并且(针对多部分的情况)不带编辑操作。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当 `concurrency_limit_exceeded` 时) + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当 `concurrency_limit_exceeded` 时) 请求体过大。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 请求内容未通过模型 schema 的校验而被拒绝。 + 请求的内容依据模型 schema 被拒绝。 - Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed` + 响应体:[`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed` - 请检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示应减少并发中的调用;`rate_limited` 表示应等待配额窗口。 + 检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示应减少在途调用;`rate_limited` 表示应等待额度窗口。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Committed-Spend-Limit`、`X-Committed-Spend-Current`、`X-Committed-Spend-Remaining`、`X-Model-Concurrency-Limit`、`X-Model-Concurrency-Current`、`X-Model-Concurrency-Remaining` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Committed-Spend-Limit`、`X-Committed-Spend-Current`、`X-Committed-Spend-Remaining`、`X-Model-Concurrency-Limit`、`X-Model-Concurrency-Current`、`X-Model-Concurrency-Remaining` - 提供商自身的响应无法被转换为结果(`provider_error`)。 + 提供商自己的响应无法转换为结果(`provider_error`)。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Comfy-Upstream-Status` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Comfy-Upstream-Status` - Router 暂时不可用。请退避重试。 + Router 暂时不可用。请退避后重试。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时) + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时) - 请求超过了截止时间。重试之前请先检查错误类型。 + 请求超过了截止期限。重试前请检查错误类型。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Comfy-Upstream-Status`、`Retry-After` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Comfy-Upstream-Status`、`Retry-After` ### `POST /v2/models/{provider}/{model}/estimate` -**在运行模型调用之前估算其价格,而无需实际运行。** +**在运行模型调用之前先为它定价,而无需实际运行。** -返回一份以美元计的预检估算,说明在此模型上运行该请求体会产生多少费用,其定价依据与实际运行计费所依据的同一份费率卡片。这是估算值,而非最终费用:你实际支付的是工作区用量与账单记录中的结算费用。请求体会先按模型的输入 schema 进行校验,与默认运行(不带 `strict_mode`、不带 `reject_unknown_fields`)的校验方式一致,因此不符合模型 schema 的请求体在这里与在运行时一样返回 `422`;不会向提供商派发任何请求,也不会产生任何费用。该结果并非价格锁定:它按 `pricing_as_of` 时点生效的费率计价,而实际运行按其计费定价时生效的费率收费。在该功能逐步推出期间,该路由会返回 `403`,并带有 `error_type: not_enabled`。 +返回一个以美元计的预检估算,表示用此模型运行该请求体将产生的费用,其定价依据与实际运行计费所依据的同一份费率卡(若某模型按其供应商上报的成本计费,则改为依据供应商公布的价格表来估算)。这是估算值,而非最终费用:你实际支付的是工作区用量与账单记录中结算后的费用。请求体会先按模型的输入 schema 进行校验,校验方式与默认运行(未设置 `strict_mode`,也未设置 `reject_unknown_fields`)相同,因此未通过模型 schema 的请求体在此处和在运行时都会得到相同的 `422`;不会向任何提供商派发请求,也不会产生任何扣费。该结果并非价格锁定:它按 `pricing_as_of` 时点生效的费率计价,而一次运行则按计费时生效的费率收费。在该功能逐步推出的期间,此路由会返回 `403`,并带有 `error_type: not_enabled`。 **参数** - 规范的 `{provider}/{model}` 模型 ID 中的小写提供商标识段,即所运行模型所属的合作伙伴。 + 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即被运行模型所属的合作伙伴。 - 类型:[`RouterProviderSegment`](#routerprovidersegment):字母数字标识,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment) -- 字母数字 slug,例如 `anthropic`,最长 64 个字符 - 规范的 `{provider}/{model}` 模型 ID 中的小写模型标识段,即在该提供商下要运行的模型。 + 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内要运行的模型。 - 类型:[`RouterModelSegment`](#routermodelsegment):字母数字标识,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment) -- 字母数字 slug,例如 `claude-opus-4-6`,最长 128 个字符 - 选择用于提供此模型的替代提供商,而非其当前的默认提供商。 + 选择用于提供此模型的备用提供商,以替代其当前的默认提供商。 **请求体** -`application/json`:[`RouterModelInput`](#routermodelinput)(必填) +`application/json` -- [`RouterModelInput`](#routermodelinput)(必填) -合作伙伴模型的原生 JSON 输入,与此模型的同步路由所接受的请求体完全相同。它会按模型自身的输入 schema 进行校验,与默认运行的校验方式一致(此路由不接受 `strict_mode` 或 `reject_unknown_fields`),并由其自身字段(输出数量、输入图像所选的操作)决定计价内容。 +合作伙伴模型的原生 JSON 输入,与此模型的同步路由所接受的请求体完全相同。它会按模型自身的输入 schema 进行校验,与默认运行的校验方式一致(此路由不接受 `strict_mode` 或 `reject_unknown_fields`),并由其自身的字段(输出数量、输入图像所选择的操作)决定计价内容。 **响应** 报价。 - 响应体:[`RouterCostEstimate`](#routercostestimate);响应头:`X-Comfy-Request-Id` + 响应体:[`RouterCostEstimate`](#routercostestimate) -- 响应头:`X-Comfy-Request-Id` 请求无效。请检查错误类型和请求体。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 凭据缺失或无效。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 此调用方或模型不允许该请求。 + 此调用方或此模型不允许该请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 请求体过大。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 估算请求的请求体被模型 schema 拒绝,或其指定的模型与路径中的模型不一致。 + 估算请求的请求体未通过模型的 schema 校验,或指定的模型与路径中的模型不一致。 - 响应体:[`RouterValidationErrorResponse`](#routervalidationerrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 暂时不可用。请使用退避策略重试。 + Router 暂时不可用。请以退避方式重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅在容量不足被拒时) + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅限容量拒绝时) ### `GET /v2/models/{provider}/{model}/openapi.json` -**以 OpenAPI 文档的形式读取单个合作伙伴模型的输入和输出 Schema。** +**以 OpenAPI 文档形式读取单个合作伙伴模型的输入和输出 Schema。** 以独立的 OpenAPI 文档形式读取单个模型的输入和输出 Schema。 @@ -393,29 +394,29 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 规范 `{provider}/{model}` 模型 ID 中的提供商部分。 - 类型:[`RouterProviderSegment`](#routerprovidersegment):字母数字 slug,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字短标识,例如 `anthropic`,最多 64 个字符 规范 `{provider}/{model}` 模型 ID 中的模型部分。 - 类型:[`RouterModelSegment`](#routermodelsegment):字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment),字母数字短标识,例如 `claude-opus-4-6`,最多 128 个字符 - 调用方从之前的 `200` 响应中持有的 `ETag`。 + 调用方此前从 `200` 响应中获取的 `ETag`。 **响应** - OK:该模型的输入和输出 Schema,作为独立的 OpenAPI 文档。 + OK - 该模型的输入和输出 Schema,以独立的 OpenAPI 文档形式呈现。 - 正文:[`RouterModelInputSchemaDocument`](#routermodelinputschemadocument);响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` + 响应体:[`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) - 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` - 未修改:自调用方在 `If-None-Match` 中发送的 `ETag` 以来,文档未发生变化。 + Not Modified - 自调用方在 `If-None-Match` 中发送的 `ETag` 以来,文档未发生变化。 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` @@ -423,71 +424,71 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 凭据缺失或无效。 - 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 此调用方或模型不允许发起该请求。 + 该调用方或该模型不允许发起此请求。 - 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router 无法完成该请求。 - 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 暂时不可用。请退避后重试。 + Router 暂时不可用。请使用退避策略重试。 - 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}/requests` -**将合作伙伴模型运行提交到队列并立即返回。** +**将合作伙伴模型运行任务提交到队列并立即返回。** -Comfy Router 的排队交付模式。请求体与 `POST /v2/models/{provider}/{model}` 为此模型接受的合作伙伴原生 JSON 输入相同:一个请求体形状、一个按模型定义的 schema、两种交付模式。但此路由不会为结果保持连接。它接纳运行,用句柄返回 `201`,调用方稍后通过下面三个读取操作收集结果。 +Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{provider}/{model}` 所接受的合作伙伴原生 JSON 输入相同:同一请求体形状、同一套按模型定义的 schema、两种投递模式,但此路由不会保持连接来等待结果。它会接纳该运行任务,返回 `201` 和一个句柄,调用方随后通过下文所述的三个读取操作获取结果。 **参数** - 规范化 `{provider}/{model}` 模型 ID 中的小写提供商段,即正在运行其模型的合作伙伴。 + 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即运行其模型的合作伙伴。 类型:[`RouterProviderSegment`](#routerprovidersegment):字母数字 slug,例如 `anthropic`,最多 64 个字符 - 规范化 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内要运行的模型。 + 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内要运行的模型。 类型:[`RouterModelSegment`](#routermodelsegment):字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 - 选择服务此模型的备用提供商,而不是其当前默认提供商。 + 选择用于服务此模型的备用提供商,而不是其当前默认提供商。 - 仅与 `model_provider` 一起使用时才有意义。 + 仅在与 `model_provider` 一起使用时才有意义。 默认值:False - 调用方生成的键,使重试一个逻辑调用变得安全。 + 调用方生成的键,可确保重试同一次逻辑调用是安全的。 1–255 个字符 - 选择拒绝此模型的输入 schema 未声明的顶层请求体字段,而不是接受它;不检查嵌套字段;并且,对于其 schema 允许未声明字段或没有已编写 schema 的模型,或者对于使用 `strict_mode=true` 发送的排队提交,不会拒绝任何内容。 + 选择拒绝此模型输入 schema 未声明的顶层请求体字段,而不是接受该字段;不会检查嵌套字段,并且对于其 schema 允许未声明字段或没有已编写 schema 的模型,或者对于使用 `strict_mode=true` 发送的队列提交,不会拒绝任何字段。 默认值:False @@ -496,312 +497,310 @@ Comfy Router 的排队交付模式。请求体与 `POST /v2/models/{provider}/{m `application/json`:[`RouterModelInput`](#routermodelinput)(必填) -合作伙伴模型的原生 JSON 输入,与同步路由为此模型接受的请求体相同;它选择操作,并以相同方式计量:请求体自身的字段决定 Router 在支持多个操作的模型上运行哪个操作(输入图像会将可编辑图像模型切换为图生图,图生图可能按其自身费率计量;Seedance 首帧图像选择图生视频,参考图像或片段选择参考生视频)。在原生调度时,Seedance 请求按 `content` 中的媒体类型计费,而不是按角色计费:任何视频输入都按视频转视频计费,否则任何图像都按图生视频计费,再否则按文生视频计费;例外情况是,来自 `draft_task` 项的最终渲染按其渲染的 Draft 的操作计费,某些模型对文生视频和图生视频收取相同费率;当 `model_provider` 选择备用提供商时,每个带条件的操作可能按该提供商自己的费率计量。相同的提供商选择约定在调度时适用:不提供 `model_provider`,或提供 `model_provider` 且 `strict_mode=false`(默认值)时,请求体是模型的原生文档,并在接纳运行之前根据模型自己的输入 schema 进行验证,因此模型会拒绝的请求体在这里会返回 `422`,而不是一个几分钟后才失败的排队请求;非严格的备用提供商请求体还会在调度时被转换为该提供商的真实 schema。使用 `strict_mode=true` 时,请求体必须已经是备用提供商自己的 schema,并会原样转发:跳过原生 schema 验证,与同步路由完全一样(参见 `model_provider` 和 `strict_mode`)。 +合作伙伴模型的原生 JSON 输入,与同步路由为此模型接受的请求体相同,并且它决定所执行的操作,也按相同方式计费:请求体自身的字段决定 Router 在支持多种操作的模型上运行哪种操作(输入图像会将可编辑图像模型切换为图生图,这可能按单独费率计费;Seedance 的首帧图像会选择图生视频,而参考图像或视频片段会选择参考生视频)。在原生调度时,Seedance 请求按 `content` 中的媒体种类计费,而不是按角色计费:任何视频输入都按视频转视频计费,否则任何图像都按图生视频计费,再否则按文生视频计费;例外是,来自 `draft_task` 项的最终渲染按其渲染的 Draft 对应的操作计费,某些模型对文生视频和图生视频收取相同费率;当 `model_provider` 选择备用提供商时,每种带条件的操作可能会按该提供商自身的费率计费。相同的提供商选择约定在调度时同样适用:未提供 `model_provider`,或提供 `model_provider` 且 `strict_mode=false`(默认值)时,请求体是模型的原生文档,并会在接纳运行任务之前依据模型自身的输入 schema 进行验证,因此模型会拒绝的请求体会在此处返回 `422`,而不是变成一个几分钟后才失败的排队请求;非严格模式下的备用提供商请求体还会在调度时转换为该提供商实际的 schema。使用 `strict_mode=true` 时,请求体必须已经是备用提供商自身的 schema,并会原样转发:跳过原生 schema 验证,与同步路由完全一致(参见 `model_provider` 和 `strict_mode`)。 **响应** - 已创建:运行已进入队列。 + 已创建:运行任务已获准进入队列。 - 响应体:[`RouterQueueSubmitResponse`](#routerqueuesubmitresponse)。响应头:`X-Comfy-Request-Id`、`Idempotent-Replayed` + 响应体:[`RouterQueueSubmitResponse`](#routerqueuesubmitresponse):响应头:`X-Comfy-Request-Id`、`Idempotent-Replayed` - 凭据缺失或无效。 + 凭证缺失或无效。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 无效请求。请检查错误类型和请求体。 + 请求无效。请检查错误类型和请求体。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 请求体过大。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 请求级失败:请求从未到达模型,或因模型本身未报告的原因而失败。 + Router 请求级失败:请求从未到达模型,或由于模型自身未反馈的原因而失败。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 此调用方或模型不允许该请求。对于合作伙伴直接以字节形式返回生成结果的模型,目前无法排队,并会以 `not_enabled` 拒绝;请改为在同步路由上运行它。 + 此调用方或模型不允许该请求。对于合作伙伴直接以字节形式返回生成结果的模型,目前尚不能排队,并会以 `not_enabled` 拒绝;请改为在同步路由上运行。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到模型 ID。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - - 检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此需要等待 `Retry-After` 指示的时间,并复用同一个键;`invalid_input` 则需要使用新的键。此路由上的两种 `invalid_input` 冲突与键完全无关,更换任何新键都无法消除:当请求体选择的是该提供商针对此模型无法处理的 multipart 操作(编辑)时,`model_provider` 指定其他提供商会被拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;之后还会进行另一项检查,如果请求已经为路径中的提供商解析出 bring-your-own-key 凭证,也会被拒绝,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或者在不携带 BYOK 凭证的情况下发送请求,并且(对于 multipart 情况)不带编辑操作。 +Check `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 并复用同一个 key;`invalid_input` 则需要使用新 key。此路由上的两个 `invalid_input` 冲突与 key 完全无关,且任何新 key 都无法消除其中任何一个:当请求正文选择该提供商针对此模型的转换器无法处理的多部分操作(编辑)时,指定备用提供商的 `model_provider` 会被拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;之后还会检查另一种情况,即当请求已经为路径中的提供商解析出自带密钥(BYOK)凭证时,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭证,并且(对于多部分情形)不带编辑操作。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)——响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(出现 `concurrency_limit_exceeded` 时) + 正文:[`RouterErrorResponse`](#routererrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当 `concurrency_limit_exceeded` 时) - 请求内容未通过模型 schema 的校验。 + 请求内容未通过模型的 schema 校验。 - 响应体:[`RouterValidationErrorResponse`](#routervalidationerrorresponse)——响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed` + 正文:[`RouterValidationErrorResponse`](#routervalidationerrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed` - 检查 `X-Comfy-Error-Type`:`queue_backlog_full` 表示你已持有的未完成排队请求数量已达到上限,等其中一个完成后再提交;`rate_limited` 表示需等待限额窗口。 + 检查 `X-Comfy-Error-Type`:`queue_backlog_full` 表示你持有的未完成排队请求已达到允许的上限,因此请在其中一个完成后再次提交;`rate_limited` 表示需要等待配额窗口。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)——响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 暂时不可用。请以退避方式重试。 + Router 暂时不可用。请使用退避策略重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)——响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时) + 正文:[`RouterErrorResponse`](#routererrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时) ### `GET /v2/models/{provider}/{model}/requests/{request_id}` -**收集一次已提交请求的结果。** +**收集一个已提交请求的结果。** -收集端点。对于已成功完成的请求,它返回合作伙伴模型自身的原生输出,与同步路由针对同一模型、同一输入在 `200` 中返回的内容逐字节相同,因此两种交付方式产生同一种结果形状,调用方无需再写一套解析器即可在两者之间切换。 +收集端点。对于已成功完成的请求,它返回合作伙伴模型自身的原生输出,与同步路由的 `200` 针对同一模型和同一输入返回的内容逐字节相同,因此两种交付模式产生同一种结果形状,调用方无需第二个解析器即可在两者之间切换。 **参数** - 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即正在运行其模型的合作伙伴。 + 规范 `{provider}/{model}` 模型 ID 的小写提供商段,即正在运行其模型的合作伙伴。 - 类型:[`RouterProviderSegment`](#routerprovidersegment):字母数字 slug,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字 slug,例如 `anthropic`,最多 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商下要运行的模型。 + 规范 `{provider}/{model}` 模型 ID 的小写模型段,即在该提供商内运行的模型。 - 类型:[`RouterModelSegment`](#routermodelsegment):字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment),字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 - 要定位的排队请求,即提交时在响应体中返回的 `request_id`。 + 要处理的已排队请求,即提交时在响应体中返回的 `request_id`。 - 类型:[`RouterQueueRequestId`](#routerqueuerequestid):`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 + 类型:[`RouterQueueRequestId`](#routerqueuerequestid),`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 **响应** - OK:为产生了结果的请求所存储的结果,该请求可以是已成功完成的请求,也可以是同时带有已记录扣费和已存储结果的终端请求,其结果按合作伙伴自身的媒体类型原样返回,与同步路由的 `200` 完全一致;并且遵循 submit 所接受的同一套提供商选择约定:不带 `model_provider`,或带 `model_provider` 且 `strict_mode=false`(默认值,在可能时转换回该模型的原生约定,转换失败时回退为备用提供商自身的原始响应,并记录日志,绝不静默处理)时,形状为该模型自身的原生输出;当 `strict_mode=true` 时,则为原样返回的备用提供商响应。对于合作伙伴直接以字节形式返回生成结果的模型,响应体是这些字节,其 `Content-Type` 为合作伙伴自身的类型,而非 `application/json`;请根据响应的 `Content-Type` 分支处理,不要假定它是 JSON 文档。 + OK:为产生了结果的请求存储的结果。该请求已成功完成,或是同时带有记录扣费和存储结果的终端请求。它按合作伙伴自己的媒体类型原样返回,与同步路由的 `200` 返回它的方式完全一致,并遵循提交时接受的相同提供商选择约定:未提供 `model_provider`,或提供 `model_provider` 且 `strict_mode=false`(默认值,在可能时转换回此模型的原生约定,转换失败时回退到备用提供商自己的原始响应,并记录日志,绝不静默),形状为此模型自身的原生输出;使用 `strict_mode=true` 时,则是备用提供商的响应原样返回。对于合作伙伴直接以字节返回生成结果的模型,响应体是这些字节,使用合作伙伴自己的 `Content-Type` 而非 `application/json`;请根据响应的 `Content-Type` 进行分支,不要假定它是 JSON 文档。 - 响应体:[`RouterModelOutput`](#routermodeloutput) 或原始字节(`*/*`)。响应头:`X-Comfy-Request-Id`、`X-Content-Type-Options`、`X-Comfy-Credits-Used` + 响应体:[`RouterModelOutput`](#routermodeloutput) 或原始字节(`*/*`);响应头:`X-Comfy-Request-Id`、`X-Content-Type-Options`、`X-Comfy-Credits-Used` - Accepted:请求尚未完成。 + 已接受:请求尚未完成。 - 响应体:[`RouterQueueStatusResponse`](#routerqueuestatusresponse)。响应头:`X-Comfy-Request-Id`、`Retry-After` + 响应体:[`RouterQueueStatusResponse`](#routerqueuestatusresponse);响应头:`X-Comfy-Request-Id`、`Retry-After` - 凭证缺失或无效。 + 缺失或无效的凭据。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 该请求对此调用方或此模型不被允许。 + 此调用方或模型不允许该请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 请求级失败:请求从未到达模型,或失败原因并非模型自身所报告。 + Router 请求级失败:请求从未到达模型,或由于模型本身未报告的原因而失败。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 暂时不可用。请退避重试。 + Router 暂时不可用。请使用退避策略重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 请求处于与该操作冲突的状态。请检查错误类型。 + 请求处于与操作冲突的状态。请检查错误类型。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 请求超过了截止时间。重试前请检查错误类型。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - - Router 请求级失败:请求从未到达模型,或失败原因并非模型自身所报告。 + Router 请求级失败:请求从未到达模型,或由于模型本身未报告的原因而失败。 - 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` -**请求取消某个已提交的请求。** +**请求取消一个已提交的请求。** -请求 Comfy 停止一个尚未完成的请求。这只是一次请求,并不构成保证,而 `202` 正是在表达这一点:`CANCELLATION_REQUESTED` 表示该请求已被接受,并不表示运行已经停止。已经发往合作伙伴处执行的运行仍可能照常完成;而合作伙伴侧完成的生成会被计费,无论是否有人取用其结果。因此,需要知道实际发生了什么情况的调用方,应在此之后读取状态端点。在那里,已生效的取消会表现为 `COMPLETED`,并和其他所有终态结果一样携带一个 `error_type`。 +请求 Comfy 停止一个尚未完成的请求。这是一项请求,而不是保证,`202` 正说明了这一点:`CANCELLATION_REQUESTED` 表示该请求已被接受,并不表示运行已经停止。已经发送给合作伙伴的运行仍可能完成;而合作伙伴完成的生成会被计费,无论是否有人获取结果。因此,需要了解实际结果的调用方应随后读取状态端点,在状态端点中,已生效的取消会显示为 `COMPLETED`,并像其他所有终端结果一样带有 `error_type`。 **参数** - 规范 `{provider}/{model}` 模型 ID 中的小写提供商片段,即正在运行其模型的合作伙伴。 + 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即正在运行其模型的合作伙伴。 - 类型:[`RouterProviderSegment`](#routerprovidersegment) -- 字母数字短标识,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字 slug,例如 `anthropic`,最多 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中的小写模型片段,即在该提供商下要运行的模型。 + 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即要在该提供商内运行的模型。 - 类型:[`RouterModelSegment`](#routermodelsegment) -- 字母数字短标识,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment),字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 - 要处理的已执行请求,即提交时在响应体中返回的 `request_id`。 + 要处理的排队请求,即提交操作在响应正文中返回的 `request_id`。 - 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 + 类型:[`RouterQueueRequestId`](#routerqueuerequestid),`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 **响应** - 已接受 - `CANCELLATION_REQUESTED`。 + 已接受:`CANCELLATION_REQUESTED`。 - 响应体:[`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- 响应头:`X-Comfy-Request-Id` + 正文:[`RouterQueueCancelResponse`](#routerqueuecancelresponse),响应头:`X-Comfy-Request-Id` - 冲突 - `ALREADY_COMPLETED`。 + 冲突:`ALREADY_COMPLETED`。 - 响应体:[`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- 响应头:`X-Comfy-Request-Id` + 正文:[`RouterQueueCancelResponse`](#routerqueuecancelresponse),响应头:`X-Comfy-Request-Id` - 无效请求。请检查错误类型与请求体。 + 无效请求。请检查错误类型和请求正文。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 凭证缺失或无效。 + 凭据缺失或无效。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 该调用方或模型不允许执行此请求。 + 该调用方或模型不允许此请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 暂时不可用。请以退避方式重试。 + Router 暂时不可用。请使用退避策略重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 请求级失败:请求从未到达模型,或因模型自身未反馈的原因而失败。 + Router 请求级失败:请求从未到达模型,或由于模型本身未反馈的原因而失败。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}/status` -**读取单个已提交请求的队列状态。** +**读取一个已提交请求的队列状态。** -轮询端点。它只返回请求的当前状态,从不返回结果,因此客户端可以持续观察一次长时间生成,而不必在每次轮询时传输其输出:当该端点返回 `COMPLETED` 时,再从下面的读取中一次性获取结果。 +轮询端点。它返回的是请求当前的状态,而非结果,因此客户端可以持续观察一次长时间生成,而无须在每次轮询时都传输其输出。当此端点返回 `COMPLETED` 时,再从下方的读取接口一次性获取结果。 **参数** - 规范 `{provider}/{model}` 模型 ID 中的小写提供商片段,即正在运行其模型的合作伙伴。 + 规范 `{provider}/{model}` 模型 ID 中的小写提供商标识段,即正在运行其模型的合作伙伴。 - 类型:[`RouterProviderSegment`](#routerprovidersegment) -- 字母数字短标识,例如 `anthropic`,最长 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment)。字母数字标识,例如 `anthropic`,最多 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中的小写模型片段,即在该提供商下要运行的模型。 + 规范 `{provider}/{model}` 模型 ID 中的小写模型标识段,即在该提供商下要运行的模型。 - 类型:[`RouterModelSegment`](#routermodelsegment) -- 字母数字短标识,例如 `claude-opus-4-6`,最长 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment)。字母数字标识,例如 `claude-opus-4-6`,最多 128 个字符 要查询的排队请求,即提交时在响应体中返回的 `request_id`。 - 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最长 36 个字符 + 类型:[`RouterQueueRequestId`](#routerqueuerequestid)。`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 **响应** - OK - 请求当前的队列状态。 + OK,请求当前的队列状态。 - Body:[`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Headers:`X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source` + 正文:[`RouterQueueStatusResponse`](#routerqueuestatusresponse)。请求头:`X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Credits-Used`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source` - 凭证缺失或无效。 + 凭据缺失或无效。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 该调用方或模型不允许此请求。 + 该调用方或模型无权执行此请求。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 请求级失败:请求从未到达模型,或因模型本身未反馈的原因而失败。 + Router 请求级失败:请求从未到达模型,或因模型自身未反馈的原因而失败。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 暂时不可用。请退避重试。 + Router 暂时不可用。请以退避方式重试。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 请求级失败:请求从未到达模型,或因模型本身未反馈的原因而失败。 + Router 请求级失败:请求从未到达模型,或因模型自身未反馈的原因而失败。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` -此处描述较为简短。模型选择、验证、重试和计费请参阅[使用 Comfy Router API](/zh/development/comfy-router/api),Header 行为请参阅 [Headers](/zh/development/comfy-router/headers)。 +此处的描述较为简短。有关模型选择、验证、重试和计费,请参阅[使用 Comfy Router API](/zh/development/comfy-router/api);有关请求头行为,请参阅[请求头](/zh/development/comfy-router/headers)。 ## 错误分类桶 @@ -839,6 +838,7 @@ Router 错误的机器可读类别,同时也会在 `X-Comfy-Error-Type` 响应 | `queue_timeout` | 已排队的请求等待超过了其队列超时时间,始终未被准入。 | | `request_not_found` | `request_id` 未指向该调用方在此模型下的任何请求。 | | `queue_backlog_full` | 调用方已有过多等待运行的排队请求,因此此次提交被拒绝。 | +| `result_expired` | 请求确实存在且已完成,但其结果已不再存储,因此收集操作没有可返回的内容。 | ## 响应头 @@ -966,41 +966,41 @@ Router 错误的机器可读类别,同时也会在 `X-Comfy-Error-Type` 响应 调用方仍可启动的昂贵模型调用数;在 `429` 时为 `0`。 -## 预检费用预估 +## 预检成本估算 -`POST /v2/models/{provider}/{model}/estimate` 可以在不运行请求体的情况下为其定价,而排队提交(`POST /v2/models/{provider}/{model}/requests`)会在其 `201` 响应中返回与 `estimate` 相同的 [`RouterCostEstimate`](#routercostestimate)。两者都按 Comfy 对该次运行计费所依据的费率卡片来定价。两者返回的任何数值都是预估,并非最终收费:工作区的用量与账单记录中的已结算费用才是最终结果。使用你自己的提供商密钥运行不会由 Comfy 计费(见下文)。在预估功能逐步开放期间,该路由会返回 `403` 以及 `error_type: not_enabled`,并且提交响应会省略 `estimate`。目录中仍然不包含任何价格。 +`POST /v2/models/{provider}/{model}/estimate` 会在不实际运行的情况下为一个请求体定价,而排队提交(`POST /v2/models/{provider}/{model}/requests`)会在其 `201` 响应中返回与 `estimate` 相同的 [`RouterCostEstimate`](#routercostestimate)。两者都依据 Comfy 对该次运行计费所采用的费率卡定价,唯一的例外是按供应商上报成本计费的模型,其价格取自供应商公布的价格表,标记为 `estimated`。返回的每个数字都是估算值,而非最终费用:最终以你工作区用量与账单记录中的结算费用为准。使用自有提供商密钥的运行不由 Comfy 计费(见下文)。在估算功能逐步推出期间,该路由会返回 `403`,并带有 `error_type: not_enabled`,且提交响应会省略 `estimate`。模型目录中仍然不包含价格。 -在读取任何金额之前,先读取 `source`。缺失的数值绝不意味着免费。 +在关注任何金额之前,请先读取 `source`。缺失的数值绝不意味着免费。 -| `source` | 携带字段 | 如何解读 | +| `source` | 携带内容 | 如何解读 | | --- | --- | --- | -| `exact` | `amount`、`amount_cents`、`credits` | 一个按 `pricing_as_of` 中的费率计算、等同于该请求体应收费用的预估;工作区的用量与账单记录中的已结算费用才是最终结果。 | -| `estimated` | `min_amount`、`max_amount` 及其 `_cents` 形式,不含 `amount` | 一个预估,其费用取决于提供商回传的某个数量,而请求体对该数量给出了界限;预期收费落在界限之间,工作区的用量与账单记录中的已结算费用才是最终结果。 | -| `unknown` | `reason`,无数值 | 在运行之前无法给出价格。任何其他 `source` 值都按 `unknown` 处理。 | +| `exact` | `amount`、`amount_cents`、`credits` | 一个估算值,等于该请求体按 `pricing_as_of` 中所列费率应收取的费用;最终以你工作区用量与账单记录中的结算费用为准。 | +| `estimated` | `min_amount`、`max_amount` 及其 `_cents` 形式,不含 `amount` | 一个估算值,其费用取决于提供商回传的某个数量,而请求体为该数量给出了边界;预期费用落在该边界之间,最终以你工作区用量与账单记录中的结算费用为准。 | +| `free` | `amount` "0",`amount_cents` 与 `credits` 为 `0` | 费率卡将该请求定价为零,因此估算值为 `0`;最终以你工作区用量与账单记录中的结算费用为准。只有 `free` 报价才读作 `0`。 | +| `unknown` | `reason`,不含任何数值 | 运行前无法给出价格。将任何其他 `source` 值都视为 `unknown`。 | -`unknown` 预估的 `reason` 是以下之一: +`unknown` 估算的 `reason` 为以下之一: -- `not_quotable`:Router 无法在调用运行之前为其定价,因为它按提供商回传的、而请求体未给出界限的数量计费,或者请求体无法按其发送时的状态定价。任何无法识别的 `reason` 都按 `not_quotable` 处理。 -- `unpriced_model`:费率卡片未为此请求定价。 -- `byok`(仅排队提交):该次运行使用你自己的提供商密钥,因此 Comfy 不收取任何费用。 -- `pricing_unavailable`(仅排队提交):请求被接收时无法读取费率卡片。提交仍会被接受,运行照常计费。 +- `not_quotable`:Router 无法在运行前为这次调用定价,因为它按提供商回传、而请求体未加限定的数量计费,或者请求体无法按其发送的内容定价。将任何无法识别的 `reason` 都视为 `not_quotable`。 +- `unpriced_model`:费率卡未对该请求定价。 +- `byok`(仅排队提交):该次运行使用你自己的提供商密钥,因此 Comfy 不为其计费。 +- `pricing_unavailable`(仅排队提交):请求被接受时无法读取费率卡。提交仍会被接受,运行照常计费。 -Router 在运行之前尚无法定价的模型列在[没有预检预估的模型](/zh/development/comfy-router/limitations#无法预先估算的模型)中。未列在该处的模型对于特定请求体仍可能返回 `unknown`,因此请对每个预估都读取 `source`。 +Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/zh/development/comfy-router/limitations#无法预先估算的模型)中。未列在该处的模型针对特定请求体仍可能返回 `unknown`,因此请对每个估算都读取 `source`。 -预估在以下情况下会采用保守失败策略: +估算采用失败关闭(fail closed)的情形: -- 当某个数值需要费率卡片,而该卡片未加载或已过期时,`/estimate` 会返回 `503`,而不是给出猜测。排队提交绝不会因为其预估而被拒绝;它改为携带 `source: unknown` 和 `reason: pricing_unavailable`。对于根本不能在运行前定价的调用(`not_quotable`),或使用你自己的提供商密钥的排队提交(`byok`),应答时不会读取费率卡片,因此该 `200` 并不说明卡片是否是最新的。 -- `/estimate` 会像默认运行那样,依据模型自身的输入 schema 校验请求体,因此未通过模型 schema 的请求体会得到与该次运行相同的 `422`,以及相同的 `detail[]` 结构。此时不会进行任何定价或派发。 -- 排队提交的幂等重放(`Idempotent-Replayed: true`)会省略 `estimate`,因为原始报价不会被存储。 +- 当某个数值需要费率卡,而费率卡未加载或已过期时,`/estimate` 会返回 `503`,而不是给出猜测。排队提交绝不会因为其估算而被拒绝;它会携带 `source: unknown` 和 `reason: pricing_unavailable`。完全无法在运行前定价的调用(`not_quotable`),或使用自有提供商密钥的排队提交(`byok`),会在不读取费率卡的情况下作答,因此那个 `200` 并不说明费率卡是否最新。 +- `/estimate` 会像默认运行那样,按模型自身的输入 schema 校验请求体,因此不符合模型 schema 的请求体会得到与该次运行相同的 `422`,以及相同的 `detail[]` 形状。此时不会定价,也不会派发。 +- 排队提交的幂等重放(`Idempotent-Replayed: true`)会省略 `estimate`,因为原始报价未被存储。 -预估的局限性。`200` 返回的数值并不承诺该次运行会被接受,也不承诺实际收费正好是这个数值: +估算的局限。一个 `200` 的数字并不代表该次运行一定会被接受,也不代表一定按该金额收费: -- `/estimate` 不接受 `strict_mode` 或 `reject_unknown_fields`,因此它只检查模型的原生契约:一个在备用提供商自身的 schema 下会被 `strict_mode=true` 的运行接受的请求体,在这里可能得到 `422`;而一个会被 `reject_unknown_fields=true` 的运行拒绝的未声明顶层字段,在这里却会被定价。 -- `pricing_as_of` 是费率卡片被获取的时间(若未读取任何卡片,则为预估被应答的时间)。它不是价格锁定:运行按其被计价时生效的费率收费。 -- `/estimate` 报价的是 `model_provider` 指定的那一段,或原生提供商。它不接受 `fallback_provider` 或 `strict_mode` 参数。同步运行如果其 fallback 重试落到另一个提供商上,就按该提供商的费率收费,而预估并未对该费率报价;运行响应中的 `X-Comfy-Router-Fallback-Provider` 表明发生了这种情况。排队提交没有 fallback,因此其 `estimate` 报价的就是实际运行的那一段。 -- 对于同一个请求体,在 `model_provider` 这一段上,或对于会在同级操作上运行的请求体,`/estimate` 与排队提交的 `estimate` 可能为略微不同的文档定价。提交的 `estimate` 按运行实际发送的文档定价。 -- `/estimate` 始终报价平台费用。使用你自己的提供商密钥运行不会由 Comfy 计费,但 `/estimate` 不会检测到这一点,仍会返回一个数值;只有排队提交会返回 `reason: byok`。 -- 美元金额由未取整的美分换算而来,最多保留 8 位小数,可计费的不足一美分的 `amount` 绝不会显示为 `0`。`credits` 为 `round(amount × 211, 2)`,与 `X-Comfy-Credits-Used` 对收费所用的换算相同,因此对于极小的非零价格,`credits` 可能取整为 `0`;在这一点重要时,请以 `amount` 或 `amount_cents` 而非 `credits` 来做预算。该响应头仍是运行事后的数值;余额位于 Comfy 平台上。 +- `/estimate` 不接受 `strict_mode` 或 `reject_unknown_fields`,因此只校验模型的原生约定:一个在 `strict_mode=true` 运行中按备用提供商自身 schema 可以接受的请求体,在这里可能得到 `422`;而某个未声明的顶层字段,在 `reject_unknown_fields=true` 的运行中会被拒绝,在这里却会被定价。Anthropic Messages 模型是例外:其 schema 允许未声明字段,因此 `reject_unknown_fields=true` 的运行不会拒绝任何字段,而估算只会为未声明的顶层字段 `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` 以及空的 `mcp_servers` 定价。任何其他未声明的顶层字段都会使其返回 `unknown`,并带有 `reason: not_quotable`。 +- `pricing_as_of` 是费率卡的获取时间;对于取自供应商公布价格表的 `estimated` 报价,它是读取该价格表的日期(两者都未读取时,则为估算作答的时间)。它不是价格锁定:运行按其被计费评级时生效的费率收费。 +- `/estimate` 为 `model_provider` 指定的分支报价,或为原生提供商报价。它不接受 `fallback_provider` 或 `strict_mode` 参数。同步运行的回退重试落到另一个提供商时,按该提供商的费率计费,而该费率并非估算所报的费率;运行响应上的 `X-Comfy-Router-Fallback-Provider` 表明发生了这种情况。排队提交没有回退,因此其 `estimate` 报的就是实际运行的分支。 +- 对于 `model_provider` 分支上的同一请求体,或对于在同级操作(sibling operation)上运行的请求体,`/estimate` 与排队提交的 `estimate` 可能为略有差异的文档定价。提交的 `estimate` 是按运行实际发送的文档定价的。 +- `/estimate` 始终报出平台费用。使用自有提供商密钥的运行不由 Comfy 计费,但 `/estimate` 不会检测这一点,仍会返回一个数值;只有排队提交才会返回 `reason: byok`。- 美元金额由未舍入的美分渲染,最多保留 8 位小数,可计费的不足 1 美分的 `amount` 绝不会显示为 `0`。`credits` 为 `round(amount × 211, 2)`,这与 `X-Comfy-Credits-Used` 对一次收费所采用的换算相同,因此对于极小的非零价格,`credits` 可能舍入为 `0`;在这一点很重要时,请按 `amount` 或 `amount_cents` 编制预算,而不是按 `credits`。该响应头仍是某次运行结束后的事后数值;余额保存在 Comfy 平台上。 ## 结果资产 @@ -1021,6 +1021,8 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 其他模型返回提供商资产引用或内联字节。提供商 URL 遵循提供商的过期时间,这可能比上述有效期短得多,且 Router 契约未对此作出规定。 +**原始 BytePlus URL(Seedance 2.x,需选择启用)。** 对于 Comfy 已在服务器端选择启用的工作区,Seedance 2.x 的结果还会在已复制的 URL 之外,于 `content.upstream_video_url` 和 `content.upstream_last_frame_url` 中携带 BytePlus 自己的 URL,以及 `content.upstream_expires_at`。没有请求参数,且默认没有任何工作区被选择启用。这些 URL 在生成后 24 小时过期,一旦 BytePlus 清除它们便不再出现;在 Seedance 2.5 上,BytePlus 将每个 URL 的上限设为 100 次下载,而 Router 自己的副本会占用其中一次。每个 URL 都是其对象的持有者凭证:任何持有者在过期前都可以下载该资产。 + 复制是按资产尽力而为的。如果某个复制失败,该条目会保留其提供商引用;响应可以同时包含 Comfy 和提供商 URL,且没有明确的按资产复制状态字段。生成仍会成功并计费。不要根据一个成功重新托管的资产来推断每个 URL 的有效期。 结果是否由 Comfy 托管也决定了已完成的调用以后是否仍能从其 `Idempotency-Key` 记录中重放;上面的 `Idempotency-Key` 参数说明了无法重放时重试会得到怎样的回应。 @@ -1033,20 +1035,38 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 ## Schemas +### RouterBilledWorkspace + +被拒绝的调用原本会扣费的钱包,位于 `RouterErrorResponse.billed_workspace` 上。它回答的是“哪个钱包是空的?”这个问题,并不一定就是调用方 UI 当前已选择的工作区;而且,即使当前打开的是一个有充足余额的团队,团队成员使用个人凭据时,这里命名的仍是其个人钱包。仅在同时存在 `denied_reason` 时才会出现。 + +**字段** + + + 云端工作区 id。在传统通道上不存在。 + + + + `personal` 或 `team`。这是一个开放字符串:其他任何值都应按个人处理。 + + + + 当调用计费到调用方在工作区出现之前的 Metronome 客户,而不是计费到某个云端工作区时,为 `legacy`;该客户没有工作区 id。对于云端工作区则不存在。 + + ### RouterChargesOnPolicyRejection -内容政策拒绝是否会对该模型计费。请将未知值视为可能计费。 +该模型的内容策略拒绝是否计费。将未知值视为可能计费。 类型:`string` ### RouterCostEstimate -对本次调用费用的预估值,以美元计,在派发之前依据该次运行实际计费所用的同一费率卡片定价。它不是最终收费:你实际支付的是工作区用量与账单记录中的结算费用。运行结束后返回的 `X-Comfy-Credits-Used` 是一个取整的事后数值,不是收据。`source` 说明该数字的可信程度:`exact` 带有 `amount`;`estimated` 带有 `min_amount` 和 `max_amount`,不带 `amount`;`unknown` 两者都不带,并带有一个 `reason`。绝不要把缺失的 `amount` 理解为免费。这不是价格锁定:请参见 `pricing_as_of`。 +本次调用将会花费多少美元的预检估算。它在派发之前,依据与运行计费相同的费率卡定价(对于按供应商报告的费用计费的模型,则依据供应商公布的价格表估算)。它不是最终扣费:你实际支付的是工作区用量与账单记录中的结算金额。运行结束后报告的 `X-Comfy-Credits-Used` 是一个四舍五入的事后数字,不是收据。`source` 表示该数字的可信程度:`exact` 带 `amount`;`free` 带 `amount` "0"(费率卡将本次请求定价为零);`estimated` 带 `min_amount` 和 `max_amount`,不带 `amount`;`unknown` 两者都不带,并带一个 `reason`。切勿把缺失的 `amount` 读作免费。它不是价格锁定:见 `pricing_as_of`。 **字段** - `exact` | `estimated` | `unknown`;其他任何值都按 `unknown` 理解。`exact` 和 `estimated` 都只是预估;两者都不是最终收费。`unknown` 不带任何数值。 + `exact` | `estimated` | `free` | `unknown`;其他任何值都按 `unknown` 读取。`exact` 和 `estimated` 标记的都是估算值;两者都不是最终扣费。`free` 表示费率卡将本次请求定价为零,因此 `amount` 为 "0"。`unknown` 不带任何数字。 @@ -1054,25 +1074,25 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 - 预估费用,以十进制字符串表示的美元金额,例如 "0.04",最多 8 位小数,且不使用指数形式。可计费的低于 1 美分的价格绝不会被渲染为 "0"。仅在 `source` 为 `exact` 时出现。这不是最终收费:最终收费是工作区用量与账单记录中的结算费用。 + 估算费用,以美元计的十进制字符串,例如 "0.04",最多 8 位小数且不含指数。可计费的不足一美分的价格绝不会渲染为 "0";只有 `free` 的报价才读作 "0"。仅当 `source` 为 `exact` 或 `free` 时出现。它不是最终扣费:工作区用量与账单记录中的结算金额才是。 - 预估值下限,以十进制字符串表示的美元金额。仅在 `source` 为 `estimated` 时出现。 + 估算值的下限,以美元计的十进制字符串。它是估算值,不是保证的下限:调用可能被计费更少,例如当提供商返回的内容少于请求所需(比如没有返回任何图像)、当估算值是根据过往调用学到的典型价格,或当价格不随请求的数量稳定上升时。仅当 `source` 为 `estimated` 时出现。 - 预估值上限,以十进制字符串表示的美元金额。仅在 `source` 为 `estimated` 时出现。 + 估算值的上限,以美元计的十进制字符串。它是估算值,不是保证的上限:调用可能被计费更多,例如当提供商返回的内容多于请求所需(比如返回的图像多于请求数量)、当估算值是根据过往调用学到的,或当价格不随请求的数量稳定上升时。仅当 `source` 为 `estimated` 时出现。 - 同一数值以美分表示,不做四舍五入,用于算术运算。与 `amount` 一同出现。 + 同一数字以美分表示,不取整,用于算术运算。与 `amount` 一同出现。 double - `min_amount` 以美分表示,不做四舍五入。与 `min_amount` 一同出现。 + `min_amount` 以美分表示,不取整。与 `min_amount` 一同出现。 double @@ -1084,78 +1104,92 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 - 使用平台换算率($1 = 211 积分)换算得到的 `amount` 积分数,四舍五入到 2 位小数,即 `X-Comfy-Credits-Used` 对 `exact` 报价预期携带的数值。该响应头是取整后的事后数值,不是收据;最终以你工作区用量与账单记录中的结算费用为准。 + `amount` 按平台换算($1 = 211 积分)折算为 Comfy 积分,四舍五入到 2 位小数,即 `exact` 报价下 `X-Comfy-Credits-Used` 预期携带的数字。该响应头是四舍五入的事后数字,不是收据;工作区用量与账单记录中的结算金额才是最终结果。 double - 该报价所对应的提供商线路。在排队提交中,它就是将要运行的那条线路。 + 本报价对应的提供商分支。在排队提交中,它就是要运行的那个分支。 - 规范的 Comfy Router 模型 ID,即 `{provider}/{model}`,正是 `POST /v2/models/{provider}/{model}` 上用于寻址该模型的值,因此调用方可以直接将其插入该路径,而无需从其他任何地方重新推导。其 `pattern` 为用单个 `/` 连接的 `RouterProviderSegment` 和 `RouterModelSegment`,`maxLength` 为二者之和加上该分隔符。 + 规范的 Comfy Router 模型 ID,格式为 `{provider}/{model}`,正是用于在 `POST /v2/models/{provider}/{model}` 上寻址该模型的那个值,因此调用方可以直接把它插入该路径,而无需从任何其他内容重新推导。它的 `pattern` 由 `RouterProviderSegment` 和 `RouterModelSegment` 以单个 `/` 连接而成,`maxLength` 为两者长度之和再加上这个分隔符。 类型:[`RouterModelId`](#routermodelid):模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 - 该报价定价所依据的费率卡片的获取时间。该预估不是价格锁定:运行按评级时生效的费率计费,而非此时间点的费率。每当未读取任何费率卡片时(`reason: pricing_unavailable`、`byok`,或无法从任何卡片定价的 `not_quotable` 调用),这里就是该报价被应答的时间。 + 本报价所依据的费率卡的获取时间。估算值不是价格锁定:运行按计费时生效的费率收费,而不是按这一时刻的费率。从供应商公布的价格表取得的 `estimated` 报价(按供应商报告的费用计费的模型)改为携带读取该价格表的日期;而计费数量由该价格表预测、再按费率卡定价的报价(按供应商报告的积分计费的模型)携带两者中较早的日期。只要没有读取任何费率卡(`reason: pricing_unavailable`、`byok`,或无法从任何卡定价的 `not_quotable` 调用),它就是回答该报价的时间。 date-time - 仅在 `source` 为 `unknown` 时出现:`not_quotable`(Router 无法在调用运行之前为其定价:其价格取决于提供商回报的内容,或者请求体未限定计费数量)、`unpriced_model`(费率卡片未对该请求定价)、`byok`(仅排队提交:运行时使用你自己的提供商密钥,因此 Comfy 不为此收取任何费用),或 `pricing_unavailable`(仅排队提交:请求被接受时无法读取费率卡片;这是暂时性的,运行仍会照常计费)。其他任何值都按 `not_quotable` 理解。 + 仅当 `source` 为 `unknown` 时出现:`not_quotable`(Router 无法在运行前为本次调用定价:其价格取决于提供商回报的内容,或者请求体没有界定出计费数量)、`unpriced_model`(费率卡未对本次请求定价)、`byok`(仅排队提交:运行使用你自己的提供商密钥,因此 Comfy 不为其计费),或 `pricing_unavailable`(仅排队提交:请求被准入时无法读取费率卡;这是暂时性的,运行仍照常计费)。其他任何值都按 `not_quotable` 读取。 ### RouterErrorResponse -用于认证、访问、模型查找、配额以及提供商传输失败的错误响应体。 +用于身份验证、访问、模型查找、配额以及提供商传输失败的错误响应体。 **字段** - 人类可读的失败描述,可安全地展示给最终用户。该字段不用于机器解析,请改为根据 `error_type` 进行分支判断。对于已退役模型的 `model_not_found`,当已记录后继模型且调用方可见时,`detail` 会显示 ` was retired on ; use `;若未记录后继模型或调用方不可见,则只显示 ` was retired on `,而不是通常的建议列表。此处指明的后继模型始终是一个有效的目录 ID,调用可以重新指向它。停用日期仍在未来的模型并未退役:它仍会被 `GET /v2/models` 列出,并在该日期之前一直可运行。与 `detail` 的其他部分一样,这段退役措辞仅用于展示,不附带任何兼容性保证。“不用于机器解析”这一规则有两个已记录的例外:在 `POST /v2/models/{provider}/{model}` 上,`409` 会针对三种互不相关但同属 `invalid_input` 分类的情况返回,只有 `detail` 能区分它们:以 "this request's `image` selects the edit operation" 开头的 `detail` 表示 multipart 的 `model_provider` 拒绝,以 `this request resolved a BYOK credential` 开头的 `detail` 表示 BYOK 的 `model_provider` 拒绝;这两者都不会因为换用新的 `Idempotency-Key` 而消除。该路由上任何其他 `invalid_input` `409` 都是密钥冲突。这两个前缀都是稳定的契约条款,可以被匹配。在其他任何地方,根据 `detail` 进行分支判断都不附带兼容性保证。 + 人类可读的失败描述,可以安全地展示给最终用户。不要对其做机器解析,而应改为根据 `error_type` 分支。对于已停用模型上的 `model_not_found`,当记录了后继模型且对调用方可见时,`detail` 会显示 ` was retired on ; use `;否则只显示 ` was retired on `,而不是通常的建议列表。此处指定的后继模型始终是一个有效目录 ID,调用可以重新指向它。停用日期尚在未来的模型不算已停用:在到达该日期之前,它仍会出现在 `GET /v2/models` 中并可继续运行。与 `detail` 的其余内容一样,这段停用措辞仅用于展示,不附带任何兼容性保证。不对其做机器解析这一规则有两个有文档记录的例外:在 `POST /v2/models/{provider}/{model}` 上,`409` 会因三种互不相关但同属 `invalid_input` 分类的情况而返回,且只有 `detail` 能区分它们。以“this request's `image` selects the edit operation”开头的 `detail` 是 multipart `model_provider` 拒绝,以 `this request resolved a BYOK credential` 开头的 `detail` 是 BYOK `model_provider` 拒绝;两者都无法通过新的 `Idempotency-Key` 消除。该路由上任何其他 `invalid_input` 的 `409` 都是密钥冲突。这两个前缀都是稳定的合约术语,可以进行匹配。在其他任何地方,基于 `detail` 分支都不提供兼容性保证。 - 对 Router 失败的粗粒度、机器可读的分类,同时镜像到 `X-Comfy-Error-Type` 响应头,以便调用方无需解析响应体即可分支判断。该集合目前是封闭的,共十九个值:六个请求级分类 `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits` 和 `model_not_found`,以及传输层的 `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found` 和 `queue_backlog_full`。“封闭”描述的是当前文档所记录的集合,并不是一个永远成立的界限:该集合预计还会增长,因此这里刻意使用普通字符串而不是 `enum`,客户端必须将无法识别的值视为 `internal_error`,而不是对上面的列表做穷举 switch,并在下次新增取值时出错。 + Router 故障的粗粒度、机器可读分类,会同步到 `X-Comfy-Error-Type` 响应头,以便调用方无需解析响应体即可分支。该集合封闭为二十个值:六个请求级分类 `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits` 和 `model_not_found`,以及传输级的 `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full` 和 `result_expired`。“封闭”描述的是当前文档所记录的状态,而不是一个永远成立的限制:该集合预计会增长,因此这里特意使用普通字符串而非 `enum`,客户端必须将无法识别的值视为 `internal_error`,而不是对上述列表做穷举式 switch 并在下一次新增时出错。 类型:[`RouterErrorType`](#routererrortype) - 模型提供商给出的、有界且经过净化的拒绝原因,仅当 `error_type` 为 `invalid_input` 且 `X-Comfy-Upstream-Status` 是提供商返回的 `4xx` 或 `2xx` 时才存在,也就是说提供商认为请求格式有误而拒绝,并说明了原因。该状态通常是 `4xx`;对于在成功信封内报告生成被拒绝的提供商,它会是 `2xx`(BytePlus 的失败任务轮询返回 HTTP `200`,原因位于响应体中)。在其他所有失败情形下都不存在,包括提供商 `5xx`、传输失败、内容策略拒绝以及 Router 针对自身提出的任何拒绝。它与 `X-Comfy-Upstream-Detail` 响应头对应。 + 模型提供商给出的、有长度限制且经过脱敏的拒绝请求原因,仅在 `error_type` 为 `invalid_input` 且 `X-Comfy-Upstream-Status` 为提供商的 `4xx` 或 `2xx` 时出现,即提供商以请求格式错误为由拒绝请求并说明了原因。通常该状态是 `4xx`;对于在成功信封内报告生成被拒绝的提供商,则为 `2xx`(BytePlus 的失败任务轮询是 HTTP `200`,原因位于响应体中)。在其他所有失败情形中均不出现,包括提供商 `5xx`、传输失败、内容策略拒绝以及 Router 自身提出的任何拒绝。它与 `X-Comfy-Upstream-Detail` 头对应。 - 内容策略拒绝针对的是哪个输入或输出,采用 Router 层面的封闭词表:`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio`。当提供商未指明具体模态时,仅用 `input` / `output` 这两个值来指明是哪一侧。仅当 `error_type` 为 `content_policy_violation` 且提供商以机器可读代码指明了被拒绝的对象时才存在;否则不存在。绝不会是提供商原文。目前已为 BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI 和 Wan(万相)的拒绝给出该字段,也为 MiniMax Router 的 Nano Banana 链路中的 Gemini 拒绝给出该字段;如果提供商的拒绝未说明针对哪一侧,该字段就会缺失。它与 `X-Comfy-Refusal-Subject` 响应头对应。 + 内容策略拒绝所针对的输入或输出,采用 Router 层面的封闭词汇表:`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio`。当提供商未指明模态时,仅用 `input` / `output` 值来表示是哪一侧。仅当 `error_type` 为 `content_policy_violation` 且提供商使用机器可读代码指明了被拒绝的对象时出现;否则不出现。绝不是提供商文本。目前会为 BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI 和 Wan 的拒绝给出该字段,也会为 MiniMax Router 的 Nano Banana 链路中的 Gemini 拒绝给出该字段;如果提供商的拒绝未说明涉及哪一侧,则该字段不出现。它与 `X-Comfy-Refusal-Subject` 头对应。 + + + + 计费系统针对合作伙伴节点支出拒绝的策略分支:当被计费钱包为空时为 `no_funds`,当调用被拒绝但没有资金读取结果说明原因时为 `unspecified`。仅当 `error_type` 为 `insufficient_credits` 且部署上报钱包相关信息时出现;否则不出现。它是机器可读代码,而非展示文本:请展示 `detail`,并基于此字段分支。 + + + + 被拒绝调用原本会扣款的钱包,位于 `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` 标头中发送。 +机器可读的 Router 错误类别,同时也会在 `X-Comfy-Error-Type` 响应头中发送。 类型:`string` ### RouterModelBilling -调用模型之前需要检查的计费行为。它不包含价格或用量信息。 +调用模型前需要检查的计费行为。它不包含价格或用量信息。 **字段** - 模型以内容政策为由拒绝的调用,是否仍向调用方计费。各提供商的做法不尽相同,而这种差异在调用时无法察觉,因此用户即使同时看到同一次调用的错误与扣费,也无从事先得知。所以这里在调用之前按模型明确说明,而不是留待各提供商各自口口相传。 + 该模型因内容政策原因拒绝的调用,是否仍向调用方计费。不同提供商的处理方式不同,而这种差异在调用时是不可见的,用户如果同一次调用既看到错误又看到扣费,根本无从预先得知。因此这里按模型逐个说明,而不是留待各提供商自行口口相传。当值为 `yes` 时,同步路由上的 `content_policy_violation` 错误可能会携带 `X-Comfy-Credits-Used`:当提供商拒绝了模型生成的输出,且 Comfy 为该次被拒绝的生成记录了用量时,就会携带该响应头,并给出相应的数量。输入端拒绝、同键重放(`Idempotent-Replayed: true`)以及金额过小、无法在响应头的两位小数中显示的扣费都不会携带它;没有该响应头的拒绝不会被报告,但这并不能证明它是免费的。 类型:[`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) ### RouterModelDetail -单个 Comfy Router 模型的逐模型详细信息:目录列表为该模型报告的全部内容,外加只有单模型路由才会携带的逐模型字段。 +单个 Comfy Router 模型的逐模型详情:既包含目录列表为该模型报告的全部内容,也包含只有单模型路由才会携带的逐模型字段。 -组合了 [`RouterModelListEntry`](#routermodellistentry)、[`RouterModelDetailFields`](#routermodeldetailfields)。 +组合了 [`RouterModelListEntry`](#routermodellistentry) 与 [`RouterModelDetailFields`](#routermodeldetailfields)。 类型:`object` @@ -1166,26 +1200,26 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 **字段** - 该模型 OpenAPI 文档的 URL,包含其输入和输出 Schema。 + 此模型的 OpenAPI 文档 URL,包括其输入和输出 schema。 HTTPS URL,例如 `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`,最多 2048 个字符 ### RouterModelId -用于 `POST /v2/models/{provider}/{model}` 的模型 ID。 +在 `POST /v2/models/{provider}/{model}` 中使用的模型 ID。 -类型:`string`。模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符。 +类型:`string`,模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符。 ### RouterModelInput -模型输入对象。请阅读已选择模型的 OpenAPI 文档,了解字段与验证规则。 +模型输入对象。请阅读已选择模型的 OpenAPI 文档以了解字段和验证。 -类型:`object` +类型: `object` ### RouterModelInputSchemaDocument -一份独立描述单个模型输入与输出的 OpenAPI 文档。 +描述单个模型输入与输出的独立 OpenAPI 文档。 类型:`object` @@ -1196,36 +1230,36 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 **字段** - 规范化的 Comfy Router 模型 ID,格式为 `{provider}/{model}`:正是在 `POST /v2/models/{provider}/{model}` 上定位该模型所用的值,因此调用方可以直接把它插值进该路径,无需再从其他任何地方推导。它的 `pattern` 是 `RouterProviderSegment` 与 `RouterModelSegment` 以单个 `/` 连接而成,`maxLength` 则是两者长度之和再加上该分隔符。 + 规范的 Comfy Router 模型 ID,格式为 `{provider}/{model}`,其值正是在 `POST /v2/models/{provider}/{model}` 上寻址该模型时所使用的值,因此调用方可以把它直接插入该路径,而无需从其他信息重新推导。它的 `pattern` 由 `RouterProviderSegment` 与 `RouterModelSegment` 以单个 `/` 连接而成,`maxLength` 为两者长度之和再加上该分隔符。 类型:[`RouterModelId`](#routermodelid),模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 - 规范化 `{provider}/{model}` 模型 ID 中的小写 `provider` 段,即所寻址模型所属的合作伙伴。调用路由的 `provider` 路径参数与目录条目的 `provider` 字段都引用这同一个 schema,正是这一点让列出的 ID 与可接受的 ID 不会彼此偏离。 + 规范 `{provider}/{model}` 模型 ID 中的小写 `provider` 段,即被寻址模型所属的合作伙伴。调用路由的 `provider` 路径参数与目录条目的 `provider` 字段都引用这同一个 schema,这正是所列出的 ID 与所接受的 ID 不会彼此偏离的原因。 - 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字 slug,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字短标识,例如 `anthropic`,最多 64 个字符 - 规范化 `{provider}/{model}` 模型 ID 中的小写 `model` 段,即在该提供商下要运行的模型。调用路由的 `model` 路径参数与目录条目的 `model` 字段共用这一 schema,原因与 `RouterProviderSegment` 相同,同样是为了避免偏离。 + 规范 `{provider}/{model}` 模型 ID 中的小写 `model` 段,即在该提供商下要运行的模型。调用路由的 `model` 路径参数与目录条目的 `model` 字段共用它,原因与 `RouterProviderSegment` 相同,同样是为了避免偏离。 - 类型:[`RouterModelSegment`](#routermodelsegment),字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment),字母数字短标识,例如 `claude-opus-4-6`,最多 128 个字符 - 调用方在调用之前需要了解的单模型计费信息,而不是价格。用量和费用数字绝不会出现在这里。 + 调用方在调用之前需要了解的按模型计费信息,而不是价格。用量与费用数字绝不会出现在这里。 类型:[`RouterModelBilling`](#routermodelbilling) - 该模型 `GET /v2/models/{provider}/{model}/openapi.json` 文档的当前强 `ETag`。在该读取请求中将其作为 `If-None-Match` 发送,当 schema 未发生变化时即可获得 `304`;也可以将其与上次看到的值比较,从而无需获取每个文档就能得知哪些模型的 schema 发生了变化。只要该读取请求此刻无法为此调用方返回 `200`,该字段就会缺失:schema 服务不可用、该模型的文档无法渲染,或者该模型在响应构建期间对此调用方变为不可用。标签缺失并不表示 schema 发生了变化;请重新读取该模型的文档以了解其当前标签。 + 该模型 `GET /v2/models/{provider}/{model}/openapi.json` 文档当前的强 `ETag`。在该读取请求中把它作为 `If-None-Match` 发送,若 schema 未变即可得到 `304`;也可以把它与上一次看到的值比较,从而无需抓取每个文档就能得知哪些模型的 schema 发生了变化。当此刻该读取对该调用方不会返回 `200` 时,该字段缺省:schema 服务不可用、该模型的文档无法渲染,或该模型在响应构建期间对此调用方变为不可用。标签缺省并不代表 schema 发生了变化;重新读取该模型的文档即可获知其当前标签。 ### RouterModelListResponse -Router 模型目录的一页。 +Router 模型目录中的一页。 **字段** @@ -1236,24 +1270,24 @@ Router 模型目录的一页。 - 本页之后是否还有另一页。只要该值为 true,就继续向后翻页;不要因为 `data` 很短或为空就断定目录已到末尾。 + 本页之后是否还有下一页。只要该值仍为 true 就继续遍历;不要因为 `data` 很短或为空就推断目录已经结束。 - 指向 Router 列表的一个不透明游标。它由服务器生成,且仅用于原样往返传递:它不是偏移量,不是模型 ID,没有顺序,也不能在目录重建后保持稳定,因此解析它、对它做自增,或在产生它的那次遍历之外持久化它,都不属于契约范围。之所以使用游标而非偏移量,是因为目录是一个不断变化的列表:当遍历过程中有条目被增删时,基于偏移量的遍历会静默地跳过或重复条目,而调用方无法察觉这种情况已经发生。 + 指向 Router 列表的不透明游标。它由服务器生成,只用于原样回传:它不是偏移量,不是模型 ID,没有顺序,也不会在目录重建后保持稳定,因此解析它、对它做自增,或在产生它的那次遍历之外持久化它,都属于约定之外的做法。之所以使用游标而不是偏移量,是因为目录是一个不断变化的列表。当遍历过程中有条目被添加或删除时,偏移量遍历会静默地跳过或重复条目,而调用方无法察觉这一点。 - 类型:[`RouterPageCursor`](#routerpagecursor),作为 `next_cursor` 返回的不透明游标,1–512 个字符 + 类型:[`RouterPageCursor`](#routerpagecursor)。以 `next_cursor` 返回的不透明游标,长度为 1–512 个字符 - 实际提供的分页大小。请求的 `limit` 超过上限时会被截断到上限,而不是被拒绝,因此该值可能小于你所请求的值。请用这个数字进行分页,而不是你发送的那个数字,否则你会假定存在一些你从未收到的行。 + 实际提供的分页大小。若请求的 `limit` 超过上限,会被限制为上限值而不是被拒绝,因此该值可能小于所请求的值。请用这个数字而不是你发送的数字来分页,否则你会以为收到了实际上并未返回的行。 1–100 ### RouterModelOutput -模型结果对象。请阅读已选择模型的输出 Schema,以了解其确切的形状。 +模型结果对象。要了解其确切形状,请阅读所选模型的输出 Schema。 类型:`object` @@ -1261,141 +1295,141 @@ Router 模型目录的一页。 `{provider}/{model}` 模型 ID 中的模型部分。 -类型:`string`,字母数字组成的 slug,例如 `claude-opus-4-6`,最多 128 个字符 +类型:`string`。字母数字组成的 slug,例如 `claude-opus-4-6`,最多 128 个字符 ### RouterPageCursor -一个不透明的目录游标。请原样传回,作为 `cursor`。 +不透明的目录游标。将其原样作为 `cursor` 传回。 -类型:`string`,即作为 `next_cursor` 返回的不透明游标,1–512 个字符 +类型:`string` -- 作为 `next_cursor` 返回的不透明游标,长度为 1–512 个字符 ### RouterProviderSegment -`{provider}/{model}` 模型 ID 中表示提供商的部分。 +`{provider}/{model}` 模型 ID 中的提供商部分。 -类型:`string`。字母数字 slug,例如 `anthropic`,最多 64 个字符 +类型:`string` -- 字母数字 slug,例如 `anthropic`,最多 64 个字符 ### RouterQueueCancelResponse -针对描述本路由已处理请求的两种状态(`202` 和 `409`)的取消询问所作的应答。两者共用同一种响应体形状,而不是一个成功信封加一个错误信封,因为两者陈述的是同一件事:取消操作发现了什么;而且,如果客户端必须按状态码解析不同的类型,这种拆分并不能带来任何好处。 +此响应用于回答针对此路由已处理请求的两种状态(`202` 和 `409`)所发起的取消请求。两种状态共用同一种响应体形状,而不是分别使用成功信封和错误信封,因为两者表达的是同一件事:取消操作发现了什么。让客户端必须按不同状态码解析不同类型,并不能从这种拆分中获得任何好处。 **字段** - 一个已排队 Router 请求的标识符,即调用方用来轮询、取消并收集结果的句柄。 + 一个已排队 Router 请求的标识符:调用方通过该句柄轮询、取消并获取结果。 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 - 取消询问所发现的内容,对应描述本路由实际已处理请求的两种结果。两者都会与 HTTP 状态相呼应,因此客户端可以依据任一者进行分支。 + 取消请求所发现的结果,适用于描述此路由实际处理过的请求的两种结果。两者都会反映在 HTTP 状态中,因此客户端可依据任一者进行分支。 类型:[`RouterQueueCancelStatus`](#routerqueuecancelstatus) ### RouterQueueCancelStatus -取消请求所得到的结果,针对的是该路由实际已处理请求的两种结果。两者都会同步反映到 HTTP 状态码上,因此客户端可以任选其一进行分支判断。 +取消请求所发现的内容,用于描述此路由实际已处理的请求的两种结果。两者都会在 HTTP 状态中体现,因此客户端可以任选其一作为分支依据。 类型:`string` ### RouterQueuePosition -在响应生成的那一刻,队列中排在此请求前面的请求有多少个。零表示此请求位于队首。 +在响应生成的那一刻,队列中有多少请求排在此请求之前。零表示此请求位于队首。 -类型:`integer` -- 至少为 0 +类型:`integer`,至少为 0 ### RouterQueueRequestId -排队中的一个 Router 请求的标识符:调用方通过该句柄进行轮询、取消并收集结果。 +一个已排队 Router 请求的标识符,即调用方用于轮询、取消并收集结果的句柄。 类型:`string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 ### RouterQueueStatus -已执行的 Router 请求的状态。它恰好有三个取值,并且与 `RouterErrorType` 不同,它是一个封闭的 `enum`,因为这两个 schema 是刻意朝相反方向封闭的。`RouterErrorType` 对失败进行分类,其集合预期会不断扩展,因此,如果一个已生成的客户端硬性拒绝某个无法识别的分类,那么它恰恰会在已经出问题的时候失败得最严重。而这一类型描述的是生命周期,而日后新增第四个状态的生命周期,无论它是否被声明为 enum,对每一个针对它编写的轮询循环而言都是破坏性变更,因此它被声明为 enum,并且这一约束被写在客户端能够看到的地方。 +排队中的 Router 请求的状态。它恰好有三个值,并且与 `RouterErrorType` 不同,这一个是有封闭取值集合的 `enum`,因为这两个 schema 被有意设计成朝相反方向封闭。`RouterErrorType` 对失败进行分类,其集合预期会增长,因此一个硬性拒绝无法识别分类的已生成客户端,恰恰会在已经出错的时候失败得最严重。这一个描述的是生命周期,而生命周期若在以后新增第四种状态,无论是否声明为 enum,都会成为针对它编写的每个轮询循环的破坏性变更。因此它被声明为 enum,并把这一约束写在客户端可以看到的地方。 -类型:`string` +Type: `string` ### RouterQueueStatusFields -`RouterQueueStatusResponse` 中不属于 URL 块的那一半:一个排队中请求的身份、它当前的状态,以及在该状态为终端状态且运行未成功时,说明失败原因所属的粗粒度分类桶。 +`RouterQueueStatusResponse` 中不属于 URL 块的那另一半:一个已入队请求的身份标识、它当前的状态,以及(当该状态为终端且本次运行未成功时)说明原因的粗粒度分类。 **字段** - 一个排队中 Router 请求的标识符:调用方用来轮询、取消并获取结果的句柄。 + 一个已入队 Router 请求的标识符:调用方通过它来轮询、取消并获取结果。 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 - 排队中 Router 请求的状态。它恰好有三个值,并且与 `RouterErrorType` 不同,这是一个封闭的 `enum`,因为这两个 schema 是故意朝相反方向封闭的。`RouterErrorType` 对失败进行分类,其集合预期会增长,因此,一个硬性拒绝无法识别分类桶的已生成客户端,恰恰会在已经出错的时候失败得最严重。而这一个描述的是生命周期,一个日后新增第四种状态的生命周期,无论是否被声明为 enum,对每一个针对它编写的轮询循环来说都是破坏性变更。因此它被声明为 enum,并把这一约束写在客户端能看到的地方。 + 一个已入队 Router 请求的状态。它恰好有三个值,并且与 `RouterErrorType` 不同,这个类型是封闭的 `enum`,因为这两个 schema 是被有意设计成朝相反方向封闭的。`RouterErrorType` 用于对失败进行分类,其取值集合预期会增长,因此一个会硬性拒绝无法识别分类的已生成客户端,恰恰会在已经出问题时失败得最严重。而这个是生命周期,日后若为其添加第四种状态,无论是否声明为 enum,都会构成对基于它编写的每一个轮询循环的破坏性变更。因此它被声明为 enum,并把这一约束写在客户端能看到的地方。 类型:[`RouterQueueStatus`](#routerqueuestatus) - 在响应生成的那一刻,队列中有多少个请求排在该请求之前。零表示该请求位于队首。 + 在响应组装完成的那一刻,队列中有多少个请求排在该请求之前。零表示该请求位于队首。 - 类型:[`RouterQueuePosition`](#routerqueueposition) -- 至少 0 + 类型:[`RouterQueuePosition`](#routerqueueposition) -- 至少为 0 - 仅出现在未成功的 `COMPLETED` 请求上,携带的正是结果读取在返回该失败时赋给 `X-Comfy-Error-Type` 的那个粗粒度分类桶。它把一个成功的终端请求与一个失败或被取消的终端请求区分开来(后两者都没有单独的终端状态),并且它在成功时是缺失的而不是 null,因此请依据它是否存在来分支。 + 仅出现在未成功的 `COMPLETED` 请求上,携带的粗粒度分类与读取结果在返回该失败时写入 `X-Comfy-Error-Type` 的分类相同。它正是用来把成功的终端请求与失败或已取消的终端请求区分开来的:这两种情况都没有单独的终端状态。成功时该字段是缺失的而非 null,因此应依据它是否存在来分支。 类型:[`RouterErrorType`](#routererrortype) ### RouterQueueStatusResponse -一个已执行请求的当前状态,由提交时返回的相同三个 URL 组合而成。 +一个已排队请求的当前状态,与提交时返回的同样三个 URL 组合在一起。 -组合了 [`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueStatusFields`](#routerqueuestatusfields)。 +组合了 [`RouterQueueUrls`](#routerqueueurls) 和 [`RouterQueueStatusFields`](#routerqueuestatusfields)。 类型:`object` ### RouterQueueSubmitFields -`RouterQueueSubmitResponse` 中除 URL 区块之外的另一半:新请求的身份,以及它被接纳那一刻的状态。 +`RouterQueueSubmitResponse` 中除了 URL 区块之外的另一半:新请求的身份标识,以及它在被接纳那一刻的状态。 **字段** - 一个排队中的 Router 请求的标识符,即调用方用来轮询、取消并获取结果的句柄。 + 一个已排队的 Router 请求的标识符,也是调用方用来轮询、取消和获取结果的句柄。 - 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最多 36 个字符 + Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最多 36 个字符 - 排队中的 Router 请求的状态。它恰好有三个取值,而且与 `RouterErrorType` 不同,这是一个封闭的 `enum`,因为这两个 schema 被有意设计成朝相反方向封闭。`RouterErrorType` 对失败进行分类,其取值集合预期会增长,因此一个会硬性拒绝无法识别分类的已生成客户端,恰恰会在已经出错的时候失败得最惨。而这一个表示的是生命周期,日后新增第四种状态对每一个针对它编写的轮询循环来说都是破坏性变更,无论它是否被声明为 enum,所以这里就把它声明为 enum,并把该约束写在客户端能看到的地方。 + 已排队的 Router 请求的状态。它恰好有三个取值,并且与 `RouterErrorType` 不同,这一个采用封闭的 `enum`,因为这两个 schema 是刻意朝相反方向封闭的。`RouterErrorType` 用于对失败进行分类,其取值集合预期会增长,所以,如果一个生成的客户端硬性拒绝无法识别的类别,那么它恰恰会在已经有东西出错时失败得最严重。而这一个描述的是一段生命周期,日后若为它增加第四个状态,对每一个基于它编写的轮询循环来说都是破坏性变更,无论它是否被声明为 enum 都是如此。因此它被声明为 enum,并且把这一约束写在客户端能看到的地方。 - 类型:[`RouterQueueStatus`](#routerqueuestatus) + Type: [`RouterQueueStatus`](#routerqueuestatus) - 在响应生成的那一刻,队列中有多少个请求排在本请求之前。零表示本请求位于队首。 + 在响应生成的那一刻,队列中有多少个请求排在这一个之前。零表示此请求位于队首。 - 类型:[`RouterQueuePosition`](#routerqueueposition) -- 至少为 0 + Type: [`RouterQueuePosition`](#routerqueueposition) -- 至少为 0 - 本次请求的预检成本估算,在调用方启用了成本估算时,会出现在新的准入响应中。它给出的是本次请求被固定到的那条提供商链路(队列没有回退循环,因此 `fallback_provider` 永远不会改变实际运行的链路)。当无法给出任何数字时,该字段仍然存在,并带有 `source: unknown`;提交永远不会因为成本估算而失败。在幂等重放时会省略(`Idempotent-Replayed: true`),因为原始报价不会被存储。它只是估算,不是最终收费,也不是价格锁定:运行时按计费当时生效的费率收费,而最终金额以你工作区的用量与账单记录中的结算费用为准。 + 此请求的预检成本估算。当调用方启用了成本估算时,新请求被接纳时会带上该字段。它报出的是此请求所固定到的提供商分支(队列没有回退循环,因此 `fallback_provider` 永远不会改变实际运行的分支)。当无法给出数值时,该字段依然存在,其值为 `source: unknown`;提交绝不会因为估算而失败。在幂等重放(`Idempotent-Replayed: true`)时省略,因为原始报价不会被存储。它是估算值,不是最终收费,也不是价格锁定:运行会按计费时生效的费率计费,而你工作区用量与账单记录中的结算金额才是最终结果。 - 类型:[`RouterCostEstimate`](#routercostestimate) + Type: [`RouterCostEstimate`](#routercostestimate) ### RouterQueueSubmitResponse -当运行被接纳进入队列时返回的句柄:包含请求的身份与状态,并组合了用于访问其生命周期其余部分的三个 URL。 +当一次运行被接纳进入队列时返回的句柄:包含该请求的身份与状态,并与另外三个用于访问其生命周期其余部分的 URL 组合在一起。 -组合了 [`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueSubmitFields`](#routerqueuesubmitfields)。 +组合了 [`RouterQueueUrls`](#routerqueueurls) 与 [`RouterQueueSubmitFields`](#routerqueuesubmitfields)。 类型:`object` ### RouterQueueUrls -这三条 URL 指向一个已入队请求剩余的生命周期,凡是携带有效句柄的响应都会返回它们,因此客户端无需自行拼接队列 URL。 +这三个 URL 用于访问某个排队请求剩余生命周期中的其他资源,凡是携带有效句柄的响应都会返回它们,这样客户端就无需自行拼接队列 URL。 **字段** @@ -1406,65 +1440,65 @@ Router 模型目录的一页。 - 用于收集此请求结果的绝对 URL。 + 获取此请求结果的绝对 URL。 URI - 用于请求取消此请求的绝对 URL。 + 请求取消操作所使用的绝对 URL。 URI ### RouterValidationErrorContext -提供商提供的关于未通过验证的规则的详情。 +提供商提供的关于验证规则失败原因的详情。 类型:`object` ### RouterValidationErrorDetail -一个字段级验证失败。 +单个字段级验证失败。 **字段** - 指向出错字段的路径,最外层片段在前,例如 `["body", "image_url"]`,或 `["body", "images", 0]`,其中整数表示数组中的索引。 + 出错字段的路径,最外层片段在前。例如 `["body", "image_url"]`,或 `["body", "images", 0]`,其中整数用于索引数组。 - 对这一次失败的人类可读描述。 + 对本次单个失败的可读描述。 - 该失败的具体且机器可读的原因,由提供商原样传递。这是类型化 SDK 异常层次结构用于分支判断的值;响应头中的 `error_type` 只是它的粗略分类。 + 本次失败的具体、机器可读的原因,由提供商原样透传。类型化 SDK 异常层级正是依据该值进行分支判断;响应头中的 `error_type` 只是它的粗略分类。 - 某个 `RouterValidationErrorDetail` 所违反的界限,由提供商原样携带,例如 `{"limit_value": 8}` 配合 `greater_than`,`{"min_width": 512}` 配合 `image_too_small`,或 `{"max_size_bytes": 10485760}` 配合 `file_too_large`。键集合特定于提供商和错误类型,因此这里刻意是一个开放对象:把它收窄为固定字段列表,或把它合并进 `msg` 字符串,正是移植后的集成能够编译、却静默丢失读取该界限的分支的原因。当错误类型不携带界限时,该字段缺省。 + 针对单个 `RouterValidationErrorDetail` 的受限值,由提供商逐字传递。例如与 `greater_than` 一同出现的 `{"limit_value": 8}`,与 `image_too_small` 一同出现的 `{"min_width": 512}`,或与 `file_too_large` 一同出现的 `{"max_size_bytes": 10485760}`。键集合取决于具体的提供商和错误类型,因此这里刻意设计为开放对象:把它收窄为固定字段列表,或将其并入 `msg` 字符串,恰恰是移植集成在编译通过后悄然丢失读取该限制值分支的典型原因。当错误类型不携带限制值时,该字段不存在。 类型:[`RouterValidationErrorContext`](#routervalidationerrorcontext) - 出错的输入值,原样回显,以便调用方无需再从 `loc` 重新推导就能看到被拒绝的内容。任意 JSON 类型,包括字符串、数字、布尔、数组、对象或 null,因此该 schema 被有意保持为无类型,而不是收窄为对象。当提供商不回显输入时,该字段缺省。 + 出错的输入值,逐字回显,使调用方无需从 `loc` 重新推导即可看到被拒绝的内容。可为任意 JSON 类型,包括字符串、数字、布尔、数组、对象或 null,因此该 schema 刻意不限定类型,而非收窄为对象。当提供商不回显输入时,该字段不存在。 类型:[`RouterValidationErrorInput`](#routervalidationerrorinput) ### RouterValidationErrorInput -提供商包含该值时,被拒绝的输入值。 +被拒绝的输入值,前提是提供商提供了该值。 ### RouterValidationErrorResponse -`422` 验证错误的响应体。读取 `X-Comfy-Error-Type` 以获取其类别。 +`422` 验证错误响应体。读取 `X-Comfy-Error-Type` 以了解其类别。 **字段** - 请求中发现的每一个验证失败项,每个出错的字段对应一个条目。 + 请求中发现的每一个验证失败,每个违规字段对应一个条目。 - 类型:[`RouterValidationErrorDetail`](#routervalidationerrordetail) 数组 + 类型:数组,元素为 [`RouterValidationErrorDetail`](#routervalidationerrordetail) diff --git a/zh/tutorials/video/minimax/minimax-h3-fastvideo.mdx b/zh/tutorials/video/minimax/minimax-h3-fastvideo.mdx index f81cea9ddf..87d155e480 100644 --- a/zh/tutorials/video/minimax/minimax-h3-fastvideo.mdx +++ b/zh/tutorials/video/minimax/minimax-h3-fastvideo.mdx @@ -2,7 +2,7 @@ title: "FastVideo FastH3:ComfyUI 工作流示例" description: "FastVideo FastH3 在 ComfyUI 中以 8 个采样步数生成带同步音频的 MiniMax H3 视频,支持文生视频与首尾帧工作流。" sidebarTitle: "FastVideo FastH3" -translationSourceHash: 7cbe9703 +translationSourceHash: cb542dfa translationFrom: tutorials/video/minimax/minimax-h3-fastvideo.mdx translationBlockHashes: "_intro": 096c332e @@ -10,9 +10,10 @@ translationBlockHashes: "FastH3 Text to Video": 1c4cb909 "FastH3 Image to Video": ec7d82bf "Model downloads": b88037db - "Workflow structure notes": 0542b184 + "Workflow structure notes": 8f5d2153 --- + [FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2) 是 FastVideo 团队基于 MiniMax H3 蒸馏得到的 DMD2 模型,能以 **8 个采样步数**生成带原生同步音频的视频,而不是基础模型的完整调度。它复用了 H3 的文本编码器、视频 VAE 和音频 VAE,因此输出设置与基础模型一致,而采样步数大幅减少。 FastH3 预览版由 Nuva Lab 与 NVIDIA FastGen 团队合作开发;蒸馏细节请阅读 [FastH3 发布公告](https://haoailab.com/blogs/fasth3-preview/)。ComfyUI 内置的是 8 步 V2 检查点,由 Comfy-Org 重新打包在 [FastVideo-FastH3-Comfy](https://huggingface.co/FastVideo/FastVideo-FastH3-Comfy) 仓库中。 @@ -133,11 +134,11 @@ ComfyUI/ ## 工作流结构说明 -两个 FastH3 工作流与基础版 H3 设置共用以下节点,并带有蒸馏相关的设置: +两个 FastH3 工作流与基础版 H3 设置共用以下节点,并采用蒸馏专用设置: -- **BlockSparseAttention**:以 VSA(Video Sparse Attention)运行,`keep_percent` 为 10,从调度的 20% 开始生效,在保持质量的同时降低注意力计算成本 +- **BlockSparseAttention**:运行 Video Sparse Attention(VSA),`keep_percent` 设为 10,并从调度的 20% 处开始生效,在保持质量的同时降低注意力计算成本 - **MiniMaxH3SigmaShift**:应用与蒸馏调度匹配的 H3 sigma shift(视频为 10,音频为 3) - **ComfyMathExpression**:将时长输入转换为 24fps 下 17k+5 网格上的有效帧 `length` -- **采样器**:`res_multistep` 采样器,`simple` 调度器,8 步 +- **采样器**:`res_multistep` 采样器,配合 `simple` 调度器,8 步 -FastH3 权重带有 `to_gate_compress` 门控层,VSA 的粗粒度分支读的就是它。基座 H3 检查点没有这些层。要比较两种方法,把 **Model Sparse Attention** 节点的 `method` 设为 `sol-attn`,并保持同一随机种子。`sol-attn` 不需要匹配权重,在任意 H3 检查点上按你设的 `tau` 运行。 +FastH3 权重包含 `to_gate_compress` 门控层,VSA 的粗粒度分支会读取这些层。基础版 H3 checkpoint 没有这些层。要比较这两种方法,请在 **Model Sparse Attention** 节点上将 `method` 设为 `sol-attn`,并保持相同的种子。`sol-attn` 无需匹配的权重,可在任意 H3 checkpoint 上按你设置的 `tau` 运行。 diff --git a/zh/tutorials/video/minimax/minimax-h3-prompt-guide.mdx b/zh/tutorials/video/minimax/minimax-h3-prompt-guide.mdx index d6e31b9af0..a1904a068b 100644 --- a/zh/tutorials/video/minimax/minimax-h3-prompt-guide.mdx +++ b/zh/tutorials/video/minimax/minimax-h3-prompt-guide.mdx @@ -2,17 +2,18 @@ title: "ComfyUI MiniMax H3 提示词指南:官方指南、技巧与提示词嵌入" description: "在 ComfyUI 中写出更好的 MiniMax H3 提示词:MiniMax 官方提示词编写指南、通用提示词技巧、对白与说话人规则,以及风格嵌入。" sidebarTitle: "提示词指南" -translationSourceHash: 0d858ae8 +translationSourceHash: 0f1ded35 translationFrom: tutorials/video/minimax/minimax-h3-prompt-guide.mdx translationBlockHashes: "_intro": da22cc9d "Official guides": 3d762c67 - "General tips": 91822299 + "General tips": fab4ad35 "Shots and cuts": 8184dae6 "Dialogue and speakers": 4985438e "Prompt embeddings": 9c899169 --- + H3 在单一提示词中承载镜头、运镜、对白与音效。本页汇总官方指南、跨工作流技巧、镜头/对白规则与风格嵌入。 ## 官方指南 @@ -26,7 +27,7 @@ H3 在单一提示词中承载镜头、运镜、对白与音效。本页汇总 ## 通用技巧 -I2VA 首行为固定图像对齐句,空一行后接字段;FL2VA/L2VA 各有对齐句;T2VA 直接从字段开始: +I2VA 的首行是一句固定的图像对齐语句,随后空一行,再接正文各字段。FL2VA/L2VA 使用各自的对齐语句;T2VA 则直接从字段开始: ```text integrated_multimodal_description: [Shot 1] ... @@ -34,19 +35,19 @@ overall_soundscape: ... non_diegetic_music: ... ``` -提示词用**英文**;对白/歌词在 `` 内;屏幕文字保留原文。 +提示词用**英文**撰写。对白/歌词放在 `` 标签中;屏幕文字逐字保留其原始语言。 -1. **先场景**:总述后写 `[Shot 1]` 内分镜 -2. **一块写完**:镜头、运镜、音频 -3. **分辨率**:16:9 原生 **1344×768**;**32** 倍数 -4. **长度**:`length` 为 24fps 帧数(默认 **124** ≈ 5s),吸附 **17k+5** -5. **屏幕文字**:英文双引号、逐条原文(如 `A red neon sign reading "营业中"`);对白用 `` -6. **R2V 音频标记**:`fully_copy`、`partially_copy`、`reference`、`weak_reference`(见官方 ref 表) -7. **音频字段**:`overall_soundscape` 写环境/动作/非语言(1–4 句;真静音才 `N/A`)。对白与画内音乐写在分镜里。`non_diegetic_music` 写配乐(1–3 句;无则 `N/A`) -8. **无负向**:`BasicGuider` 在 `cfg` 1 无负面分支。写「不要什么」反而引入概念;改写正面描述或 R2V 保留字段 -9. **多格参考图(R2V)**:一张图多视角/分镜格时单独 ``(不要只写在 `` 内),在镜头中指名某一格(如 `` 的正面全身格) +1. **先写场景**:先写整体场景,再在 `integrated_multimodal_description` 的 `[Shot 1]` 内按时间顺序写分镜 +2. **一个整体**:分镜、相机与音频放在一起写 +3. **分辨率**:16:9 原生 **1344×768**;取 **32** 的倍数 +4. **长度**:`length` 是以 24fps 计的帧数(默认 **124** ≈ 5s),会对齐到 **17k+5** +5. **屏幕文字**:每个字符串用英文双引号包裹,逐字照抄(如 `A red neon sign reading "营业中"`)。台词使用 ``,不要用引号 +6. **R2V 音频标记**:在保留分析中,按片段的实际用法把每个音频参考标记为 `fully_copy`、`partially_copy`、`reference` 或 `weak_reference`(见官方参考指南表格) +7. **音频字段**:`overall_soundscape` = 环境声/音效/非语言声音(1–4 句;只有完全静音时才写 `N/A`)。对白与画内音乐仍写在分镜中。`non_diegetic_music` = 仅配乐(1–3 句;没有则写 `N/A`)。若出现不需要的语音,请把这两个字段都明确填写 +8. **不要写负面内容**:`BasicGuider` 以 `cfg` 1 运行,没有负面分支。禁止清单反而会引入不想要的概念。请正面描述应该出现的内容(或使用 R2V 保留字段:`fully_preserved`、`partially_preserved` 等) +9. **参考图版(R2V)**:一张图像可以包含多个分格。请为该图版单独指定 ``(不要只写在 `` 内),描述各分格,并在分镜中指向具体分格(如 `` 的正面全身视图)。请清晰标注各分格 -工作流专属标签见各工作流页。 +各工作流专属的标签与控制项见对应工作流页面。 ## 镜头与切换 From 3cb750f55837cb1bee60dabeee3d5026d5f797a7 Mon Sep 17 00:00:00 2001 From: comfyui-wiki Date: Sat, 31 Oct 2026 09:05:39 +0800 Subject: [PATCH 2/6] fix(i18n): remove stray ```mdx fences breaking mint-checks Two ResponseField open tags in ja/zh Seedance code pages accidentally kept a trailing ```mdx fence from the sync, which made mint broken-links fail to parse the MDX. --- .../models/byteplus/dreamina-seedance-2-0-260128/code.mdx | 2 +- .../models/byteplus/seedance-1-0-pro-250528/code.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 1df3726492..3a23417044 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -407,7 +407,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。 エラーメッセージ -```mdx + ビデオ生成タスクのID diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index daeb9c06c5..13ad884815 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -399,7 +399,7 @@ false: 不返回已生成视频的最后一帧图像。 报错信息 -```mdx + 视频生成任务的 ID From a5c96eb58665af1618eddd62a09d139fe16fea90 Mon Sep 17 00:00:00 2001 From: comfyui-wiki Date: Sat, 31 Oct 2026 09:10:47 +0800 Subject: [PATCH 3/6] fix(i18n): break same-line ResponseField bodies for mint MDX parse MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit mint broken-links rejects …content on one line as an unclosed JSX tag. Normalize id/409 fields in zh/ja/ko Seedance and Router reference pages so the body starts on the next indented line. --- .../models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx | 3 ++- .../models/byteplus/seedance-1-0-pro-250528/code.mdx | 3 ++- .../models/byteplus/seedance-1-0-pro-fast-251015/code.mdx | 3 ++- .../models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx | 3 ++- .../models/byteplus/dreamina-seedance-2-0-mini/code.mdx | 3 ++- .../models/byteplus/seedance-1-0-pro-fast-251015/code.mdx | 3 ++- .../models/byteplus/seedance-1-5-pro-251215/code.mdx | 3 ++- ko/development/comfy-router/reference.mdx | 3 ++- .../models/byteplus/dreamina-seedance-2-0-mini/code.mdx | 3 ++- .../models/byteplus/seedance-1-5-pro-251215/code.mdx | 3 ++- zh/development/comfy-router/reference.mdx | 3 ++- 11 files changed, 22 insertions(+), 11 deletions(-) diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 5fd194b017..b33007d441 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -399,7 +399,8 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.js エラーメッセージ -ビデオ生成タスクのID + + ビデオ生成タスクのID diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 1a86cca8c8..89d9be1b9f 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -399,7 +399,8 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 エラーメッセージ -The ID of the video generation task + + The ID of the video generation task diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 1c1df19527..0d3cd6f3c6 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -401,7 +401,8 @@ false: 生成されたビデオの最後のフレーム画像を返しません エラーメッセージ -The ID of the video generation task + + The ID of the video generation task diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 3f3af5cc1a..b552dadeb9 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -399,7 +399,8 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 오류 메시지 -비디오 생성 작업의 ID + + 비디오 생성 작업의 ID diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 6480680517..6d55390eba 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -400,7 +400,8 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 오류 메시지 -The ID of the video generation task + + The ID of the video generation task Wait, I need to translate that too. Let me redo. diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 06b3f19b91..4d7c40f493 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -399,7 +399,8 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 오류 메시지 -비디오 생성 작업의 ID + + 비디오 생성 작업의 ID diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index b010d78e03..13800db3cd 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -399,7 +399,8 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 오류 메시지 -비디오 생성 작업의 ID + + 비디오 생성 작업의 ID diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index b35f2a20b2..6547d5ccc3 100644 --- a/ko/development/comfy-router/reference.mdx +++ b/ko/development/comfy-router/reference.mdx @@ -545,7 +545,8 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` -`X-Comfy-Error-Type`을 확인하세요. `concurrency_limit_exceeded`는 원본 호출이 아직 실행 중이라는 뜻이므로 `Retry-After`만큼 기다린 뒤 같은 키를 재사용하세요. `invalid_input`은 새 키가 필요합니다. 이 라우트의 두 가지 `invalid_input` 충돌은 키와 전혀 무관하며 새 키로도 어느 쪽도 해소되지 않습니다. `model_provider`로 대체 공급자를 지정한 경우, 요청 본문이 그 공급자의 이 모델용 변환기가 처리할 수 없는 멀티파트 작업(편집)을 선택하면 거부되며, `detail`은 "this request's `image` selects the edit operation"으로 시작합니다. 그리고 그 이후에 검사되는 것으로, 요청이 경로에 있는 공급자에 대한 BYOK(bring-your-own-key) 자격 증명을 이미 확인한 경우에도 거부되며, `detail`은 `this request resolved a BYOK credential`로 시작합니다. `model_provider`를 제거하거나, BYOK 자격 증명 없이 그리고 (멀티파트의 경우) 편집 없이 요청을 보내세요. + + `X-Comfy-Error-Type`을 확인하세요. `concurrency_limit_exceeded`는 원본 호출이 아직 실행 중이라는 뜻이므로 `Retry-After`만큼 기다린 뒤 같은 키를 재사용하세요. `invalid_input`은 새 키가 필요합니다. 이 라우트의 두 가지 `invalid_input` 충돌은 키와 전혀 무관하며 새 키로도 어느 쪽도 해소되지 않습니다. `model_provider`로 대체 공급자를 지정한 경우, 요청 본문이 그 공급자의 이 모델용 변환기가 처리할 수 없는 멀티파트 작업(편집)을 선택하면 거부되며, `detail`은 "this request's `image` selects the edit operation"으로 시작합니다. 그리고 그 이후에 검사되는 것으로, 요청이 경로에 있는 공급자에 대한 BYOK(bring-your-own-key) 자격 증명을 이미 확인한 경우에도 거부되며, `detail`은 `this request resolved a BYOK credential`로 시작합니다. `model_provider`를 제거하거나, BYOK 자격 증명 없이 그리고 (멀티파트의 경우) 편집 없이 요청을 보내세요. 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded`인 경우) diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index a931a5b8a5..6995497779 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -398,7 +398,8 @@ false: 不返回已生成视频的最后一帧图像。 报错信息 -视频生成任务的 ID + + 视频生成任务的 ID diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 59e3abf8fa..42cabe70ab 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -395,7 +395,8 @@ false: 不返回已生成视频的最后一帧图像。 报错信息 -The ID of the video generation task + + The ID of the video generation task diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index 6062255945..51f1a1ee9a 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -543,7 +543,8 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` -Check `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 并复用同一个 key;`invalid_input` 则需要使用新 key。此路由上的两个 `invalid_input` 冲突与 key 完全无关,且任何新 key 都无法消除其中任何一个:当请求正文选择该提供商针对此模型的转换器无法处理的多部分操作(编辑)时,指定备用提供商的 `model_provider` 会被拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;之后还会检查另一种情况,即当请求已经为路径中的提供商解析出自带密钥(BYOK)凭证时,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭证,并且(对于多部分情形)不带编辑操作。 + + Check `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 并复用同一个 key;`invalid_input` 则需要使用新 key。此路由上的两个 `invalid_input` 冲突与 key 完全无关,且任何新 key 都无法消除其中任何一个:当请求正文选择该提供商针对此模型的转换器无法处理的多部分操作(编辑)时,指定备用提供商的 `model_provider` 会被拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;之后还会检查另一种情况,即当请求已经为路径中的提供商解析出自带密钥(BYOK)凭证时,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭证,并且(对于多部分情形)不带编辑操作。 正文:[`RouterErrorResponse`](#routererrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当 `concurrency_limit_exceeded` 时) From 327b0d95b279b612df08c7ffb54a6436020278a5 Mon Sep 17 00:00:00 2001 From: comfyui-wiki Date: Fri, 30 Oct 2026 18:17:35 -0700 Subject: [PATCH 4/6] fix(i18n): repair ResponseField close/orphan body in Seedance MDX MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Move Korean id field text that sat after back into the body, and restore the Japanese id description that was dropped when tags were smashed onto one line — both broke mint MDX parse. --- .../models/byteplus/dreamina-seedance-2-0-mini/code.mdx | 4 +++- .../models/byteplus/seedance-1-0-pro-250528/code.mdx | 4 ++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index a3b6e2d2e4..1fc770ca00 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -402,8 +402,10 @@ false: 生成されたビデオの最終フレーム画像を返しません。 + ビデオ生成タスクのID + - + タスクで使用されたモデルの名前とバージョン diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 58ec1f2dd5..6db703933c 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -396,8 +396,8 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - -비디오 생성 작업의 ID + 비디오 생성 작업의 ID + 작업에서 사용한 모델의 이름과 버전 From 2f1662e02dcc0cc1da3f50ca9694f08c8fd7cbba Mon Sep 17 00:00:00 2001 From: comfyui-wiki Date: Fri, 30 Oct 2026 18:23:32 -0700 Subject: [PATCH 5/6] fix(i18n): unsmash Accordion/list lines in zh/ja/ko models.mdx Mint failed parsing zh/.../models.mdx when
ran into the next list item. Split backtick-id + list smashes the same way in ja/ko. --- ja/development/comfy-router/models.mdx | 15 ++++++++++----- ko/development/comfy-router/models.mdx | 15 ++++++++++----- zh/development/comfy-router/models.mdx | 14 +++++++++----- 3 files changed, 29 insertions(+), 15 deletions(-) diff --git a/ja/development/comfy-router/models.mdx b/ja/development/comfy-router/models.mdx index a91ea5dde9..d414e73e79 100644 --- a/ja/development/comfy-router/models.mdx +++ b/ja/development/comfy-router/models.mdx @@ -105,7 +105,8 @@ translationBlockHashes: - [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ja/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/ja/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` -- [Video Background Removal](/ja/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal`- [Veo 3.1 Fast Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` +- [Video Background Removal](/ja/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` +- [Veo 3.1 Fast Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` - [HappyHorse 1.0 I2V](/ja/development/comfy-router/models/wan/happyhorse-1-0-i2v/code): `wan/happyhorse-1.0-i2v` @@ -159,7 +160,8 @@ translationBlockHashes: - [Image Edit Remove Background Guided](/ja/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/ja/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/ja/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [Image Edit Replace Object By Text](/ja/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text`- [Image Edit Reseason](/ja/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [Image Edit Replace Object By Text](/ja/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` +- [Image Edit Reseason](/ja/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` - [Image Edit Restore](/ja/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` - [Image](/ja/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` @@ -210,7 +212,8 @@ translationBlockHashes: - [Recraft V4.1 Utility](/ja/development/comfy-router/models/recraft/recraftv4-1-utility/code): `recraft/recraftv4_1_utility` - [Recraft V4.1 Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-vector/code): `recraft/recraftv4_1_vector` - [Recraft V4.1](/ja/development/comfy-router/models/recraft/recraftv4-1/code): `recraft/recraftv4_1` -- [Recraft V4 Pro](/ja/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro`- [Recraft V4 Styles Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` +- [Recraft V4 Pro](/ja/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro` +- [Recraft V4 Styles Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` - [Recraft V4 Styles Pro](/ja/development/comfy-router/models/recraft/recraftv4-styles-pro/code): `recraft/recraftv4_styles_pro` - [Recraft V4 Styles Vector](/ja/development/comfy-router/models/recraft/recraftv4-styles-vector/code): `recraft/recraftv4_styles_vector` - [Recraft V4 Styles](/ja/development/comfy-router/models/recraft/recraftv4-styles/code): `recraft/recraftv4_styles` @@ -264,7 +267,8 @@ translationBlockHashes: - [Wan 2.5 T2V Preview](/ja/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` - [Wan 2.6 I2V](/ja/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` - [Wan 2.6 R2V](/ja/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` -- [Wan 2.6 T2V](/ja/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v`- [Wan 2.7 I2V](/ja/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` +- [Wan 2.6 T2V](/ja/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` +- [Wan 2.7 I2V](/ja/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` - [Wan 2.7 T2V](/ja/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` - [Wan 3.0 Video Prime](/ja/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` - [Wan 3.0 Video](/ja/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` @@ -325,7 +329,8 @@ translationBlockHashes: - [GPT 5](/ja/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [GPT 6 Astra](/ja/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/ja/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` -- [GPT 6 Sol](/ja/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol`- [o3](/ja/development/comfy-router/models/openai/o3/code): `openai/o3` +- [GPT 6 Sol](/ja/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` +- [o3](/ja/development/comfy-router/models/openai/o3/code): `openai/o3` - [Chat Completions](/ja/development/comfy-router/models/openrouter/chat-completions/code): `openrouter/chat-completions`
diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index a02660db8d..baba59fe6c 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -105,7 +105,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` +- [Video Background Removal](/ko/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` +- [Veo 3.1 Fast Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` - [HappyHorse 1.0 I2V](/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code): `wan/happyhorse-1.0-i2v` @@ -159,7 +160,8 @@ translationBlockHashes: - [Image Edit Remove Background Guided](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/ko/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [Image Edit Replace Object By Text](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text`- [Image Edit Reseason](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [Image Edit Replace Object By Text](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` +- [Image Edit Reseason](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` - [Image Edit Restore](/ko/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` - [Image](/ko/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` @@ -210,7 +212,8 @@ translationBlockHashes: - [Recraft V4.1 Utility](/ko/development/comfy-router/models/recraft/recraftv4-1-utility/code): `recraft/recraftv4_1_utility` - [Recraft V4.1 Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-vector/code): `recraft/recraftv4_1_vector` - [Recraft V4.1](/ko/development/comfy-router/models/recraft/recraftv4-1/code): `recraft/recraftv4_1` -- [Recraft V4 Pro](/ko/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro`- [Recraft V4 Styles Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` +- [Recraft V4 Pro](/ko/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro` +- [Recraft V4 Styles Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` - [Recraft V4 Styles Pro](/ko/development/comfy-router/models/recraft/recraftv4-styles-pro/code): `recraft/recraftv4_styles_pro` - [Recraft V4 Styles Vector](/ko/development/comfy-router/models/recraft/recraftv4-styles-vector/code): `recraft/recraftv4_styles_vector` - [Recraft V4 Styles](/ko/development/comfy-router/models/recraft/recraftv4-styles/code): `recraft/recraftv4_styles` @@ -264,7 +267,8 @@ translationBlockHashes: - [Wan 2.5 T2V Preview](/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` - [Wan 2.6 I2V](/ko/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` - [Wan 2.6 R2V](/ko/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` -- [Wan 2.6 T2V](/ko/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v`- [Wan 2.7 I2V](/ko/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` +- [Wan 2.6 T2V](/ko/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` +- [Wan 2.7 I2V](/ko/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` - [Wan 2.7 T2V](/ko/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` - [Wan 3.0 Video Prime](/ko/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` - [Wan 3.0 Video](/ko/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` @@ -325,7 +329,8 @@ translationBlockHashes: - [GPT 5](/ko/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [GPT 6 Astra](/ko/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/ko/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` -- [GPT 6 Sol](/ko/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol`- [o3](/ko/development/comfy-router/models/openai/o3/code): `openai/o3` +- [GPT 6 Sol](/ko/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` +- [o3](/ko/development/comfy-router/models/openai/o3/code): `openai/o3` - [Chat Completions](/ko/development/comfy-router/models/openrouter/chat-completions/code): `openrouter/chat-completions`
diff --git a/zh/development/comfy-router/models.mdx b/zh/development/comfy-router/models.mdx index 6b606ef215..fe1d3ddb5f 100644 --- a/zh/development/comfy-router/models.mdx +++ b/zh/development/comfy-router/models.mdx @@ -105,7 +105,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`- [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` +- [Video Background Removal](/zh/development/comfy-router/models/veed/video-background-removal/code):`veed/video-background-removal` +- [Veo 3.1 Fast Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code):`veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-generate-001/code):`veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code):`veo/veo-3.1-lite-generate-001` - [HappyHorse 1.0 I2V](/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code):`wan/happyhorse-1.0-i2v` @@ -158,7 +159,8 @@ translationBlockHashes: - [图像编辑:重新打光](/zh/development/comfy-router/models/bria/image-edit-relight/code):`bria/image-edit-relight` - [图像编辑:引导式移除背景](/zh/development/comfy-router/models/bria/image-edit-remove-background-guided/code):`bria/image-edit-remove-background-guided` - [图像编辑:移除背景](/zh/development/comfy-router/models/bria/image-edit-remove-background/code):`bria/image-edit-remove-background` -- [图像编辑:替换背景](/zh/development/comfy-router/models/bria/image-edit-replace-background/code):`bria/image-edit-replace-background`- [图像编辑:Reseason](/zh/development/comfy-router/models/bria/image-edit-reseason/code):`bria/image-edit-reseason` +- [图像编辑:替换背景](/zh/development/comfy-router/models/bria/image-edit-replace-background/code):`bria/image-edit-replace-background` +- [图像编辑:Reseason](/zh/development/comfy-router/models/bria/image-edit-reseason/code):`bria/image-edit-reseason` - [图像编辑:修复](/zh/development/comfy-router/models/bria/image-edit-restore/code):`bria/image-edit-restore` - [图像](/zh/development/comfy-router/models/bria/image/code):`bria/image` - [Seedream 4.0 250828](/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code):`byteplus/seedream-4-0-250828` @@ -208,7 +210,8 @@ translationBlockHashes: - [Recraft V4.1 Utility Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code):`recraft/recraftv4_1_utility_vector` - [Recraft V4.1 Utility](/zh/development/comfy-router/models/recraft/recraftv4-1-utility/code):`recraft/recraftv4_1_utility` - [Recraft V4.1 Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-vector/code):`recraft/recraftv4_1_vector` -- [Recraft V4.1](/zh/development/comfy-router/models/recraft/recraftv4-1/code):`recraft/recraftv4_1`- [Recraft V4 Styles Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code):`recraft/recraftv4_styles_pro_vector` +- [Recraft V4.1](/zh/development/comfy-router/models/recraft/recraftv4-1/code):`recraft/recraftv4_1` +- [Recraft V4 Styles Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code):`recraft/recraftv4_styles_pro_vector` - [Recraft V4 Styles Pro](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro/code):`recraft/recraftv4_styles_pro` - [Recraft V4 Styles Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-vector/code):`recraft/recraftv4_styles_vector` - [Recraft V4 Styles](/zh/development/comfy-router/models/recraft/recraftv4-styles/code):`recraft/recraftv4_styles` @@ -264,7 +267,7 @@ translationBlockHashes: - [Wan 2.6 R2V](/zh/development/comfy-router/models/wan/wan2-6-r2v/code):`wan/wan2.6-r2v` - [Wan 2.6 T2V](/zh/development/comfy-router/models/wan/wan2-6-t2v/code):`wan/wan2.6-t2v` -
- [Wan 2.7 I2V](/zh/development/comfy-router/models/wan/wan2-7-i2v/code):`wan/wan2.7-i2v` +- [Wan 2.7 I2V](/zh/development/comfy-router/models/wan/wan2-7-i2v/code):`wan/wan2.7-i2v` - [Wan 2.7 T2V](/zh/development/comfy-router/models/wan/wan2-7-t2v/code):`wan/wan2.7-t2v` - [Wan 3.0 Video Prime](/zh/development/comfy-router/models/wan/wan3-0-video-prime/code):`wan/wan3.0-video-prime` - [Wan 3.0 Video](/zh/development/comfy-router/models/wan/wan3-0-video/code):`wan/wan3.0-video` @@ -325,7 +328,8 @@ translationBlockHashes: - [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`- [o3](/zh/development/comfy-router/models/openai/o3/code):`openai/o3` +- [GPT 6 Sol](/zh/development/comfy-router/models/openai/gpt-6-sol/code):`openai/gpt-6-sol` +- [o3](/zh/development/comfy-router/models/openai/o3/code):`openai/o3` - [Chat Completions](/zh/development/comfy-router/models/openrouter/chat-completions/code):`openrouter/chat-completions` From 91eaba019f05c05ec2eba7f89a6d076253ccf4b7 Mon Sep 17 00:00:00 2001 From: comfyui-wiki Date: Fri, 30 Oct 2026 18:28:58 -0700 Subject: [PATCH 6/6] fix(i18n): point locale limitations.mdx at /router-openapi.yaml Mint broken-links flagged /ja|/ko|/zh/router-openapi.yaml; the OpenAPI file lives at repo root like the English page. --- ja/development/comfy-router/limitations.mdx | 2 +- ko/development/comfy-router/limitations.mdx | 2 +- zh/development/comfy-router/limitations.mdx | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index 0a79861f55..e251530d59 100644 --- a/ja/development/comfy-router/limitations.mdx +++ b/ja/development/comfy-router/limitations.mdx @@ -139,7 +139,7 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 ## Routerはすべてのパートナー操作をカバーしていない -Routerはモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、`/proxy/…` 配下のパートナープロキシルートが必要になる場合があります。これらはRouterの外部にあり、そのコントラクトには記述されていません。Router自体のサーフェスは [Comfy Router specification](/ja/router-openapi.yaml) です。サポートはプロバイダーによって異なります。 +Routerはモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、`/proxy/…` 配下のパートナープロキシルートが必要になる場合があります。これらはRouterの外部にあり、そのコントラクトには記述されていません。Router自体のサーフェスは [Comfy Router specification](/router-openapi.yaml) です。サポートはプロバイダーによって異なります。 ### Krea 3の参照画像:先にアップロードするか、公開https URLを使用する diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index bf39dca70d..5fd22da5b6 100644 --- a/ko/development/comfy-router/limitations.mdx +++ b/ko/development/comfy-router/limitations.mdx @@ -139,7 +139,7 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 ## Router는 모든 파트너 작업을 다루지 않습니다 -Router는 모델을 실행합니다. 파일 업로드, 계정 읽기, 에셋 관리, 스트리밍, 공급자 작업 제어에는 Router 외부에 있고 그 계약에서 설명되지 않는 `/proxy/…` 아래의 파트너 프록시 라우트가 필요할 수 있습니다. Router 자체의 표면은 [Comfy Router 명세](/ko/router-openapi.yaml)이며, 지원 여부는 공급자마다 다릅니다. +Router는 모델을 실행합니다. 파일 업로드, 계정 읽기, 에셋 관리, 스트리밍, 공급자 작업 제어에는 Router 외부에 있고 그 계약에서 설명되지 않는 `/proxy/…` 아래의 파트너 프록시 라우트가 필요할 수 있습니다. Router 자체의 표면은 [Comfy Router 명세](/router-openapi.yaml)이며, 지원 여부는 공급자마다 다릅니다. ### Krea 3 참조 이미지: 먼저 업로드하거나 공개 https URL 사용 diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index e55adef975..f580a19c68 100644 --- a/zh/development/comfy-router/limitations.mdx +++ b/zh/development/comfy-router/limitations.mdx @@ -139,7 +139,7 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价, ## Router 并不覆盖每一项合作伙伴操作 -Router 负责运行模型。文件上传、账户读取、资产管理、流式传输以及提供商任务控制可能需要位于 `/proxy/…` 下的合作伙伴代理路由,这些路由处在 Router 之外,Router 的契约也不涵盖它们。Router 自身对外提供的接口以 [Comfy Router 规范](/zh/router-openapi.yaml) 为准;支持情况因提供商而异。 +Router 负责运行模型。文件上传、账户读取、资产管理、流式传输以及提供商任务控制可能需要位于 `/proxy/…` 下的合作伙伴代理路由,这些路由处在 Router 之外,Router 的契约也不涵盖它们。Router 自身对外提供的接口以 [Comfy Router 规范](/router-openapi.yaml) 为准;支持情况因提供商而异。 ### Krea 3 参考图像:先上传,或使用公共 https URL