API Key 管理
1
进入控制台
打开 AIOAGI 控制台,登录你的账户。
2
创建密钥
在 令牌 页面创建新密钥,并为不同业务线使用不同密钥。
3
保存密钥
将密钥保存到服务端环境变量或密钥管理服务中,例如
AIO_API_KEY。令牌字段说明
string
required
建议使用业务名、环境名或目标模型名,例如
chat-prod-gpt4o、academic-claude 或 image-mj-test。datetime or never
测试 Key 建议设置较短有效期。长期服务可以使用更长有效期,但仍建议定期轮换。
number
单个令牌可使用的上限额度。额度用尽后,该 Key 会停止可用。DOCX 手册中给出了
500000 = 1 USD 的示例换算,实际显示以控制台为准。string
required
分组会影响可用模型、速度和费率。不同分组可访问的模型集合可能不同。
enabled or disabled
不再使用的 Key 建议及时禁用或删除,减少泄露风险。
令牌配置建议
- 生产、测试和个人实验使用不同 Key。
- 给每个业务线设置独立额度上限。
- 先确认分组支持目标模型,再把 Key 下发到客户端配置。
- 不要在截图、录屏或公开 issue 中展示完整 Key。
- 对短期协作场景使用临时 Key,而不是长期共享同一个 Key。
安全建议
- 不要把 API Key 写入前端代码。
- 不要把 API Key 提交到 Git 仓库。
- 为测试、生产和不同业务线使用不同密钥。
- 定期轮换密钥,并删除不再使用的密钥。
- 为企业团队配置独立 Token 组,限制可用额度。
余额与额度
余额查询
在控制台查看账户余额、消费记录和可用资源。
Token 组
按业务、团队或客户拆分额度,避免不同业务互相影响。
分组与模型
为什么分组很重要?
为什么分组很重要?
分组决定线路、可用模型和倍率。你在聊天应用或 SDK 中选不到某个模型时,先检查 Key 所属分组是否支持它。
什么时候需要新建一个 Key?
什么时候需要新建一个 Key?
当你要隔离预算、隔离环境、切换模型族或给不同成员分配额度时,都应该新建独立 Key。
官网说明余额查询与部分实时语音能力使用
api-s1.aiearth.dev 或 api-s1.aiearth.vip 系列端点。具体接口以控制台和开发者指南为准。