快速开始：5 分钟首次调用
适用角色：开发者 更新日期：2026-07-14
本文带你从零开始，在 5 分钟内完成第一次 API 调用，看到模型返回的回复。
API 地址为
YOUR_API_BASE_URL，路由前缀/v1，认证用Authorization: Bearer sk-xxx。你也可以在控制台「API 密钥」页查看当前可用的 Base URL。
前置条件
开始之前，确认你已经：
- ✅ 拥有一个平台账号（组织账号自行注册，或子用户用激活码完成注册）
- ✅ 账号有可用余额 / 额度（真实扣费始终扣所属组织的余额；额度为 0 时请联系所属组织）
第一步：拿到 API Key
v2 下 API Key 由主用户在控制台创建：
-
如果你是主用户：
- 登录 控制台
- 进入「API 密钥」页面
- 点击「创建 API Key」，给它起个名字（如
my-first-key），可选绑定一个路由分组（不绑则走默认路由） - 创建后立即复制保存 Key（形如
sk-xxxxxxxx），它只完整显示一次
-
如果你是子用户：你可在「API 密钥」页自助创建 Key（路由分组限主用户授权范围）；也可由主用户代建分发。
子用户可在「API 密钥」页自助创建 Key（路由分组可选，只能在主用户授权范围内选）；主用户也可代建分发。
⚠️ API Key 等同密码，请勿提交到代码仓库或公开分享。
拿到 Key 后，你还需要确定 model 字段写什么——见下一步。
第二步：获取模型调用名
登录控制台后，在「调用指南」页查看可用模型并复制调用名（如 claude-sonnet-4-6）。也可在模型广场或通过 /v1/models API 获取。大多数场景下直接使用模型名称即可。
如果主用户开启了分组标识路由，「调用指南」页还会额外显示带分组标识的调用名（如 5MHXZWKA/gpt-4o），可点名到指定分组。未开启时带分组标识前缀的调用会被拒绝。
路由规则详见 调用指南与路由说明。本文示例以模型名称为例。
第三步：发送第一个请求（curl）
把下面命令里的 YOUR_API_KEY 换成你的 Key，model 换成你从调用指南复制的调用名，在终端执行：
curl YOUR_API_BASE_URL/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{"role": "user", "content": "用一句话介绍你自己"}
]
}'如果一切正常，你会收到类似这样的响应：
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"model": "claude-sonnet-4-6",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "我是一个 AI 助手，可以帮你解答问题、编写代码、处理文本。"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 20,
"total_tokens": 32
}
}恭喜，你已经完成第一次调用！
第四步：用 Python 调用
更贴近真实开发，用官方 OpenAI SDK（只需改 base_url 和 api_key）：
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="YOUR_API_BASE_URL"
)
resp = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[
{"role": "user", "content": "用一句话介绍你自己"}
]
)
print(resp.choices[0].message.content)安装依赖：pip install openai
常见快速排错
| 现象 | 可能原因 | 解决 |
|---|---|---|
401 Unauthorized |
Key 错误或没填 Bearer |
检查 Authorization 头格式 |
403 / 余额或额度不足 |
所属组织余额为 0，或子用户额度封顶 | 联系所属组织充值 / 上调额度 |
| 模型不可用 / 找不到 | 调用名写错，或不在你账户的可用范围内 | 去调用指南复制调用名，确认可用范围 |
| 带分组标识报"分组不可达" | 该分组不在可用范围或渠道不可用，或分组标识路由未开启 | 见 调用指南与路由说明 |
429 |
限额/限流耗尽 | 降低请求频率，见 错误码与排障 |
完整错误码见 错误码与排障。