API Key 放在哪里？
API Key 必须放在服务端环境变量或密钥管理系统中。不要把 Key 写入前端代码、移动端包体、公开文档或 Git 仓库。为什么 OpenAI SDK 可以直接调用？
AIOAGI 提供 OpenAI 兼容接口。你通常只需要替换base_url 和 api_key，并把 model 改为控制台支持的模型名称。
如何查看可用模型？
你可以在控制台查看模型列表，也可以调用GET /models 获取当前 Key 可访问的模型。
请求失败时先检查什么？
Authorization是否为Bearer sk-...格式。base_url是否包含/v1。- 模型名称是否与控制台一致。
- 账户余额或 Token 组额度是否充足。
- 请求体是否为合法 JSON。
出现 Failed to fetch 怎么办？
按以下顺序排查：
- 检查当前令牌分组是否支持所选模型。
- 刷新页面，重新打开聊天窗口，再发起一次请求。
- 检查应用设置中的接口地址和 API Key 是否正确。
- 切换网络环境，确认是否需要开启或关闭代理/VPN。
- 如果是浏览器应用，检查控制台是否有跨域、网络或证书错误。
Codex 返回 Unexpected status 403 Forbidden 怎么办？
如果你在 Codex 中看到类似下面的报错，通常先检查本地网络和代理环境：
- 检查代理或 VPN 状态。先确认是否开启了 VPN，再尝试切换为关闭状态；如果当前未开启，也可以反向测试开启后再重试。
- 重置本地网络环境。必要时重启网络连接，并重启电脑后再试一次。
- 检查 Codex 中配置的
base_url和 API Key 是否正确，确认请求地址仍为可用的 OpenAI 兼容接口。端点和支持策略可能变化，请以控制台和开发者指南显示的信息为准。 - 重装codex，删除.codex目录文件后重装codex（证实有效）。
- 如果以上尝试后仍无法恢复，请通过微信联系 AIOAGI 获取技术支持，并提供报错时间、请求地址、模型名称和完整错误信息，便于定位问题。
密码重置链接无法访问怎么办？
如果邮件中的重置链接只有相对路径，例如/user/reset?...，请在前面补上控制台域名：
为什么 GPT-4 类模型说自己是 GPT-3？
模型的自我描述不一定可靠。它可能沿用训练语料中的旧身份描述，也可能被客户端提示词影响。判断模型是否生效时，优先看控制台模型配置、请求日志和实际能力测试。 如果你需要验证模型，可以使用几类测试问题：- 常识纠错，例如“鲁迅和周树人是什么关系？”
- 多步推理，例如时间关系、数量变化和条件推断。
- 业务样例，例如让模型处理你真实场景中的代码、论文段落或结构化输出。
是否支持余额查询和实时语音？
官网说明余额查询和实时语音 API 使用api-s1.aiearth.dev 或 api-s1.aiearth.vip 相关端点。具体路径和参数请以控制台及开发者指南为准。
免费体验是否等于免费 API？
不是。平台可能提供免费聊天或学术智能体体验入口，但这不代表 API 调用免费。API 调用仍以账户余额、令牌额度和控制台费率为准。如何获得技术支持？
你可以通过官网、控制台、开发者指南和服务社区获取支持。官网首页展示的支持入口包括 CSDN 企业社区、Link3 Link Hub、QQ 技术支持群和微信咨询。企业用户可联系官方展示的客服渠道咨询批量接入、资源包和售后方案。QQ 群和微信信息可以直接写进代码吗？
不要。QQ 群、微信、商城商品和企业服务政策都可能变化。建议在文档里说明入口和用途，具体联系方式以官网首页最新展示为准。如何判断是平台问题还是本地配置问题？
先按这个顺序排查：- 查看 服务状态与支持 中的官网和控制台入口。
- 检查控制台余额和令牌额度。
- 检查 Key 分组是否支持目标模型。
- 检查客户端端点和
/v1路径。 - 换网络或代理环境重试。
- 携带请求时间、模型名、端点、错误码和请求 ID 联系支持。