Claude API 接入指南(Anthropic 原生接口)
TokenMilo 提供与 Anthropic 官方完全一致的 Messages 接口。官方文档里的请求格式、SDK 和功能都能直接使用,只需要换 Base URL 和 Key。
更新于 2026-11-16
一、接口地址
| Base URL(SDK / 工具里填写) | https://api.tokenmilo.com |
| Messages 接口 | POST https://api.tokenmilo.com/v1/messages |
| Token 计数 | POST https://api.tokenmilo.com/v1/messages/count_tokens |
二、鉴权
在 控制台的「令牌」页面创建 Key,请求时放在请求头里:
x-api-key: sk-...(Anthropic 官方方式),或Authorization: Bearer sk-...anthropic-version: 2023-06-01content-type: application/json
三、快速开始(curl)
curl https://api.tokenmilo.com/v1/messages \
-H "x-api-key: $TOKENMILO_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "用一句话介绍你自己"}]
}'带 system 提示词和多轮对话
{
"model": "claude-opus-5-5",
"max_tokens": 2048,
"system": "你是一名资深 Python 工程师,回答简洁。",
"messages": [
{"role": "user", "content": "怎么读取一个大 CSV 文件?"},
{"role": "assistant", "content": "可以用 pandas 的 chunksize 分块读取。"},
{"role": "user", "content": "给个示例代码"}
]
}四、Python 与 Node.js
Python
# pip install anthropic
import os, anthropic
client = anthropic.Anthropic(
base_url="https://api.tokenmilo.com", # 不要带 /v1
api_key=os.environ["TOKENMILO_API_KEY"],
)
# 普通调用
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)
print(msg.usage) # input_tokens / output_tokens / cache_read_input_tokens ...
# 流式调用
with client.messages.stream(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "讲个笑话"}],
) as s:
for text in s.text_stream:
print(text, end="", flush=True)Node.js
// npm i @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
baseURL: "https://api.tokenmilo.com",
apiKey: process.env.TOKENMILO_API_KEY,
});
const msg = await client.messages.create({
model: "claude-opus-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "你好" }],
});
console.log(msg.content[0].text);五、流式输出
请求体加上 "stream": true,返回 SSE 事件流(message_start、content_block_delta、message_stop 等),和官方一致。
curl https://api.tokenmilo.com/v1/messages \
-H "x-api-key: $TOKENMILO_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-N -d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"stream": true,
"messages": [{"role": "user", "content": "写一首关于秋天的短诗"}]
}'六、提示词缓存(省钱关键)
把长而固定的内容(系统提示词、文档、代码)标记为可缓存,后续请求命中缓存的部分按缓存读取价计费,比普通输入便宜约 90%。
{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"system": [
{
"type": "text",
"text": "<这里放很长的固定内容:文档、代码库说明、规则……>",
"cache_control": {"type": "ephemeral"}
}
],
"messages": [{"role": "user", "content": "根据上面的文档回答:……"}]
}默认缓存 5 分钟;需要更长可设置 "cache_control": {"type": "ephemeral", "ttl": "1h"}。在 TokenMilo,1 小时缓存写入和 5 分钟同价。响应里的 usage.cache_read_input_tokens 显示命中的 token 数。
七、工具调用(Function Calling)
{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"tools": [{
"name": "get_weather",
"description": "查询城市天气",
"input_schema": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}],
"messages": [{"role": "user", "content": "上海今天天气怎么样?"}]
}模型需要调用工具时会返回 stop_reason: "tool_use" 和 tool_use 内容块,你执行工具后把结果以 tool_result 发回即可。
八、常见错误码
| 状态码 | 含义 | 处理 |
|---|---|---|
| 400 | 请求格式错误 | 检查 JSON、必填字段(model、max_tokens、messages) |
| 401 | Key 无效 | 重新复制 Key,确认没有多余空格 |
| 403 | 额度不足或无权使用该模型 | 充值,或检查令牌的额度和可用模型设置 |
| 404 | 路径或模型不存在 | Base URL 不要重复 /v1;模型 ID 以模型列表为准 |
| 429 | 请求过于频繁 | 降低并发,指数退避重试 |
| 5xx / 529 | 上游暂时繁忙 | 稍后重试 |
常见问题
x-api-key 和 Authorization: Bearer 都可以吗?
都可以。Anthropic SDK 默认发送 x-api-key;部分工具(如 Claude Code 使用 ANTHROPIC_AUTH_TOKEN 时)发送 Authorization: Bearer,TokenMilo 两种都支持。
支持图片输入、工具调用、扩展思考吗?
支持。TokenMilo 转发的是 Anthropic 原生 Messages 接口,请求体按 Anthropic 官方文档写即可,模型支持的功能都能用。
怎么查用量和余额?
控制台的「日志」页有每次请求的模型、token 数和费用;「钱包」页显示余额。也可以给每个令牌单独设置额度上限。
相关教程
- 快速开始 — 几分钟拿到 Key 并发出第一个请求。
- OpenAI 兼容接口指南 — 用 OpenAI SDK 调用 Chat Completions 与 Responses。
- Claude Code 中转配置教程 — 在 macOS、Linux、Windows 上用 TokenMilo 的 Key 跑 Claude Code。
- Codex CLI 中转配置教程 — 通过自定义 provider 让 Codex CLI 使用 GPT-6。
- Cursor 接入教程 — 用自己的 Key 在 Cursor 里添加 Claude 和 GPT 模型。