常见问题
401 Unauthorized
- 检查是否携带
Authorization: Bearer <Key> - Key 是否已禁用 / 过期
- 是否误用了控制台 Session，而非 API Key
模型不存在 / model_not_found
- 到 模型广场 复制准确模型名
- 注意大小写、厂商前缀与连字符
- 该模型可能暂时下线或未对你的账号开放
超时 / 空响应
- 增大客户端超时（复杂推理模型可能较慢）
- 检查网络与是否走了错误代理
- 稍后重试；若持续失败，携带
request id（若有）联系支持
Base URL 怎么填？
text
https://api.hoyoai.cn/v1部分客户端要求「不要带 /v1」、部分要求「必须带」——以该客户端文档为准；报 404 时优先切换这两种写法试一次。
Claude Code / Cursor 连不上？
见 客户端集成：需把官方域名改成 HOYOAI，并配置对应协议（Chat / Messages 等）。
如何查看余额？
登录控制台 钱包。生产环境请以控制台余额为准；勿依赖未公开的第三方余额路径。
文档与官网
| 站点 | URL |
|---|---|
| 官网 | https://hoyoai.cn |
| 控制台 | https://api.hoyoai.cn |
| 文档 | https://docs.hoyoai.cn |