Appearance
认证方式
好用 AI 使用 Bearer Token 认证,与 OpenAI API 一致。
请求头
http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json将 YOUR_API_KEY 替换为在控制台创建的密钥。
安全建议
- 仅在后端使用 Key,不要写入前端 JavaScript、移动端安装包或公开 Git 仓库。
- 使用环境变量注入 Key,例如
OPENAI_API_KEY或自定义HAOYONG_API_KEY。 - 定期轮换 Key;泄露后立即在控制台删除并新建。
- 为不同环境(开发 / 生产)使用不同 Key,便于隔离与吊销。
错误码说明
| HTTP 状态 | 含义 |
|---|---|
| 401 | 未提供 Key、Key 无效或已删除 |
| 403 | 无权限或账户状态异常(如余额不足) |
| 429 | 请求过于频繁,请稍后重试 |
测试 Key 是否有效
bash
curl -s https://api.haoyong-ai.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"返回模型列表即表示认证成功(具体响应格式以实际部署为准)。