在 Qoder 中把 Router One 添加为 OpenAI Compatible 自定义模型

本指南适用于哪个 Qoder 产品

Qoder 旗下有好几款产品，模型各自单独配置。本指南针对 Qoder 桌面端：它的自定义模型文档写明了下文用到的每一个字段。按 Qoder 文档，自定义模型的费用由模型服务商的 API 账户直接结算（这里就是你的 Router One Key），不占用 Qoder Credits；Repo Wiki 使用固定模型、单独计费，会消耗 Qoder Credits，生成时会有提示。

把 Qoder 配置到 Router One base URL

进入 Qoder 设置，在左侧导航栏选择「模型」。点「+ 添加」，打开「供应商」，在「自定义」分组中选择 OpenAI Compatible，首次测试时再选 Chat Completions API。「接口地址（Base URL）」填 https://api.router.one/v1，「API Key」填专用的 Router One Key，「Model ID」填 /models 上的精确 ID；同一接口要配多个模型时，点「添加 Model ID」。Qoder 界面给出的示例格式 https://api.example.com/v1 与 Router One 的 /v1 地址写法相同，不要在后面追加 /chat/completions 或 /responses。点「下一步」按下文设置模型能力，再点「校验并添加模型」：Qoder 会先验证连接，通过后才保存模型。之后这个模型会出现在任务、Agent 和自动化的模型选择器中：

接口地址 / Base URL

https://api.router.one/v1

# Qoder 设置 → 模型 → + 添加 → 供应商 → 自定义
# Qoder Settings → Models → + Add → Provider → Custom
供应商 / Provider:            OpenAI Compatible
API:                          Chat Completions API   # Responses API：仅 GPT、DeepSeek V4、Grok 对话模型 / GPT, DeepSeek V4, Grok chat IDs only
接口地址 / Base URL:          https://api.router.one/v1
API Key:                      sk-your-router-one-key
Model ID:                     anthropic/claude-sonnet-5
添加 Model ID / Add Model ID: google/gemini-3.7-flash

# 下一步 → 每个模型的能力 / Next → capabilities for each model
显示名称 / Display name:                       Claude Sonnet 5 (Router One)
支持的上下文窗口 / Supported Context Windows:  不超过模型详情页的上下文窗口 / values up to the model page's context window
默认上下文窗口 / Default Context Window:       从已选值中选一个 / one of the selected values
视觉 / Vision:                                 仅当模型详情页列出图片输入时开启 / On only if the model page lists image input
思考模式 / Thinking Mode:                      首次校验时关闭 / Off for the first validation

# 校验并添加模型 / Validate and Add Model

Chat Completions API 还是 Responses API：哪些 Router One ID 放在哪里

API 类型作用于整个接口条目，同一条目下添加的所有 Model ID 都按同一种方式调用。Router One 在 Chat Completions 上提供全部对话模型，在 Responses 上原生提供 GPT 系列、DeepSeek V4 的 ID 与 Grok 对话模型；每个模型的详情页都列出它支持的端点。Claude 与 Gemini 的 ID 请放进 Chat Completions 条目；GPT 的 ID 两种都可以，想让 Qoder 对它们走 Responses 时，再单独添加一个选 Responses API 的条目。Claude 系列 ID 发到 Responses 时，会在调用任何模型之前被拒绝，返回 HTTP 400 invalid_request_error：model '<id>' must be called via /v1/messages or /v1/chat/completions。「自定义」分组里还有 Anthropic Compatible，但 Qoder 文档没有说明它如何在 Base URL 后拼接 Messages 路径，因此本指南不给出这一项的填写值；Router One 在 Chat Completions 上同样提供这些 Claude 系列 ID。

模型能力设置：上下文窗口、视觉与思考模式

点「下一步」后，Qoder 会让你按模型服务商公布的能力完成设置；Router One 把这些能力写在每个模型的详情页上。这一步不能修改 Model ID；按 Qoder 文档，「编辑」只能更新模型使用的 API Key，之后要改这些设置，需要删除模型再重新添加：

• 显示名称：模型在 Qoder 选择器中显示的名称，例如 Claude Sonnet 5 (Router One)。
• 支持的上下文窗口与默认上下文窗口：只选不超过模型详情页上下文窗口的值（anthropic/claude-sonnet-5 为 1,048,576 tokens，openai/gpt-5.5 为 1,050,000，anthropic/claude-haiku-4.5 为 200,000）。默认值是任务开始时使用的窗口；窗口越大，长任务每次请求可带的输入越多，而每个输入 Token 都会计费。需要释放上下文空间时，可以在任务中输入 /compact 压缩，Qoder 也可能自动压缩。
• 视觉：只有模型详情页列出图片输入时才开启。
• 思考模式：验证连接时先关闭；之后再开启，只勾选模型支持的思考强度，并到控制台 → 日志确认请求仍然成功。
• 工具调用：Qoder 的 Agent 会调用工具，优先选详情页列出工具调用的 ID；其他 ID 先试一次工具调用。

在日志中核对 Qoder Agent 的请求

Qoder 的任务是一个 Agent 循环：规划、读取文件、调用工具、核对结果，循环中的每一次模型调用都是一次单独计费的请求。自定义模型也会出现在「自动化」的模型选择器中，用 Router One 模型运行的定时任务会在你离开时继续消耗费用。请给 Qoder 单独一把设了 maxSpend 的 Key：触顶后该 Key 的请求返回 HTTP 402，其他 Key 不受影响。Qoder 文档没有说明「校验并添加模型」是否会发出计费请求，添加后可到控制台 → 日志查看。之后运行一个小任务，按时间、模型和 request_id 找到对应请求：日志中可以看到 Token、花费、状态、总耗时，以及产生过输出的流式请求的首字延迟（TTFT）。

Qoder 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 Qoder 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个客户端或应用单独建 API Key，并设置 maxSpend 消费上限。

Qoder 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

在请求日志里核对 Qoder 的调用

先在 Qoder 发出一次简单文本请求，再到控制台 → 日志按时间、模型和 request_id 找到这条记录，核对 Token、花费、总耗时和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，先查客户端配置和网络，不能仅凭客户端报错认定是网关或上游故障。

常见问题