参数
| 参数 | 必填 | 取值 |
|---|---|---|
| （无参数） | — | 不需要任何入参，也不消耗额度 |
返回什么
quota_usd 剩余额度（美元）、used_usd 已用累计、group 与 group_zh 是账户所属分组（国内平台与海外平台分组独立开通）、is_admin 标记管理员账户。
典型用法：先算预算再开跑
批量任务常见的做法是：先 check_balance 拿余量，再用单次均价估一遍这批任务要花多少，不够就分批跑。比「跑到一半发现没钱」省事得多。
配额和密钥的关系
同一账户下的所有密钥共用账户余额——不是每把密钥各有一份额度。如果你确实想给某把密钥单独设上限，可以在控制台给它填一个正数额度，此时以该上限为准。
复制即可运行
cURL
curl -s https://lucydomi.com/mcp/v1/check_balance \
-H "Authorization: Bearer $BUSYBEE_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{}'Python（标准库）
import os, json, urllib.request
KEY = os.environ["BUSYBEE_API_KEY"]
req = urllib.request.Request(
"https://lucydomi.com/mcp/v1/check_balance",
data=json.dumps({}).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
method="POST",
)
data = json.load(urllib.request.urlopen(req, timeout=60))
for it in data["items"]:
print(it.get("url"), it.get("text", "")[:60])真实返回样例
下面这段是线上真实返回（已截断到 1 条，去掉了计费字段）。
{
"ok": true,
"username": "your_account",
"quota_usd": 0.2,
"used_usd": 0.0231,
"quota_exact_usd": 0.2,
"group": "default",
"group_zh": "默认分组",
"is_admin": false,
"note": "数值为示例；实际调用返回你账户的真实余量"
}常见问题
要花钱吗？
不要。免费、不计次，可以放心放在循环开头。
余额是所有密钥共用的吗？
是。账户余额是唯一口径；不填额度的密钥自动视为共用余额。
余额见底会怎样？
调用返回余额不足（402），不会静默返回空数据；充值是按量预付，不存在自动扣款。