API 密钥
在控制台创建、查看、编辑和删除 API 密钥(令牌),设置额度、过期时间、模型范围和 IP 白名单。
API 密钥(令牌)在控制台左侧菜单「API 密钥」页管理:https://ai.myaiexp.com/keys。页面以表格展示每个密钥的名称、状态、掩码密钥、额度(剩余与已用)、可用模型、IP 限制、创建与最后使用时间、过期时间等信息。
列表上方可以按名称或密钥搜索,按状态(如已启用、已禁用、已过期、已耗尽)筛选,并选择要显示的列。
创建 API 密钥
- 打开「API 密钥」,点击「创建 API 密钥」,会打开创建表单。
- 填写名称,按需设置过期时间和一次创建的数量。
- 设置额度:可以选择不限额度(只受账户余额限制),也可以关闭后填写额度上限(美元)。
- 需要限制范围时,在高级设置里选择允许的模型、填写 IP 白名单。
- 保存。新密钥会出现在列表里。
配置项说明
| 选项 | 作用 | 建议 |
|---|---|---|
| 名称 | 仅用于你自己区分 | 按项目命名,如 blog-bot |
| 过期时间 | 到期后密钥自动失效,默认永不过期;可以快速选择常用时长,也可以自选日期和时间 | 临时给外部协作者的密钥务必设置过期时间 |
| 数量 | 一次创建多个密钥,名称会自动添加后缀 | 批量分发给多人时使用 |
| 额度(USD) | 该密钥最多能花多少;不限额度时只受账户余额限制 | 给自动化脚本、第三方工具单独设一个较小的额度 |
| 模型限制 | 选择允许调用的模型,留空表示允许所有 | 想防止误用高价模型时设置,例如只允许某个低价模型 |
| IP 白名单 | 只允许来自指定 IP 的请求,支持 CIDR 表达式 | 服务端有固定出口 IP 时建议开启 |
如果表单里出现「分组」选项,保持默认即可。可调用的模型以该密钥调用 GET /v1/models 的返回为准。
API 密钥等同于密码。不要把完整密钥提交到代码仓库、截图、日志或聊天工具;怀疑泄露时应立即删除并创建新密钥。
查看和复制密钥
列表里的密钥默认以掩码显示(例如 sk-AbCd**********WxYz):
- 点击掩码密钥,可以查看完整值。
- 点击掩码右侧的复制图标,直接复制完整密钥。
- 「操作」列的菜单里也有复制密钥的入口;还有「复制连接信息」,会把密钥和服务地址一起复制,供支持导入的客户端使用。
调用时使用的 Base URL:
- OpenAI SDK / OpenAI 兼容客户端:
https://ai.myaiexp.com/v1 - Anthropic SDK / Claude Code:
https://ai.myaiexp.com(不带/v1)
编辑、禁用和删除
在列表的「操作」列:
- 编辑:修改名称、额度、过期时间、模型限制等配置(密钥本身不会变)。
- 禁用:保留配置,立即停止调用;之后可以重新启用。
- 删除:删除后该密钥立即失效,无法恢复。
勾选多行后可以批量删除。操作菜单里的「CC Switch」可以把密钥一键导入本机的 CC Switch,见 CC Switch 接入。
查看密钥和剩余额度
控制台的密钥列表直接显示已用额度、总额度和使用比例(以美元显示)。也可以用接口查询当前密钥:
# 查询当前密钥的额度(单位为「额度」,500000 额度 = 1 美元)
curl -sS https://ai.myaiexp.com/api/usage/token/ \
-H "Authorization: Bearer $MYAIEXP_API_KEY"返回示例:
{
"code": true,
"data": {
"name": "my-first-key",
"total_granted": 2500000,
"total_used": 1825,
"total_available": 2498175,
"unlimited_quota": false,
"expires_at": 0,
"model_limits_enabled": false
},
"message": "ok"
}字段单位是「额度」,total_available / 500000 即剩余美元数;expires_at 为 0 表示永不过期。
安全建议
- 一个项目一个密钥,泄露后只需删除那一个。
- 不要把 Key 写进前端代码或提交到仓库;放在服务端环境变量里。
- 发现异常消耗,先在控制台禁用或删除该密钥,再到 使用日志 排查来源。
本服务仅供学习与研究用途。请遵守各模型提供方的使用政策。