MoeRouter 文档 获取 API Key

接口与协议

MoeRouter 提供 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 和 Gemini 原生四种接口。这一篇列出各接口的地址、认证方式,以及模型和接口的对应关系。

更新于 2026-11-15 阅读约 3 分钟 实测:2026-11-15 实际请求

本页目录
  1. 四种接口
  2. 模型和接口要配对
  3. 客户端里的地址怎么填
  4. 流式输出
  5. 响应里的额外信息
  6. 出错时的格式

四种接口#

所有接口共用一个根地址 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/{模型}:generateContent
POST /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."
  }
}

每个错误码的含义见报错对照表。

↑↓ 选择Enter 打开可以直接粘贴报错原文