四种接口#
所有接口共用一个根地址 https://moerouter.com 和同一个 API Key。
| 接口 | 路径 | 认证 | 模型广场里的端点名 |
|---|---|---|---|
| OpenAI Chat Completions | POST /v1/chat/completions |
Authorization: Bearer <Key> |
openai |
| OpenAI Responses | POST /v1/responses |
Authorization: Bearer <Key> |
openai-response |
| Anthropic Messages | POST /v1/messages |
x-api-key: <Key>,或 Authorization: Bearer <Key> |
anthropic |
| Gemini 原生 | POST /v1beta/models/{模型}:generateContentPOST /v1beta/models/{模型}:streamGenerateContent |
x-goog-api-key: <Key>,或 ?key=<Key> |
gemini |
还有几个辅助接口:
| 接口 | 路径 | 说明 |
|---|---|---|
| 模型列表 | GET /v1/models |
返回当前 Key 能用的模型,不消耗额度。用 x-api-key 加 anthropic-version 请求时,按 Anthropic 的格式返回 |
| Token 计数 | POST /v1/messages/count_tokens |
Claude Code 用它估算上下文长度。由 MoeRouter 自己估算,不消耗额度 |
| 图像生成 | POST /v1/images/generations |
用于端点为 image-generation 的模型,按次计费 |
| 查询 Key 额度 | GET /api/usage/token |
见计费与额度 |
Responses 接口目前只提供 HTTP。客户端发起 WebSocket 握手时会收到 426 和“请改用 HTTP”的提示,Codex 会自动改走 HTTP。
模型和接口要配对#
不是每个模型都支持全部四种接口。一个模型支持哪些,写在模型广场卡片的“端点”一栏,GET /v1/models 返回的 supported_endpoint_types 里也有。
几个常见的例子:
| 模型 | Chat Completions | Responses | Messages | Gemini |
|---|---|---|---|---|
claude-opus-5-5、claude-sonnet-5-5、claude-haiku-4-5 |
— | — | 支持 | — |
claude-fable-5-2(stable 分组) |
支持 | — | 支持 | — |
gpt-6.1-sol、gpt-6-astra、gpt-6.1-terra |
支持 | 支持 | 支持 | — |
deepseek-v4-pro、gemini-3.8-flash、gemini-4-argon |
支持 | 支持 | 支持 | 支持 |
最常见的错配:用聊天客户端调用 Claude Opus 5.5。 大多数聊天客户端走 Chat Completions,而 claude-opus-5-5 只提供 Messages 接口,于是收到 404:
Model claude-opus-5-5 is not offered on OpenAI Chat Completions (/v1/chat/completions) for this API key.
Call it on: Anthropic Messages (/v1/messages).
解决办法有三个:
- 用 Claude Code,或者支持“Anthropic 格式”的客户端;
- 在聊天客户端里把接口类型选成 Anthropic(如果它支持);
- 换一个支持 Chat Completions 的模型,例如 stable 分组的
claude-fable-5-2,或者gpt-6-astra。
客户端里的地址怎么填#
客户端填的是“基础地址”,后面的路径由客户端自己拼。拼法不同,所以有的要带 /v1,有的不带:
| 客户端或 SDK | 基础地址 |
|---|---|
| OpenAI SDK、Codex、大多数聊天客户端 | https://moerouter.com/v1 |
| Anthropic SDK、Claude Code、Claude Desktop | https://moerouter.com |
| Gemini CLI、Google GenAI SDK | https://moerouter.com |
填错的典型现象是 404:路径变成了 /v1/v1/chat/completions,或者少了 /v1。
流式输出#
四种接口都支持流式输出,写法和各家官方接口一致:Chat Completions、Responses 和 Messages 在请求体里加 "stream": true,Gemini 用 :streamGenerateContent。
耗时长的请求请用流式。 非流式请求在模型生成完之前没有任何数据返回,等待超过一百秒左右,连接可能在中途被网络设备断开,表现为 524 或者连接重置。流式请求一直有数据在传,没有这个问题。
响应里的额外信息#
| 响应头 | 含义 |
|---|---|
X-Moe-Pricing-Policy |
这次请求的线路是怎么选的,见动态路由 |
Retry-After |
出现在 429 和部分 503 上:建议等这么多秒再重试 |
X-Oneapi-Request-Id |
这次请求的编号。向我们反馈问题时带上它,能直接定位到这一次请求 |
出错时的格式#
大多数错误是这个格式:
{
"error": {
"message": "Model gpt4 does not exist or is not offered to this API key (group default). GET /v1/models lists the models this key can use.",
"type": "new_api_error",
"code": "model_not_found"
}
}
code 是稳定的,适合在程序里判断;message 是给人看的,会说明原因和处理办法,末尾带着这次请求的编号。客户端带了中文的 Accept-Language,或者你在控制台把语言设成了中文时,message 是中文。
Messages 接口上,请求已经交给模型之后才出的错(限流、超时、内容被拒绝等)按 Anthropic 的格式返回,错误码在 error.type 里:
{
"type": "error",
"error": {
"type": "rate_limit_exceeded",
"message": "The request rate limit was reached. Reduce request frequency or concurrency and retry later."
}
}
每个错误码的含义见报错对照表。