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

> https://router.one/zh/integrations/warp 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-11-10

Warp 自称「诞生于终端的 agentic 开发环境」：可以用它内置的编程 Agent（Warp Agent），也可以接入你自己的 CLI Agent。Warp Agent 支持自定义推理端点：按 Warp 的 custom inference endpoint 文档（2026-11-10 核对），填入 OpenAI 兼容端点的 base URL、API Key 和要用的模型 ID，这些模型就会出现在模型选择器里。用 https://api.router.one/v1 和一把 Router One Key 添加 Router One 后，你从目录里添加的 Claude、GPT、Gemini、Grok 和 DeepSeek 对话模型就会出现在 Warp Agent 的模型选择器里，都用这一把 Key；网关转发给模型的每个请求都会出现在控制台 → 日志中，可核对 Token、钱包扣费或套餐扣减次数（在输出任何内容之前就失败的流式请求可能没有记录）。按同一份文档，发往个人端点的请求会先经过 Warp 的服务器。本指南按 Warp 的文档与更新日志，以及 Warp 开源仓库默认分支（master）上自定义端点设置的源码核对（2026-11-10；当天 Warp 下载链接提供的是稳定版 v0.2026.11.04.08.17.stable_01）。

## 先确认 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 的模型选择器中。填好的对话框如下：

`warp-custom-endpoint`

```text
# 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；在输出任何内容之前就失败的流式请求也可能没有日志。看客户端收到的状态码和错误消息就能区分是哪一种；先确认这一点，再判断是不是网关或上游故障。

## 常见问题

### Endpoint URL 填 <https://api.router.one/v1>，还是完整的 /chat/completions 路径？

填 <https://api.router.one/v1>。按 Warp 文档（2026-11-10 核对），Endpoint URL 是暴露 /v1/chat/completions 的 base URL，文档里的 ngrok 示例地址也以 /v1 结尾，所以不要再加 /chat/completions。地址必须是 HTTPS 的公网主机：按 Warp 的设置源码，没有 https:// 或指向 localhost、内网地址的 URL 不会被保存。

### 我的 Router One Key 会经过 Warp 的服务器吗？

传输途中会。按 Warp 的 custom inference endpoint 文档（2026-11-10 核对），选中端点模型后，提示词、上下文、端点地址和 Key 会经过 Warp 的服务器发往 Router One；Warp 不保留这把 Key，配置保存在本机，Key 放在安全存储里。同一份文档还说明，经自定义端点发出的请求，Warp 无法保证零数据保留；网关这一侧的规则见 Router One 的数据保留页（/data-retention）。建议为 Warp 单独建一把设了 maxSpend 上限的 Key，删除端点后到控制台 → API 密钥吊销它。

### 加了 Router One 之后，Warp 为什么还在消耗 Warp credits？

通常是因为选的是 Auto 模型或自定义路由器。按 Warp 文档（2026-11-10 核对），即使配置了端点，Auto 模型仍使用 Warp 提供的推理，自定义路由器也只能指向 Warp 支持的模型，所以要在模型选择器里选 Router One 的模型或它的别名。Warp 的其他 AI 功能使用各自的推理配置；Business 与 Enterprise 套餐在本地运行时使用端点，仍会产生平台费用。

### Warp 能通过网关用哪些模型？

选用当前目录中同时支持 Warp 所用端点和所需功能的模型。精确 ID、当前单价与能力以 /models 及模型详情为准；不要仅按 GPT、Claude 等系列名判断兼容性。客户端能列出模型，只说明它从自身配置或 GET /v1/models 读到了这个 ID，仍需验证实际调用。

### 能列出模型，但调用报 400 或 404，怎么办？

先记录实际请求路径和错误消息，再核对精确模型 ID。400 可能是参数、工具类型或模型与端点不匹配；404 可能是请求路径或资源不存在，不能直接判定模型下线。若错误提示 must be called via，按它指明的端点调整客户端 provider，或换用支持当前端点的模型。不要在所有工具里统一增删 /v1 或 /chat/completions。

### 中国大陆能直连吗？

Router One 的端点在中国大陆可直连、无需 VPN，但用 Warp 时，你的电脑连的并不是这个端点：按 Warp 的 custom inference endpoint 文档（2026-11-10 核对），发往个人端点的请求经由 Warp 的服务器转发，所以 Warp 仍需像平时一样连上 Warp 自己的服务，这一段 Router One 改变不了。Router One 钱包的支付宝充值见 /alipay-llm-api。

### 报 401/402/403/429 怎么排查？

先看客户端收到的响应：状态码、错误消息和 X-Request-ID 响应头。401（Key 缺失、不存在、已吊销或已过期）、402（钱包余额不足，或这把 Key 达到 maxSpend 上限）以及 Key 或账户自身限额触发的 429，都在调用任何模型之前被拒绝，不会出现在控制台 → 日志里；模型 ID 或端点写错导致的 400 / 404 也一样。401 查 Key 是否完整传入、在控制台 → API 密钥里是否仍有效；402 充值或调高这把 Key 的 maxSpend；403 请保留完整错误消息。429 请退避后重试；日志里能查到的 429 是网关重试之后上游仍返回的。保留 request_id，再按错误码速查页逐项排查。

## 相关页面

- 全部接入指南：https://router.one/zh/integrations
- Warp 的 API 错误排查：https://router.one/zh/llm-api-error-codes
- API 兼容性：端点与功能对照：https://router.one/zh/facts/api-compatibility.md
- Responses API 配置与限制：https://router.one/zh/codex-responses-api
- Cline 接入：https://router.one/zh/integrations/cline
- Aider 接入：https://router.one/zh/integrations/aider
- 通过网关使用工具调用：https://router.one/zh/llm-tool-calling
- Hermes Agent 接入：终端 Agent 的自定义端点：https://router.one/zh/integrations/hermes-agent
- 连接与 /v1 路径排查：https://router.one/zh/api-connection-troubleshooting
- 数据保留说明：https://router.one/zh/data-retention
- 支付宝充值：https://router.one/zh/alipay-llm-api
- Warp 官方文档：custom inference endpoint：https://docs.warp.dev/agents/inference/custom-inference-endpoint/
- Warp 更新日志（2026）：https://docs.warp.dev/changelog/2026/
- 统一 LLM API 网关概览：https://router.one/zh/llm-api-gateway
- OpenAI 兼容 API：https://router.one/zh/openai-compatible-api
- API 文档：https://router.one/zh/docs
- 本页规范地址：https://router.one/zh/integrations/warp
- 模型与每模型 token 价格：https://router.one/zh/models （markdown：https://router.one/zh/models.md ）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md