积分

MuAPI 使用积分系统计量 API 用量。积分需要提前购买，并在每次生成时扣除。

你的积分钱包

每个账户都有一个独立的积分钱包。你可以在控制台查看余额。

  • 积分永不过期。
  • 所有 AI 生成任务都会在生成时扣除积分。
  • 文件上传免费，但要求余额大于 0。

查询余额

通过 API：

GET /api/v1/account/balance
x-api-key: YOUR_API_KEY

响应：

{ "balance": 42.50 }

通过 CLI：

muapi account balance

充值

  1. 前往控制台 → 账单 → 添加积分。
  2. 选择金额并完成 Stripe 结账。
  3. 支付成功后，积分会立即添加到你的钱包。

通过 API：

POST /api/v1/account/topup
{ "amount": 20 }

接口会返回 Stripe 结账 URL。

API 响应中的单次请求成本

每个生成 API 响应都会返回本次请求实际从钱包扣除的成本：

{
  "request_id": "abc123",
  "status": "processing",
  "cost": {
    "amount_usd": 0.0042,
    "amount_credits": 1,
    "bonus_credits_used": 0,
    "refunded": false
  }
}

响应头中也会提供相同信息（X-MuAPI-Cost-USD、X-MuAPI-Cost-Credits、X-MuAPI-Cost-Bonus-Credits），以及 X-Account-Balance，方便 Agent 在无需轮询余额端点的情况下追踪支出。详见API 参考 → 单次请求成本。

用量历史

你可以在控制台查看完整的用量日志。每条记录包含：

  • 使用的模型和调用的端点
  • 扣除的积分
  • 请求 ID 和时间戳
  • 输入参数和输出 URL

免费积分

新账户会获得少量免费积分，用于开始体验。

另请参阅

积分 — Muapi Docs