MoeRouter 兼容四种接口。已有的代码通常只要改两处:接口地址和 Key。
OpenAI SDK#
地址写 https://moerouter.com/v1,带 /v1。模型要选端点带 openai 的。
# pip install openai
import os
from openai import OpenAI
client = OpenAI(
base_url="https://moerouter.com/v1",
api_key=os.environ["MOEROUTER_API_KEY"],
)
# 普通请求
reply = client.chat.completions.create(
model="gpt-6.1-terra",
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(reply.choices[0].message.content)
# 流式输出
stream = client.chat.completions.create(
model="gpt-6.1-terra",
messages=[{"role": "user", "content": "写一首四行小诗"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
// npm install openai
import OpenAI from 'openai'
const client = new OpenAI({
baseURL: 'https://moerouter.com/v1',
apiKey: process.env.MOEROUTER_API_KEY,
})
// 普通请求
const reply = await client.chat.completions.create({
model: 'gpt-6.1-terra',
messages: [{ role: 'user', content: '用一句话介绍你自己' }],
})
console.log(reply.choices[0].message.content)
// 流式输出
const stream = await client.chat.completions.create({
model: 'gpt-6.1-terra',
messages: [{ role: 'user', content: '写一首四行小诗' }],
stream: true,
})
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? '')
}
# 端点带 openai-response 的模型可以用 Responses 接口
reply = client.responses.create(
model="gpt-6.1-sol",
input="用一句话介绍你自己",
)
print(reply.output_text)
Anthropic SDK#
地址写 https://moerouter.com,不带 /v1,SDK 会自己拼上 /v1/messages。模型要选端点带 anthropic 的。
# pip install anthropic
import os
from anthropic import Anthropic
client = Anthropic(
base_url="https://moerouter.com",
api_key=os.environ["MOEROUTER_API_KEY"],
)
message = client.messages.create(
model="claude-haiku-4-5",
max_tokens=1024,
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(message.content[0].text)
// npm install @anthropic-ai/sdk
import Anthropic from '@anthropic-ai/sdk'
const client = new Anthropic({
baseURL: 'https://moerouter.com',
apiKey: process.env.MOEROUTER_API_KEY,
})
const message = await client.messages.create({
model: 'claude-haiku-4-5',
max_tokens: 1024,
messages: [{ role: 'user', content: '用一句话介绍你自己' }],
})
console.log(message.content[0].text)
不只是 Claude 模型:gpt-6.1-terra、deepseek-v4-pro 这些端点带 anthropic 的模型,也可以用 Anthropic SDK 调用。
直接发 HTTP 请求#
curl -sS https://moerouter.com/v1/chat/completions \
-H "Authorization: Bearer $MOEROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-6.1-terra", "messages": [{"role": "user", "content": "你好"}]}'
curl -sS https://moerouter.com/v1/responses \
-H "Authorization: Bearer $MOEROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-6.1-sol", "input": "你好"}'
curl -sS https://moerouter.com/v1/messages \
-H "x-api-key: $MOEROUTER_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model": "claude-haiku-4-5", "max_tokens": 256, "messages": [{"role": "user", "content": "你好"}]}'
curl -sS "https://moerouter.com/v1beta/models/gemini-3.8-flash:generateContent" \
-H "x-goog-api-key: $MOEROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents": [{"role": "user", "parts": [{"text": "你好"}]}]}'
每种接口的认证方式和路径见接口与协议。
聊天客户端#
从控制台一键导入#
控制台的 API 密钥 页,每个 Key 右侧的 ⋯ → 聊天 里列出了可以一键导入的客户端,包括 Cherry Studio、AionUI、DeepChat、Lobe Chat、OpenCat 等。点一下就会打开对应的应用并带上地址和 Key。

手动填写#
客户端里一般有三个字段:
| 字段 | 填写 |
|---|---|
| 接口类型 | OpenAI 兼容(有的写“OpenAI”“自定义”) |
| API 地址(Base URL) | https://moerouter.com/v1。如果客户端说明里写着“不需要 /v1”,就填 https://moerouter.com |
| API Key | 你的 MoeRouter Key |
模型 ID 从模型广场复制,选端点带 openai 的模型。客户端支持“获取模型列表”时,它读的是 /v1/models,只会列出这个 Key 所在分组能用的模型。
有用的细节#
让同一段对话走同一条线路#
多轮对话时,在请求体里带一个固定的 prompt_cache_key,或者在请求头里带 X-Session-Id。MoeRouter 会让同一个会话优先留在上次成功的线路上,上游的提示词缓存才能命中。缓存命中的部分,价格通常只有正常输入的十分之一左右,有的模型更低。
reply = client.chat.completions.create(
model="deepseek-v4-pro",
messages=history,
extra_headers={"X-Session-Id": "chat-7f3a"}, # 同一段对话用同一个值
)
原理和规则见会话亲和与缓存。
看这次请求是怎么选线路的#
模型请求的响应里都带一个 X-Moe-Pricing-Policy 响应头:
| 值 | 含义 |
|---|---|
dynamic-lowest-cost |
选了当前可用线路里最便宜的一条 |
dynamic-session-affinity |
沿用了这个会话上次成功的线路 |
dynamic-long-context-preference |
输入很长,选了更适合长上下文的线路 |
raw = client.chat.completions.with_raw_response.create(
model="gpt-6.1-terra",
messages=[{"role": "user", "content": "你好"}],
)
print(raw.headers.get("x-moe-pricing-policy"))
列出模型#
curl -sS https://moerouter.com/v1/models -H "Authorization: Bearer $MOEROUTER_API_KEY"
返回这个 Key 能用的模型,每一项的 supported_endpoint_types 是它支持的接口。不消耗额度。
用 Key 查询额度#
curl -sS https://moerouter.com/api/usage/token -H "Authorization: Bearer $MOEROUTER_API_KEY"
返回这个 Key 的 total_granted(总额度)、total_used(已用)、total_available(剩余)、是否无限额度和过期时间。数值是内部额度单位,500,000 单位等于 1 美元,控制台按 1 美元 = 7.3 元换算成人民币显示。
Key 的高级设置里开启了“允许查询额度”时,返回里还有 user_quota,是整个账户的剩余额度和已用额度。
错误怎么处理#
出错时响应体是 {"error": {"message": …, "type": …, "code": …}}。code 是稳定的,可以用来判断该怎么处理。Messages 接口上,上游返回的错误按 Anthropic 的格式给出:{"type": "error", "error": {"type": …, "message": …}}。
429、503且带Retry-After响应头:等这么多秒再重试。400、404:请求本身要改,重试没有用。提示里会说明该改什么。
完整列表见报错对照表。