常见问题（FAQ）
本文按用户最常遇到的场景整理，覆盖认证、模型、计费、兼容性、网络稳定性五大类问题。
认证与密钥
1. 我怎么创建 API 密钥？
- 登录控制台
https://anideaai.com/console - 进入「令牌」页面点击新建
- 复制以
sk-开头的密钥并立即保存
2. 返回 401（未授权）时怎么排查？
- 检查请求头是否包含
Authorization: Bearer sk-xxxxx - 确认没有把
Bearer写漏或多了空格 - 在控制台确认密钥未过期、未禁用
3. 一个账号可以创建多个密钥吗？
可以。建议按环境拆分：开发、测试、生产分别使用不同密钥，方便隔离风险与定位问题。
4. 密钥泄露了该怎么处理？
- 立刻在控制台禁用旧密钥
- 新建密钥并更新业务配置
- 回查最近日志，确认是否有异常调用
5. 为什么我有密钥但仍然返回 403（禁止访问）？
常见原因：模型权限不足、分组权限不匹配、IP 白名单不通过或账户额度不足。优先检查密钥绑定的权限配置。
模型与调用
6. 怎么查看当前可用模型？
调用 GET https://anideaai.com/v1/models，以实时返回结果为准。
7. 请求提示模型不存在怎么办？
- 先调用
/v1/models确认模型名 - 检查大小写和后缀是否一致
- 确认当前密钥对该模型有访问权限
8. 同一个任务应该选什么模型？
实操建议：
- 先按任务类型粗分（对话、向量、图像、音频）
- 在 Playground 对比 2 到 3 个候选模型
- 以质量、时延、成本三项结果决定主模型
9. 为什么模型偶尔变慢？
可能是上游拥塞、请求高峰、输入过长。建议在高峰期给关键业务配置备选模型，并启用重试策略。
计费与额度
10. AnideaAI 怎么计费？
按调用量计费，常见为输入与输出分别计价。具体价格以 https://anideaai.com/pricing 和控制台实时数据为准。
11. 余额充足但请求失败，可能是什么原因？
除了余额，还可能命中：
- 分组限额
- 订阅窗口限额（5 小时/日/周/月）
- 模型频率限制
12. 如何查看我的消费明细？
- 控制台查看用量统计
- 按时间、模型、密钥维度筛选
- 结合请求日志定位异常消耗来源
13. 月卡车辆和按量计费有什么区别？
月卡车辆适合稳定团队协作，按量计费更适合波动业务。月卡更强调座位共享和周期配额管理。
兼容性与迁移
14. 我从 OpenAI 迁移要改哪些地方？
通常只改两项：
- 基础地址改为
https://anideaai.com/v1 - API 密钥改为 AnideaAI 控制台签发的密钥
15. 现有 SDK 代码要重写吗？
大多数情况下不需要。OpenAI 兼容的请求结构可直接复用，重点检查 base_url 与模型名。
16. 从其他中转平台迁移会踩什么坑？
高频问题：
- 沿用了旧平台的私有模型名
- 旧平台自定义请求头未清理
- 旧平台的地址是否带
/v1与当前不一致
17. 哪些工具可以直接接入？
常见编码工具、聊天客户端、开发框架基本都可接入，关键是填对基础地址、密钥和模型名。
网络与稳定性
18. 返回 429（频率限制）怎么处理？
- 读取错误码确认是全局限制、模型限制还是并发限制
- 若有
Retry-After，按该秒数等待 - 使用指数退避重试，避免瞬时回冲
19. 返回 5xx（服务错误）怎么处理？
- 记录
request_id或trace_id - 先做 2 到 3 次退避重试
- 持续失败时提交工单并附上请求编号
20. 海外或公司内网访问不稳定怎么办？
- 先检查本地 DNS 与代理策略
- 减少单次输入体积，降低超时概率
- 给关键请求设置超时与重试，不要无限等待
21. 流式输出中断是什么原因？
常见于网络抖动、连接超时、客户端读取逻辑异常。建议在客户端增加断线重连和输出片段拼接。
22. 如何提高生产环境稳定性？
- 主模型 + 备选模型双路配置
- 分环境、分业务拆分密钥与分组
- 为关键接口配置监控告警（错误率、超时率、429 比例）