个人管理 API

个人管理 API 面向脚本、内部面板和自动化工具。第一版支持：

• 查询账户余额
• 获取可用分组与用户倍率
• 拉取、创建、查看、修改和删除 API Key
• 查询单个 API Key 的 Usage 明细、汇总和每日趋势

创建管理密钥

登录 MuskAI 后，进入 API 密钥 页面，在“个人管理 API”卡片中创建密钥。

管理密钥以 sk-mgmt- 开头，完整内容只在生成时显示一次。数据库只保存哈希，平台之后无法再次展示原文。

:::warning 高权限凭证 管理密钥可以查看余额并管理账户下的全部 API Key。不要把它填写到 Claude Code、Codex、Cherry Studio 等模型客户端，也不要与普通推理 API Key 混用。 :::

基础地址与鉴权

BASE_URL="https://muskapi.cc/api/v1/management"
MANAGEMENT_KEY="sk-mgmt-..."

所有请求使用 Bearer 鉴权：

Authorization: Bearer sk-mgmt-...
Content-Type: application/json

成功响应统一使用以下外层结构，实际结果位于 data：

{
  "code": 0,
  "message": "success",
  "data": {}
}

接口总览

方法	路径	用途
GET	/balance	查询余额
GET	/groups/available	查询可绑定分组
GET	/groups/rates	查询当前用户的分组倍率
GET	/api-keys	分页拉取 API Key
POST	/api-keys	创建 API Key
GET	/api-keys/{id}	查看一个 API Key
PUT	/api-keys/{id}	修改 API Key 属性
DELETE	/api-keys/{id}	删除 API Key
GET	/api-keys/{id}/usage	查询请求级 Usage
GET	/api-keys/{id}/usage/stats	查询 Usage 汇总
GET	/api-keys/{id}/usage/daily	查询每日 Usage 趋势

查询余额

curl "$BASE_URL/balance" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

返回包括普通余额 balance、返佣余额 commission_balance、活动余额 activity_balance 和积分余额 points_balance。

拉取 API Key 列表

curl "$BASE_URL/api-keys?page=1&page_size=20&status=active&search=production" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

可用查询参数：

参数	说明
page / page_size	分页，page_size 最大 1000
search	按名称或 Key 搜索，最多 100 个字符
status	状态筛选
group_id	分组 ID；先通过 /groups/available 获取

创建 API Key

curl -X POST "$BASE_URL/api-keys" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "production-bot",
    "group_id": 12,
    "quota": 20,
    "rate_limit_1d": 5,
    "expires_in_days": 90,
    "ip_whitelist": ["203.0.113.10"]
  }'

创建时常用字段：

字段	类型	说明
name	string	必填，Key 名称
group_id	number/null	旧版单分组绑定
group_bindings	array	按 openai、anthropic、gemini 协议配置分组与优先级
cross_group_retry_enabled	boolean	是否按绑定优先级跨分组重试
custom_key	string	可选自定义 Key；批量创建时不可用
count	number	一次创建 1–100 个
quota	number	总消费额度，美元；0 表示不限
rate_limit_5h / rate_limit_1d / rate_limit_7d	number	各时间窗消费限制，美元；0 表示不限
expires_in_days	number	多少天后过期
ip_whitelist / ip_blacklist	string[]	IP 或 CIDR 列表
openai_reasoning_summary_disabled	boolean	禁用 OpenAI 推理摘要请求
openai_degraded_retry_enabled	boolean	启用 OpenAI 异常推理重试

多协议绑定示例：

{
  "group_bindings": [
    {"protocol": "openai", "group_id": 12, "position": 0},
    {"protocol": "openai", "group_id": 18, "position": 1},
    {"protocol": "anthropic", "group_id": 9, "position": 0}
  ],
  "cross_group_retry_enabled": true
}

修改 API Key 属性

curl -X PUT "$BASE_URL/api-keys/123" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "production-bot-v2",
    "status": "active",
    "quota": 50,
    "rate_limit_1d": 8,
    "expires_at": "2026-12-31T23:59:59Z",
    "ip_whitelist": ["203.0.113.10", "198.51.100.0/24"]
  }'

更新接口支持创建接口中的可变属性，并额外支持：

• status: active 或 inactive
• expires_at: RFC 3339 时间；传空字符串可清除有效期
• reset_quota: true: 将累计额度用量重置为 0
• reset_rate_limit_usage: true: 重置时间窗限额用量

未传字段保持不变。group_bindings 传空数组不是“保持不变”；如果只想修改名称或限额，请不要发送该字段。

查询单个 Key 的 Usage

请求级明细：

curl "$BASE_URL/api-keys/123/usage?page=1&page_size=50&start_date=2026-08-01&end_date=2026-08-11&timezone=Asia%2FShanghai" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

可选筛选包括 model、request_type、billing_type、start_date、end_date、timezone 和 exact_total。

区间汇总：

curl "$BASE_URL/api-keys/123/usage/stats?start_date=2026-08-01&end_date=2026-08-11&timezone=Asia%2FShanghai" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

每日趋势（1–90 天，默认 30 天）：

curl "$BASE_URL/api-keys/123/usage/daily?days=30&timezone=Asia%2FShanghai" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

平台会校验 {id} 是否属于当前管理密钥对应的用户，不能跨用户读取或修改 Key。

轮换与撤销

在 MuskAI 的 API 密钥 → 个人管理 API 卡片中可以重新生成或撤销密钥：

• 重新生成后，旧密钥立即失效。
• 撤销后，所有管理 API 请求立即返回 401。
• 自动化程序应从密钥管理器或环境变量读取密钥，不要提交到 Git。