API 參考
餘額與用量查詢
GET https://api.flyrouter.ai/v1/dashboard/billing/subscription
GET https://api.flyrouter.ai/v1/dashboard/billing/usage
用 API Key 直接查詢這個 Key 的額度和已用金額，格式相容 OpenAI 舊版帳單介面，許多用戶端（如 CC-Switch、各類餘額監控腳本）可以直接使用。金額單位為美元。
查詢額度
終端機
curl https://api.flyrouter.ai/v1/dashboard/billing/subscription \
-H "Authorization: Bearer $FLYROUTER_API_KEY"json
{
"object": "billing_subscription",
"has_payment_method": true,
"soft_limit_usd": 20,
"hard_limit_usd": 20,
"system_hard_limit_usd": 20,
"access_until": -1
}| 欄位 | 說明 |
|---|---|
hard_limit_usd | 這個 Key 的總額度（剩餘 + 已用），單位美元。Key 未設定額度上限時固定回傳 100000000 |
access_until | Key 的過期時間（Unix 時間戳），-1 表示永不過期 |
查詢已用金額
終端機
curl https://api.flyrouter.ai/v1/dashboard/billing/usage \
-H "Authorization: Bearer $FLYROUTER_API_KEY"json
{
"object": "list",
"total_usage": 512.5
}total_usage 是這個 Key 累計已用的金額，單位為美分（上例即 $5.125）。
計算剩餘額度
balance.py
import os, requests
base = "https://api.flyrouter.ai"
headers = {"Authorization": f"Bearer {os.environ['FLYROUTER_API_KEY']}"}
total = requests.get(f"{base}/v1/dashboard/billing/subscription", headers=headers).json()["hard_limit_usd"]
used = requests.get(f"{base}/v1/dashboard/billing/usage", headers=headers).json()["total_usage"] / 100
if total >= 100000000:
print(f"這個 Key 不限額度，已用 ${used:.2f}")
else:
print(f"已用 ${used:.2f}，剩餘 ${total - used:.2f}")這兩個介面統計的是單一 Key。帳戶的總餘額請在控制台查看；想讓腳本能監控餘額，可以給 Key 設定額度上限，再用上面的方法計算剩餘額度。
FlyRouter