把 Warp 的自定义推理端点接到 Router One

先确认 Warp 套餐，再创建专用 Key

按 Warp 的 custom inference endpoint 文档（2026-11-10 核对），个人自定义端点适用于 Free 套餐及所有符合条件的付费套餐，面向个人用户和员工不超过 10 人的组织；更大的组织需要 Business 或 Enterprise 套餐，这两档在本地运行时使用端点仍会产生 Warp 的平台费用，也可以由管理员改为配置团队统一管理的端点。组织统一管理自定义推理时，Warp 的设置页会提示个人 API Key 和自定义端点已被停用。在 Router One 控制台 → API 密钥点「创建密钥」，为 Warp 单独建一把 Key 并设置 maxSpend 上限：一次 Agent 任务可能发出很多次模型请求，maxSpend 是钱包扣费的硬性上限，专用 Key 也方便在控制台 → 日志里只看 Warp 的请求。

把 Warp 配置到 Router One base URL

打开 Warp 的 Settings → Agents → Warp Agent，找到「Custom Inference」一节（Warp 文档也建议在设置里搜索 inference endpoint）。点「+ Add custom model」，打开「Add custom endpoint」对话框。「API schema」保持默认的 OpenAI Chat Completions；「Endpoint name」填 Router One 之类的名称，「Endpoint URL」填 https://api.router.one/v1，「API key」粘贴专用 Key。「Model name」填精确的目录 ID，例如 anthropic/claude-sonnet-5；「Model alias (optional)」是模型选择器里显示的别名，可以不填。还要用别的 ID 就点「+ Add model」逐个添加，最后点「Add endpoint」。按 Warp 的设置源码，名称、地址、Key 和至少一个模型名称都填好后对话框才会保存；之后端点出现在「Custom endpoints」列表里，它的模型出现在 Warp Agent 的模型选择器中。填好的对话框如下：

Endpoint URL

https://api.router.one/v1

# Warp: Settings → Agents → Warp Agent → Custom Inference → + Add custom model
API schema:              OpenAI Chat Completions
Endpoint name:           Router One
Endpoint URL:            https://api.router.one/v1
API key:                 sk-your-router-one-key
Model name:              anthropic/claude-sonnet-5
Model alias (optional):  Claude Sonnet 5 via Router One

# + Add model for each further catalog ID, then Add endpoint
# Pick the Router One model in Warp Agent's model picker, not Auto

Endpoint URL：公网 HTTPS 地址，以 /v1 结尾

按 Warp 文档（2026-11-10 核对），Endpoint URL 是暴露 /v1/chat/completions 的 base URL，文档里的 ngrok 示例地址也以 /v1 结尾，所以填 https://api.router.one/v1，不要再加 /chat/completions。Warp 的设置源码会拒绝不是 HTTPS 的地址，也会拒绝指向 localhost 或内网 IP 的地址：这时「Endpoint URL」输入框会出现红色边框，「Add endpoint」按钮保持不可点击，对话框不显示报错文字。文档解释了为什么必须是公网地址：选中端点模型后，你的提示词、上下文、端点地址和 Key 会经过 Warp 的服务器发往端点，Warp 需要能从公网访问它；api.router.one 正是公网 HTTPS 地址。按同一份文档，Warp 不会保留你的个人端点 API Key；Warp 的设置页也写明，在那里添加的 Key 只存放在本机，不存放在 Warp 的服务器上。

API schema：保持 OpenAI Chat Completions

「API schema」下拉框里有 OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages 三项：Warp 在 2026.07.31 版的更新日志里加入了这项选择，设置页也说明自定义端点须支持三者之一。但 Warp 的 custom inference endpoint 文档（2026-11-10 核对）只介绍了 Chat Completions，没有说明另外两种 schema 该填什么地址，所以本指南保持默认的 OpenAI Chat Completions。在 Router One 一侧，它能覆盖全部对话模型：Claude、GPT、Gemini、Grok 和 DeepSeek 的 ID 都通过 POST /v1/chat/completions 提供。

在模型选择器里选 Router One 的模型，不要选 Auto

按 Warp 的 custom inference endpoint 文档（2026-11-10 核对）：

• Auto 模型使用 Warp 自己提供的推理，即使配置了端点也会消耗你在 Warp 的用量，所以要在模型选择器里直接选 Router One 的模型或它的别名。
• 自定义路由器（custom routers）用不了这个端点：它的路由目标只能是 Warp 支持的模型。
• 个人端点只用于本地运行的 Warp Agent，不用于云端 Agent；Business 与 Enterprise 的管理员可以配置团队统一管理的端点，本地和云端都能用。
• Warp 的其他 AI 功能使用各自的推理配置，不受个人端点影响。
• Warp Agent 通过工具完成工作（Warp 更新日志里提到 create_file 等工具），所以要选 /models 详情页列出工具调用的模型，例如 anthropic/claude-sonnet-5 或 deepseek-v4.1-flash。这个 schema 的请求走 POST /v1/chat/completions，用 GPT 系列 ID 之前，先看工具调用指南（/llm-tool-calling）里按模型列出的端点规则。

计费：请求由 Router One 计费，日志逐条可查

按 Warp 文档（2026-11-10 核对），发往端点的推理由端点提供方按自己的价格计费，不占用你在 Warp 的用量，Warp 的用量统计也不会完整反映这些外部账单。在 Router One 一侧，套餐档位列出的模型先扣对应档位的额度，额度用完后从钱包扣费；其他模型按 token 从钱包扣费，价格见模型详情页；各套餐包含哪些模型、额度多少，以 /pricing 为准。钱包支持支付宝充值。在控制台 → 日志中按 Warp 专用的 Key 筛选，每条记录显示模型、Token、钱包扣费或套餐扣减次数、状态和总耗时。

Warp 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 Warp 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个客户端或应用单独建 API Key，并设置 maxSpend 消费上限。每把 Key 的消费上限（maxSpend）限的是这把 Key 能从钱包扣的钱：累计扣费到上限后，这把 Key 上需要钱包付费的请求返回 HTTP 402。套餐额度覆盖的请求从账户共用的套餐额度里扣，不计入任何 Key 的上限。

Warp 用的是哪种 API 协议？

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

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

先在 Warp 发出一次简单文本请求，再到控制台 → 日志按时间、模型和 request_id 找到这条记录，核对 Token、钱包扣费或套餐扣减次数、总耗时和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，要么请求没到达网关（客户端配置或网络问题），要么网关在调用模型之前就拒绝了它——Key 问题的 401、余额不足或 Key 达到 maxSpend 上限的 402、Key 或账户自身限额触发的 429，或模型 ID、端点不对的 400 / 404；在输出任何内容之前就失败的流式请求也可能没有日志。看客户端收到的状态码和错误消息就能区分是哪一种；先确认这一点，再判断是不是网关或上游故障。

常见问题