الرصيد والاستهلاك

اقرأ رصيد حسابك بالدولار الأمريكي وإجمالي إنفاقك وحد الطلبات الخاص بالمفتاح المستخدم. يُعيد المساران الاستجابة نفسها: /credits و/key (وهو اسم بديل أقصر).

GET https://api14.com/api/v1/credits
GET https://api14.com/api/v1/key

كل المبالغ بـ الدولار الأمريكي.

الطلب

لا توجد معاملات. صادِق باستخدام مفتاح API:

curl https://api14.com/api/v1/credits \
  -H "Authorization: Bearer sk-api14-..."

الاستجابة

{
  "data": {
    "total_credits": 145.0,
    "total_usage": 102.82,
    "balance_usd": 42.18,
    "key_id": "ckey_01JABCDEF",
    "rate_limit": { "requests": 120, "interval": "1m" }
  }
}

قد يختلف total_credits - total_usage قليلًا عن balance_usd بسبب المبالغ المستردة والتعديلات اليدوية، وbalance_usd هو القيمة المعتمدة.

مثال: التوقف قبل نفاد الرصيد

import os, requests

r = requests.get(
    "https://api14.com/api/v1/credits",
    headers={"Authorization": f"Bearer {os.environ['API14_API_KEY']}"},
)
balance = r.json()["data"]["balance_usd"]
if balance < 1:
    raise SystemExit(f"Balance low: ${balance:.2f}. Add funds at /dashboard/billing")

curl -s https://api14.com/api/v1/key \
  -H "Authorization: Bearer $API14_API_KEY" | jq '.data.balance_usd'

عندما يصل الرصيد إلى 0 دولار

تُعيد الطلبات المدفوعة الخطأ 402 insufficient_balance إلى أن تضيف رصيدًا، ما لم يكن الشحن التلقائي مفعّلًا في صفحة الفوترة. تستمر قراءة /credits و/key و/models في العمل. راجع الأسعار والفوترة.

الأخطاء

راجع الأخطاء.