开始调用
将服务的 base_url 与令牌配置到你的客户端或代码中,即可像调用 OpenAI 官方 API 一样发起请求。
认证方式
所有接口均使用 Bearer Token 认证。在 HTTP 请求头中加入:
Authorization
Authorization: Bearer sk-xxxxxx
其中 sk-xxxxxx 替换为你在控制台复制的 API Key。请求地址中的 base_url 请使用当前 API 服务地址(通常形如 https://your-api-domain.com/v1)。
最小可运行示例
以下示例以聊天接口(Chat Completions)为例,替换对应的 base_url 与 api_key 即可直接运行。
cURL
Bash
curl https://your-api-domain.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxxx" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"}
]
}'
Python
Python
from openai import OpenAI
client = OpenAI(
base_url="https://your-api-domain.com/v1",
api_key="sk-xxxxxx"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"}
]
)
print(response.choices[0].message.content)
接口分类速查
系统兼容多种格式,点击下面对应分类查看详细接口说明、请求参数与返回示例。
查看可用模型
在调用前,你可以通过 列出模型 接口获取当前可用的模型列表,确保传入的 model 参数有效。
常见错误排查
| 状态码 / 现象 | 可能原因与处理 |
|---|---|
| 401 Unauthorized | API Key 错误、已删除或已过期。请检查 Authorization 头的 Bearer Token 是否完整正确。 |
| 403 Forbidden | IP 不在白名单内,或该分组/模型对你不可用。请检查令牌配置与账户权限。 |
| 429 Too Many Requests | 触发速率限制。请降低请求频率,或联系管理员调整限流策略。 |
| 余额不足 | 个人或令牌额度已耗尽。请在控制台查看剩余额度,或联系管理员充值。 |