开始调用

将服务的 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 触发速率限制。请降低请求频率,或联系管理员调整限流策略。
余额不足 个人或令牌额度已耗尽。请在控制台查看剩余额度,或联系管理员充值。