anbalu OpenAI 帮助中心
返回官网

OpenAI 接入帮助

这是一个面向终端用户的 OpenAI 兼容接入说明,帮助你用最少步骤完成 API Key、Base URL 和请求测试。

适用范围

本页仅说明 OpenAI-compatible 接口的基本接入方式,不包含其它模型协议或进阶计费说明。

Step 1 注册 / 登录

先打开 anbalu 控制台完成注册或登录,确保你能进入个人控制台页面并查看 API 管理入口。

  1. 访问官网并登录你的账号。
  2. 首次使用时,先确认账号状态正常,可进入控制台。
  3. 后续所有 OpenAI 兼容调用都基于你自己的 API Key 进行鉴权。

Step 2 创建 API Key

登录后,在控制台创建一个新的 API Key。创建后请立即保存,避免丢失。

  • 建议为不同项目分别创建 Key,方便后续排查调用来源。
  • 不要把 Key 直接写进公开仓库、前端源码或聊天截图。
  • 如果怀疑泄露,请在控制台中禁用旧 Key 并重新生成。

Step 3 Base URL

OpenAI 兼容客户端通常需要填写 Base URL。将下方地址填入你的 SDK、插件或第三方客户端。

Base URL
https://api.anbalu.top/v1

大多数客户端只需要填写到 /v1 这一层,不需要手动补更深路径。

Step 4 客户端配置

把你创建的 API Key 和 Base URL 填入客户端即可开始调用。

必填项

  • API Key:控制台生成的密钥
  • Base URL:https://api.anbalu.top/v1
  • 模型名:按你当前可用模型填写

常见注意点

  • 如果客户端有“自定义 Host”或“API Endpoint”,优先填 Base URL。
  • 若支持 OpenAI 模式切换,请选择 OpenAI 或 OpenAI-compatible。
  • 请求头里需要带上 Authorization: Bearer YOUR_KEY

Step 5 测试请求

如果你想先验证链路是否通畅,可以直接使用下面的示例请求。

请求地址
https://api.anbalu.top/v1/chat/completions
curl 示例
curl https://api.anbalu.top/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "你好,请返回一条测试消息"}
    ]
  }'

如果请求返回正常 JSON,说明你的 Key、网络和 Base URL 都已经配置正确。

Step 6 常见错误

下面这些状态码是接入阶段最常见的几类问题,可以先按对应方向排查。

  • 401:通常表示 API Key 无效、漏传或格式错误。
  • 402:通常表示账号额度、余额或服务状态需要检查。
  • 429:通常表示请求过快、并发过高或触发限流。
  • 502:通常表示上游服务暂时异常,建议稍后重试。
  • 503:通常表示服务暂时不可用,建议等待后再次请求。