From 034d78b24e8c61fe3a3046d380240a4e0e9088fc Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Mon, 2 Nov 2026 11:04:11 +0800 Subject: [PATCH 1/4] i18n: add zh/ja/ko translations for Comfy Router realtime voice page --- docs.json | 3 + ja/development/comfy-router/realtime.mdx | 223 +++++++++++++++++++++++ ko/development/comfy-router/realtime.mdx | 223 +++++++++++++++++++++++ zh/development/comfy-router/realtime.mdx | 223 +++++++++++++++++++++++ 4 files changed, 672 insertions(+) create mode 100644 ja/development/comfy-router/realtime.mdx create mode 100644 ko/development/comfy-router/realtime.mdx create mode 100644 zh/development/comfy-router/realtime.mdx diff --git a/docs.json b/docs.json index adeab7e429..ba584cd2a3 100644 --- a/docs.json +++ b/docs.json @@ -7487,6 +7487,7 @@ "zh/development/comfy-router/queue", "zh/development/comfy-router/errors", "zh/development/comfy-router/billing", + "zh/development/comfy-router/realtime", "zh/development/comfy-router/headers", "zh/development/comfy-router/reference", "zh/development/comfy-router/limitations", @@ -11556,6 +11557,7 @@ "ja/development/comfy-router/queue", "ja/development/comfy-router/errors", "ja/development/comfy-router/billing", + "ja/development/comfy-router/realtime", "ja/development/comfy-router/headers", "ja/development/comfy-router/reference", "ja/development/comfy-router/limitations", @@ -15555,6 +15557,7 @@ "ko/development/comfy-router/queue", "ko/development/comfy-router/errors", "ko/development/comfy-router/billing", + "ko/development/comfy-router/realtime", "ko/development/comfy-router/headers", "ko/development/comfy-router/reference", "ko/development/comfy-router/limitations", diff --git a/ja/development/comfy-router/realtime.mdx b/ja/development/comfy-router/realtime.mdx new file mode 100644 index 0000000000..1cd640f8d5 --- /dev/null +++ b/ja/development/comfy-router/realtime.mdx @@ -0,0 +1,223 @@ +--- +title: "Comfy Router リアルタイム音声セッション" +sidebarTitle: "リアルタイム音声" +description: "Comfy Router 経由で Grok Voice のリアルタイム WebSocket セッションを開く方法: エンドポイント、認証、秒単位の料金、セッションの制限、そして発生しうるエラーとクローズコードについて説明します。" +translationSourceHash: e4024a38 +translationFrom: development/comfy-router/realtime.mdx +translationBlockHashes: + "_intro": a85f88e5 + "Endpoint": 2ae36abf + "Authentication": 582120fe + "Connect": b61ae8c6 + "Events": a3ac8c47 + "Pricing": 25d35f6c + "Limits": 85e21dff + "Errors": 3085ba65 + "Next": 3e8c1bd8 +--- +Comfy Router は、fal が提供する xAI の Grok Voice とのリアルタイム音声対音声セッションを中継します。Comfy APIキーを使って Router への WebSocket を1本開きます。Router はアカウントとクレジットを確認し、上流でセッションを開き、その後イベントを双方向に中継します。料金はセッションの秒単位で Comfy クレジットから支払われます。 + +## エンドポイント + +```text +wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime +``` + +リクエストは WebSocket アップグレード（`GET` と `Connection: Upgrade`、`Upgrade: websocket`）です。それ以外のリクエストは `426` で拒否されます。 + +## 認証 + +アップグレードリクエストのヘッダーで、`X-API-Key: comfyui-...` または `Authorization: Bearer comfyui-...` のいずれかとして Comfy APIキーを送信してください。Router はクエリ文字列や WebSocket サブプロトコルからキーを読み取りません。 + + +ブラウザは WebSocket にヘッダーを設定できません。また、Comfy APIキーがブラウザに渡ることは決してあってはなりません。お使いのサーバーからセッションを開き、オーディオをブラウザにご自身で中継してください。 + + +## 接続 + +アップグレードが成功したら、Grok Voice 向けに xAI がドキュメント化しているリアルタイムイベントを送受信します。この例では、セッションを設定し、1 回のテキストターンを送信して、受信した各イベントタイプを出力します。 + + + +```python Python +# pip install websockets msgpack +import asyncio +import os + +import msgpack +import websockets + +URL = "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime" + + +async def send(ws, event): + await ws.send(msgpack.packb(event)) + + +async def main(): + async with websockets.connect( + URL, + additional_headers={"X-API-Key": os.environ["COMFY_API_KEY"]}, + ) as ws: + await send(ws, { + "type": "session.update", + "session": { + "voice": "eve", + "instructions": "You are a helpful assistant.", + "turn_detection": {"type": "server_vad"}, + }, + }) + await send(ws, { + "type": "conversation.item.create", + "item": { + "type": "message", + "role": "user", + "content": [{"type": "input_text", "text": "Hello!"}], + }, + }) + await send(ws, {"type": "response.create"}) + + async for message in ws: + if isinstance(message, str): + continue # fal 自身の x-fal-message フレーム + event = msgpack.unpackb(message) + print(event["type"]) + if event["type"] == "response.done": + break + + +asyncio.run(main()) +``` + +```javascript Node.js +// npm install ws @msgpack/msgpack +import WebSocket from "ws"; +import { encode, decode } from "@msgpack/msgpack"; + +const ws = new WebSocket( + "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime", + { headers: { "X-API-Key": process.env.COMFY_API_KEY } }, +); + +ws.on("unexpected-response", (req, res) => { + // アップグレードが拒否されました。理由は JSON ボディに示されています。 + let body = ""; + res.on("data", (chunk) => (body += chunk)); + res.on("end", () => console.error(res.statusCode, body)); +}); + +const send = (event) => ws.send(encode(event)); + +ws.on("open", () => { + send({ + type: "session.update", + session: { + voice: "eve", + instructions: "You are a helpful assistant.", + turn_detection: { type: "server_vad" }, + }, + }); + send({ + type: "conversation.item.create", + item: { + type: "message", + role: "user", + content: [{ type: "input_text", text: "Hello!" }], + }, + }); + send({ type: "response.create" }); +}); + +ws.on("message", (data, isBinary) => { + if (!isBinary) return; // fal 自身の x-fal-message フレーム + const event = decode(data); + console.log(event.type); + if (event.type === "response.done") ws.close(); +}); + +ws.on("close", (code) => console.log("closed", code)); +``` + + + +完了したらすぐにソケットを閉じてください。課金は最後の応答までではなく、セッションが閉じるまで続きます。 + +## イベント + +Router は独自のイベントプロトコルを定義していません。サーバーイベントは fal が送信するそのままの形で届き、Router が受け付けるクライアントイベントは変更されずに転送されます。イベント一覧、セッションフィールド、音声、オーディオ形式については、以下を参照してください: + +- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) と xAI の [realtime event schema](https://docs.x.ai/voice-realtime.ws.json) +- fal の [Grok Voice realtime model page](https://fal.ai/models/xai/grok-voice/realtime) とその [API ページ](https://fal.ai/models/xai/grok-voice/realtime/api) + +例のように、各クライアントイベントを 1 つの msgpack バイナリメッセージとして送信してください。これは fal の realtime クライアントが使用するフレーミングであり、モデルのイベントも同様に、`session.created` で始まる msgpack バイナリメッセージとして返されます。fal はさらに、タイプ `x-fal-message` の独自の JSON テキストメッセージ(タイミング情報)も送信しますが、これはスキップしてかまいません。Router のチェックではクライアントイベントを 1 つの JSON テキストメッセージとしても受け付けますが、クライアントで JSON をテスト済みでない限り msgpack を使用してください。 + +Router は転送前に各クライアントイベントをチェックします: + +- **イベントタイプ:** `session.update`、`input_audio_buffer.append`、`input_audio_buffer.commit`、`input_audio_buffer.clear`、`conversation.item.create`、`conversation.item.delete`、`conversation.item.truncate`、`response.create`、`response.cancel`、および fal の `x-fal-session.configure`。 +- **モデル:** `session.update` 内の `model` は `grok-voice-latest`、`grok-voice-3.0`、または `grok-voice-2.0` である必要があります。 +- **ツール:** クライアントが実行する関数ツールは許可されます。サーバー側ツール(ウェブ検索、X 検索、ファイル検索、MCP)は拒否されます。 +- **メディア:** 画像およびビデオ入力は拒否されます。セッションは音声とテキストのみです。 +- **サイズ:** クライアントメッセージ 1 つあたり最大 1 MiB です。 + +拒否されたイベントは転送されず、Router はクローズコード `1008` でセッションを閉じます。 + +## 料金 + +セッションの料金は **1 秒あたり $0.0011869** です（1 分あたり約 $0.0712、1 秒あたり 0.2504 クレジット、1 分あたり約 15.0 クレジット。211 クレジット = 1 USD）。セッションが開いている間は 15 秒単位で課金され、最後の端数の単位は秒単位で切り上げて課金されます。課金はアップグレードからソケットが閉じるまで、オーディオが流れているかどうかに関係なく続きます。 + +## 制限 + +| 制限 | 値 | +| --- | --- | +| アカウントあたりのセッション数 | 同時に開けるセッションは 1 つです。2 つ目を開くと `429` と `router.realtime.session_already_live` が返されます。 | +| セッション長 | 最大 30 分で、接続時点のあなたのクレジット残高で賄える時間を超えることはありません。 | +| セッション中のクレジット | Router は 15 秒ごとに残高を再確認し、次の 1 秒を賄えなくなった時点でセッションを終了します。 | +| 接続レート | 各アップグレード試行は、[呼び出し元ごとのリクエストレート](/ja/development/comfy-router/limitations#リクエストは呼び出し元ごとにレート制限される)にカウントされ、他の Router 呼び出しと共有されます。 | + +セッションが時間制限に達した場合、またはクレジットが不足した場合、接続はクローズフレームなしで閉じることがあります（多くの場合、クローズコード `1006` として現れます）。トップアップ後にのみ再接続するか、より長い時間が必要な場合は新しいセッションを開始してください。 + +## エラー + +### アップグレード前 + +Router が接続を拒否した場合、プロトコルを切り替える代わりに HTTP ステータスと JSON ボディで応答します。 + +```json +{ + "detail": "Insufficient credits to open a realtime session.", + "error_type": "insufficient_credits", + "code": "router.realtime.insufficient_credits" +} +``` + +判定には `code` を使用してください。`detail` は人間向けの説明です。 + +| ステータス | `code` | 原因 | 対処 | +| --- | --- | --- | --- | +| `426` | `router.realtime.upgrade_required` | リクエストが WebSocket アップグレードではありませんでした。 | WebSocket クライアントで接続してください。 | +| `401` | `router.realtime.unauthorized` | APIキーが不足しているか無効です。 | `X-API-Key` または `Authorization: Bearer` で有効なキーを送信してください。 | +| `402` | `router.realtime.insufficient_credits` | 残高がセッションの最低1秒分にも満たない状態です。 | クレジットを追加してから再接続してください。 | +| `402` | `router.realtime.spend_denied` | このセッションの課金対象となるウォレットに資金がありません。ボディ内の `denied_reason` と `billed_workspace` がどのウォレットかを示します。 | そのワークスペースにクレジットを追加してから再接続してください。 | +| `403` | `router.realtime.provider_disabled` | ワークスペースのパートナープロバイダーポリシーがこのプロバイダーを許可していません。 | ワークスペースの管理者に許可を依頼してください。 | +| `404` | `router.realtime.model_not_allowed` | URL 内のモデルはリアルタイムでは利用不可です。 | URL を確認してください。 | +| `429` | `router.realtime.rate_limited` | リクエストレートを超過しました。 | `Retry-After` の時間待ってから再試行してください。 | +| `429` | `router.realtime.session_already_live` | あなたのアカウントで既に別のセッションが開いています。 | 先にそれを閉じてください。 | +| `429` | `router.realtime.concurrency_limit` | パートナーモデルの同時呼び出しが多すぎます。 | 同時実行数を減らして再試行してください。 | +| `502` | `router.realtime.upstream_refused`、`router.realtime.token_mint_failed` | 上流プロバイダーがセッションを開きませんでした。 | バックオフを伴って再試行してください。 | +| `503` | その他の `router.realtime.*` コード | リアルタイムセッションが一時的に利用できません。 | バックオフを伴って再試行してください。 | + +### アップグレード後 + +| クローズコード | 意味 | 対処 | +| --- | --- | --- | +| `1008` | クライアントイベントが拒否されました（[イベント](#イベント)を参照）。 | イベントを修正してください。セッションは終了します。 | +| `1012` | Router が再起動中です。 | 再接続してください。新しいセッションが開始され、新しいアップグレード時点から課金されます。 | +| `1006`（クローズフレームなし） | セッションが制限時間に達した、またはクレジットが不足した際にクライアントが報告する値としてよく見られます。ネットワーク切断も同じように見えます。 | クレジットを追加するか、新しいセッションを開始してください。 | + +その他のクローズコードは fal または xAI からのものです。[イベント](#イベント)にリンクされている各社のドキュメントを参照してください。 + +## 次のステップ + +- [課金](/ja/development/comfy-router/billing): Router の課金方法と利用量の照合方法。 +- [エラーとリトライ](/ja/development/comfy-router/errors): 他の Router 呼び出しが返すエラーの分類。 +- [制限事項](/ja/development/comfy-router/limitations): リクエストレートやその他の制限。 diff --git a/ko/development/comfy-router/realtime.mdx b/ko/development/comfy-router/realtime.mdx new file mode 100644 index 0000000000..3f7db7d40c --- /dev/null +++ b/ko/development/comfy-router/realtime.mdx @@ -0,0 +1,223 @@ +--- +title: "Comfy Router 실시간 음성 세션" +sidebarTitle: "실시간 음성" +description: "Comfy Router를 통해 Grok Voice 실시간 WebSocket 세션을 여는 방법을 설명합니다. 엔드포인트, 인증, 초당 가격, 세션 제한, 그리고 발생할 수 있는 오류와 종료 코드를 다룹니다." +translationSourceHash: e4024a38 +translationFrom: development/comfy-router/realtime.mdx +translationBlockHashes: + "_intro": a85f88e5 + "Endpoint": 2ae36abf + "Authentication": 582120fe + "Connect": b61ae8c6 + "Events": a3ac8c47 + "Pricing": 25d35f6c + "Limits": 85e21dff + "Errors": 3085ba65 + "Next": 3e8c1bd8 +--- +Comfy Router는 fal이 제공하는 xAI의 Grok Voice와 실시간 음성 대 음성 세션을 중계합니다. 사용자는 Comfy API 키로 Router에 WebSocket 하나를 엽니다. Router는 계정과 크레딧을 확인하고, 업스트림에서 세션을 연 뒤, 양방향으로 이벤트를 중계합니다. 세션 시간(초)당 Comfy 크레딧으로 요금이 청구됩니다. + +## 엔드포인트 + +```text +wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime +``` + +요청은 WebSocket 업그레이드입니다 (`GET`에 `Connection: Upgrade` 및 `Upgrade: websocket` 사용). 그 외의 요청은 `426`으로 거부됩니다. + +## 인증 + +업그레이드 요청의 헤더에 Comfy API 키를 `X-API-Key: comfyui-...` 또는 `Authorization: Bearer comfyui-...` 형식으로 보내세요. Router는 쿼리 문자열이나 WebSocket 서브프로토콜에서 키를 읽지 않습니다. + + +브라우저는 WebSocket에 헤더를 설정할 수 없으며, Comfy API 키는 절대 브라우저에 도달해서는 안 됩니다. 서버에서 세션을 열고 오디오를 브라우저로 직접 중계하세요. + + +## 연결 + +업그레이드가 성공하면 xAI가 Grok Voice용으로 문서화한 실시간 이벤트를 보내고 받으세요. 이 예제는 세션을 구성하고, 텍스트 턴 하나를 보내며, 수신하는 각 이벤트 유형을 출력합니다. + + + +```python Python +# pip install websockets msgpack +import asyncio +import os + +import msgpack +import websockets + +URL = "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime" + + +async def send(ws, event): + await ws.send(msgpack.packb(event)) + + +async def main(): + async with websockets.connect( + URL, + additional_headers={"X-API-Key": os.environ["COMFY_API_KEY"]}, + ) as ws: + await send(ws, { + "type": "session.update", + "session": { + "voice": "eve", + "instructions": "You are a helpful assistant.", + "turn_detection": {"type": "server_vad"}, + }, + }) + await send(ws, { + "type": "conversation.item.create", + "item": { + "type": "message", + "role": "user", + "content": [{"type": "input_text", "text": "Hello!"}], + }, + }) + await send(ws, {"type": "response.create"}) + + async for message in ws: + if isinstance(message, str): + continue # fal 자체의 x-fal-message 프레임 + event = msgpack.unpackb(message) + print(event["type"]) + if event["type"] == "response.done": + break + + +asyncio.run(main()) +``` + +```javascript Node.js +// npm install ws @msgpack/msgpack +import WebSocket from "ws"; +import { encode, decode } from "@msgpack/msgpack"; + +const ws = new WebSocket( + "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime", + { headers: { "X-API-Key": process.env.COMFY_API_KEY } }, +); + +ws.on("unexpected-response", (req, res) => { + // 업그레이드가 거부되었습니다. JSON 본문에 사유가 명시됩니다. + let body = ""; + res.on("data", (chunk) => (body += chunk)); + res.on("end", () => console.error(res.statusCode, body)); +}); + +const send = (event) => ws.send(encode(event)); + +ws.on("open", () => { + send({ + type: "session.update", + session: { + voice: "eve", + instructions: "You are a helpful assistant.", + turn_detection: { type: "server_vad" }, + }, + }); + send({ + type: "conversation.item.create", + item: { + type: "message", + role: "user", + content: [{ type: "input_text", text: "Hello!" }], + }, + }); + send({ type: "response.create" }); +}); + +ws.on("message", (data, isBinary) => { + if (!isBinary) return; // fal 자체의 x-fal-message 프레임 + const event = decode(data); + console.log(event.type); + if (event.type === "response.done") ws.close(); +}); + +ws.on("close", (code) => console.log("closed", code)); +``` + + + +작업을 마치면 즉시 소켓을 닫으세요. 마지막 응답 시점이 아니라 세션이 닫힐 때까지 과금됩니다. + +## 이벤트 + +Router는 자체 이벤트 프로토콜을 정의하지 않습니다. 서버 이벤트는 fal이 보내는 그대로 도달하며, Router가 허용하는 클라이언트 이벤트도 변경 없이 전달됩니다. 이벤트 목록, 세션 필드, 음성, 오디오 형식은 다음 문서를 참고하세요: + +- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) 및 xAI의 [realtime 이벤트 스키마](https://docs.x.ai/voice-realtime.ws.json) +- fal의 [Grok Voice realtime 모델 페이지](https://fal.ai/models/xai/grok-voice/realtime) 및 [API 페이지](https://fal.ai/models/xai/grok-voice/realtime/api) + +각 클라이언트 이벤트는 예제에서처럼 하나의 msgpack 바이너리 메시지로 보내세요. 이는 fal의 realtime 클라이언트가 사용하는 프레이밍이며, 모델의 이벤트도 `session.created`로 시작하는 msgpack 바이너리 메시지로 같은 방식으로 돌아옵니다. fal은 또한 자체 JSON 텍스트 메시지인 `x-fal-message`(타이밍 정보)를 보내는데, 이는 건너뛰어도 됩니다. Router의 검사는 클라이언트 이벤트를 하나의 JSON 텍스트 메시지로도 허용하지만, 클라이언트에서 JSON을 테스트해 보지 않았다면 msgpack을 사용하세요. + +Router는 전달하기 전에 각 클라이언트 이벤트를 검사합니다: + +- **이벤트 유형:** `session.update`, `input_audio_buffer.append`, `input_audio_buffer.commit`, `input_audio_buffer.clear`, `conversation.item.create`, `conversation.item.delete`, `conversation.item.truncate`, `response.create`, `response.cancel`, 그리고 fal의 `x-fal-session.configure`. +- **모델:** `session.update`의 `model`은 `grok-voice-latest`, `grok-voice-3.0`, `grok-voice-2.0` 중 하나여야 합니다. +- **도구:** 클라이언트가 실행하는 함수 도구는 허용됩니다. 서버 측 도구(웹 검색, X 검색, 파일 검색, MCP)는 거부됩니다. +- **미디어:** 이미지 및 비디오 입력은 거부됩니다. 세션은 음성과 텍스트 전용입니다. +- **크기:** 클라이언트 메시지 하나는 최대 1 MiB입니다. + +거부된 이벤트는 전달되지 않으며, Router는 종료 코드 `1008`로 세션을 닫습니다. + +## 가격 + +세션 비용은 **초당 $0.0011869**입니다(분당 약 $0.0712, 초당 0.2504 크레딧, 분당 약 15.0 크레딧이며, 211 크레딧 = $1 USD 기준). 세션이 열려 있는 동안 15초 단위로 청구되며, 마지막 부분 증가분은 초 단위로 올림하여 청구됩니다. 청구는 업그레이드 시점부터 소켓이 닫힐 때까지 진행되며, 오디오가 흐르고 있는지 여부와 관계없이 적용됩니다. + +## 제한 사항 + +| 제한 | 값 | +| --- | --- | +| 계정당 세션 수 | 한 번에 하나의 세션만 열 수 있습니다. 두 번째 세션을 열면 `router.realtime.session_already_live`와 함께 `429`가 반환됩니다. | +| 세션 시간 | 최대 30분이며, 연결 시점의 보유 크레딧 잔액으로 감당할 수 있는 시간을 초과할 수 없습니다. | +| 세션 중 크레딧 | Router는 15초마다 잔액을 다시 확인하며, 잔액이 다음 1초를 더 감당할 수 없게 되면 세션을 종료합니다. | +| 연결 요청 속도 | 각 업그레이드 시도는 [호출자별 요청 속도](/ko/development/comfy-router/limitations#요청은-호출자별로-속도-제한됩니다)에 포함되며, 이 속도는 다른 Router 호출과 공유됩니다. | + +세션이 시간 제한에 도달하거나 크레딧이 소진되면, close 프레임 없이 연결이 닫힐 수 있습니다(흔히 close 코드 `1006`으로 표시됨). 크레딧을 충전한 이후에만 다시 연결하거나, 더 많은 시간이 필요하면 새 세션을 시작하세요. + +## 오류 + +### 업그레이드 이전 + +Router가 연결을 거부하면 프로토콜을 전환하지 않고 HTTP 상태와 JSON 본문으로 응답합니다. + +```json +{ + "detail": "Insufficient credits to open a realtime session.", + "error_type": "insufficient_credits", + "code": "router.realtime.insufficient_credits" +} +``` + +`code`를 기준으로 분기하세요. `detail`은 사람이 읽기 위한 것입니다. + +| 상태 | `code` | 원인 | 해결 방법 | +| --- | --- | --- | --- | +| `426` | `router.realtime.upgrade_required` | 요청이 WebSocket 업그레이드가 아니었습니다. | WebSocket 클라이언트로 연결하세요. | +| `401` | `router.realtime.unauthorized` | API 키가 누락되었거나 유효하지 않습니다. | `X-API-Key` 또는 `Authorization: Bearer`에 유효한 키를 보내세요. | +| `402` | `router.realtime.insufficient_credits` | 잔액으로 최소 1초의 세션도 감당할 수 없습니다. | 크레딧을 추가한 뒤 다시 연결하세요. | +| `402` | `router.realtime.spend_denied` | 세션이 청구될 지갑에 자금이 없습니다. 본문의 `denied_reason`과 `billed_workspace`가 어느 지갑인지 알려줍니다. | 해당 워크스페이스에 크레딧을 추가한 뒤 다시 연결하세요. | +| `403` | `router.realtime.provider_disabled` | 워크스페이스의 파트너 공급자 정책이 이 공급자를 허용하지 않습니다. | 워크스페이스 관리자에게 허용을 요청하세요. | +| `404` | `router.realtime.model_not_allowed` | URL에 있는 모델은 realtime에 사용할 수 없습니다. | URL을 확인하세요. | +| `429` | `router.realtime.rate_limited` | 요청 속도 제한을 초과했습니다. | `Retry-After`만큼 기다린 뒤 재시도하세요. | +| `429` | `router.realtime.session_already_live` | 계정에 이미 다른 세션이 열려 있습니다. | 먼저 해당 세션을 닫으세요. | +| `429` | `router.realtime.concurrency_limit` | 동시 파트너 모델 호출이 너무 많습니다. | 동시 작업을 줄이고 재시도하세요. | +| `502` | `router.realtime.upstream_refused`, `router.realtime.token_mint_failed` | 업스트림 공급자가 세션을 열지 않았습니다. | 백오프를 두고 재시도하세요. | +| `503` | 그 밖의 다른 `router.realtime.*` 코드 | realtime 세션을 일시적으로 사용할 수 없습니다. | 백오프를 두고 재시도하세요. | + +### 업그레이드 이후 + +| 종료 코드 | 의미 | 해결 방법 | +| --- | --- | --- | +| `1008` | 클라이언트 이벤트가 거부되었습니다([이벤트](#이벤트) 참고). | 이벤트를 수정하세요. 세션은 종료되었습니다. | +| `1012` | Router가 재시작 중입니다. | 다시 연결하세요. 새 세션이 시작되며 새 업그레이드 시점부터 과금됩니다. | +| `1006` (종료 프레임 없음) | 세션이 시간 제한에 도달했거나 크레딧이 소진되었을 때 클라이언트가 흔히 보고하는 값입니다. 네트워크 끊김도 동일하게 보입니다. | 크레딧을 추가하거나 새 세션을 시작하세요. | + +그 밖의 종료 코드는 fal 또는 xAI에서 발생합니다. [이벤트](#이벤트)에 링크된 해당 문서를 참고하세요. + +## 다음 + +- [청구](/ko/development/comfy-router/billing): Router가 과금하는 방식과 사용량을 확인하는 방법입니다. +- [오류 및 재시도](/ko/development/comfy-router/errors): 다른 Router 호출이 반환하는 오류 유형입니다. +- [제한 사항](/ko/development/comfy-router/limitations): 요청 비율 및 기타 제한 사항입니다. diff --git a/zh/development/comfy-router/realtime.mdx b/zh/development/comfy-router/realtime.mdx new file mode 100644 index 0000000000..ca3fbb1b8f --- /dev/null +++ b/zh/development/comfy-router/realtime.mdx @@ -0,0 +1,223 @@ +--- +title: "Comfy Router 实时语音会话" +sidebarTitle: "实时语音" +description: "通过 Comfy Router 开启 Grok Voice 实时 WebSocket 会话：端点、身份验证、按秒计费、会话限制，以及可能遇到的错误和关闭代码。" +translationSourceHash: e4024a38 +translationFrom: development/comfy-router/realtime.mdx +translationBlockHashes: + "_intro": a85f88e5 + "Endpoint": 2ae36abf + "Authentication": 582120fe + "Connect": b61ae8c6 + "Events": a3ac8c47 + "Pricing": 25d35f6c + "Limits": 85e21dff + "Errors": 3085ba65 + "Next": 3e8c1bd8 +--- +Comfy Router 会中继一段由 fal 提供的、与 xAI Grok Voice 之间的实时语音到语音会话。你只需使用自己的 Comfy API 密钥，向 Router 建立一个 WebSocket 连接。Router 会校验你的账户与积分，在上游开启会话，随后双向中继事件。会话按秒计费，费用从你的 Comfy 积分中扣除。 + +## 端点 + +```text +wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime +``` + +该请求是一个 WebSocket 升级（`GET` 请求，带有 `Connection: Upgrade` 和 `Upgrade: websocket`）。其他请求一律以 `426` 拒绝。 + +## 身份验证 + +在升级请求的头部中携带你的 Comfy API 密钥，可以是 `X-API-Key: comfyui-...`，也可以是 `Authorization: Bearer comfyui-...`。Router 不会从查询字符串或 WebSocket 子协议中读取密钥。 + + +浏览器无法为 WebSocket 设置头部，而且 Comfy API 密钥绝不能出现在浏览器中。请从你的服务器打开会话，并自行将音频转发到浏览器。 + + +## 连接 + +升级成功后，发送并接收 xAI 为 Grok Voice 文档中描述的实时事件。此示例配置会话、发送一轮文本，并打印它收到的每个事件类型。 + + + +```python Python +# pip install websockets msgpack +import asyncio +import os + +import msgpack +import websockets + +URL = "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime" + + +async def send(ws, event): + await ws.send(msgpack.packb(event)) + + +async def main(): + async with websockets.connect( + URL, + additional_headers={"X-API-Key": os.environ["COMFY_API_KEY"]}, + ) as ws: + await send(ws, { + "type": "session.update", + "session": { + "voice": "eve", + "instructions": "You are a helpful assistant.", + "turn_detection": {"type": "server_vad"}, + }, + }) + await send(ws, { + "type": "conversation.item.create", + "item": { + "type": "message", + "role": "user", + "content": [{"type": "input_text", "text": "Hello!"}], + }, + }) + await send(ws, {"type": "response.create"}) + + async for message in ws: + if isinstance(message, str): + continue # fal 自己的 x-fal-message 帧 + event = msgpack.unpackb(message) + print(event["type"]) + if event["type"] == "response.done": + break + + +asyncio.run(main()) +``` + +```javascript Node.js +// npm install ws @msgpack/msgpack +import WebSocket from "ws"; +import { encode, decode } from "@msgpack/msgpack"; + +const ws = new WebSocket( + "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime", + { headers: { "X-API-Key": process.env.COMFY_API_KEY } }, +); + +ws.on("unexpected-response", (req, res) => { + // 升级被拒绝。JSON 正文说明了原因。 + let body = ""; + res.on("data", (chunk) => (body += chunk)); + res.on("end", () => console.error(res.statusCode, body)); +}); + +const send = (event) => ws.send(encode(event)); + +ws.on("open", () => { + send({ + type: "session.update", + session: { + voice: "eve", + instructions: "You are a helpful assistant.", + turn_detection: { type: "server_vad" }, + }, + }); + send({ + type: "conversation.item.create", + item: { + type: "message", + role: "user", + content: [{ type: "input_text", text: "Hello!" }], + }, + }); + send({ type: "response.create" }); +}); + +ws.on("message", (data, isBinary) => { + if (!isBinary) return; // fal 自己的 x-fal-message 帧 + const event = decode(data); + console.log(event.type); + if (event.type === "response.done") ws.close(); +}); + +ws.on("close", (code) => console.log("closed", code)); +``` + + + +完成后立即关闭套接字。计费会持续到会话关闭，而不是到最后一次响应。 + +## 事件 + +Router 不定义自己的事件协议。服务器事件会完全按照 fal 发送的原样到达你这里，Router 接受的客户端事件也会被原样转发。关于事件列表、会话字段、语音和音频格式，请参阅： + +- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) 以及 xAI 的 [realtime 事件 schema](https://docs.x.ai/voice-realtime.ws.json) +- fal 的 [Grok Voice realtime 模型页面](https://fal.ai/models/xai/grok-voice/realtime) 及其 [API 页面](https://fal.ai/models/xai/grok-voice/realtime/api) + +请像示例中那样，把每个客户端事件作为一条 msgpack 二进制消息发送。这是 fal 的 realtime 客户端所使用的帧格式，模型的事件也会以相同方式返回，即同样是以 `session.created` 开头的 msgpack 二进制消息。fal 还会发送自己的 JSON 文本消息，类型为 `x-fal-message`（计时信息），你可以跳过它们。Router 的检查也接受以单条 JSON 文本消息形式发送的客户端事件，但除非你已经用你的客户端测试过 JSON，否则请使用 msgpack。 + +Router 会在转发每个客户端事件之前先对其进行检查： + +- **事件类型：** `session.update`、`input_audio_buffer.append`、`input_audio_buffer.commit`、`input_audio_buffer.clear`、`conversation.item.create`、`conversation.item.delete`、`conversation.item.truncate`、`response.create`、`response.cancel`，以及 fal 的 `x-fal-session.configure`。 +- **模型：** `session.update` 中的 `model` 必须是 `grok-voice-latest`、`grok-voice-3.0` 或 `grok-voice-2.0`。 +- **工具：** 允许使用由你的客户端执行的函数工具。服务器端工具（Web 搜索、X 搜索、文件搜索和 MCP）会被拒绝。 +- **媒体：** 图像和视频输入会被拒绝。会话仅支持语音和文本。 +- **大小：** 单条客户端消息最大为 1 MiB。 + +被拒绝的事件不会被转发，Router 会以关闭码 `1008` 关闭会话。 + +## 定价 + +一次会话的费用为**每秒 $0.0011869**（约每分钟 $0.0712，或每秒 0.2504 积分，约每分钟 15.0 积分，按 211 积分 = 1 美元计算）。会话开启期间按 15 秒的增量计费，最后一个不足 15 秒的增量按秒计费并向上取整。计费从升级时开始，直到 socket 关闭为止，无论期间是否有音频传输。 + +## 限制 + +| 限制项 | 值 | +| --- | --- | +| 每账户会话数 | 同一时间只能有一个打开的会话。打开第二个会话会返回 `429`，错误码为 `router.realtime.session_already_live`。 | +| 会话时长 | 最长 30 分钟，且绝不会超过连接时你的积分余额所能覆盖的时长。 | +| 会话期间的积分 | Router 每 15 秒重新检查一次你的余额，当余额不足以覆盖下一秒时便会结束会话。 | +| 连接速率 | 每次升级尝试都计入你的[按调用方请求速率](/zh/development/comfy-router/limitations#请求按调用方进行速率限制)，并与其他 Router 调用共享该额度。 | + +当会话达到时间上限或积分已用完时，连接可能会在没有关闭帧的情况下关闭（通常表现为关闭码 `1006`）。请在充值之后再重新连接，或者如果需要更多时间，请启动一个新会话。 + +## 错误 + +### 升级之前 + +如果 Router 拒绝连接，它会返回 HTTP 状态码和 JSON 响应体，而不是切换协议： + +```json +{ + "detail": "Insufficient credits to open a realtime session.", + "error_type": "insufficient_credits", + "code": "router.realtime.insufficient_credits" +} +``` + +请根据 `code` 进行判断；`detail` 是供人阅读的。 + +| 状态码 | `code` | 原因 | 处理方式 | +| --- | --- | --- | --- | +| `426` | `router.realtime.upgrade_required` | 该请求不是 WebSocket 升级请求。 | 使用 WebSocket 客户端连接。 | +| `401` | `router.realtime.unauthorized` | API 密钥缺失或无效。 | 在 `X-API-Key` 或 `Authorization: Bearer` 中发送有效密钥。 | +| `402` | `router.realtime.insufficient_credits` | 你的余额不足以支付至少一秒的会话费用。 | 添加积分，然后重新连接。 | +| `402` | `router.realtime.spend_denied` | 本次会话将扣费的钱包没有足够资金。响应体中的 `denied_reason` 和 `billed_workspace` 会说明是哪个钱包。 | 向该工作区添加积分，然后重新连接。 | +| `403` | `router.realtime.provider_disabled` | 你的工作区的合作伙伴提供商策略不允许使用此提供商。 | 请工作区管理员允许使用该提供商。 | +| `404` | `router.realtime.model_not_allowed` | URL 中的模型不可用于实时会话。 | 检查 URL。 | +| `429` | `router.realtime.rate_limited` | 你超过了请求速率限制。 | 等待 `Retry-After`，然后重试。 | +| `429` | `router.realtime.session_already_live` | 你的账户已打开另一个会话。 | 请先关闭该会话。 | +| `429` | `router.realtime.concurrency_limit` | 并发合作伙伴模型调用过多。 | 减少并发任务并重试。 | +| `502` | `router.realtime.upstream_refused`、`router.realtime.token_mint_failed` | 上游提供商未能打开会话。 | 使用退避策略重试。 | +| `503` | 任何其他 `router.realtime.*` 代码 | 实时会话暂时不可用。 | 使用退避策略重试。 | + +### 升级之后 + +| 关闭码 | 含义 | 处理方式 | +| --- | --- | --- | +| `1008` | 客户端事件被拒绝（见[事件](#事件)）。 | 修正该事件。会话已结束。 | +| `1012` | Router 正在重启。 | 重新连接。新会话会启动，并从新的升级开始计费。 | +| `1006`（无关闭帧） | 通常是在会话达到时间限制或积分用完时客户端报告的结果。网络中断看起来也是如此。 | 添加积分或启动新会话。 | + +任何其他关闭码都来自 fal 或 xAI。请参阅[事件](#事件)下链接的文档。 + +## 下一步 + +- [计费](/zh/development/comfy-router/billing)：Router 如何收费以及如何核对用量。 +- [错误与重试](/zh/development/comfy-router/errors)：其他 Router 调用返回的错误分类。 +- [限制](/zh/development/comfy-router/limitations)：请求速率及其他限制。 From 17e0c06e30f94cecc5e151dc688a546f3623b618 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Mon, 2 Nov 2026 11:15:20 +0800 Subject: [PATCH 2/4] i18n: sync zh/ja/ko Comfy Router pages with upstream/main (2026-11-02) --- ja/development/comfy-router/api.mdx | 5 +++-- ja/development/comfy-router/limitations.mdx | 14 +++++-------- .../dreamina-seedance-2-0-260128/code.mdx | 10 +++++----- .../code.mdx | 10 +++++----- .../dreamina-seedance-2-0-mini/code.mdx | 10 +++++----- .../dreamina-seedance-2-5-260628/code.mdx | 10 +++++----- .../byteplus/seedance-1-0-pro-250528/code.mdx | 10 +++++----- .../seedance-1-0-pro-fast-251015/code.mdx | 10 +++++----- .../byteplus/seedance-1-5-pro-251215/code.mdx | 10 +++++----- .../models/kling/kling-3-0-turbo/code.mdx | 8 ++++---- .../models/kling/kling-image-o1/code.mdx | 8 ++++---- .../models/kling/kling-v2-5-turbo/code.mdx | 8 ++++---- .../models/kling/kling-v2-6/code.mdx | 8 ++++---- .../models/kling/kling-v3-omni/code.mdx | 8 ++++---- .../models/kling/kling-v3/code.mdx | 8 ++++---- .../models/kling/kling-video-o1/code.mdx | 8 ++++---- .../kling/videos-avatar-image2video/code.mdx | 8 ++++---- .../models/kling/videos-lip-sync/code.mdx | 6 +++--- .../models/runway/gen4-image/code.mdx | 6 +++--- .../xai/grok-imagine-image-2-0/code.mdx | 8 ++++---- .../xai/grok-imagine-image-pro/code.mdx | 8 ++++---- .../xai/grok-imagine-image-quality/code.mdx | 8 ++++---- .../models/xai/grok-imagine-image/code.mdx | 8 ++++---- ja/development/comfy-router/reference.mdx | 20 +++++++++---------- ko/development/comfy-router/api.mdx | 5 +++-- ko/development/comfy-router/limitations.mdx | 14 +++++-------- .../dreamina-seedance-2-0-260128/code.mdx | 10 +++++----- .../code.mdx | 10 +++++----- .../dreamina-seedance-2-0-mini/code.mdx | 10 +++++----- .../dreamina-seedance-2-5-260628/code.mdx | 10 +++++----- .../byteplus/seedance-1-0-pro-250528/code.mdx | 10 +++++----- .../seedance-1-0-pro-fast-251015/code.mdx | 10 +++++----- .../byteplus/seedance-1-5-pro-251215/code.mdx | 10 +++++----- .../models/kling/kling-3-0-turbo/code.mdx | 8 ++++---- .../models/kling/kling-image-o1/code.mdx | 8 ++++---- .../models/kling/kling-v2-5-turbo/code.mdx | 8 ++++---- .../models/kling/kling-v2-6/code.mdx | 8 ++++---- .../models/kling/kling-v3-omni/code.mdx | 8 ++++---- .../models/kling/kling-v3/code.mdx | 8 ++++---- .../models/kling/kling-video-o1/code.mdx | 8 ++++---- .../kling/videos-avatar-image2video/code.mdx | 8 ++++---- .../models/kling/videos-lip-sync/code.mdx | 6 +++--- .../models/runway/gen4-image/code.mdx | 6 +++--- .../xai/grok-imagine-image-2-0/code.mdx | 8 ++++---- .../xai/grok-imagine-image-pro/code.mdx | 8 ++++---- .../xai/grok-imagine-image-quality/code.mdx | 8 ++++---- .../models/xai/grok-imagine-image/code.mdx | 8 ++++---- ko/development/comfy-router/reference.mdx | 20 +++++++++---------- zh/development/comfy-router/api.mdx | 5 +++-- zh/development/comfy-router/limitations.mdx | 14 +++++-------- .../dreamina-seedance-2-0-260128/code.mdx | 10 +++++----- .../code.mdx | 10 +++++----- .../dreamina-seedance-2-0-mini/code.mdx | 10 +++++----- .../dreamina-seedance-2-5-260628/code.mdx | 10 +++++----- .../byteplus/seedance-1-0-pro-250528/code.mdx | 10 +++++----- .../seedance-1-0-pro-fast-251015/code.mdx | 10 +++++----- .../byteplus/seedance-1-5-pro-251215/code.mdx | 10 +++++----- .../models/kling/kling-3-0-turbo/code.mdx | 8 ++++---- .../models/kling/kling-image-o1/code.mdx | 8 ++++---- .../models/kling/kling-v2-5-turbo/code.mdx | 8 ++++---- .../models/kling/kling-v2-6/code.mdx | 8 ++++---- .../models/kling/kling-v3-omni/code.mdx | 8 ++++---- .../models/kling/kling-v3/code.mdx | 8 ++++---- .../models/kling/kling-video-o1/code.mdx | 8 ++++---- .../kling/videos-avatar-image2video/code.mdx | 8 ++++---- .../models/kling/videos-lip-sync/code.mdx | 6 +++--- .../models/runway/gen4-image/code.mdx | 6 +++--- .../xai/grok-imagine-image-2-0/code.mdx | 8 ++++---- .../xai/grok-imagine-image-pro/code.mdx | 8 ++++---- .../xai/grok-imagine-image-quality/code.mdx | 8 ++++---- .../models/xai/grok-imagine-image/code.mdx | 8 ++++---- zh/development/comfy-router/reference.mdx | 20 +++++++++---------- 72 files changed, 321 insertions(+), 330 deletions(-) diff --git a/ja/development/comfy-router/api.mdx b/ja/development/comfy-router/api.mdx index c6f3fadec0..dd4fb7cbd6 100644 --- a/ja/development/comfy-router/api.mdx +++ b/ja/development/comfy-router/api.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API の概要" sidebarTitle: "概要" description: "Comfy Router API の仕組み: モデル ID ごとに 1 つのルート。検出、スキーマ、キュー中のリクエスト、エラー、課金に関するガイドを用意しています。" -translationSourceHash: dac7e853 +translationSourceHash: cb493feb translationFrom: development/comfy-router/api.mdx --- @@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx - [クイックスタート](/ja/development/comfy-router/quickstart): インストール、呼び出し、画像の保存。 - [モデル](/ja/development/comfy-router/models): カタログをブラウズし、モデル固有のリクエスト例を確認します。 - [ヘッダー](/ja/development/comfy-router/headers): 認証、冪等性、リクエスト ID、リトライのペース配分。 -- [API リファレンス](/ja/development/comfy-router/reference): エンドポイントのパラメータ、スキーマ、レスポンスコード。 \ No newline at end of file +- [API リファレンス](/ja/development/comfy-router/reference): エンドポイントのパラメータ、スキーマ、レスポンスコード。 +- [リアルタイム音声](/ja/development/comfy-router/realtime): Grok Voice の WebSocket セッションを開き、秒単位で課金されます。 diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index e251530d59..96993f599f 100644 --- a/ja/development/comfy-router/limitations.mdx +++ b/ja/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router の機能と制限" sidebarTitle: "機能と制限" description: "Comfy Router とパートナープロキシのどちらを選ぶか、長時間実行される呼び出しへの備え、リカバリ・レート制限・アセット保存について説明します。" -translationSourceHash: 235802c5 +translationSourceHash: b4d8209c translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": cf6e2050 - "Models without a pre-flight estimate": 495bdb2b + "Models without a pre-flight estimate": f6dfd921 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -116,21 +116,17 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} - **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` -- **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **fal**: `fal/crystal-upscaler`, `fal/crystal-video-upscaler`, `fal/fal-gpt-image-2`, `fal/fal-gpt-image-2.5-flare`, `fal/fal-gpt-image-2.5-sunburst`, `fal/fal-nano-banana-2`, `fal/fal-nano-banana-pro`, `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`, `fal/flux-3-max`, `fal/patina` +- **fal**: `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5` - **freepik**: `freepik/ai-image-upscaler-precision-v2`, `freepik/ai-skin-enhancer-creative`, `freepik/ai-skin-enhancer-faithful`, `freepik/ai-skin-enhancer-flexible` - **heygen**: `heygen/starfish` -- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`, `ideogram/p-image-ideogram` -- **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` -- **luma**: `luma/photon-1`, `luma/photon-flash-1` -- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` +- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` +- **kling**: `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` - **runware**: `runware/runware-gpt-image-2`, `runware/runware-gpt-image-2.5-flare`, `runware/runware-gpt-image-2.5-sunburst`, `runware/runware-nano-banana-2`, `runware/runware-nano-banana-pro`, `runware/runware-seedance-2.0`, `runware/runware-seedance-2.5` - **synclabs**: `synclabs/sync-3` -- **veed**: `veed/clean-audio`, `veed/clean-audio-video`, `veed/fabric-1.0`, `veed/lipsync-2.0`, `veed/video-background-removal`, `veed/video-background-removal-fast`, `veed/video-background-removal-green-screen` - **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 3a23417044..db3d238d64 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "Dreamina Seedance 2.0 260128 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-260128 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 9604ca27 +translationSourceHash: 70ec471f translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 6c5da06a + "Schema": 8c0478c9 "Examples": 641c458b --- @@ -287,10 +287,10 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ 返されたタスク 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.0、2.0 fast、2.0 mini: [4,15] または -1（自動）。 - 範囲: `2` から `30` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index b33007d441..660ce9f9ff 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Dreamina Seedance 2.0 Fast 260128 を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-fast-260128 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: b02c6ed1 +translationSourceHash: 8036f4db translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": e03c503a + "Schema": 90b60b2e "Examples": 7714eccd --- @@ -279,10 +279,10 @@ v1 /proxy を直接呼び出す場合は、代わりに BytePlus 自身のバリ 返されたタスク ID を `draft_task` コンテンツ項目に渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間（秒）。Seedance 2.5: [4,30] または -1（自動。ビデオ編集タスクは -1 のみをサポート）。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1（自動）。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間（秒）。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1（自動）。 - 範囲: `2` から `30` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 1fc770ca00..2f8f216ebd 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Dreamina Seedance 2.0 Mini を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-mini を呼び出す方法: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 28c5c053 +translationSourceHash: a1d75c67 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 3c26a330 + "Schema": ebf1fc3a "Examples": db01067e --- @@ -281,10 +281,10 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ 返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間（秒）。Seedance 2.5: [4,30] または -1（自動。ビデオ編集タスクは -1 のみをサポート）。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1（自動）。Seedance 1.5 プロ: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間（秒）。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1（自動）。 - 範囲: `2` 〜 `30` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 32aea062d4..048ce0e7a1 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,13 +2,13 @@ title: "Dreamina Seedance 2.5 260628 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-5-260628 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンス。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 07fd9c64 +translationSourceHash: 3606fb83 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0a76af44 + "Schema": d2c28a84 "Examples": 5465695b --- @@ -292,10 +292,10 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ 返されたタスク ID を `draft_task` コンテンツ項目で渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間（秒）。Seedance 2.5: [4,30] または -1（自動。ビデオ編集タスクは -1 のみをサポート）。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1（自動）。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間（秒）。Seedance 2.5: [4,30] または -1（自動）。 - 範囲: `2` から `30` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 89d9be1b9f..a2c17b032b 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Seedance 1.0 Pro 250528 を使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-250528 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 450bbe6e +translationSourceHash: 642f85ab translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": fc979e05 + "Schema": b57b84de "Examples": 815d621e --- @@ -279,10 +279,10 @@ Comfy側のガードレールであり、BytePlusの制約ではありません 返されたタスクIDを `draft_task` コンテンツ項目に渡すと、最終的な 1080p ビデオがレンダリングされます。ドラフトタスクIDは7日間有効です。 - - ビデオの再生時間（秒）。Seedance 2.5: [4,30] または -1（自動。ビデオ編集タスクは -1 のみサポート）。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1（自動）。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間（秒）。Seedance 1.0 pro、1.0 pro fast: [2,12]。 - 範囲: `2` 〜 `30` + 指定可能な値: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 0d3cd6f3c6..ee5d48e414 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,12 +2,12 @@ title: "Seedance 1.0 Pro Fast 251015 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-fast-251015 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて解説します。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 43683424 +translationSourceHash: 61dd0135 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": a882b2d8 + "Schema": dd74b012 "Examples": 1469ab97 --- @@ -281,10 +281,10 @@ BytePlus 自身のバリデータが応答します。実際のトラフィッ 返されたタスク ID を `draft_task` コンテンツ項目に渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間（秒）。Seedance 2.5: [4,30] または -1（自動。ビデオ編集タスクは -1 のみをサポート）。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1（自動）。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間（秒）。Seedance 1.0 pro、1.0 pro fast: [2,12]。 - 範囲: `2` から `30` + 指定可能な値: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 7a54185e4e..6134345bb4 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,12 +2,12 @@ title: "Comfy Router で Seedance 1.5 Pro 251215 を使用する" description: "Comfy Router 経由で byteplus/seedance-1-5-pro-251215 を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。" sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 1d016721 +translationSourceHash: 2263b4cf translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 35f3b5dc + "Schema": f4d67fb6 "Examples": 7e73ac5c --- @@ -279,10 +279,10 @@ v1 /proxy を直接呼び出した場合は BytePlus 自身のバリデータが 返されたタスク ID を `draft_task` コンテンツ項目で指定して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 - - ビデオの再生時間（秒）。Seedance 2.5: [4,30] または -1（自動。ビデオ編集タスクは -1 のみをサポート）。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1（自動）。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + + ビデオの再生時間（秒）。Seedance 1.5 pro: [4,12] または -1（自動）。 - 範囲: `2` から `30` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx index e387986e28..9e70ef6ad1 100644 --- a/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router で Kling 3.0 Turbo を使用する" description: "Comfy Router 経由で kling/kling-3.0-turbo を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling 3.0 Turbo" -translationSourceHash: 301a1ee1 +translationSourceHash: d03a4ba5 translationFrom: development/comfy-router/models/kling/kling-3-0-turbo/code.mdx translationBlockHashes: "_intro": 5a8c5f4b "Quick start": a2145573 "Serving providers": 7ec93d4f - "Schema": 1f5f61c1 + "Schema": 4ec53894 "Examples": 0a9a8bbe --- @@ -195,11 +195,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - タスク結果のコールバック通知 URL。タスクのステータスが変化したときにサーバーが通知します。 + タスク結果のコールバック通知 URL。タスクのステータスが変化したときにサーバーが通知します。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 - カスタムタスク ID。システムが生成したタスク ID を上書きすることはありませんが、クエリに使用できます。1 つのユーザーアカウント内で一意である必要があります。 + カスタムタスク ID。システムが生成したタスク ID を上書きすることはありませんが、クエリに使用できます。1 つのユーザーアカウント内で一意である必要があります。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx b/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx index 1dfb6f8731..7edb88fd58 100644 --- a/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Kling Image O1 を使用する" description: "Comfy Router を通じて kling/kling-image-o1 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling Image O1" -translationSourceHash: cf053382 +translationSourceHash: 0d76917c translationFrom: development/comfy-router/models/kling/kling-image-o1/code.mdx translationBlockHashes: "_intro": 513c65df "Quick start": 6256a30d - "Schema": d18a5393 + "Schema": 61821697 "Examples": 826db173 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクステータスが変化したときにサーバーから能動的に通知されます。 + このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクステータスが変化したときにサーバーから能動的に通知されます。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -182,7 +182,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。 + カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index a69f9bf8a4..55044739be 100644 --- a/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,12 +2,12 @@ title: "Kling V2.5 Turbo を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-v2-5-turbo を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1a5ec6e5 +translationSourceHash: 1671e7b6 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 2495a4d3 "Quick start": dc63b3ac - "Schema": 68d50e72 + "Schema": 3bcb036e "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - コールバック通知先アドレス + コールバック通知先アドレス 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - カスタムタスクID + カスタムタスクID 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx index 86f2e928dc..6594273577 100644 --- a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Kling V2.6 を使用する" description: "Comfy Router 経由で kling/kling-v2-6 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V2.6" -translationSourceHash: 1e64e957 +translationSourceHash: c445a7bd translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": 04868509 "Quick start": 48a3d970 - "Schema": 9d23ff94 + "Schema": a61a551f "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - コールバック通知先アドレス + コールバック通知先アドレス 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - カスタムタスク ID + カスタムタスク ID 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx index d6e09f2638..1e63a56c77 100644 --- a/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -2,12 +2,12 @@ title: "Kling V3 Omni を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-v3-omni を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V3 Omni" -translationSourceHash: 226ee8a6 +translationSourceHash: 29d1799c translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": f9b37353 + "Schema": 68bd0500 "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーが能動的に通知します。 + このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーが能動的に通知します。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 フォーマット: `uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - カスタムタスクID。単一のユーザーアカウント内で一意である必要があります。 + カスタムタスクID。単一のユーザーアカウント内で一意である必要があります。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-v3/code.mdx b/ja/development/comfy-router/models/kling/kling-v3/code.mdx index bd8c4f29cf..8e04045525 100644 --- a/ja/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router で Kling V3 を使用する" description: "Comfy Router 経由で kling/kling-v3 を呼び出します。エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V3" -translationSourceHash: ecfa3f9b +translationSourceHash: e07d4035 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 74a12e0f "Quick start": 09c0a41a "Serving providers": a8b20c72 - "Schema": 77550c0a + "Schema": 8e8b04e6 "Examples": 8623c725 --- @@ -177,7 +177,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - コールバック通知先アドレス + コールバック通知先アドレス 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -247,7 +247,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - カスタムタスクID + カスタムタスクID 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx b/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx index 1bc4fa1c1c..791d6d9dc3 100644 --- a/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -2,12 +2,12 @@ title: "Kling Video O1 を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-video-o1 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling Video O1" -translationSourceHash: 3c228231 +translationSourceHash: 892ccf77 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": 6f4cf55b + "Schema": f693e2ef "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーから能動的に通知されます。 + このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーから能動的に通知されます。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - カスタムタスクID。1 つのユーザーアカウント内で一意である必要があります。 + カスタムタスクID。1 つのユーザーアカウント内で一意である必要があります。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx index 46daa06fdf..e0f850e6c6 100644 --- a/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx +++ b/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Videos Avatar Image 2video を使用する" description: "Comfy Router 経由で kling/videos-avatar-image2video を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Videos Avatar Image 2video" -translationSourceHash: 444b1395 +translationSourceHash: 5181e917 translationFrom: development/comfy-router/models/kling/videos-avatar-image2video/code.mdx translationBlockHashes: "_intro": baca1542 "Quick start": 5605d33f - "Schema": eeb06fe1 + "Schema": 073bf8b2 "Examples": ce6803dd --- @@ -164,13 +164,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R - このタスクの結果を受け取るコールバック通知アドレス。 + このタスクの結果を受け取るコールバック通知アドレス。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` - カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。 + カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx index 80a7965e28..845e809713 100644 --- a/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx +++ b/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Videos Lip Sync を使う" description: "Comfy Router 経由で kling/videos-lip-sync を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて。" sidebarTitle: "Videos Lip Sync" -translationSourceHash: ddd2a405 +translationSourceHash: 6103bea9 translationFrom: development/comfy-router/models/kling/videos-lip-sync/code.mdx translationBlockHashes: "_intro": 0477697a "Quick start": e13a4628 - "Schema": 90571e9f + "Schema": 4fb7c777 "Examples": d1dd6ed8 --- @@ -176,7 +176,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID ### 入力 - コールバック通知アドレス。タスクのステータスが変更されるとサーバーから通知されます。 + コールバック通知アドレス。タスクのステータスが変更されるとサーバーから通知されます。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` diff --git a/ja/development/comfy-router/models/runway/gen4-image/code.mdx b/ja/development/comfy-router/models/runway/gen4-image/code.mdx index 02df1cab50..550a44df97 100644 --- a/ja/development/comfy-router/models/runway/gen4-image/code.mdx +++ b/ja/development/comfy-router/models/runway/gen4-image/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Gen 4 Image を使用する" description: "Comfy Router 経由で runway/gen4_image を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Gen 4 Image" -translationSourceHash: c5792f5c +translationSourceHash: 51dc9815 translationFrom: development/comfy-router/models/runway/gen4-image/code.mdx translationBlockHashes: "_intro": f3b89ce9 "Quick start": 82a202eb - "Schema": d889abf3 + "Schema": 1160ec6d "Examples": 291dbf54 --- @@ -168,7 +168,7 @@ curl https://api.comfy.org/v2/models/runway/gen4_image/requests/$REQUEST_ID \ - エンコードされた画像を含む HTTPS URL またはデータ URI + エンコードされた画像を含む HTTPS URL、Runway アップロード URI（runway://）、または data URI Router が `GET /v2/models/runway/gen4_image/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx index b0b1763d17..f2bbc30d2e 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Grok Imagine Image 2.0 を使用する" description: "Comfy Router 経由で xai/grok-imagine-image-2.0 を呼び出します: endpoint、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Grok Imagine Image 2.0" -translationSourceHash: 83fe91a1 +translationSourceHash: e062dc40 translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: "_intro": 614e2e15 "Quick start": ff9945c8 - "Schema": faf9e081 + "Schema": cb29dfae "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES - 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します（low/medium。デフォルトは medium）。その他のモデルは現在これを無視します。 + 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します（low、medium、または auto。省略時は xAI のデフォルトで、auto は生成時に low、編集時に medium を使用）。その他のモデルはこれを無視します。 - 指定可能な値: `low`, `medium`, `high` + 指定可能な値: `low`, `medium`, `high`, `auto` diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx index ea409df086..db5f5ae708 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx @@ -2,12 +2,12 @@ title: "Grok Imagine Image Pro を Comfy Router で使用する" description: "Comfy Router 経由で xai/grok-imagine-image-pro を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。" sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: 7932bb72 +translationSourceHash: 773b1560 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: "_intro": 97d341e4 "Quick start": 3a4bd585 - "Schema": 5d56d158 + "Schema": 805c771c "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES - 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します（low/medium、デフォルトは medium）。その他のモデルでは現在無視されます。 + 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します（low、medium、または auto。省略時は xAI のデフォルトで、auto は生成時に low、編集時に medium を使用）。その他のモデルはこれを無視します。 - 指定可能な値: `low`, `medium`, `high` + 指定可能な値: `low`, `medium`, `high`, `auto` diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx index 5f7d233efb..e8c6ea066a 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Grok Imagine Image Quality を使用する" description: "Comfy Router 経由で xai/grok-imagine-image-quality を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて。" sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 923968d2 +translationSourceHash: 9f6e16d5 translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: "_intro": 72081c22 "Quick start": 799275b8 - "Schema": e0fcef44 + "Schema": e2c96ff6 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE - 出力画像の品質。grok-imagine-image-2.0 では価格ティア（low/medium。デフォルトは medium）を選択します。その他のモデルは現在この項目を無視します。 + 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します（low、medium、または auto。省略時は xAI のデフォルトで、auto は生成時に low、編集時に medium を使用）。その他のモデルはこれを無視します。 - 指定可能な値: `low`、`medium`、`high` + 指定可能な値: `low`、`medium`、`high`、`auto` diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx index 92b8b1dfc1..9bb27cb588 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Grok Imagine Image を使う" description: "Comfy Router 経由で xai/grok-imagine-image を呼び出す: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Grok Imagine Image" -translationSourceHash: 9cfb938a +translationSourceHash: 2e5c55ad translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: "_intro": a2e97c88 "Quick start": a5495331 - "Schema": 1d17b83a + "Schema": 171da7d5 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID - 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します（low/medium。デフォルトは medium）。その他のモデルは現在のところこれを無視します。 + 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します（low、medium、または auto。省略時は xAI のデフォルトで、auto は生成時に low、編集時に medium を使用）。その他のモデルはこれを無視します。 - 取り得る値: `low`、`medium`、`high` + 指定可能な値: `low`、`medium`、`high`、`auto` diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index fd47f1f242..afe1998237 100644 --- a/ja/development/comfy-router/reference.mdx +++ b/ja/development/comfy-router/reference.mdx @@ -2,17 +2,17 @@ title: "Comfy Router API リファレンス" description: "Comfy API 契約から生成済みの、Comfy Router のすべてのエンドポイント、パラメータ、レスポンスボディ、エラーバケット。" sidebarTitle: "API リファレンス" -translationSourceHash: a6f99965 +translationSourceHash: aee933a1 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": 222fd740 + "Endpoints": e0879d3c "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 5952af3f - "Result assets": 18fe6dad + "Pre-flight cost estimates": f0ba96a1 + "Result assets": 5936427c "Per-model input and output schemas": 61c6bde8 - "Schemas": 984bd216 + "Schemas": c1245cc9 --- @@ -309,7 +309,7 @@ Comfy API キーは Bearer トークンとして送信することもできま **モデル呼び出しを実行する前に、実行せずに価格を見積もります。** -このボディをこのモデルで実行した場合のコストを米ドルで示す事前見積もりを返します。価格は、実行時の請求に使われるのと同じレートカードから算出されます（ベンダーが報告するコストで課金されるモデルの場合は、代わりにベンダーの公開価格表から見積もられます）。これは見積もりであり、最終的な請求額ではありません。実際に支払うのは、ワークスペースの利用状況および請求記録に確定した請求額です。ボディはまずモデルの入力スキーマに対して検証されます。デフォルトの実行（`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` となります。また、Router がまだ実行できないモデルは、実行ルート自身の `detail` を伴う同じ `403` を返すため、`detail` を読んで両者を区別してください。 **パラメータ** @@ -1000,7 +1000,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 見積もりの限界。`200` の数値は、実行が受け付けられること、または正確にその金額が請求されることを約束するものではありません: - `/estimate` は `strict_mode` や `reject_unknown_fields` を受け取らないため、モデルのネイティブな契約のみを検証します。`strict_mode=true` の実行が代替プロバイダー自身のスキーマで受け付けるボディが、ここでは `422` になることがあります。また、`reject_unknown_fields=true` の実行なら拒否する未宣言のトップレベルフィールドが、ここでは価格付けされます。Anthropic Messages モデルは例外です。そのスキーマは未宣言のフィールドを許容するため、`reject_unknown_fields=true` の実行でも何も拒否せず、見積もりは未宣言のトップレベルフィールド `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` および空の `mcp_servers` のみを価格付けします。その他の未宣言のトップレベルフィールドがあると、`reason: not_quotable` とともに `unknown` を返します。 -- `pricing_as_of` は料率表を取得した時刻、またはベンダーの公開価格表から取得した `estimated` の見積もりの場合はその価格表を読んだ日付です(どちらも読まれていない場合は、見積もりを返した時刻です)。これは価格の固定ではありません。実行は、レーティング時点で有効な料率で請求されます。 +- `pricing_as_of` は料率表を取得した時刻です。ベンダーの公開価格表から取得した `estimated` の見積もりは、その価格表を読んだ日付を持ちます。請求数量をベンダーの公開スケジュールから予測し、その後レートカードで価格設定する `exact` または `estimated` の見積もりは、そのスケジュールの読み取り日がカードより古い場合、スケジュールの読み取り日を持ちます。カードもスケジュールも読まれていない場合は、見積もりを返した時刻です。これは価格の固定ではありません。実行は、レーティング時点で有効な料率で請求されます。 - `/estimate` は `model_provider` が示すレグ、またはネイティブのプロバイダーを価格付けします。`fallback_provider` や `strict_mode` パラメータは受け取りません。フォールバックのリトライが別のプロバイダーで行われる同期実行は、そのプロバイダーの料率で請求され、見積もりはそのレグを価格付けしていません。実行のレスポンスの `X-Comfy-Router-Fallback-Provider` が、それが発生したことを示します。キュー中の送信にはフォールバックがないため、その `estimate` は実行されるレグを価格付けします。 - `/estimate` とキュー中の送信の `estimate` は、`model_provider` レグの同じボディ、または兄弟オペレーションで実行されるボディについて、わずかに異なるドキュメントを価格付けすることがあります。送信の `estimate` は、実行が送信するドキュメントに基づいて価格付けされます。 - `/estimate` は常にプラットフォームの請求額を算出します。自分のプロバイダーキーでの実行は Comfy から請求されませんが、`/estimate` はそれを検出せずに数値を返します。`reason: byok` を返すのはキュー中の送信だけです。- ドルは丸めていないセントから最大8桁の小数で表示され、課金対象の1セント未満の `amount` が `0` と表示されることはありません。`credits` は `round(amount × 211, 2)` であり、これは `X-Comfy-Credits-Used` が課金に適用するのと同じ変換です。そのため、ごく小さい非ゼロの価格では `credits` が `0` にラウンドされることがあります。これが重要となる場合は、`credits` ではなく `amount` または `amount_cents` で予算を立ててください。このヘッダーは引き続き、1回の実行に対する事後的な数値です。残高は Comfy プラットフォーム上にあります。 @@ -1016,7 +1016,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 | `minimax/*` | 完了したビデオ | 12 時間 | | `xai/*` | 生成されたすべての画像、および完了したビデオ | 24 時間 | -これらの有効期間は、URL を開いたときではなく、URL が署名されたときに開始されます。キャッシュされた URL や再利用された URL は残り時間が短い場合があります。再利用しても有効期間は更新されません。アセットは速やかにダウンロードしてください。コピーされるのは各行に記載されたアセットのみです。`byteplus/seedream-*` と `byteplus/seededit-*` の画像は BytePlus ビデオの行には含まれません。 +これらの有効期間は、URL を開いたときではなく、URL が署名されたときに開始されます。キャッシュされた URL や再利用された URL は残り時間が短い場合があります。再利用しても有効期間は更新されません。`Idempotency-Key` の記録は、保持する URL より長く残ることがあるため、そうした URL の有効期限が切れる 1 時間前から、同じキーでの再試行は記録済みのレスポンスではなく `409 invalid_input` で応答されます。応答が返された時点ですでにそれだけ期限に近かった場合は、5 分間は再再生できます。アセットは速やかにダウンロードしてください。コピーされるのは各行に記載されたアセットのみです。`byteplus/seedream-*` と `byteplus/seededit-*` の画像は BytePlus ビデオの行には含まれません。 コピーを実行するのは、モデルのネイティブプロバイダーのみです。代替プロバイダーによって処理された実行、つまり `model_provider` が代替プロバイダーを指定している場合、またはネイティブ実行のフォールバック再試行が代替プロバイダーに到達した場合（`X-Comfy-Router-Fallback-Provider` で開示されます）は、そのプロバイダー自身の URL を返します。これらの URL はプロバイダーの有効期限に従い、コピーされません。`model_provider` の値 `default`、`comfy`、`comfyui` は代替プロバイダーを指定しないため、それらの実行はネイティブであり、上記と同様にコピーされます。フォールバック再試行がネイティブプロバイダーに戻った `model_provider` の実行も同様です。 @@ -1123,7 +1123,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 - この見積もりの価格設定に使用したレートカードを取得した日時。見積もりは価格ロックではありません。実行は、評価時点で有効な料金で請求され、この時点の料金ではありません。ベンダーの公開価格表から取得した `estimated` 見積もり（ベンダーが報告するコストで請求されるモデル）では、代わりにその価格表を読み取った日付を持ちます。請求数量をその価格表から予測し、その後レートカードで価格設定するもの（ベンダーが報告するクレジットで請求されるモデル）では、2 つの日付のうち古い方を持ちます。レートカードを読み取らなかった場合（`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し）は、これは見積もりに回答した時点です。 + この見積もりの価格設定に使用したレートカードを取得した日時。見積もりは価格ロックではありません。実行は、評価時点で有効な料金で請求され、この時点の料金ではありません。ベンダーの公開価格表から取得した `estimated` 見積もり（ベンダーが報告するコストで請求されるモデル）では、代わりにその価格表を読み取った日付を持ちます。請求数量をベンダーの公開スケジュールから予測し、その後レートカードで価格設定する見積もりは、`exact` の回答でも `estimated` の回答でも、そのスケジュールの読み取り日とカードの取得時刻のうち古い方を持ちます（ベンダーが報告するクレジットで請求されるモデルが `estimated` の場合です）。レートカードを読み取らなかった場合（`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し）は、これは見積もりに回答した時点です。 date-time @@ -1334,7 +1334,7 @@ Router モデルカタログの 1 ページ分です。 このルートが実際に解決したリクエストを表す2つの結果について、キャンセル要求が見つけた内容を示します。どちらもHTTPステータスに反映されるため、クライアントはどちらを基準に分岐してもかまいません。 -型: `文字列` +型: `string` ### RouterQueuePosition diff --git a/ko/development/comfy-router/api.mdx b/ko/development/comfy-router/api.mdx index dfff2eac06..f205d1bf4d 100644 --- a/ko/development/comfy-router/api.mdx +++ b/ko/development/comfy-router/api.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API 개요" sidebarTitle: "개요" description: "Comfy Router API의 작동 방식: 모델 ID당 하나의 라우트이며, 검색, 스키마, 대기 중인 요청, 오류, 결제에 대한 가이드를 제공합니다." -translationSourceHash: dac7e853 +translationSourceHash: cb493feb translationFrom: development/comfy-router/api.mdx --- @@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx - [빠른 시작](/ko/development/comfy-router/quickstart): 설치, 호출, 이미지 저장. - [모델](/ko/development/comfy-router/models): 카탈로그를 찾아보고 모델별 요청 예시를 확인합니다. - [헤더](/ko/development/comfy-router/headers): 인증, 멱등성, 요청 ID, 재시도 간격 조정. -- [API 레퍼런스](/ko/development/comfy-router/reference): 엔드포인트 파라미터, 스키마, 응답 코드. \ No newline at end of file +- [API 레퍼런스](/ko/development/comfy-router/reference): 엔드포인트 파라미터, 스키마, 응답 코드. +- [실시간 음성](/ko/development/comfy-router/realtime): Grok Voice WebSocket 세션을 열고 초 단위로 과금됩니다. diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index 5fd22da5b6..2086187958 100644 --- a/ko/development/comfy-router/limitations.mdx +++ b/ko/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 기능과 한계" sidebarTitle: "기능과 한계" description: "Comfy Router 또는 파트너 프록시 선택, 장시간 실행되는 호출 대비, 복구, 속도 제한 및 자산 저장에 대해 설명합니다." -translationSourceHash: 235802c5 +translationSourceHash: b4d8209c translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": cf6e2050 - "Models without a pre-flight estimate": 495bdb2b + "Models without a pre-flight estimate": f6dfd921 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -116,21 +116,17 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} - **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` -- **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **fal**: `fal/crystal-upscaler`, `fal/crystal-video-upscaler`, `fal/fal-gpt-image-2`, `fal/fal-gpt-image-2.5-flare`, `fal/fal-gpt-image-2.5-sunburst`, `fal/fal-nano-banana-2`, `fal/fal-nano-banana-pro`, `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`, `fal/flux-3-max`, `fal/patina` +- **fal**: `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5` - **freepik**: `freepik/ai-image-upscaler-precision-v2`, `freepik/ai-skin-enhancer-creative`, `freepik/ai-skin-enhancer-faithful`, `freepik/ai-skin-enhancer-flexible` - **heygen**: `heygen/starfish` -- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`, `ideogram/p-image-ideogram` -- **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` -- **luma**: `luma/photon-1`, `luma/photon-flash-1` -- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` +- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` +- **kling**: `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` - **runware**: `runware/runware-gpt-image-2`, `runware/runware-gpt-image-2.5-flare`, `runware/runware-gpt-image-2.5-sunburst`, `runware/runware-nano-banana-2`, `runware/runware-nano-banana-pro`, `runware/runware-seedance-2.0`, `runware/runware-seedance-2.5` - **synclabs**: `synclabs/sync-3` -- **veed**: `veed/clean-audio`, `veed/clean-audio-video`, `veed/fabric-1.0`, `veed/lipsync-2.0`, `veed/video-background-removal`, `veed/video-background-removal-fast`, `veed/video-background-removal-green-screen` - **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 1df7667f38..831b21f68c 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 Dreamina Seedance 2.0 260128 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-260128을 호출합니다. endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 9604ca27 +translationSourceHash: 70ec471f translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 6c5da06a + "Schema": 8c0478c9 "Examples": 641c458b --- @@ -294,10 +294,10 @@ Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). - 범위: `2` ~ `30` + 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` 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 b552dadeb9..579142be5d 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,12 +2,12 @@ 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: b02c6ed1 +translationSourceHash: 8036f4db translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": e03c503a + "Schema": 90b60b2e "Examples": 7714eccd --- @@ -279,10 +279,10 @@ BytePlus의 제약이 아닌 Comfy 측 보호 장치입니다. BytePlus는 텍 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). - 범위: `2` ~ `30` + 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` 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 6d55390eba..d48699d1df 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,12 +2,12 @@ title: "Comfy Router와 함께 Dreamina Seedance 2.0 Mini 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-mini를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 28c5c053 +translationSourceHash: a1d75c67 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 3c26a330 + "Schema": ebf1fc3a "Examples": db01067e --- @@ -280,10 +280,10 @@ BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하면 최종 1080p 비디오가 렌더링됩니다. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). - 범위: `2` ~ `30` + 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` 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 e57578b988..0d3147eea6 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router에서 Dreamina Seedance 2.5 260628 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-5-260628을 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 07fd9c64 +translationSourceHash: 3606fb83 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0a76af44 + "Schema": d2c28a84 "Examples": 5465695b --- @@ -291,10 +291,10 @@ BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동). - 범위: `2` ~ `30` + 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` 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 6db703933c..f8ba4298d6 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Seedance 1.0 Pro 250528 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-250528을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 450bbe6e +translationSourceHash: 642f85ab translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": fc979e05 + "Schema": b57b84de "Examples": 815d621e --- @@ -275,10 +275,10 @@ v1 /proxy를 직접 호출할 경우에는 대신 BytePlus 자체 검증기가 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하면 최종 1080p 비디오를 렌더링합니다. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 1.0 pro, 1.0 pro fast: [2,12]. - 범위: `2` ~ `30` + 가능한 값: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` 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 4d7c40f493..80b0f0e982 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router에서 Seedance 1.0 Pro Fast 251015 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-fast-251015를 호출하는 방법: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 43683424 +translationSourceHash: 61dd0135 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": a882b2d8 + "Schema": dd74b012 "Examples": 1469ab97 --- @@ -279,10 +279,10 @@ v1 /proxy를 직접 호출할 경우에는 BytePlus 자체 검증기가 대신 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 1.0 pro, 1.0 pro fast: [2,12]. - 범위: `2` ~ `30` + 가능한 값: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` 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 13800db3cd..92ed015aea 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,12 +2,12 @@ title: "Comfy Router로 Seedance 1.5 Pro 251215 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-5-pro-251215를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 1d016721 +translationSourceHash: 2263b4cf translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 35f3b5dc + "Schema": f4d67fb6 "Examples": 7e73ac5c --- @@ -279,10 +279,10 @@ v1 /proxy를 직접 호출하면 대신 BytePlus 자체 검증기가 응답합 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. - - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + + 비디오 재생 시간(초)입니다. Seedance 1.5 pro: [4,12] 또는 -1(자동). - 범위: `2` ~ `30` + 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/ko/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/ko/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx index fb407ea5de..77809eb0d3 100644 --- a/ko/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 Kling 3.0 Turbo 사용하기" description: "Comfy Router를 통해 kling/kling-3.0-turbo를 호출합니다. 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Kling 3.0 Turbo" -translationSourceHash: 301a1ee1 +translationSourceHash: d03a4ba5 translationFrom: development/comfy-router/models/kling/kling-3-0-turbo/code.mdx translationBlockHashes: "_intro": 5a8c5f4b "Quick start": a2145573 "Serving providers": 7ec93d4f - "Schema": 1f5f61c1 + "Schema": 4ec53894 "Examples": 0a9a8bbe --- @@ -195,11 +195,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 작업 결과에 대한 콜백 알림 URL입니다. 작업 상태가 변경되면 서버가 알림을 보냅니다. + 작업 결과에 대한 콜백 알림 URL입니다. 작업 상태가 변경되면 서버가 알림을 보냅니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. - 사용자 지정 작업 ID입니다. 시스템이 생성한 작업 ID를 덮어쓰지는 않지만 조회에 사용할 수 있습니다. 단일 사용자 계정 내에서 고유해야 합니다. + 사용자 지정 작업 ID입니다. 시스템이 생성한 작업 ID를 덮어쓰지는 않지만 조회에 사용할 수 있습니다. 단일 사용자 계정 내에서 고유해야 합니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-image-o1/code.mdx b/ko/development/comfy-router/models/kling/kling-image-o1/code.mdx index 85e9483b17..5e190c08f2 100644 --- a/ko/development/comfy-router/models/kling/kling-image-o1/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-image-o1/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router와 함께 Kling Image O1 사용하기" description: "Comfy Router를 통해 kling/kling-image-o1 호출하기: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling Image O1" -translationSourceHash: cf053382 +translationSourceHash: 0d76917c translationFrom: development/comfy-router/models/kling/kling-image-o1/code.mdx translationBlockHashes: "_intro": 513c65df "Quick start": 6256a30d - "Schema": d18a5393 + "Schema": 61821697 "Examples": 826db173 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 이 작업 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. + 이 작업 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -182,7 +182,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 사용자 지정 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. + 사용자 지정 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index ac88236104..9a9579cf3c 100644 --- a/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Kling V2.5 Turbo 사용하기" description: "Comfy Router를 통해 kling/kling-v2-5-turbo를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1a5ec6e5 +translationSourceHash: 1671e7b6 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 2495a4d3 "Quick start": dc63b3ac - "Schema": 68d50e72 + "Schema": 3bcb036e "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 콜백 알림 주소 + 콜백 알림 주소 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 사용자 정의 Task ID + 사용자 정의 Task ID 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx b/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx index 893e68985e..59c19ce1d2 100644 --- a/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Kling V2.6 사용하기" description: "Comfy Router를 통해 kling/kling-v2-6을 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답." sidebarTitle: "Kling V2.6" -translationSourceHash: 1e64e957 +translationSourceHash: c445a7bd translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": 04868509 "Quick start": 48a3d970 - "Schema": 9d23ff94 + "Schema": a61a551f "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 콜백 알림 주소 + 콜백 알림 주소 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 사용자 정의 작업 ID + 사용자 정의 작업 ID 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx index deae7364d7..1a428adb70 100644 --- a/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Kling V3 Omni 사용하기" description: "Comfy Router를 통해 kling/kling-v3-omni를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "Kling V3 Omni" -translationSourceHash: 226ee8a6 +translationSourceHash: 29d1799c translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": f9b37353 + "Schema": 68bd0500 "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 이 작업의 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. + 이 작업의 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 사용자 정의 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. + 사용자 정의 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-v3/code.mdx b/ko/development/comfy-router/models/kling/kling-v3/code.mdx index 27d8caab71..30895188c2 100644 --- a/ko/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 Kling V3 사용하기" description: "Comfy Router를 통해 kling/kling-v3 호출하기: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling V3" -translationSourceHash: ecfa3f9b +translationSourceHash: e07d4035 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 74a12e0f "Quick start": 09c0a41a "Serving providers": a8b20c72 - "Schema": 77550c0a + "Schema": 8e8b04e6 "Examples": 8623c725 --- @@ -177,7 +177,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 콜백 알림 주소 + 콜백 알림 주소 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -247,7 +247,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 사용자 정의 작업 ID + 사용자 정의 작업 ID 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx b/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx index f80a82c880..5458761525 100644 --- a/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Kling Video O1 사용하기" description: "Comfy Router를 통해 kling/kling-video-o1 호출: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling Video O1" -translationSourceHash: 3c228231 +translationSourceHash: 892ccf77 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": 6f4cf55b + "Schema": f693e2ef "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 이 작업 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. + 이 작업 결과에 대한 콜백 알림 주소입니다. 설정하면 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 사용자 정의 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. + 사용자 정의 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/ko/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx index 5e9cf499b4..911afcdc5b 100644 --- a/ko/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx +++ b/ko/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Videos Avatar Image 2video 사용하기" description: "Comfy Router를 통해 kling/videos-avatar-image2video를 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답입니다." sidebarTitle: "Videos Avatar Image 2video" -translationSourceHash: 444b1395 +translationSourceHash: 5181e917 translationFrom: development/comfy-router/models/kling/videos-avatar-image2video/code.mdx translationBlockHashes: "_intro": baca1542 "Quick start": 5605d33f - "Schema": eeb06fe1 + "Schema": 073bf8b2 "Examples": ce6803dd --- @@ -164,13 +164,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R - 이 작업의 결과에 대한 콜백 알림 주소입니다. + 이 작업의 결과에 대한 콜백 알림 주소입니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` - 사용자 지정 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. + 사용자 지정 작업 ID입니다. 단일 사용자 계정 내에서 고유해야 합니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. diff --git a/ko/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/ko/development/comfy-router/models/kling/videos-lip-sync/code.mdx index 8ea8d2d235..efc675217b 100644 --- a/ko/development/comfy-router/models/kling/videos-lip-sync/code.mdx +++ b/ko/development/comfy-router/models/kling/videos-lip-sync/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Videos Lip Sync 사용하기" description: "Comfy Router를 통해 kling/videos-lip-sync를 호출합니다. endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Videos Lip Sync" -translationSourceHash: ddd2a405 +translationSourceHash: 6103bea9 translationFrom: development/comfy-router/models/kling/videos-lip-sync/code.mdx translationBlockHashes: "_intro": 0477697a "Quick start": e13a4628 - "Schema": 90571e9f + "Schema": 4fb7c777 "Examples": d1dd6ed8 --- @@ -176,7 +176,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID ### 입력 - 콜백 알림 주소입니다. 작업 상태가 변경되면 서버가 알림을 보냅니다. + 콜백 알림 주소입니다. 작업 상태가 변경되면 서버가 알림을 보냅니다. 무시됩니다. comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` diff --git a/ko/development/comfy-router/models/runway/gen4-image/code.mdx b/ko/development/comfy-router/models/runway/gen4-image/code.mdx index 676ca6d9aa..6b5f0cd535 100644 --- a/ko/development/comfy-router/models/runway/gen4-image/code.mdx +++ b/ko/development/comfy-router/models/runway/gen4-image/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Gen 4 Image 사용하기" description: "Comfy Router를 통해 runway/gen4_image를 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Gen 4 Image" -translationSourceHash: c5792f5c +translationSourceHash: 51dc9815 translationFrom: development/comfy-router/models/runway/gen4-image/code.mdx translationBlockHashes: "_intro": f3b89ce9 "Quick start": 82a202eb - "Schema": d889abf3 + "Schema": 1160ec6d "Examples": 291dbf54 --- @@ -168,7 +168,7 @@ curl https://api.comfy.org/v2/models/runway/gen4_image/requests/$REQUEST_ID \ - 인코딩된 이미지를 포함하는 HTTPS URL 또는 데이터 URI + 인코딩된 이미지를 포함하는 HTTPS URL, Runway 업로드 URI(runway://) 또는 data URI Router가 `GET /v2/models/runway/gen4_image/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx index bb47c8467f..b54aa6f881 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router에서 Grok Imagine Image 2.0 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image-2.0을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Grok Imagine Image 2.0" -translationSourceHash: 83fe91a1 +translationSourceHash: e062dc40 translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: "_intro": 614e2e15 "Quick start": ff9945c8 - "Schema": faf9e081 + "Schema": cb29dfae "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES - 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급(low/medium, 기본값은 medium)을 선택합니다. 다른 모델은 현재 이 값을 무시합니다. + 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low, medium 또는 auto, 생략 시 xAI의 기본값이며 auto는 생성 시 low, 편집 시 medium 사용). 다른 모델은 이를 무시합니다. - 가능한 값: `low`, `medium`, `high` + 가능한 값: `low`, `medium`, `high`, `auto` diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx index 441313b906..b67a36c6bf 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Grok Imagine Image Pro 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image-pro를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: 7932bb72 +translationSourceHash: 773b1560 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: "_intro": 97d341e4 "Quick start": 3a4bd585 - "Schema": 5d56d158 + "Schema": 805c771c "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES - 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급(low/medium, 기본값은 medium)을 선택합니다. 다른 모델은 현재 이를 무시합니다. + 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low, medium 또는 auto, 생략 시 xAI의 기본값이며 auto는 생성 시 low, 편집 시 medium 사용). 다른 모델은 이를 무시합니다. - 가능한 값: `low`, `medium`, `high` + 가능한 값: `low`, `medium`, `high`, `auto` diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx index eb1ef0f56e..80b048b5ae 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Grok Imagine Image Quality 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image-quality를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 923968d2 +translationSourceHash: 9f6e16d5 translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: "_intro": 72081c22 "Quick start": 799275b8 - "Schema": e0fcef44 + "Schema": e2c96ff6 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE - 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low/medium, 기본값은 medium). 다른 모델은 현재 이 값을 무시합니다. + 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low, medium 또는 auto, 생략 시 xAI의 기본값이며 auto는 생성 시 low, 편집 시 medium 사용). 다른 모델은 이를 무시합니다. - 가능한 값: `low`, `medium`, `high` + 가능한 값: `low`, `medium`, `high`, `auto` diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx index 75afa4df95..387a7232ac 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Grok Imagine Image 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Grok Imagine Image" -translationSourceHash: 9cfb938a +translationSourceHash: 2e5c55ad translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: "_intro": a2e97c88 "Quick start": a5495331 - "Schema": 1d17b83a + "Schema": 171da7d5 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID - 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low/medium, 기본값은 medium). 다른 모델은 현재 이 값을 무시합니다. + 출력 이미지의 품질입니다. grok-imagine-image-2.0의 경우 가격 등급을 선택합니다(low, medium 또는 auto, 생략 시 xAI의 기본값이며 auto는 생성 시 low, 편집 시 medium 사용). 다른 모델은 이를 무시합니다. - 가능한 값: `low`, `medium`, `high` + 가능한 값: `low`, `medium`, `high`, `auto` diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index 6547d5ccc3..c645afb46c 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: a6f99965 +translationSourceHash: aee933a1 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": 222fd740 + "Endpoints": e0879d3c "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 5952af3f - "Result assets": 18fe6dad + "Pre-flight cost estimates": f0ba96a1 + "Result assets": 5936427c "Per-model input and output schemas": 61c6bde8 - "Schemas": 984bd216 + "Schemas": c1245cc9 --- @@ -53,7 +53,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 **Comfy Router가 실행할 수 있는 모델을 나열합니다.** -사용 가능한 모델 ID와 청구 정보를 나열합니다. `has_more`가 `true`인 동안 `next_cursor`를 사용하세요. +사용 가능한 모델 ID와 청구 정보를 나열합니다. `has_more`가 true인 동안 `next_cursor`를 사용하세요. **파라미터** @@ -309,7 +309,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 **모델 호출을 실행하기 전에, 실행하지 않고 가격을 산정합니다.** -이 모델에서 이 본문을 실행하면 얼마가 들지 미국 달러로 사전 견적하여 반환합니다. 가격은 실행 시 청구에 사용되는 것과 동일한 요율표를 기준으로 산정됩니다(공급업체가 보고한 비용으로 청구되는 모델은 대신 공급업체가 공개한 가격표를 기준으로 견적됩니다). 이는 견적일 뿐 최종 청구가 아닙니다. 실제로 지불하는 금액은 워크스페이스의 사용량 및 결제 기록에 정산된 청구액입니다. 본문은 먼저 모델의 입력 스키마에 대해 검증되며, 이는 기본 실행(`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`을 응답합니다. 또한 Router가 아직 실행할 수 없는 모델은 실행 라우트 자체의 `detail`과 함께 동일한 `403`을 응답하므로, `detail`을 읽어 두 경우를 구분하세요. **파라미터** @@ -1000,7 +1000,7 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 예상치의 한계. `200` 응답의 금액은 실행이 수락된다거나 정확히 그 금액이 청구된다는 약속이 아닙니다: - `/estimate`는 `strict_mode`나 `reject_unknown_fields`를 받지 않으므로 모델의 기본 계약만 검사합니다. `strict_mode=true` 실행이 대체 공급자 자체 스키마에서 수락하는 본문이 여기서는 `422`를 받을 수 있고, `reject_unknown_fields=true` 실행이 거부할 선언되지 않은 최상위 필드도 여기서는 가격이 산정됩니다. Anthropic Messages 모델은 예외입니다. 해당 스키마는 선언되지 않은 필드를 허용하므로 `reject_unknown_fields=true` 실행도 아무것도 거부하지 않으며, 예상치는 선언되지 않은 최상위 필드 `tools`, `tool_choice`, `temperature`, `top_p`, `top_k`, `stop_sequences`, `metadata`, `thinking` 및 빈 `mcp_servers`에 대해서만 가격을 산정합니다. 그 밖의 선언되지 않은 최상위 필드가 있으면 `reason: not_quotable`과 함께 `unknown`을 응답합니다. -- `pricing_as_of`는 요율표를 가져온 시점이며, 공급자의 공개 가격표에서 가져온 `estimated` 견적의 경우에는 그 가격표를 읽은 날짜입니다(둘 다 읽지 않은 경우에는 예상치를 응답한 시점입니다). 이는 가격 고정이 아닙니다. 실행은 요율이 적용되는 시점에 유효한 요율로 청구됩니다. +- `pricing_as_of`는 요율표를 가져온 시점입니다. 공급자의 공개 가격표에서 가져온 `estimated` 견적은 그 가격표를 읽은 날짜를 담습니다. 청구 수량을 공급자의 공개 일정표에서 예측한 뒤 요율표로 가격을 매기는 `exact` 또는 `estimated` 견적은, 해당 일정표를 읽은 날짜가 요율표보다 이르면 그 날짜를 담습니다. 요율표와 일정표 모두 읽지 않은 경우에는 예상치를 응답한 시점입니다. 이는 가격 고정이 아닙니다. 실행은 요율이 적용되는 시점에 유효한 요율로 청구됩니다. - `/estimate`는 `model_provider`가 지정한 레그 또는 기본 공급자의 견적을 제시합니다. `fallback_provider`나 `strict_mode` 매개변수는 받지 않습니다. 폴백 재시도가 다른 공급자에 도달한 동기 실행은 예상치가 제시하지 않았던 그 공급자의 요율로 청구되며, 실행 응답의 `X-Comfy-Router-Fallback-Provider`가 그런 일이 있었음을 알려줍니다. 대기 중 제출에는 폴백이 없으므로 그 `estimate`는 실제 실행되는 레그의 견적을 제시합니다. - `/estimate`와 대기 중 제출의 `estimate`는 `model_provider` 레그에서 또는 형제 작업에서 실행되는 본문의 경우 동일한 본문에 대해 약간 다른 문서를 가격 산정할 수 있습니다. 제출의 `estimate`는 실행이 전송하는 문서를 기준으로 산정됩니다. - `/estimate`는 항상 플랫폼 청구액의 견적을 제시합니다. 자체 공급자 키로 실행하면 Comfy는 청구하지 않지만, `/estimate`는 이를 감지하지 못하고 여전히 금액을 반환합니다. `reason: byok`를 응답하는 것은 대기 중 제출뿐입니다.- 달러는 반올림되지 않은 센트 값을 기준으로 소수점 이하 최대 8자리까지 표시되며, 청구 가능한 1센트 미만의 `amount`는 절대 `0`으로 표시되지 않습니다. `credits`는 `round(amount × 211, 2)`이며, 이는 `X-Comfy-Credits-Used`가 청구 금액에 적용하는 것과 동일한 변환입니다. 따라서 매우 작은 0이 아닌 가격에서는 `credits`가 `0`으로 반올림될 수 있습니다. 이 점이 중요할 때는 `credits`가 아니라 `amount` 또는 `amount_cents`를 기준으로 예산을 책정하세요. 해당 헤더는 한 번의 실행에 대한 사후 수치로 남습니다. 잔액은 Comfy 플랫폼에 있습니다. @@ -1016,7 +1016,7 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 | `minimax/*` | 완료된 비디오 | 12시간 | | `xai/*` | 생성된 모든 이미지, 그리고 완료된 비디오 | 24시간 | -이 수명은 URL에 서명될 때 시작되며, URL을 열 때 시작되는 것이 아닙니다. 캐시되었거나 재생된 URL은 남은 시간이 더 적을 수 있으며, 재생해도 수명이 갱신되지 않습니다. 에셋을 즉시 다운로드하세요. 각 행에 명시된 에셋만 복사됩니다. `byteplus/seedream-*` 및 `byteplus/seededit-*` 이미지는 BytePlus 비디오 행에 포함되지 않습니다. +이 수명은 URL에 서명될 때 시작되며, URL을 열 때 시작되는 것이 아닙니다. 캐시되었거나 재생된 URL은 남은 시간이 더 적을 수 있으며, 재생해도 수명이 갱신되지 않습니다. `Idempotency-Key` 기록은 보유한 URL보다 오래 유지될 수 있으므로, 해당 URL이 만료되기 1시간 전부터 같은 키로 재시도하면 기록된 응답 대신 `409 invalid_input`이 응답됩니다. 응답이 반환될 때 이미 그만큼 만료에 가까웠던 경우에는 5분 동안 재생할 수 있습니다. 에셋을 즉시 다운로드하세요. 각 행에 명시된 에셋만 복사됩니다. `byteplus/seedream-*` 및 `byteplus/seededit-*` 이미지는 BytePlus 비디오 행에 포함되지 않습니다. 복사는 해당 모델의 네이티브 공급자만 수행합니다. 대체 공급자가 처리한 실행, 즉 `model_provider`가 대체 공급자를 지정한 경우나 폴백 재시도가 대체 공급자에 도달한 네이티브 실행(`X-Comfy-Router-Fallback-Provider`로 공개됨)은 해당 공급자 자체의 URL을 반환하며, 이 URL은 공급자의 만료 정책을 따르고 복사되지 않습니다. `model_provider` 값 `default`, `comfy`, `comfyui`는 대체 공급자를 지정하지 않으므로 해당 실행은 네이티브이며 위와 같이 복사됩니다. 폴백 재시도가 다시 네이티브 공급자에 도달한 `model_provider` 실행도 마찬가지입니다. @@ -1123,7 +1123,7 @@ Type: `string` - 이 견적을 산정한 요율표를 가져온 시점입니다. 이 추정치는 가격 고정이 아닙니다. 실행은 이 시점이 아니라 실행이 요율 산정되는 시점에 유효한 요율로 청구됩니다. 공급자의 공개 가격표에서 가져온 `estimated` 견적(공급자가 보고하는 비용으로 청구되는 모델)의 경우에는 대신 해당 가격표를 읽은 날짜가 담깁니다. 청구 수량을 그 가격표에서 예측한 뒤 요율표로 가격을 매기는 견적(공급자가 보고하는 크레딧으로 청구되는 모델)의 경우에는 두 날짜 중 이른 날짜가 담깁니다. 어떤 요율표도 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 요율표로도 가격을 매길 수 없는 `not_quotable` 호출)에는 이 값이 견적이 응답된 시점입니다. + 이 견적을 산정한 요율표를 가져온 시점입니다. 이 추정치는 가격 고정이 아닙니다. 실행은 이 시점이 아니라 실행이 요율 산정되는 시점에 유효한 요율로 청구됩니다. 공급자의 공개 가격표에서 가져온 `estimated` 견적(공급자가 보고하는 비용으로 청구되는 모델)의 경우에는 대신 해당 가격표를 읽은 날짜가 담깁니다. 청구 수량을 공급자의 공개 일정표에서 예측한 뒤 요율표로 가격을 매기는 견적은 `exact` 답변이든 `estimated` 답변이든 해당 일정표를 읽은 날짜와 요율표를 가져온 시점 중 이른 날짜를 담습니다(공급자가 보고하는 크레딧으로 청구되는 모델이 `estimated`인 경우입니다). 어떤 요율표도 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 요율표로도 가격을 매길 수 없는 `not_quotable` 호출)에는 이 값이 견적이 응답된 시점입니다. date-time diff --git a/zh/development/comfy-router/api.mdx b/zh/development/comfy-router/api.mdx index 63a66aff1a..b8db6daf9f 100644 --- a/zh/development/comfy-router/api.mdx +++ b/zh/development/comfy-router/api.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API 概览" sidebarTitle: "概览" description: "Comfy Router API 的工作方式：每个模型 ID 对应一个路由，并提供关于发现模型、schema、排队请求、错误和计费的指南。" -translationSourceHash: dac7e853 +translationSourceHash: cb493feb translationFrom: development/comfy-router/api.mdx --- @@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx - [快速开始](/zh/development/comfy-router/quickstart)：安装、调用以及保存图像。 - [模型](/zh/development/comfy-router/models)：浏览目录并查看各模型专属的请求示例。 - [请求头](/zh/development/comfy-router/headers)：身份验证、幂等性、请求 ID 以及重试节奏。 -- [API 参考](/zh/development/comfy-router/reference)：端点参数、schema 以及响应码。 \ No newline at end of file +- [API 参考](/zh/development/comfy-router/reference)：端点参数、schema 以及响应码。 +- [实时语音](/zh/development/comfy-router/realtime)：打开 Grok Voice 的 WebSocket 会话，按秒计费。 diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index f580a19c68..c445523018 100644 --- a/zh/development/comfy-router/limitations.mdx +++ b/zh/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 的能力与限制" sidebarTitle: "能力与限制" description: "选择 Comfy Router 还是合作伙伴代理，为长时间运行的调用做好规划，并了解恢复、速率限制与资产存储。" -translationSourceHash: 235802c5 +translationSourceHash: b4d8209c translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": cf6e2050 - "Models without a pre-flight estimate": 495bdb2b + "Models without a pre-flight estimate": f6dfd921 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -116,21 +116,17 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价， {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} - **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` -- **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **fal**: `fal/crystal-upscaler`, `fal/crystal-video-upscaler`, `fal/fal-gpt-image-2`, `fal/fal-gpt-image-2.5-flare`, `fal/fal-gpt-image-2.5-sunburst`, `fal/fal-nano-banana-2`, `fal/fal-nano-banana-pro`, `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`, `fal/flux-3-max`, `fal/patina` +- **fal**: `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5` - **freepik**: `freepik/ai-image-upscaler-precision-v2`, `freepik/ai-skin-enhancer-creative`, `freepik/ai-skin-enhancer-faithful`, `freepik/ai-skin-enhancer-flexible` - **heygen**: `heygen/starfish` -- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`, `ideogram/p-image-ideogram` -- **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` -- **luma**: `luma/photon-1`, `luma/photon-flash-1` -- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` +- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` +- **kling**: `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` - **runware**: `runware/runware-gpt-image-2`, `runware/runware-gpt-image-2.5-flare`, `runware/runware-gpt-image-2.5-sunburst`, `runware/runware-nano-banana-2`, `runware/runware-nano-banana-pro`, `runware/runware-seedance-2.0`, `runware/runware-seedance-2.5` - **synclabs**: `synclabs/sync-3` -- **veed**: `veed/clean-audio`, `veed/clean-audio-video`, `veed/fabric-1.0`, `veed/lipsync-2.0`, `veed/video-background-removal`, `veed/video-background-removal-fast`, `veed/video-background-removal-green-screen` - **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 4ddd53b499..763dfe84b5 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "使用 Dreamina Seedance 2.0 260128 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-260128：端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 9604ca27 +translationSourceHash: 70ec471f translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 6c5da06a + "Schema": 8c0478c9 "Examples": 641c458b --- @@ -287,10 +287,10 @@ Comfy 侧的保护措施，并非 BytePlus 的限制。BytePlus 未公布文本 将返回的任务 ID 传入 `draft_task` 内容项，以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长（秒）。Seedance 2.5：[4,30] 或 -1（自动；视频编辑任务仅支持 -1）。Seedance 2.0、2.0 fast 和 2.0 mini：[4,15] 或 -1（自动）。Seedance 1.5 pro：[4,12] 或 -1。Seedance 1.0：[2,12]。 + + 视频时长，单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini：[4,15] 或 -1（自动）。 - 范围：`2` 到 `30` + 可能的值：`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index e3b70a93fc..5ab516fef8 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,12 +2,12 @@ title: "使用 Comfy Router 调用 Dreamina Seedance 2.0 Fast 260128" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-fast-260128：端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: b02c6ed1 +translationSourceHash: 8036f4db translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": e03c503a + "Schema": 90b60b2e "Examples": 7714eccd --- @@ -271,10 +271,10 @@ Base64 编码内容：格式必须为 data:image/\;base64,\ 将返回的任务 ID 传入 `draft_task` 内容项，以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长，单位为秒。Seedance 2.5：[4,30] 或 -1（自动；视频编辑任务仅支持 -1）。Seedance 2.0、2.0 fast 和 2.0 mini：[4,15] 或 -1（自动）。Seedance 1.5 pro：[4,12] 或 -1。Seedance 1.0：[2,12]。 + + 视频时长，单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini：[4,15] 或 -1（自动）。 - 范围：`2` 到 `30` + 可能的值：`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 6995497779..d1474a43f1 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用 Dreamina Seedance 2.0 Mini" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-mini：endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 28c5c053 +translationSourceHash: a1d75c67 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 3c26a330 + "Schema": ebf1fc3a "Examples": db01067e --- @@ -278,10 +278,10 @@ Comfy Router（/v2/models/byteplus/\{model}）是执行该限制的接口； 将返回的任务 ID 传入 `draft_task` 内容项，以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 - - 视频时长，单位为秒。Seedance 2.5：[4,30] 或 -1（自动；视频编辑任务仅支持 -1）。Seedance 2.0、2.0 fast 和 2.0 mini：[4,15] 或 -1（自动）。Seedance 1.5 pro：[4,12] 或 -1。Seedance 1.0：[2,12]。 + + 视频时长，单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini：[4,15] 或 -1（自动）。 - 范围：`2` 到 `30` + 可能的值：`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 6b83dea46c..1aacbc9334 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,13 +2,13 @@ title: "使用 Dreamina Seedance 2.5 260628 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-5-260628:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 07fd9c64 +translationSourceHash: 3606fb83 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0a76af44 + "Schema": d2c28a84 "Examples": 5465695b --- @@ -291,10 +291,10 @@ Base64 编码内容：格式必须为 data:image/\;base64,\ 在 `draft_task` 内容项中传入返回的任务 ID，以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 - - 视频时长，单位为秒。Seedance 2.5：[4,30] 或 -1（自动；视频编辑任务仅支持 -1）。Seedance 2.0、2.0 fast 与 2.0 mini：[4,15] 或 -1（自动）。Seedance 1.5 pro：[4,12] 或 -1。Seedance 1.0：[2,12]。 + + 视频时长，单位为秒。Seedance 2.5：[4,30] 或 -1（自动）。 - 范围：`2` 到 `30` + 可能的值：`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 13ad884815..abebaade7b 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,12 +2,12 @@ title: "将 Seedance 1.0 Pro 250528 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-250528：endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 450bbe6e +translationSourceHash: 642f85ab translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": fc979e05 + "Schema": b57b84de "Examples": 815d621e --- @@ -279,10 +279,10 @@ Comfy Router（/v2/models/byteplus/\{model}）是执行该限制的接口； 将返回的任务 ID 传入 `draft_task` 内容项以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长，单位为秒。Seedance 2.5：[4,30] 或 -1（自动；视频编辑任务仅支持 -1）。Seedance 2.0、2.0 fast 和 2.0 mini：[4,15] 或 -1（自动）。Seedance 1.5 pro：[4,12] 或 -1。Seedance 1.0：[2,12]。 + + 视频时长，单位为秒。Seedance 1.0 pro 和 1.0 pro fast：[2,12]。 - 范围：`2` 至 `30` + 可能的值：`2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 573d9a16e9..e2daccec1b 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,12 +2,12 @@ title: "使用 Comfy Router 调用 Seedance 1.0 Pro Fast 251015" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-fast-251015：endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 43683424 +translationSourceHash: 61dd0135 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": a882b2d8 + "Schema": dd74b012 "Examples": 1469ab97 --- @@ -271,10 +271,10 @@ Comfy 侧的防护限制，并非 BytePlus 的约束。BytePlus 未公布文本 将返回的任务 ID 传入 `draft_task` 内容项，以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - - 视频时长，单位为秒。Seedance 2.5：[4,30] 或 -1（自动；视频编辑任务仅支持 -1）。Seedance 2.0、2.0 fast 和 2.0 mini：[4,15] 或 -1（自动）。Seedance 1.5 pro：[4,12] 或 -1。Seedance 1.0：[2,12]。 + + 视频时长，单位为秒。Seedance 1.0 pro 和 1.0 pro fast：[2,12]。 - 范围：`2` 到 `30` + 可能的值：`2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 42cabe70ab..c1747d7edb 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,12 +2,12 @@ title: "通过 Comfy Router 使用 Seedance 1.5 Pro 251215" description: "通过 Comfy Router 调用 byteplus/seedance-1-5-pro-251215：endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 1d016721 +translationSourceHash: 2263b4cf translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 35f3b5dc + "Schema": f4d67fb6 "Examples": 7e73ac5c --- @@ -274,10 +274,10 @@ Base64 编码内容：格式必须为 data:image/\;base64,\ 将返回的任务 ID 传入 `draft_task` 内容项，以渲染最终的 1080p 视频。草稿任务 ID 的有效期为 7 天。 - - 视频时长，以秒为单位。Seedance 2.5：[4,30] 或 -1（自动；视频编辑任务仅支持 -1）。Seedance 2.0、2.0 fast 和 2.0 mini：[4,15] 或 -1（自动）。Seedance 1.5 pro：[4,12] 或 -1。Seedance 1.0：[2,12]。 + + 视频时长，单位为秒。Seedance 1.5 pro：[4,12] 或 -1（自动）。 - 范围：`2` 至 `30` + 可能的值：`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` diff --git a/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx index 05ce84cd96..1a9a01600e 100644 --- a/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx @@ -2,13 +2,13 @@ title: "通过 Comfy Router 使用 Kling 3.0 Turbo" description: "通过 Comfy Router 调用 kling/kling-3.0-turbo：endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling 3.0 Turbo" -translationSourceHash: 301a1ee1 +translationSourceHash: d03a4ba5 translationFrom: development/comfy-router/models/kling/kling-3-0-turbo/code.mdx translationBlockHashes: "_intro": 5a8c5f4b "Quick start": a2145573 "Serving providers": 7ec93d4f - "Schema": 1f5f61c1 + "Schema": 4ec53894 "Examples": 0a9a8bbe --- @@ -195,11 +195,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 任务结果回调通知 URL。当任务状态发生变化时，服务器会发送通知。 + 任务结果回调通知 URL。当任务状态发生变化时，服务器会发送通知。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 - 自定义任务 ID。不会覆盖系统生成的任务 ID，但可用于查询。在单个用户账号内必须唯一。 + 自定义任务 ID。不会覆盖系统生成的任务 ID，但可用于查询。在单个用户账号内必须唯一。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx b/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx index e3731aac5b..f9304aab70 100644 --- a/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx @@ -2,12 +2,12 @@ title: "使用 Comfy Router 调用 Kling Image O1" description: "通过 Comfy Router 调用 kling/kling-image-o1：端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling Image O1" -translationSourceHash: cf053382 +translationSourceHash: 0d76917c translationFrom: development/comfy-router/models/kling/kling-image-o1/code.mdx translationBlockHashes: "_intro": 513c65df "Quick start": 6256a30d - "Schema": d18a5393 + "Schema": 61821697 "Examples": 826db173 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 此任务结果的回调通知地址。若已配置，任务状态发生变化时服务器会主动通知。 + 此任务结果的回调通知地址。若已配置，任务状态发生变化时服务器会主动通知。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` @@ -182,7 +182,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账户内必须唯一。 + 自定义任务 ID。在单个用户账户内必须唯一。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index 711df496fd..d2bbe9ca65 100644 --- a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,12 +2,12 @@ title: "将 Kling V2.5 Turbo 与 Comfy Router 搭配使用" description: "通过 Comfy Router 调用 kling/kling-v2-5-turbo：端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1a5ec6e5 +translationSourceHash: 1671e7b6 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 2495a4d3 "Quick start": dc63b3ac - "Schema": 68d50e72 + "Schema": 3bcb036e "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 回调通知地址 + 回调通知地址 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 自定义任务 ID + 自定义任务 ID 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx b/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx index ccfd89e64f..ede7b09dd0 100644 --- a/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用 Kling V2.6" description: "通过 Comfy Router 调用 kling/kling-v2-6：端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Kling V2.6" -translationSourceHash: 1e64e957 +translationSourceHash: c445a7bd translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": 04868509 "Quick start": 48a3d970 - "Schema": 9d23ff94 + "Schema": a61a551f "Examples": 8623c725 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 回调通知地址 + 回调通知地址 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` @@ -236,7 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 自定义任务 ID + 自定义任务 ID 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx index 9bbff5063b..b763aab34c 100644 --- a/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用 Kling V3 Omni" description: "通过 Comfy Router 调用 kling/kling-v3-omni：端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling V3 Omni" -translationSourceHash: 226ee8a6 +translationSourceHash: 29d1799c translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": f9b37353 + "Schema": 68bd0500 "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 本任务结果的回调通知地址。若配置此项，任务状态发生变化时服务器将主动通知。 + 本任务结果的回调通知地址。若配置此项，任务状态发生变化时服务器将主动通知。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账号内必须唯一。 + 自定义任务 ID。在单个用户账号内必须唯一。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-v3/code.mdx b/zh/development/comfy-router/models/kling/kling-v3/code.mdx index 614cc72b20..c88f42fa94 100644 --- a/zh/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,13 +2,13 @@ title: "通过 Comfy Router 使用 Kling V3" description: "通过 Comfy Router 调用 kling/kling-v3：端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Kling V3" -translationSourceHash: ecfa3f9b +translationSourceHash: e07d4035 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 74a12e0f "Quick start": 09c0a41a "Serving providers": a8b20c72 - "Schema": 77550c0a + "Schema": 8e8b04e6 "Examples": 8623c725 --- @@ -177,7 +177,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 回调通知地址 + 回调通知地址 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` @@ -247,7 +247,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 自定义任务 ID + 自定义任务 ID 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx index 1fd6d2c0a4..df89a4745c 100644 --- a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -2,12 +2,12 @@ title: "将 Kling Video O1 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 kling/kling-video-o1：endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling Video O1" -translationSourceHash: 3c228231 +translationSourceHash: 892ccf77 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": 6f4cf55b + "Schema": f693e2ef "Examples": 6c2642d6 --- @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 本任务结果的回调通知地址。若已配置，任务状态发生变化时服务器会主动通知。 + 本任务结果的回调通知地址。若已配置，任务状态发生变化时服务器会主动通知。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账号内必须唯一。 + 自定义任务 ID。在单个用户账号内必须唯一。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx index f59763d31c..550c1b9af0 100644 --- a/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx +++ b/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx @@ -2,12 +2,12 @@ title: "配合 Comfy Router 使用 Videos Avatar Image 2video" description: "通过 Comfy Router 调用 kling/videos-avatar-image2video：端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Videos Avatar Image 2video" -translationSourceHash: 444b1395 +translationSourceHash: 5181e917 translationFrom: development/comfy-router/models/kling/videos-avatar-image2video/code.mdx translationBlockHashes: "_intro": baca1542 "Quick start": 5605d33f - "Schema": eeb06fe1 + "Schema": 073bf8b2 "Examples": ce6803dd --- @@ -164,13 +164,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R - 本任务结果的回调通知地址。 + 本任务结果的回调通知地址。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` - 自定义任务 ID。在单个用户账户内必须唯一。 + 自定义任务 ID。在单个用户账户内必须唯一。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx index de571505d6..c486bdd34d 100644 --- a/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx +++ b/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用视频唇形同步" description: "通过 Comfy Router 调用 kling/videos-lip-sync：端点、请求结构以及 Router 返回的响应。" sidebarTitle: "视频唇形同步" -translationSourceHash: ddd2a405 +translationSourceHash: 6103bea9 translationFrom: development/comfy-router/models/kling/videos-lip-sync/code.mdx translationBlockHashes: "_intro": 0477697a "Quick start": e13a4628 - "Schema": 90571e9f + "Schema": 4fb7c777 "Examples": d1dd6ed8 --- @@ -176,7 +176,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID ### 输入 - 回调通知地址。任务状态发生变化时，服务器会发出通知。 + 回调通知地址。任务状态发生变化时，服务器会发出通知。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` diff --git a/zh/development/comfy-router/models/runway/gen4-image/code.mdx b/zh/development/comfy-router/models/runway/gen4-image/code.mdx index 4c11d24ba8..5eedc8a457 100644 --- a/zh/development/comfy-router/models/runway/gen4-image/code.mdx +++ b/zh/development/comfy-router/models/runway/gen4-image/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用 Gen 4 Image" description: "通过 Comfy Router 调用 runway/gen4_image：端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Gen 4 Image" -translationSourceHash: c5792f5c +translationSourceHash: 51dc9815 translationFrom: development/comfy-router/models/runway/gen4-image/code.mdx translationBlockHashes: "_intro": f3b89ce9 "Quick start": 82a202eb - "Schema": d889abf3 + "Schema": 1160ec6d "Examples": 291dbf54 --- @@ -168,7 +168,7 @@ curl https://api.comfy.org/v2/models/runway/gen4_image/requests/$REQUEST_ID \ - 包含编码图像的 HTTPS URL 或 data URI + 包含编码图像的 HTTPS URL、Runway 上传 URI（runway://）或 data URI 由 Router 在 `GET /v2/models/runway/gen4_image/openapi.json` 提供的 schema 生成，这也是请求到达提供商之前它用于校验调用的同一份文档。 diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx index e5f33d3207..309178558b 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx @@ -2,12 +2,12 @@ title: "将 Grok Imagine Image 2.0 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 xai/grok-imagine-image-2.0：端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Grok Imagine Image 2.0" -translationSourceHash: 83fe91a1 +translationSourceHash: e062dc40 translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: "_intro": 614e2e15 "Quick start": ff9945c8 - "Schema": faf9e081 + "Schema": cb29dfae "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES - 输出图像的质量。对于 grok-imagine-image-2.0，此项用于选择价格档位（low/medium；medium 为默认值）；其他模型目前会忽略此项。 + 输出图像的质量。对于 grok-imagine-image-2.0，此项用于选择价格档位：low、medium 或 auto（省略时为 xAI 的默认值；auto 在生成时使用 low，编辑时使用 medium）。其他模型会忽略此项。 - 可选值：`low`、`medium`、`high` + 可能的值：`low`、`medium`、`high`、`auto` diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx index f2ce00dd3e..57bfe834b7 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx @@ -2,12 +2,12 @@ title: "配合 Comfy Router 使用 Grok Imagine Image Pro" description: "通过 Comfy Router 调用 xai/grok-imagine-image-pro:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: 7932bb72 +translationSourceHash: 773b1560 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: "_intro": 97d341e4 "Quick start": 3a4bd585 - "Schema": 5d56d158 + "Schema": 805c771c "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES - 输出图像的质量。对于 grok-imagine-image-2.0，此项用于选择价格档位（low/medium；默认为 medium）；其他模型目前会忽略该项。 + 输出图像的质量。对于 grok-imagine-image-2.0，此项用于选择价格档位：low、medium 或 auto（省略时为 xAI 的默认值；auto 在生成时使用 low，编辑时使用 medium）。其他模型会忽略此项。 - 可选值：`low`、`medium`、`high` + 可能的值：`low`、`medium`、`high`、`auto` diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx index 11a69c5911..67e5aebd4e 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx @@ -2,12 +2,12 @@ title: "配合 Comfy Router 使用 Grok Imagine Image Quality" description: "通过 Comfy Router 调用 xai/grok-imagine-image-quality：端点、请求结构与 Router 返回的响应。" sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 923968d2 +translationSourceHash: 9f6e16d5 translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: "_intro": 72081c22 "Quick start": 799275b8 - "Schema": e0fcef44 + "Schema": e2c96ff6 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE - 输出图像的质量。对于 grok-imagine-image-2.0，此参数用于选择价格档位（low/medium；默认 medium）；其他模型目前会忽略该项。 + 输出图像的质量。对于 grok-imagine-image-2.0，此项用于选择价格档位：low、medium 或 auto（省略时为 xAI 的默认值；auto 在生成时使用 low，编辑时使用 medium）。其他模型会忽略此项。 - 可选值：`low`、`medium`、`high` + 可能的值：`low`、`medium`、`high`、`auto` diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx index 50889fad9d..70f243a657 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx @@ -2,12 +2,12 @@ title: "使用 Grok Imagine Image 与 Comfy Router" description: "通过 Comfy Router 调用 xai/grok-imagine-image：端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Grok Imagine Image" -translationSourceHash: 9cfb938a +translationSourceHash: 2e5c55ad translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: "_intro": a2e97c88 "Quick start": a5495331 - "Schema": 1d17b83a + "Schema": 171da7d5 "Examples": 3222291b --- @@ -172,9 +172,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID - 输出图像的质量。对于 grok-imagine-image-2.0，此参数用于选择价格档位（low/medium；默认为 medium）；其他模型目前会忽略该参数。 + 输出图像的质量。对于 grok-imagine-image-2.0，此项用于选择价格档位：low、medium 或 auto（省略时为 xAI 的默认值；auto 在生成时使用 low，编辑时使用 medium）。其他模型会忽略此项。 - 可能的值：`low`, `medium`, `high` + 可能的值：`low`, `medium`, `high`, `auto` diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index 51f1a1ee9a..b560e1fca8 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: a6f99965 +translationSourceHash: aee933a1 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": 222fd740 + "Endpoints": e0879d3c "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 5952af3f - "Result assets": 18fe6dad + "Pre-flight cost estimates": f0ba96a1 + "Result assets": 5936427c "Per-model input and output schemas": 61c6bde8 - "Schemas": 984bd216 + "Schemas": c1245cc9 --- @@ -51,7 +51,7 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 **列出 Comfy Router 可以运行的模型。** -列出可用的模型 ID 和计费信息。当 `has_more` 为 `true` 时，使用 `next_cursor`。 +列出可用的模型 ID 和计费信息。当 `has_more` 为 true 时，使用 `next_cursor`。 **参数** @@ -307,7 +307,7 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 **在运行模型调用之前先为它定价，而无需实际运行。** -返回一个以美元计的预检估算，表示用此模型运行该请求体将产生的费用，其定价依据与实际运行计费所依据的同一份费率卡（若某模型按其供应商上报的成本计费，则改为依据供应商公布的价格表来估算）。这是估算值，而非最终费用：你实际支付的是工作区用量与账单记录中结算后的费用。请求体会先按模型的输入 schema 进行校验，校验方式与默认运行（未设置 `strict_mode`，也未设置 `reject_unknown_fields`）相同，因此未通过模型 schema 的请求体在此处和在运行时都会得到相同的 `422`；不会向任何提供商派发请求，也不会产生任何扣费。该结果并非价格锁定：它按 `pricing_as_of` 时点生效的费率计价，而一次运行则按计费时生效的费率收费。在该功能逐步推出的期间，此路由会返回 `403`，并带有 `error_type: not_enabled`。 +返回一个以美元计的预检估算，表示用此模型运行该请求体将产生的费用，其定价依据与实际运行计费所依据的同一份费率卡（若某模型按其供应商上报的成本计费，则改为依据供应商公布的价格表来估算）。这是估算值，而非最终费用：你实际支付的是工作区用量与账单记录中结算后的费用。请求体会先按模型的输入 schema 进行校验，校验方式与默认运行（未设置 `strict_mode`，也未设置 `reject_unknown_fields`）相同，因此未通过模型 schema 的请求体在此处和在运行时都会得到相同的 `422`；不会向任何提供商派发请求，也不会产生任何扣费。该结果并非价格锁定：它按 `pricing_as_of` 时点生效的费率计价，而一次运行则按计费时生效的费率收费。在该功能逐步推出的期间，此路由会返回 `403`，并带有 `error_type: not_enabled`；Router 尚无法运行的模型会返回同样的 `403`，但带有运行路由自身的 `detail`，因此请读取 `detail` 以区分两者。 **参数** @@ -998,7 +998,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ 估算的局限。一个 `200` 的数字并不代表该次运行一定会被接受，也不代表一定按该金额收费： - `/estimate` 不接受 `strict_mode` 或 `reject_unknown_fields`，因此只校验模型的原生约定：一个在 `strict_mode=true` 运行中按备用提供商自身 schema 可以接受的请求体，在这里可能得到 `422`；而某个未声明的顶层字段，在 `reject_unknown_fields=true` 的运行中会被拒绝，在这里却会被定价。Anthropic Messages 模型是例外：其 schema 允许未声明字段，因此 `reject_unknown_fields=true` 的运行不会拒绝任何字段，而估算只会为未声明的顶层字段 `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` 以及空的 `mcp_servers` 定价。任何其他未声明的顶层字段都会使其返回 `unknown`，并带有 `reason: not_quotable`。 -- `pricing_as_of` 是费率卡的获取时间；对于取自供应商公布价格表的 `estimated` 报价，它是读取该价格表的日期（两者都未读取时，则为估算作答的时间）。它不是价格锁定：运行按其被计费评级时生效的费率收费。 +- `pricing_as_of` 是费率卡的获取时间。取自供应商公布价格表的 `estimated` 报价携带的是读取该价格表的日期。计费数量由供应商公布的调度表预测、再按费率卡定价的 `exact` 或 `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 平台上。 @@ -1014,7 +1014,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ | `minimax/*` | 已完成视频 | 12 小时 | | `xai/*` | 每一张已生成的图像，以及已完成视频 | 24 小时 | -这些有效期从 URL 签名时开始计算，而不是从你打开它时开始。缓存或重放的 URL 可能剩余时间更少；重放不会为其续期。请及时下载资产。只有每一行中列出的资产会被复制：`byteplus/seedream-*` 和 `byteplus/seededit-*` 图像不在 BytePlus 视频行的覆盖范围内。 +这些有效期从 URL 签名时开始计算，而不是从你打开它时开始。缓存或重放的 URL 可能剩余时间更少；重放不会为其续期。一条 `Idempotency-Key` 记录的有效期可能长于它所保存的 URL，因此在这样的 URL 到期前一小时起，使用同一键重试会得到 `409 invalid_input`，而不是记录中的响应；若某条响应在送达时就已如此接近到期，则它在 5 分钟内仍可重放。请及时下载资产。只有每一行中列出的资产会被复制：`byteplus/seedream-*` 和 `byteplus/seededit-*` 图像不在 BytePlus 视频行的覆盖范围内。 复制只由模型的原生提供商执行。由替代提供商提供服务的运行（`model_provider` 指定了某个替代提供商，或原生运行的回退重试落到了替代提供商上，并通过 `X-Comfy-Router-Fallback-Provider` 披露）会返回该提供商自己的 URL，这些 URL 遵循提供商的过期时间，不会被复制。`model_provider` 取值 `default`、`comfy` 和 `comfyui` 时不指定替代提供商，因此这些运行属于原生运行并按上述方式复制；`model_provider` 运行的回退重试落回原生提供商时也同样如此。 @@ -1121,7 +1121,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ - 本报价所依据的费率卡的获取时间。估算值不是价格锁定：运行按计费时生效的费率收费，而不是按这一时刻的费率。从供应商公布的价格表取得的 `estimated` 报价（按供应商报告的费用计费的模型）改为携带读取该价格表的日期；而计费数量由该价格表预测、再按费率卡定价的报价（按供应商报告的积分计费的模型）携带两者中较早的日期。只要没有读取任何费率卡（`reason: pricing_unavailable`、`byok`，或无法从任何卡定价的 `not_quotable` 调用），它就是回答该报价的时间。 + 本报价所依据的费率卡的获取时间。估算值不是价格锁定：运行按计费时生效的费率收费，而不是按这一时刻的费率。从供应商公布的价格表取得的 `estimated` 报价（按供应商报告的费用计费的模型）改为携带读取该价格表的日期；而计费数量由供应商公布的调度表预测、再按费率卡定价的报价，无论给出的是 `exact` 还是 `estimated` 答案，都携带该调度表的读取日期与费率卡获取时间中较早的一个（按供应商报告的积分计费的模型属于 `estimated` 情形）。只要没有读取任何费率卡（`reason: pricing_unavailable`、`byok`，或无法从任何卡定价的 `not_quotable` 调用），它就是回答该报价的时间。 date-time From b578de299eb332574661d2ff48cbcf52746745c0 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Mon, 2 Nov 2026 11:32:02 +0800 Subject: [PATCH 3/4] i18n: drop stray space before appended ignored-field sentence in zh/ja Kling pages --- .../comfy-router/models/kling/kling-3-0-turbo/code.mdx | 4 ++-- .../comfy-router/models/kling/kling-image-o1/code.mdx | 4 ++-- .../comfy-router/models/kling/kling-v3-omni/code.mdx | 4 ++-- .../comfy-router/models/kling/kling-video-o1/code.mdx | 4 ++-- .../models/kling/videos-avatar-image2video/code.mdx | 4 ++-- .../comfy-router/models/kling/videos-lip-sync/code.mdx | 2 +- .../comfy-router/models/kling/kling-3-0-turbo/code.mdx | 4 ++-- .../comfy-router/models/kling/kling-image-o1/code.mdx | 4 ++-- .../comfy-router/models/kling/kling-v3-omni/code.mdx | 4 ++-- .../comfy-router/models/kling/kling-video-o1/code.mdx | 4 ++-- .../models/kling/videos-avatar-image2video/code.mdx | 4 ++-- .../comfy-router/models/kling/videos-lip-sync/code.mdx | 2 +- 12 files changed, 22 insertions(+), 22 deletions(-) diff --git a/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx index 9e70ef6ad1..178e03001d 100644 --- a/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx @@ -195,11 +195,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - タスク結果のコールバック通知 URL。タスクのステータスが変化したときにサーバーが通知します。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 + タスク結果のコールバック通知 URL。タスクのステータスが変化したときにサーバーが通知します。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 - カスタムタスク ID。システムが生成したタスク ID を上書きすることはありませんが、クエリに使用できます。1 つのユーザーアカウント内で一意である必要があります。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 + カスタムタスク ID。システムが生成したタスク ID を上書きすることはありませんが、クエリに使用できます。1 つのユーザーアカウント内で一意である必要があります。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx b/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx index 7edb88fd58..4795fab741 100644 --- a/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクステータスが変化したときにサーバーから能動的に通知されます。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 + このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクステータスが変化したときにサーバーから能動的に通知されます。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -182,7 +182,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 + カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx index 1e63a56c77..161299a1f8 100644 --- a/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーが能動的に通知します。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 + このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーが能動的に通知します。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 フォーマット: `uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - カスタムタスクID。単一のユーザーアカウント内で一意である必要があります。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 + カスタムタスクID。単一のユーザーアカウント内で一意である必要があります。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx b/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx index 791d6d9dc3..dcd06095bb 100644 --- a/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーから能動的に通知されます。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 + このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーから能動的に通知されます。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - カスタムタスクID。1 つのユーザーアカウント内で一意である必要があります。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 + カスタムタスクID。1 つのユーザーアカウント内で一意である必要があります。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx index e0f850e6c6..a4db08bffc 100644 --- a/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx +++ b/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx @@ -164,13 +164,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R - このタスクの結果を受け取るコールバック通知アドレス。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 + このタスクの結果を受け取るコールバック通知アドレス。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` - カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 + カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 diff --git a/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx index 845e809713..5a948550b4 100644 --- a/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx +++ b/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx @@ -176,7 +176,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID ### 入力 - コールバック通知アドレス。タスクのステータスが変更されるとサーバーから通知されます。 無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 + コールバック通知アドレス。タスクのステータスが変更されるとサーバーから通知されます。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router が代わりにポーリングします。 形式: `uri` diff --git a/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx index 1a9a01600e..8c3d2f1438 100644 --- a/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx @@ -195,11 +195,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID - 任务结果回调通知 URL。当任务状态发生变化时，服务器会发送通知。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 + 任务结果回调通知 URL。当任务状态发生变化时，服务器会发送通知。已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 - 自定义任务 ID。不会覆盖系统生成的任务 ID，但可用于查询。在单个用户账号内必须唯一。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 + 自定义任务 ID。不会覆盖系统生成的任务 ID，但可用于查询。在单个用户账号内必须唯一。已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx b/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx index f9304aab70..ab61565876 100644 --- a/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 此任务结果的回调通知地址。若已配置，任务状态发生变化时服务器会主动通知。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 + 此任务结果的回调通知地址。若已配置，任务状态发生变化时服务器会主动通知。已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` @@ -182,7 +182,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账户内必须唯一。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 + 自定义任务 ID。在单个用户账户内必须唯一。已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx index b763aab34c..3e932df4e1 100644 --- a/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 本任务结果的回调通知地址。若配置此项，任务状态发生变化时服务器将主动通知。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 + 本任务结果的回调通知地址。若配置此项，任务状态发生变化时服务器将主动通知。已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账号内必须唯一。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 + 自定义任务 ID。在单个用户账号内必须唯一。已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx index df89a4745c..550f454ff5 100644 --- a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -166,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 本任务结果的回调通知地址。若已配置，任务状态发生变化时服务器会主动通知。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 + 本任务结果的回调通知地址。若已配置，任务状态发生变化时服务器会主动通知。已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账号内必须唯一。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 + 自定义任务 ID。在单个用户账号内必须唯一。已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx index 550c1b9af0..1c74914be3 100644 --- a/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx +++ b/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx @@ -164,13 +164,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R - 本任务结果的回调通知地址。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 + 本任务结果的回调通知地址。已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` - 自定义任务 ID。在单个用户账户内必须唯一。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 + 自定义任务 ID。在单个用户账户内必须唯一。已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 diff --git a/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx index c486bdd34d..ae5c95a754 100644 --- a/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx +++ b/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx @@ -176,7 +176,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID ### 输入 - 回调通知地址。任务状态发生变化时，服务器会发出通知。 已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 + 回调通知地址。任务状态发生变化时，服务器会发出通知。已忽略。comfy-api 会在转发前丢弃该字段，由 Comfy Router 代你轮询。 格式：`uri` From 57b50d544c70c94c9fb729e0cd68a0b44ce21b6f Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Mon, 2 Nov 2026 11:32:15 +0800 Subject: [PATCH 4/4] i18n: fix ungrammatical relative clause in zh realtime intro --- zh/development/comfy-router/realtime.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh/development/comfy-router/realtime.mdx b/zh/development/comfy-router/realtime.mdx index ca3fbb1b8f..dae580edb5 100644 --- a/zh/development/comfy-router/realtime.mdx +++ b/zh/development/comfy-router/realtime.mdx @@ -35,7 +35,7 @@ wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime ## 连接 -升级成功后，发送并接收 xAI 为 Grok Voice 文档中描述的实时事件。此示例配置会话、发送一轮文本，并打印它收到的每个事件类型。 +升级成功后，发送并接收 xAI 在 Grok Voice 文档中说明的实时事件。此示例配置会话、发送一轮文本，并打印它收到的每个事件类型。