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/api.mdx b/ja/development/comfy-router/api.mdx
index c6f3fadec0..5dfdd0561c 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..e79f9355a7 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: df1da85a
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": f23c325f
"Router does not cover every partner operation": 786c0fb2
"Model outputs and stored assets": 06c737c1
"Next": be85b789
@@ -116,7 +116,6 @@ 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`
- **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`
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..026fca6dfa 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..387a47e476 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..f5f740e601 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..73d67c2e0f 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..765878b269 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..d076fa35b8 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..ef2e832725 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..8af172042b 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..1f0880d972 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/realtime.mdx b/ja/development/comfy-router/realtime.mdx
new file mode 100644
index 0000000000..3723f0c26e
--- /dev/null
+++ b/ja/development/comfy-router/realtime.mdx
@@ -0,0 +1,224 @@
+---
+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 アップグレードです(`Connection: Upgrade` と `Upgrade: websocket` を伴う `GET`)。それ以外のリクエストは `426` で拒否されます。
+
+## 認証
+
+アップグレードリクエストのヘッダーで、Comfy API キーを `X-API-Key: comfyui-...` または `Authorization: Bearer comfyui-...` として送信します。Router はクエリ文字列や WebSocket サブプロトコルからキーを読み取りません。
+
+
+ブラウザは WebSocket にヘッダーを設定できません。また、Comfy API キーを絶対にブラウザへ到達させてはいけません。サーバーからセッションを開き、オーディオをブラウザへ自分で中継してください。
+
+
+## 接続
+
+アップグレードが成功したら、xAI が Grok Voice 向けに文書化しているリアルタイムイベントを送受信します。この例ではセッションを設定し、1 回のテキストターンを送信して、受信した各イベントタイプを出力します。
+
+
+
+```python Python
+# pip install websockets msgpack
+import asyncio
+import os
+
+import msgpack
+import websockets
+
+URL = "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime"
+
+
+async def send(ws, event):
+ await ws.send(msgpack.packb(event))
+
+
+async def main():
+ async with websockets.connect(
+ URL,
+ additional_headers={"X-API-Key": os.environ["COMFY_API_KEY"]},
+ ) as ws:
+ await send(ws, {
+ "type": "session.update",
+ "session": {
+ "voice": "eve",
+ "instructions": "You are a helpful assistant.",
+ "turn_detection": {"type": "server_vad"},
+ },
+ })
+ await send(ws, {
+ "type": "conversation.item.create",
+ "item": {
+ "type": "message",
+ "role": "user",
+ "content": [{"type": "input_text", "text": "Hello!"}],
+ },
+ })
+ await send(ws, {"type": "response.create"})
+
+ async for message in ws:
+ if isinstance(message, str):
+ continue # fal 独自の x-fal-message フレーム
+ event = msgpack.unpackb(message)
+ print(event["type"])
+ if event["type"] == "response.done":
+ break
+
+
+asyncio.run(main())
+```
+
+```javascript Node.js
+// npm install ws @msgpack/msgpack
+import WebSocket from "ws";
+import { encode, decode } from "@msgpack/msgpack";
+
+const ws = new WebSocket(
+ "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime",
+ { headers: { "X-API-Key": process.env.COMFY_API_KEY } },
+);
+
+ws.on("unexpected-response", (req, res) => {
+ // アップグレードが拒否されました。JSON ボディに理由が示されています。
+ let body = "";
+ res.on("data", (chunk) => (body += chunk));
+ res.on("end", () => console.error(res.statusCode, body));
+});
+
+const send = (event) => ws.send(encode(event));
+
+ws.on("open", () => {
+ send({
+ type: "session.update",
+ session: {
+ voice: "eve",
+ instructions: "You are a helpful assistant.",
+ turn_detection: { type: "server_vad" },
+ },
+ });
+ send({
+ type: "conversation.item.create",
+ item: {
+ type: "message",
+ role: "user",
+ content: [{ type: "input_text", text: "Hello!" }],
+ },
+ });
+ send({ type: "response.create" });
+});
+
+ws.on("message", (data, isBinary) => {
+ if (!isBinary) return; // fal 独自の x-fal-message フレーム
+ const event = decode(data);
+ console.log(event.type);
+ if (event.type === "response.done") ws.close();
+});
+
+ws.on("close", (code) => console.log("closed", code));
+```
+
+
+
+終わったらすぐにソケットを閉じてください。課金されるのは最後のレスポンスまでではなく、セッションが閉じるまでです。
+
+## イベント
+
+Router は独自のイベントプロトコルを定義していません。サーバーイベントは fal が送信するそのままの形で届き、Router が受け付けるクライアントイベントは変更されずに転送されます。イベント一覧、セッションのフィールド、ボイス、オーディオ形式については、次を参照してください。
+
+- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) および xAI の [realtime イベントスキーマ](https://docs.x.ai/voice-realtime.ws.json)
+- fal の [Grok Voice realtime モデルページ](https://fal.ai/models/xai/grok-voice/realtime) とその [API ページ](https://fal.ai/models/xai/grok-voice/realtime/api)
+
+各クライアントイベントは、例のように 1 つの msgpack バイナリメッセージとして送信してください。これは fal のリアルタイムクライアントが使用するフレーミングであり、モデルのイベントも同じ方法で、`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 呼び出しと共有されます。 |
+
+セッションが時間制限に達した場合、またはクレジットが不足した場合、接続は 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 内のモデルはリアルタイムでは利用不可です。 | 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/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..9d5f2b6bb8 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: df1da85a
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": f23c325f
"Router does not cover every partner operation": 786c0fb2
"Model outputs and stored assets": 06c737c1
"Next": be85b789
@@ -116,7 +116,6 @@ 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`
- **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`
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..18d3888b40 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..38a2b57351 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..bd4708d308 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..414979a62a 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..0c0b5cdd04 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..5f65e76b50 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..dacb6a13f1 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..7de123135c 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..f55922e978 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/queue.mdx b/ko/development/comfy-router/queue.mdx
index 3f17f8df57..3667b70ef1 100644
--- a/ko/development/comfy-router/queue.mdx
+++ b/ko/development/comfy-router/queue.mdx
@@ -270,7 +270,7 @@ async with AsyncComfy() as client:
- **동기 경로와 동일한 과금.** 공급자가 Comfy에 과금할 때 과금됩니다. 실행 대기열에서 대기한 시간은 과금되지 않습니다.
- **제출당 하나의 `Idempotency-Key`.** SDK는 `submit` 호출마다 새로운 키를 생성하므로, 같은 입력을 의도적으로 두 번 제출하면 두 개의 요청이 됩니다. 동일한 키로 같은 호출을 재시도해도 두 번째 실행이 실행 대기열에 들어가지 않습니다. 대신 원본 핸들을 `Idempotent-Replayed: true`와 함께 반환합니다. 응답을 잃어버려 `request_id`를 놓칠 수 있는 상황이라면 직접 키를 전달하세요. [헤더](/ko/development/comfy-router/headers)를 참고하세요.
- **결과는 만료됩니다.** 완료된 요청은 완료 후 24시간 동안 보관됩니다. 그 이후에는 상태 및 결과 조회가 `410`을 응답하고 결과는 사라집니다. 신속하게 수집하고 출력에 담긴 에셋 URL을 다운로드하세요.
-- **폴링도 요청입니다.** 상태 및 결과 조회는 [호출자별 요청 비율](/ko/development/comfy-router/limitations#요청은-호출자별로-속도-제한됨)에 포함됩니다. 짧은 고정 간격으로 폴링하기보다 `Retry-After`를 따르세요.
+- **폴링도 요청입니다.** 상태 및 결과 조회는 [호출자별 요청 비율](/ko/development/comfy-router/limitations#요청은-호출자별로-속도-제한됩니다)에 포함됩니다. 짧은 고정 간격으로 폴링하기보다 `Retry-After`를 따르세요.
## 실행 대기열 오류 응답
diff --git a/ko/development/comfy-router/realtime.mdx b/ko/development/comfy-router/realtime.mdx
new file mode 100644
index 0000000000..2b09050145
--- /dev/null
+++ b/ko/development/comfy-router/realtime.mdx
@@ -0,0 +1,224 @@
+---
+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 event 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은 `x-fal-message` 유형의 자체 JSON 텍스트 메시지(타이밍 정보)도 보내는데, 이는 건너뛰어도 됩니다. Router의 검사는 클라이언트 이벤트를 하나의 JSON 텍스트 메시지로도 허용하지만, 클라이언트에서 JSON을 테스트해 보지 않았다면 msgpack을 사용하세요.
+
+Router는 전달하기 전에 각 클라이언트 이벤트를 검사합니다:
+
+- **이벤트 유형:** `session.update`, `input_audio_buffer.append`, `input_audio_buffer.commit`, `input_audio_buffer.clear`, `conversation.item.create`, `conversation.item.delete`, `conversation.item.truncate`, `response.create`, `response.cancel`, 그리고 fal의 `x-fal-session.configure`.
+- **모델:** `session.update`의 `model`은 `grok-voice-latest`, `grok-voice-3.0`, `grok-voice-2.0` 중 하나여야 합니다.
+- **도구:** 클라이언트가 실행하는 함수 도구는 허용됩니다. 서버 측 도구(웹 검색, X 검색, 파일 검색, MCP)는 거부됩니다.
+- **미디어:** 이미지 및 비디오 입력은 거부됩니다. 세션은 음성과 텍스트만 지원합니다.
+- **크기:** 클라이언트 메시지 하나는 최대 1 MiB입니다.
+
+거부된 이벤트는 전달되지 않으며, Router는 종료 코드 `1008`로 세션을 닫습니다.
+
+## 가격
+
+세션 비용은 **초당 $0.0011869**입니다(분당 약 $0.0712, 초당 0.2504 크레딧, 분당 약 15.0 크레딧이며, 211 크레딧 = $1 USD 기준입니다). 세션이 열려 있는 동안 15초 증가분 단위로 청구되며, 마지막 부분 증가분은 초 단위로 올림하여 청구됩니다. 청구는 오디오가 흐르는지 여부와 관계없이 업그레이드 시점부터 소켓이 닫힐 때까지 이루어집니다.
+
+## 제한
+
+| 제한 | 값 |
+| --- | --- |
+| 계정당 세션 | 한 번에 하나의 세션만 열 수 있습니다. 두 번째 세션을 열면 `429`와 `router.realtime.session_already_live`가 반환됩니다. |
+| 세션 길이 | 최대 30분이며, 연결 시점의 보유 크레딧 잔액으로 감당할 수 있는 시간보다 길 수 없습니다. |
+| 세션 중 크레딧 | Router는 15초마다 잔액을 다시 확인하며, 잔액이 다음 1초를 감당할 수 없게 되면 세션을 종료합니다. |
+| 연결 빈도 | 각 업그레이드 시도는 다른 Router 호출과 공유되는 [호출자별 요청 속도](/ko/development/comfy-router/limitations#요청은-호출자별로-속도-제한됩니다)에 포함됩니다. |
+
+세션이 시간 제한에 도달하거나 크레딧이 소진되면 연결이 종료 프레임 없이 닫힐 수 있습니다(흔히 종료 코드 `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에서 발생합니다. [이벤트](#이벤트)에 링크된 해당 문서를 참조하세요.
+
+## 다음
+
+- [청구](/ko/development/comfy-router/billing): Router가 요금을 부과하는 방식과 사용량을 대조하는 방법.
+- [오류 및 재시도](/ko/development/comfy-router/errors): 다른 Router 호출이 반환하는 오류 분류.
+- [제한 사항](/ko/development/comfy-router/limitations): 요청 속도 및 기타 제한.
diff --git a/zh/development/comfy-router/api.mdx b/zh/development/comfy-router/api.mdx
index 63a66aff1a..32a3545b2e 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..d039c33e41 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: df1da85a
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": f23c325f
"Router does not cover every partner operation": 786c0fb2
"Model outputs and stored assets": 06c737c1
"Next": be85b789
@@ -116,7 +116,6 @@ 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`
- **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`
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..1e39b276ff 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..0e827348ac 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..8ecd5d5829 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..7a6ba616cc 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..729411f1f0 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..c996013049 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..da101120b5 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..3794f1bde1 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..5b8012fba0 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/realtime.mdx b/zh/development/comfy-router/realtime.mdx
new file mode 100644
index 0000000000..fee84d1083
--- /dev/null
+++ b/zh/development/comfy-router/realtime.mdx
@@ -0,0 +1,224 @@
+---
+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 中继与 xAI Grok Voice 的实时语音到语音会话,Grok Voice 由 fal 提供。你使用 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 语音到语音](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 还会发送自己的、类型为 `x-fal-message` 的 JSON 文本消息(计时信息),你可以跳过它们。Router 的检查也接受把客户端事件作为一条 JSON 文本消息发送,但除非你已经用你的客户端测试过 JSON,否则请使用 msgpack。
+
+Router 在转发每个客户端事件之前都会对其进行检查:
+
+- **事件类型:** `session.update`、`input_audio_buffer.append`、`input_audio_buffer.commit`、`input_audio_buffer.clear`、`conversation.item.create`、`conversation.item.delete`、`conversation.item.truncate`、`response.create`、`response.cancel`,以及 fal 的 `x-fal-session.configure`。
+- **模型:** `session.update` 中的 `model` 必须是 `grok-voice-latest`、`grok-voice-3.0` 或 `grok-voice-2.0`。
+- **工具:** 允许使用由你的客户端执行的函数工具。服务器端工具(网络搜索、X 搜索、文件搜索和 MCP)会被拒绝。
+- **媒体:** 图像和视频输入会被拒绝。会话仅支持语音和文本。
+- **大小:** 单条客户端消息最大为 1 MiB。
+
+被拒绝的事件不会被转发,Router 会以关闭码 `1008` 关闭会话。
+
+## 定价
+
+一次会话的费用为**每秒 $0.0011869**(约每分钟 $0.0712,或每秒 0.2504 积分、约每分钟 15.0 积分,按 211 积分 = 1 美元计算)。会话开启期间以 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):请求速率及其他限制。