本页目录
创建
- 登录后进入控制台 › API Keys。
- 点击「新建 Key」，填写名称（建议用途 + 环境，例如
web-prod）。 - 按需选择可用模型、折扣与线路和有效期，保存。
- 复制完整 Key —— 关闭弹窗后无法再次查看，丢失只能重新创建或轮换。
Key 的构成
Key 是一串随机字符，本身不携带账号信息。列表里只显示前缀和末 4 位，方便你核对是哪一把。禁用、删除或过期后立即失效，无需等待缓存过期。
可配置的限制
可用模型全部 / 指定模型选「指定模型」后，这把 Key 只能调用勾选的模型；调用其他模型返回 403 API_KEY_MODEL_DENIED，不影响其他 Key。
折扣与线路档位这把 Key 按哪一档价格计费、走哪类线路。默认跟随账号设置。
归属项目项目把 Key 归到某个项目下，用量统计时可以按项目区分。
有效期日期到期自动失效，之后的请求返回 401（API token has expired）。适合给外包或临时合作方用。
保管方式
注意
不要把 Key 写进前端代码、移动端包体或公开仓库。浏览器里任何人都能读到你的请求头；一旦泄露，任何人都可以用你的余额调用模型。
- 服务端读取环境变量或密钥管理服务，前端只调用你自己的后端。
- 不同环境用不同 Key（
dev/staging/prod），出问题只需吊销一把。 - 在 CI 里用仓库 Secret 注入，不要提交
.env。
bash
# 本地开发：写进 shell 配置，不要写进代码
export APIONE_API_KEY="YOUR_APIONE_KEY"
# 校验是否可用（返回 200 即为有效）
curl -s -o /dev/null -w "%{http_code}\n" \
https://api.apione.ai/v1/models \
-H "Authorization: Bearer $APIONE_API_KEY"轮换与吊销
建议每 90 天轮换一次。安全的顺序是：先创建新 Key → 灰度切换服务 → 观察用量迁移完成 → 再删除旧 Key。删除是立即生效且不可恢复的操作；若只是暂时停用，用「禁用」而不是删除。
相关
- API Key 管理：多环境与团队场景的组织方式。
- Reference › 鉴权：请求头与错误响应。
联系我们
文档没写清楚，或者需要人工协助？按问题类型选一个渠道即可。