配置指南
3 分钟上手蓝天
创建 API 密钥,选择当前实例开放的模型,发送第一条请求。
获取 API Key
在代码中调用 API
本机后端的 OpenAI 兼容基础地址为 http://localhost:18081/v1。远程部署时应替换为你部署的后端域名。
curl http://localhost:18081/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"你好"}]}'将 YOUR_API_KEY 和 YOUR_MODEL_ID 替换为实际密钥和当前分组提供的模型。密钥不要写入浏览器公开代码或提交到代码仓库。
检查模型目录
curl http://localhost:18081/v1/models -H "Authorization: Bearer YOUR_API_KEY"如果目录为空,需要管理员先在 sub2api 配置上游账户和分组。没有上游账户时,创建密钥并不会自动开通模型。
调用没有成功?
| 状态 | 检查项目 |
|---|---|
| 401 | 确认密钥有效,并使用 Bearer 认证。 |
| 400 / 404 | 确认请求路径、JSON 格式和模型调用 ID。 |
| 429 | 查看账户额度、并发限制和重试响应信息。 |
| 5xx | 检查上游账户状态,保留请求 ID 以便排查。 |