Skip to content

鉴权

HOYOAI 使用 Bearer Token(API Key)鉴权。

请求头

http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

获取 Key

  1. 登录 https://api.hoyoai.cn
  2. 进入 令牌 / API Keys
  3. 创建并复制密钥

常见错误

HTTP原因处理
401Key 无效、过期或未传检查 Authorization 头与 Key 状态
403权限不足或账号受限检查令牌范围 / 账号状态
429触发限流降频或稍后重试

安全建议

  • Key 只放在服务端环境变量或密钥管理中
  • 前端页面不要硬编码 Key
  • 泄露后立即在控制台禁用并重新创建

HOYOAI · OpenAI 兼容 AI API