国内怎么调用 Claude API?Python / Node.js 接入示例与报错排查
国内直接调用 Anthropic 官方 Claude API,要过注册、海外支付、封号和网络四道坎。本文给出大陆直连调用 Claude 的完整代码:Anthropic SDK、OpenAI SDK、流式输出与 curl,以及每个报错码的含义和处理方法。
天机云 TIANJI CLOUD · 更新于
想在自己的程序里接入 Claude,最直接的办法是调用 Anthropic 官方 API。但在国内,这条路有几道坎:
- Anthropic 的官方服务不对中国大陆开放,账号注册和验证经常失败。
- 官方 API 要绑海外信用卡充值,国内银行卡付不了。
- 账号可能因为登录地区、支付方式或 IP 被封,已经跑在线上的服务会直接中断。
- 服务器在国内时,连海外接口延迟高、偶发超时,需要自己处理网络。
天机云大模型 API 与 Anthropic 官方接口格式兼容,同时兼容 OpenAI 格式。不需要官方账号和海外信用卡,大陆直连,代码里只改两处:接口地址和 Key。一个 Key 还能同时调用 GPT、Gemini、DeepSeek 等其他模型。
准备
| 项目 | 填写 |
|---|---|
| Anthropic 格式接口地址 | https://ai.tianjiyun.org(不带 /v1) |
| OpenAI 格式接口地址 | https://ai.tianjiyun.org/v1 |
| API Key | 在天机面板新建,tj- 开头 |
| 模型 ID | 厂商/模型,例如 anthropic/claude-sonnet-5.5。完整列表在面板「模型」页 |
调用前先在面板把天机云余额转入大模型余额,也可以开启自动转入。
Python:Anthropic 官方 SDK
流式输出
Python:OpenAI SDK
项目里已经在用 OpenAI SDK 的,不用换库:地址改成带 /v1 的那个,模型 ID 换成 Claude 的即可。同一段代码换个模型 ID 就能调 GPT 或 DeepSeek。
Node.js
curl 快速测试
Windows 用户可以直接复制面板「接入文档」分页里按系统分好的测试命令。
报错码速查
| 状态码 | 含义 | 处理 |
|---|---|---|
| 400 | 请求不是合法 JSON,或模型 ID 不可用 | 检查请求体;到面板「模型」页复制完整模型 ID |
| 401 | Key 无效 | 确认 Key 完整、未撤销,前后没有空格 |
| 402 | 大模型余额不足,或 Key 达到花费上限 | 转入余额、开启自动转入,或调高 Key 上限;max_tokens 过大也会触发,可适当调小 |
| 403 | Key 已暂停或账户不可用 | 到面板查看 Key 状态 |
| 413 | 请求体过大 | 压缩图片、减少一次塞进去的内容 |
| 429 | 同一账户同时进行的请求太多 | 按响应里的 retry-after 稍后重试 |
| 502 / 503 | 服务暂时不可用 | 稍后重试;生产代码建议加自动重试 |
上线到生产环境前
- 对 429 和 5xx 做指数退避重试,两家官方 SDK 都自带重试参数(max_retries)。
- 每个服务、每个环境单独建一个 Key,各自设花费上限,出问题只停一个。
- max_tokens 按实际需要设置。调用前会按最大可能花费预先冻结余额,设得过大容易因余额不足被拒。
- Key 放在环境变量或密钥管理里,不要写进代码仓库。
想看每个模型的价格、怎么估算花费,见大模型 API 怎么计费;用 Claude Code 写代码见Claude Code 国内怎么用。
常见问题
和直接用官方 API 有什么区别?
接口格式与官方兼容,模型能力由各模型厂商提供。区别是:大陆可以直接访问,不需要官方账号和海外信用卡,也就不存在官方账号被封的问题;一个 Key 能调用所有主流模型,统一用天机云余额结算。
Claude API 价格怎么算?
按每次调用的实际 Token 用量计费,输入和输出分开计价,没有月费和最低消费。各模型美元参考价在面板「天机云大模型 → 模型」页。
支持工具调用(function calling)和图片输入吗?
支持。具体模型是否支持,以面板「模型」页的「工具调用」「图片输入」标记为准。
会保存我发送的内容吗?
不会。天机云只记录调用时间、模型、Token 数和花费等计费信息,不保存你的提问和模型的回答。