> ## Documentation Index > Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 配合 Comfy Router 使用 Chat Completions > 通过 Comfy Router 调用 openrouter/chat-completions：端点、请求结构以及 Router 返回的响应。 `openrouter/chat-completions` 的 API 参考文档，由 Comfy Router 从 Openrouter 提供服务。 ## 请求设置在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建一个密钥，并将其导出为 `COMFY_API_KEY`。对于 Python，运行 `pip install comfy-sdk`。对于 TypeScript，运行 `npm install @comfyorg/sdk`。对于 Swift，添加 [`ComfySwiftSDK`](https://github.com/Comfy-Org/comfy-swift-sdk) 包。cURL 使用原始 HTTP。 **模型 ID：** `openrouter/chat-completions` **端点：** `POST https://api.comfy.org/v2/models/openrouter/chat-completions` 此模型没有可运行的请求示例。请根据下方的输入文档构建请求体，然后配合 [Router 快速入门](/zh/development/comfy-router/quickstart)使用。 ## Schema ### 输入启用自动提示词缓存。在顶层设置时，系统会自动将缓存断点应用到请求中最后一个可缓存的块。目前支持 Anthropic Claude 模型。可选值：`5m`、`1h` 可选值：`ephemeral` 用于检查请求转换的调试选项（仅限流式传输）如果为是，则在流开始时将转换后的上游请求体包含在一个调试数据块中。仅在流式传输模式下有效。频率惩罚（-2.0 到 2.0）格式：`double` Token logit 偏置调整返回对数概率补全的最大 token 数最大 token 数（已弃用，请使用 max\_completion\_tokens）。注意：部分提供商会强制要求最小值为 16。对话的消息列表用于附加对象信息的键值对（最多 16 对，键最长 64 个字符，值最长 512 个字符）响应的输出模态。支持的值为 "text"、"image" 和 "audio"。用于补全的模型用于补全的模型在使用工具时是否启用并行函数调用。为是时，模型可能在单次响应中生成多个工具调用。你想为此请求启用的插件，包括其设置。存在惩罚（-2.0 到 2.0）格式：`double` 当有多个模型提供商可用时，可选择性地指明你的路由偏好。是否允许备用提供商处理请求 * true：（默认）当主要提供商（或你在 "order" 中的自定义提供商）不可用时，使用次优的提供商。 * false：仅使用主要/自定义提供商，若其不可用则返回上游错误。数据收集设置。如果没有可用的模型提供商满足该要求，你的请求将返回错误。 * allow：（默认）允许非临时存储用户数据并可能据此训练的提供商 * deny：仅使用不收集用户数据的提供商。是否将路由限制为仅使用允许文本蒸馏的模型。为是时，仅使用作者已允许蒸馏的模型。要忽略的提供商 slug 列表。如果提供，此列表会与此请求中你账户级别的忽略提供商设置合并。用于指定你愿意为此请求支付的最高价格的对象。以美元计，每百万 token 的价格，针对提示词和补全。每百万提示词 token 的价格每百万提示词 token 的价格每百万提示词 token 的价格每百万提示词 token 的价格每百万提示词 token 的价格允许使用的提供商 slug 列表。如果提供，此列表会与你的账户级允许提供商设置合并，并应用于本次请求。按顺序排列的提供商 slug 列表。路由器会在此列表中支持你所请求模型的子集里，优先尝试第一个提供商；如果该提供商不可用，则回退到下一个。如果没有任何可用的提供商，请求将失败并返回报错信息。首选的最大延迟（单位为秒）。可以是一个数字（适用于 p50），也可以是带有各百分位特定阈值的对象。高于阈值的端点仍可能被使用，但在路由中会被降低优先级。使用回退模型时，如果回退模型满足阈值，可能会导致使用回退模型而不是主模型。首选的最小吞吐量（单位为每秒 token 数）。可以是一个数字（适用于 p50），也可以是带有各百分位特定阈值的对象。低于阈值的端点仍可能被使用，但在路由中会被降低优先级。使用回退模型时，如果回退模型满足阈值，可能会导致使用回退模型而不是主模型。用于按量化级别过滤提供商的列表。是否将提供商过滤为仅保留那些支持你所提供参数的服务商。如果省略此设置或将其设为 false，提供商将只收到它们支持的参数，并忽略其余参数。如果未指定 "order"，则使用此排序策略来处理本次请求。设置后，不会执行负载均衡。是否将路由限制为仅使用 ZDR（零数据保留）端点。设为 true 时，只会使用不保留提示词的端点。推理模型的配置选项限制推理模型在推理上投入的力度可能的值：`auto`、`concise`、`detailed` 响应格式配置任意类型用于生成确定性输出的随机种子用于处理此请求的服务层级。用于对相关请求（例如一次对话或智能体工作流）进行分组以便可观测的唯一标识符。如果同时在请求体和 x-session-id 请求头中提供，则以请求体中的值为准。最多 256 个字符。停止序列（最多 4 个）服务器工具智能体循环的停止条件。任一条件触发都会终止循环（OR 逻辑）。设置后，此设置会覆盖 `max_tool_calls`。启用流式响应流式配置选项已弃用：此字段不产生任何效果。完整的用量详情始终会被包含。采样温度（0-2）格式：`double` 工具选择配置可用于函数调用的工具返回的 top log 概率数量（0-20）核采样参数（0-1）格式：`double` 用于可观测性和追踪的元数据。已知的键（trace\_id、trace\_name、span\_name、generation\_name、parent\_span\_id）有特殊处理。其他键会作为自定义元数据透传给已配置的广播目标。唯一用户标识符根据 Router 在 `GET /v2/models/openrouter/chat-completions/openapi.json` 提供的 schema 生成，该文档与请求到达提供商之前 Router 用于校验调用的文档相同。 ### 输出补全选项列表可能的值：`tool_calls`、`stop`、`length`、`content_filter`、`error` 选项索引补全的对数概率内容 token 的对数概率 token 的 UTF-8 字节 token 的对数概率格式：`double` 该 token 带概率的备选 token 排名格式：`double` 拒绝 token 的对数概率 token 的 UTF-8 字节 token 的对数概率格式：`double` 该 token 带概率的备选 token 排名格式：`double` 请求和响应的助手消息音频输出数据或引用 Base64 编码的音频数据音频过期时间戳音频输出标识符音频转写文本助手消息内容图像生成模型生成的图像生成图像的 URL 或 base64 编码数据助手的可选名称推理输出扩展思考模型的推理详情内容被拒绝时的拒绝消息助手发起的工具调用 JSON 字符串形式的函数参数要调用的函数名称工具调用标识符可能的值：`function` 创建时间的 Unix 时间戳唯一的补全标识符用于补全的模型可能的值：`chat.completion` 格式：`double` 格式：`double` 格式：`double` 流水线阶段的分类类型。多个插件可以共享同一个类型（例如所有 guardrail 级别的插件都会输出 `guardrail`）；`name` 字段用于区分具体是哪个插件输出的。可能的值：`guardrail`、`plugin`、`server_tools`、`response_healing`、`context_compression` 可能的值：`direct`、`auto`、`free`、`latest`、`alias`、`fallback`、`pareto`、`bodybuilder`、`fusion` 上游提供商为此请求使用的服务层级系统指纹 Token 使用量统计补全内容中的 token 数量详细的补全 token 用量补全的费用格式：`double` 上游推理费用的明细格式：`double` 格式：`double` 格式：`double` 该请求是否使用了自带密钥（Bring Your Own Key）配置提示词中的 token 数量详细的提示词 token 用量 token 总数 ## 示例 ### 输出 ```json theme={null} { "choices": [ { "finish_reason": "stop", "index": 0, "message": {} } ], "created": 1750000000, "id": "gen-0000000000-examplecompletion", "model": "anthropic/claude-sonnet-4.5", "object": "chat.completion", "system_fingerprint": null, "usage": { "completion_tokens": 128, "cost": 0.00123, "prompt_tokens": 42, "total_tokens": 170 } } ``` ## 发布前须知 SDK 会生成 `Idempotency-Key` 并在自动重试中复用它。手动重试时，请复用原始 key。Router 最长可保持连接 10 分钟。请求失败时，Router 会发送 `X-Comfy-Error-Type` 响应头说明原因。`422` 表示 Router 在调用提供商之前就拒绝了输入，`413` 表示请求体超出了 Router 可接受的大小。已生成的资源请及时下载，因为[结果 URL 会过期](/zh/development/comfy-router/reference#结果资产)。上文任何字段描述中提到的尺寸限制，都是提供商对该字段自身的限定，引自提供商的规范。Router 会对整个请求体另行设置上限，base64 编码的媒体内容也计入其中：参见[请求体大小](/zh/development/comfy-router/limitations)。本页记录的是通过 Comfy Router 调用的某一个合作伙伴模型。同一个 `comfy-sdk` / `@comfyorg/sdk` 包还提供第二个客户端，用于在 Comfy Cloud 上运行完整的 ComfyUI 工作流图：`Comfy(api_key=...)` / `new Comfy({ apiKey })`，并带有 `client.workflows`、`client.assets` 和 `client.jobs`。请参阅 [Comfy SDKs](/zh/development/api-development/sdks)。身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。模型发现、验证错误、重试与计费。 Router 目前不支持的功能，以及替代方案。