Amux AI

sub2api 格式

最近更新：2026年10月29日

兼容 sub2api 用量接口，用于以「Sub2API」类型接入的 new-api 及 cc-switch 等工具查询余额。

兼容 sub2api 用量接口，适用于以下场景：

  • new-api 以「Sub2API」类型接入本平台时的渠道余额查询；
  • cc-switch 等工具的余额查询。
GEThttps://gateway.amux.ai/v1/usage

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> 控制台创建的 Amux 密钥。忘了可以回控制台的密钥页再看一次。

响应

200response

余额信息。

401response

密钥缺失或无效。

模式

mode含义返回的余额字段
unrestricted仅受账户余额约束remaining、balance
quota_limited受密钥或工作区消费限额约束remaining

remaining 为当前密钥的可用额度，单位为美元。

可用额度不受限时，不返回 remaining 与 balance。sub2api 以 -1 表示不限额，但 new-api 会将 -1 视为实际余额，因此本平台省略这两个字段。

限制

sub2api 仅对 OAuth 账号及部分官方厂商的密钥查询余额。以 API 密钥账号方式将本平台接入 sub2api 时，sub2api 不会发起余额查询。

cURL
curl https://gateway.amux.ai/v1/usage \
  -H "Authorization: Bearer $AMUX_API_KEY"
{
  "isValid": true,
  "mode": "unrestricted",
  "planName": "Amux",
  "unit": "USD",
  "remaining": 48.25,
  "balance": 48.25
}