يوفّر 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 key مخصصًا لاستعلامات الرصيد واضبط حصته على 0 (صلاحية الاستعلام فقط). حتى إذا تم تسريب المفتاح، فلن يمكن استخدامه لطلبات model.
Request parameters
| Parameter | Type | Required | Description |
|---|
key | string | Yes | مفتاح CometAPI API الخاص بك |
start_date | string | No | تاريخ البدء للتقسيم اليومي (بتنسيق YYYY-MM-DD) |
end_date | string | No | تاريخ الانتهاء للتقسيم اليومي (بتنسيق YYYY-MM-DD) |
start_date وend_date، تتضمن الاستجابة حقل daily_quota مع استخدام كل مفتاح موزعًا حسب اليوم.
Response fields
| Field | Type | Description |
|---|
username | string | اسم المستخدم |
total_quota | number | رصيد الحساب الحالي (USD) |
total_used_quota | number | الاستخدام التراكمي (USD) |
request_count | integer | إجمالي عدد الطلبات |
keys | array | تفاصيل الحصة لكل مفتاح |
keys[].name | string | اسم API key |
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 key |
daily_quota[date][].quota_used | number | استخدام ذلك المفتاح في ذلك التاريخ (USD) |
daily_quota[date][].request_count | integer | عدد الطلبات لذلك المفتاح في ذلك التاريخ |
Code examples
استعلام رصيد الحساب:
curl "https://query.cometapi.com/user/quota?key=$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
}
]
}
}
