外观
API Key
ArcAI 只有一种 Key:组织 API Key。它属于当前组织、由创建它的成员持有,调用费用从该组织钱包扣除。
创建 Key
进入 API 密钥 → 创建密钥:
| 字段 | 说明 |
|---|---|
| 名称 | 便于在 Trace 和用量中识别,例如 support-agent、ci-bot |
| 分组 | 决定能调用的模型和价格倍率,必选 |
| 额度上限 | 这个 Key 的累计消费上限,可选,默认不限 |
| 过期时间 | 可选,默认永久有效 |
| IP 白名单 / 黑名单 | 每行一个 IP 或 CIDR,可选 |
保管好 Key
Key 等同于组织钱包的支付凭证。不要提交到代码仓库,不要发在聊天群里。泄露后请立即在控制台禁用或删除。
使用密钥
在 Key 列表点 使用密钥,会按 Key 所在分组生成对应客户端的配置(环境变量或配置文件),可以直接复制。
列表上方的 API 端点 显示当前可用的 Base URL。
管理 Key
- 启用 / 禁用:临时停用某个 Key,不影响其他 Key。
- 更换分组:点分组名称即可切换。
- 批量编辑:勾选多个 Key,统一修改额度、过期时间或 IP 名单。
- 删除:删除后不可恢复。
谁能管理哪些 Key:
- Member 只能管理自己创建的 Key。
- Owner 和 Admin 可以管理全组织的 Key。
Key 额度上限
- 达到上限后该 Key 的新请求会被拒绝。
- 已用金额不能重置。需要更多额度时调高上限即可。
- 上限只是限制,不会单独划拨资金。
如果想按"人"而不是按"Key"控制花费,用 成员额度。
查询 Key 用量
除了控制台的 使用记录,还可以在首页的 Key 用量查询页输入 Key 查看消费情况。Key 只在浏览器本地处理,不会被保存。
待确认
Key 用量查询页是否在线上开放、入口在哪。