اعتبار

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

免费اعتبار

新账户会获得少量免费اعتبار，用于开始体验。

另请参阅