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-01
  • content-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)
401Key 无效重新复制 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 数和费用;「钱包」页显示余额。也可以给每个令牌单独设置额度上限。

相关教程

还没有 API Key?

在 TokenMilo 注册、充值,一分钟内就能在控制台创建 Key。

获取 API Key 查看全部模型