快速开始
通过 模驿API，一个 API Key 即可调用 Claude、GPT、Gemini、DeepSeek 等主流模型。请求按模型所属的协议发送，响应保持该协议的原始结构。
使用 模驿API API
- 在控制台创建 API Key（
sk-moyiapi-开头）。 - 发送第一个请求。以 Claude 为例：
curl https://api.moyiapi.cn/v1/messages \
-H "x-api-key: sk-moyiapi-xxxxxx" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "你好"}]
}'
Python：
import requests
resp = requests.post(
"https://api.moyiapi.cn/v1/messages",
headers={
"x-api-key": "sk-moyiapi-xxxxxx",
"anthropic-version": "2023-06-01",
"content-type": "application/json",
},
json={
"model": "claude-sonnet-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "你好"}],
},
)
print(resp.json()["content"][0]["text"])
TypeScript：
const resp = await fetch("https://api.moyiapi.cn/v1/messages", {
method: "POST",
headers: {
"x-api-key": "sk-moyiapi-xxxxxx",
"anthropic-version": "2023-06-01",
"content-type": "application/json",
},
body: JSON.stringify({
model: "claude-sonnet-5",
max_tokens: 256,
messages: [{ role: "user", content: "你好" }],
}),
});
const data = await resp.json();
console.log(data.content[0].text);
响应示例
{
"id": "msg_01KxDE...",
"type": "message",
"role": "assistant",
"model": "claude-sonnet-5",
"content": [{"type": "text", "text": "你好！有什么可以帮你的？"}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 9, "output_tokens": 12}
}
回复文本在 content 数组里 type 为 text 的块中。字段的完整说明见创建消息。
调用失败时返回 error 对象和顶层 trace_id，常见的是 401（API Key 无效）和 402（余额不足），对照表见错误码。
更换模型时需同时更换协议：Claude 用 Anthropic 原生格式，GPT 用 OpenAI 兼容格式，Gemini 用 Gemini 原生格式，完整对照见 API 概览。模型 ID 以 GET /v1/models 返回为准。
使用官方 SDK
将官方 SDK 的 api_key 设为 模驿API API Key、base_url 指向 模驿API，业务代码无需修改：Anthropic SDK 用 https://api.moyiapi.cn，OpenAI SDK 用 https://api.moyiapi.cn/v1，Google GenAI SDK 用 https://api.moyiapi.cn。各 SDK 示例见对应端点页：创建消息、创建对话补全、生成内容。
在 Agent 工具中使用
Claude Code、Codex、Cursor 等工具只需将 Base URL 与 API Key 改为 模驿API 的值，各工具的配置步骤见接入指南。