拿到 API Key 之后怎么用？3 分钟跑通第一次调用
更新于 2026-09-23
在把 Key 填进各种工具之前，先用最简单的方式确认它能用。这样出了问题你能分清是 Key 的问题，还是工具配置的问题。
先搞清两个值
- 接口地址（base URL）：中转站给的地址，OpenAI 兼容格式一般以
/v1结尾。 - Key：在站点后台「令牌」页新建。令牌可以设额度上限和可用分组，新手建议设一个小额上限。
还要知道你想用的模型名，从站点的模型列表或价格页复制，不要自己手打。
OpenAI 兼容格式：一条 curl 测通
绝大多数中转站都提供 OpenAI 兼容接口。Mac 终端或 Windows 的 Git Bash 里执行：
curl https://你的中转站地址/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{"model": "模型名", "messages": [{"role": "user", "content": "你好"}]}'返回一段 JSON，里面 choices 有回复内容，就说明通了。
用 Python 调用
装好官方 SDK（pip install openai）后，只需在创建客户端时改 base_url：
from openai import OpenAI
client = OpenAI(
base_url="https://你的中转站地址/v1",
api_key="sk-你的令牌",
)
resp = client.chat.completions.create(
model="模型名",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)Claude 原生格式
Claude Code 等工具用的是 Anthropic 原生格式（/v1/messages），请求头也不同。如果站点支持，可以这样测：
curl https://你的中转站地址/v1/messages \
-H "x-api-key: sk-你的令牌" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model": "模型名", "max_tokens": 256, "messages": [{"role": "user", "content": "你好"}]}'是否支持原生格式、地址要不要加路径，以站点说明为准。
常见报错对照
| 现象 | 多半是 |
|---|---|
| 401 / invalid key | Key 复制错、多了空格，或令牌已被禁用 |
| 404 | 地址路径错了，常见是 /v1 重复或缺失 |
| 模型不存在 / 无可用渠道 | 模型名不对，或令牌所在分组没有这个模型 |
| 额度不足 | 余额用完，或令牌设置的额度上限到了 |
| 429 | 请求太频繁被限流，等一会儿再试 |
每次调用后去站点后台的使用日志看一眼：用的哪个模型、消耗多少 token、扣了多少钱，和价格页对得上才放心。
常见问题
- API Key 怎么获取？
- 在中转站注册后进入后台的令牌（Token）页面新建即可，一般以 sk- 开头。新建时可以限制额度和分组。
- base_url 要不要带 /v1？
- OpenAI 兼容格式通常带 /v1，但不同工具拼接方式不同，有的工具会自动补 /v1。报 404 时先检查这里。