GET /v1/account/balance

查询当前账户的 T 币余额、单张成本、key 限流。请求前预检很有用。

响应(200)

{
  "user_id": "cmnxqxxxxxxxxxxxx",
  "balance_tcoin": 482,
  "cost_per_image_tcoin": 2,
  "rate_limit": {
    "rpm": 60,
    "daily_max": 5000
  }
}

示例

curl

curl https://aiimg.top/v1/account/balance \
  -H "Authorization: Bearer $AIIMG_API_KEY"

预检逻辑(Python)

import os, requests

r = requests.get(
    "https://aiimg.top/v1/account/balance",
    headers={"Authorization": f"Bearer {os.environ['AIIMG_API_KEY']}"},
).json()

cost = r["cost_per_image_tcoin"] * 4  # 想生 4 张
if r["balance_tcoin"] < cost:
    raise SystemExit(f"余额不够，需 {cost}，剩 {r['balance_tcoin']}")