控制台
API 密钥
在生产控制台创建、限制、保存和撤销 InfiniteX API 密钥
这一步能完成什么
创建一个只满足当前任务所需的 API 密钥，并理解名称、分组、额度、有效期、模型和 IP 限制的实际作用。
前置条件
- 已登录 InfiniteX 普通用户账号。
- 已从模型广场和可用渠道确定本次任务需要的协议与模型范围。
- 准备本机受信任的密钥管理方式；文档和截图不保存完整 Key。
准确入口
创建最小权限 Key
- 点击“创建 API 密钥”。
- 名称：使用能说明客户端或短期任务的名称，不写邮箱、项目机密或真实 Token。
- 分组：选择当前页面提供且与可用渠道匹配的分组。
auto只在生产当前提供时使用；它的跨分组重试会扩大可尝试范围。 - 到期时间：临时测试选择短有效期；长期客户端也应设置可轮换周期。
- 数量：首次只创建
1个。 - 关闭“无限额度”，填写足够完成当前最小请求的低额度。
- 展开“高级设置”，把模型限制收敛到实际需要的模型。
- 只有在调用端有稳定出口 IP 时才填写 IP 白名单；支持逐行 IP/CIDR。动态网络填错会导致合法请求被拒绝。
- 保存后只在本机安全位置读取和保存完整 Key；不要通过截图、聊天、文档或 issue 传递。
字段影响
| 字段 | 最小权限做法 | 失败表现 |
|---|---|---|
| 名称 | 标识客户端或用途 | 不影响鉴权，但模糊名称妨碍撤销 |
| 分组 | 只选当前需要且可用的分组 | 模型不可见或无可用渠道 |
| 到期时间 | 短期测试设短有效期 | 到期后返回认证失败 |
| 有限额度 | 只给当前任务所需预算 | 用尽后拒绝继续调用 |
| 模型限制 | 只允许必要模型 | 其他模型返回权限/模型错误 |
| IP 白名单 | 仅在稳定出口 IP 时启用 | 来源 IP 不匹配时被拒绝 |
| 跨分组重试 | 仅 auto 分组且确有需要时启用 | 可能扩大路线和计费差异 |
成功结果
列表中出现新 Key，名称、分组、剩余额度、到期时间、模型限制和 IP 限制与表单一致；完整 Key 默认不应长期明文显示。
常见错误
- 保存按钮无效：检查名称、额度和分组是否满足表单校验。
- Key 能看到模型但请求失败：核对 endpoint、可用渠道、IP 白名单和额度。
- 为排障开启无限额度：不要这样做；先保留 request ID 并定位具体限制。
- 复制错 Key：通过名称和创建时间确认目标，测试后删除临时 Key。
安全与计费
API 密钥代表账号调用权限。有限额度是 Key 级预算，不等同于账号钱包余额；请求仍按生产实时价格计费。怀疑泄露时立即删除 Key，而不是只修改名称。
下一步
完成第一次 API 请求。
最后更新于