外观
完成第一次 API 调用
本文说明如何使用刚创建的 API 密钥发送一次 OpenAI 兼容的文本请求，并在控制台查看结果。开始前请先完成注册和创建 API 密钥。
前置条件
- 已登录控制台。
- 已创建可用的 API 密钥，并保存在安全位置。
- 账户有可用 Quota；可在钱包查看。
先确认 API 地址和模型
API 地址和模型名称不是所有站点都相同，请优先使用控制台或站点提供的实际值。本文中的 YOUR_API_BASE_URL 和 YOUR_MODEL 只是占位符，不要原样复制。
| 占位符 | 需要替换成什么 |
|---|---|
YOUR_API_BASE_URL | 平台提供的基础 API 地址，例如包含 /v1 的地址。不要重复添加 /v1。 |
YOUR_API_KEY | 你在 API Keys 页面刚创建的完整密钥。 |
YOUR_MODEL | 当前账户可调用的模型名称，大小写和标点必须完全一致。 |
操作步骤
- 打开控制台的“API Keys”页面，复制刚创建的密钥。
- 从控制台提供的 API 地址中确认服务地址。若使用本平台示例地址，请替换为你的实际站点地址。
- 在本地终端执行以下请求。将
YOUR_API_KEY、YOUR_API_BASE_URL和YOUR_MODEL替换为自己的值：
bash
curl "YOUR_API_BASE_URL/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL",
"messages": [
{"role": "user", "content": "你好，请用一句话介绍自己。"}
]
}'- 请求成功后，终端会返回模型生成的内容。
- 打开控制台的使用记录，按最新时间查看这次调用；需要定位问题时记录“请求 ID”。
如何判断请求成功
- HTTP 状态码为成功状态，通常是
2xx。 - 返回正文中包含模型回答，而不是错误对象。
- 使用日志中出现对应的请求记录。
- 钱包或订阅额度出现与该调用相符的消费变化。
如果终端一直没有返回内容，先按API 调用失败排查检查地址、网络和请求格式，不要连续重复发送同一请求。
请求字段说明
| 字段 | 说明 |
|---|---|
Authorization | 请求认证信息。Bearer 后面跟 API 密钥，中间保留一个空格。 |
Content-Type | 声明请求正文为 JSON 格式。JSON 是一种常见的结构化文本格式。 |
model | 要调用的 AI 模型名称，必须是账户可用的模型。 |
messages | 对话消息列表。role: user 表示这是用户提出的问题。 |
常见复制错误
| 现象 | 原因 | 处理方式 |
|---|---|---|
| 返回 401 | API 密钥错误、缺少 Bearer 或复制了不完整的密钥 | 重新复制完整密钥并检查请求头。 |
| 返回 404 | API 地址路径或模型名称错误 | 使用站点提供的地址和可用模型名称。 |
| 返回 429 | 请求过快，触发 RPM、TPM 或并发限制 | 等待后降低请求速度，阅读频率限制。 |
| 返回余额不足 | 账户或密钥没有足够额度 | 查看钱包余额和订阅额度。 |
关键概念
| 关键词 | 含义和用途 |
|---|---|
| API 地址 | 你的程序发送请求的网络地址。客户端配置时通常也称为 Base URL 或基础地址。 |
| API 密钥 | 放在 Authorization 请求头中，用于认证调用身份的敏感凭证。 |
| 请求头 | 随请求发送的附加信息，例如身份认证和数据格式。 |
| JSON | 用大括号和字段名描述数据的文本格式，本例的请求内容就是 JSON。 |
| 请求 ID | 平台为一次调用生成的唯一编号，可用于在日志中查询请求。 |
提示
需要使用流式输出、处理错误或了解 Token 与限流规则时，继续阅读API 使用指南。