يوفر CometAPI طريقتين للتحقق من رصيد الحساب والاستخدام: CometAPI CLI وQuery service API على query.cometapi.com.
أسرع طريقة للتحقق من رصيدك من الطرفية. راجع نظرة عامة على CometAPI CLI للتثبيت.
أضف --source token للحصول على التفاصيل الخاصة بكل مفتاح:
cometapi balance --source token
Query service API
GET https://query.cometapi.com/user/quota
يعيد رصيد الحساب على مستوى الحساب، والاستخدام التراكمي، وإجمالي عدد الطلبات، وتفاصيل الحصة لكل مفتاح. تستخدم هذه النقطة النهائية خدمة استعلام منفصلة على query.cometapi.com وتتم المصادقة فيها عبر معامل الاستعلام key بدلًا من Bearer Token.
أنشئ مفتاح API مخصصًا لاستعلامات الرصيد واضبط حصته على 0 (إذن للاستعلام فقط). حتى إذا تسرّب المفتاح، فلن يمكن استخدامه لطلبات model.
معلمات الطلب
| Parameter | Type | Required | Description |
|---|
key | string | Yes | مفتاح API الخاص بك في CometAPI |
start_date | string | No | تاريخ البداية للتفصيل اليومي (بصيغة YYYY-MM-DD) |
end_date | string | No | تاريخ النهاية للتفصيل اليومي (بصيغة YYYY-MM-DD) |
start_date وend_date، تتضمن الاستجابة حقل daily_quota مع استخدام كل مفتاح مفصّلًا حسب اليوم.
حقول الاستجابة
| Field | Type | Description |
|---|
username | string | اسم المستخدم |
total_quota | number | رصيد الحساب الحالي (USD) |
total_used_quota | number | الاستخدام التراكمي (USD) |
request_count | integer | إجمالي عدد الطلبات |
keys | array | تفاصيل الحصة لكل مفتاح |
keys[].name | string | اسم مفتاح API |
keys[].remain_quota | number | الحصة المتبقية للمفتاح؛ -1 تعني غير محدودة |
keys[].used_quota | number | الحصة المستخدمة للمفتاح؛ -1 تعني غير محدودة |
daily_quota | object | تفصيل الاستخدام اليومي (فقط عند تعيين start_date وend_date) |
daily_quota[date] | array | إدخالات الاستخدام لكل مفتاح في ذلك التاريخ |
daily_quota[date][].token_name | string | اسم مفتاح API |
daily_quota[date][].quota_used | number | استخدام ذلك المفتاح في ذلك التاريخ (USD) |
daily_quota[date][].request_count | integer | عدد الطلبات لذلك المفتاح في ذلك التاريخ |
أمثلة على الكود
استعلم عن رصيد الحساب:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
مثال على الاستجابة
{
"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
}
]
}
مثال على التفصيل اليومي
استعلم عن الاستخدام اليومي لنطاق زمني:
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
}
]
}
}
