余额

http

GET https://modelgo-web-api.modelgo.ai/api/openapi/v1/user/balance
Authorization: Bearer mgpat_xxxxxxxx
X-Tenant-Id: <tenant_id>        # 可选

响应字段（单租户）

字段	说明
`tenant_id`	实际读取的租户
`is_active`	账户是否可用
`is_personal`	是否个人租户（个人租户只有一个 owner；组织租户为 `false`）
`balance` / `available`	真正可消费金额 = cash + grant + rebate；桶值已扣减冻结
`reserved`	预授权冻结金额（不要从 balance 再减一次）
`main` / `gift` / `reward`	cash / grant / rebate 三个桶的可用余额
`total`	`used + available + reserved`；仅 owner/admin 返回
`used`	全时段累计消耗（Σ charge）；仅 owner/admin 返回
`currency`	结算币种
`updated_at`	余额账本最近一次变动时间（cash 账户）
`balance_status`	`ok` / `insufficient` / `arrears` / `partial` / `unavailable`

balance 已经包含赠送与返佣余额，且不扣除冻结；reserved 单独展示。

不传 X-Tenant-Id

返回该账号所有有权限租户的余额列表：

json

{
  "items": [
    { "tenant_id": "tnt_a", "balance": "10.00", "used": "2.00", "total": "12.00", "balance_status": "ok" },
    { "tenant_id": "tnt_b", "balance": "0", "balance_status": "insufficient" }
  ]
}

按 tenant_id 排序；没有权限的租户不会出现；某个租户读取失败时该项 balance_status=unavailable 且不填金额。