API 密钥

在控制台创建、查看、编辑和删除 API 密钥(令牌),设置额度、过期时间、模型范围和 IP 白名单。

API 密钥(令牌)在控制台左侧菜单「API 密钥」页管理:https://ai.myaiexp.com/keys。页面以表格展示每个密钥的名称、状态、掩码密钥、额度(剩余与已用)、可用模型、IP 限制、创建与最后使用时间、过期时间等信息。

列表上方可以按名称或密钥搜索,按状态(如已启用、已禁用、已过期、已耗尽)筛选,并选择要显示的列。

创建 API 密钥

  1. 打开「API 密钥」,点击「创建 API 密钥」,会打开创建表单。
  2. 填写名称,按需设置过期时间和一次创建的数量。
  3. 设置额度:可以选择不限额度(只受账户余额限制),也可以关闭后填写额度上限(美元)。
  4. 需要限制范围时,在高级设置里选择允许的模型、填写 IP 白名单。
  5. 保存。新密钥会出现在列表里。

配置项说明

选项作用建议
名称仅用于你自己区分按项目命名,如 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 接入。

查看密钥和剩余额度

控制台的密钥列表直接显示已用额度、总额度和使用比例(以美元显示)。也可以用接口查询当前密钥:

usage.sh
# 查询当前密钥的额度(单位为「额度」,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 写进前端代码或提交到仓库;放在服务端环境变量里。
  • 发现异常消耗,先在控制台禁用或删除该密钥,再到 使用日志 排查来源。

本服务仅供学习与研究用途。请遵守各模型提供方的使用政策。

本页目录