الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

يوفّر CometAPI طريقتين للتحقق من رصيد الحساب والاستخدام: CometAPI CLI وQuery Service API على query.cometapi.com.

​
CometAPI CLI

أسرع طريقة للتحقق من رصيدك من الطرفية. راجع نظرة عامة على CometAPI CLI للتثبيت. 
cometapi balance
أضف --source token للحصول على تفاصيل كل مفتاح: 
cometapi balance --source token
راجع مرجع الأوامر لجميع الخيارات المتاحة.

​
Query service API

GET https://query.cometapi.com/user/quota يعيد رصيد الحساب على مستوى الحساب، والاستخدام التراكمي، وإجمالي عدد الطلبات، وتفاصيل الحصة لكل مفتاح. تستخدم هذه النقطة الطرفية خدمة استعلام منفصلة على query.cometapi.com وتتم المصادقة فيها عبر معامل الاستعلام key بدلًا من Bearer Token.
أنشئ API key مخصصًا لاستعلامات الرصيد واضبط حصته على 0 (صلاحية الاستعلام فقط). حتى إذا تم تسريب المفتاح، فلن يمكن استخدامه لطلبات model.

​
Request parameters

ParameterTypeRequiredDescription
keystringYesمفتاح CometAPI API الخاص بك
start_datestringNoتاريخ البدء للتقسيم اليومي (بتنسيق YYYY-MM-DD)
end_datestringNoتاريخ الانتهاء للتقسيم اليومي (بتنسيق YYYY-MM-DD)
عند توفير start_date وend_date، تتضمن الاستجابة حقل daily_quota مع استخدام كل مفتاح موزعًا حسب اليوم.

​
Response fields

FieldTypeDescription
usernamestringاسم المستخدم
total_quotanumberرصيد الحساب الحالي (USD)
total_used_quotanumberالاستخدام التراكمي (USD)
request_countintegerإجمالي عدد الطلبات
keysarrayتفاصيل الحصة لكل مفتاح
keys[].namestringاسم API key
keys[].remain_quotanumberالحصة المتبقية للمفتاح؛ -1 تعني غير محدود
keys[].used_quotanumberالحصة المستخدمة للمفتاح؛ -1 تعني غير محدود
daily_quotaobjectتقسيم الاستخدام اليومي (فقط عند تعيين start_date وend_date)
daily_quota[date]arrayإدخالات استخدام كل مفتاح لذلك التاريخ
daily_quota[date][].token_namestringاسم API key
daily_quota[date][].quota_usednumberاستخدام ذلك المفتاح في ذلك التاريخ (USD)
daily_quota[date][].request_countintegerعدد الطلبات لذلك المفتاح في ذلك التاريخ

​
Code examples

استعلام رصيد الحساب: 
curl `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`

​
Response example

{
  "username": "example_user",
  "total_quota": 2105.23,
  "total_used_quota": 21.07,
  "request_count": 1221,
  "keys": [
    {
      "name": "my-key",
      "remain_quota": 8.94,
      "used_quota": 2.10
    }
  ]
}

​
Daily breakdown example

استعلم عن الاستخدام اليومي لنطاق زمني: 
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
تتضمن الاستجابة نفس الحقول ذات المستوى الأعلى بالإضافة إلى daily_quota: 
{
  "username": "example_user",
  "total_quota": 2105.23,
  "total_used_quota": 21.07,
  "request_count": 1221,
  "daily_quota": {
    "2026-04-13T00:00:00Z": [
      {
        "token_name": "my-key",
        "quota_used": 4.27,
        "request_count": 59
      }
    ],
    "2026-04-14T00:00:00Z": [
      {
        "token_name": "my-key",
        "quota_used": 0.57,
        "request_count": 36
      }
    ]
  }
}