OpenAI 接入帮助
这是一个面向终端用户的 OpenAI 兼容接入说明,帮助你用最少步骤完成 API Key、Base URL 和请求测试。
适用范围
本页仅说明 OpenAI-compatible 接口的基本接入方式,不包含其它模型协议或进阶计费说明。
Step 1 注册 / 登录
先打开 anbalu 控制台完成注册或登录,确保你能进入个人控制台页面并查看 API 管理入口。
- 访问官网并登录你的账号。
- 首次使用时,先确认账号状态正常,可进入控制台。
- 后续所有 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:通常表示服务暂时不可用,建议等待后再次请求。