MoeRouter 文档 获取 API Key

SDK 与聊天客户端

用 OpenAI SDK、Anthropic SDK 或直接发 HTTP 请求调用 MoeRouter,以及把 Key 一键导入 Cherry Studio 等聊天客户端。含流式输出、查询余额和读取路由信息的写法。

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

本页目录
  1. OpenAI SDK
  2. Anthropic SDK
  3. 直接发 HTTP 请求
  4. 聊天客户端
  5. 从控制台一键导入
  6. 手动填写
  7. 有用的细节
  8. 让同一段对话走同一条线路
  9. 看这次请求是怎么选线路的
  10. 列出模型
  11. 用 Key 查询额度
  12. 错误怎么处理

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。

API 密钥的操作菜单,里面有“聊天”子菜单
“复制连接信息”会复制地址和 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:请求本身要改,重试没有用。提示里会说明该改什么。

完整列表见报错对照表。

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