国内怎么调用 Claude API?Python / Node.js 接入示例与报错排查

国内直接调用 Anthropic 官方 Claude API,要过注册、海外支付、封号和网络四道坎。本文给出大陆直连调用 Claude 的完整代码:Anthropic SDK、OpenAI SDK、流式输出与 curl,以及每个报错码的含义和处理方法。

天机云 TIANJI CLOUD · 更新于

想在自己的程序里接入 Claude,最直接的办法是调用 Anthropic 官方 API。但在国内,这条路有几道坎:

天机云大模型 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

pip install anthropic
import anthropic

client = anthropic.Anthropic(base_url="https://ai.tianjiyun.org", api_key="tj-你的Key")
msg = client.messages.create(
    model="anthropic/claude-sonnet-5.5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

流式输出

Python
with client.messages.stream(
    model="anthropic/claude-sonnet-5.5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "写一首关于秋天的短诗"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Python:OpenAI SDK

项目里已经在用 OpenAI SDK 的,不用换库:地址改成带 /v1 的那个,模型 ID 换成 Claude 的即可。同一段代码换个模型 ID 就能调 GPT 或 DeepSeek。

pip install openai
from openai import OpenAI

client = OpenAI(base_url="https://ai.tianjiyun.org/v1", api_key="tj-你的Key")
resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-5.5",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js

npm install @anthropic-ai/sdk
import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({ baseURL: 'https://ai.tianjiyun.org', apiKey: 'tj-你的Key' });
const msg = await client.messages.create({
  model: 'anthropic/claude-sonnet-5.5',
  max_tokens: 1024,
  messages: [{ role: 'user', content: '你好' }],
});
console.log(msg.content[0].text);

curl 快速测试

终端
curl https://ai.tianjiyun.org/v1/messages \
  -H "x-api-key: tj-你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"anthropic/claude-sonnet-5.5","max_tokens":256,"messages":[{"role":"user","content":"你好"}]}'

Windows 用户可以直接复制面板「接入文档」分页里按系统分好的测试命令。

报错码速查

状态码含义处理
400请求不是合法 JSON,或模型 ID 不可用检查请求体;到面板「模型」页复制完整模型 ID
401Key 无效确认 Key 完整、未撤销,前后没有空格
402大模型余额不足,或 Key 达到花费上限转入余额、开启自动转入,或调高 Key 上限;max_tokens 过大也会触发,可适当调小
403Key 已暂停或账户不可用到面板查看 Key 状态
413请求体过大压缩图片、减少一次塞进去的内容
429同一账户同时进行的请求太多按响应里的 retry-after 稍后重试
502 / 503服务暂时不可用稍后重试;生产代码建议加自动重试

上线到生产环境前

想看每个模型的价格、怎么估算花费,见大模型 API 怎么计费;用 Claude Code 写代码见Claude Code 国内怎么用。

常见问题

和直接用官方 API 有什么区别?

接口格式与官方兼容,模型能力由各模型厂商提供。区别是:大陆可以直接访问,不需要官方账号和海外信用卡,也就不存在官方账号被封的问题;一个 Key 能调用所有主流模型,统一用天机云余额结算。

Claude API 价格怎么算?

按每次调用的实际 Token 用量计费,输入和输出分开计价,没有月费和最低消费。各模型美元参考价在面板「天机云大模型 → 模型」页。

支持工具调用(function calling)和图片输入吗?

支持。具体模型是否支持,以面板「模型」页的「工具调用」「图片输入」标记为准。

会保存我发送的内容吗?

不会。天机云只记录调用时间、模型、Token 数和花费等计费信息,不保存你的提问和模型的回答。

← 全部文章