الاستعلام عن الرصيد والاستخدام

يوفر CometAPI طريقتين للتحقق من رصيد الحساب والاستخدام: CometAPI CLI وquery service API على query.cometapi.com. إذا كنت تستخدم Workspace، فراجع إدارة فريق باستخدام CometAPI Workspace لفهم Organization Credits المشتركة وأدوار الفوترة.

CometAPI CLI

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

cometapi balance

أضف --source token للحصول على تفاصيل لكل مفتاح:

cometapi balance --source token

راجع مرجع الأوامر للاطلاع على جميع الخيارات المتاحة.

واجهة برمجة تطبيقات خدمة الاستعلام

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

استخدم مفتاح API مخصصًا لاستعلامات الرصيد. إذا كنت تريد تقليل مستوى التعرض، فعطّل Unlimited Quota واضبط أصغر حد ائتماني موجب يسمح به لوحة التحكم.

معاملات الطلب

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 مع استخدام كل مفتاح مفصلًا حسب اليوم.

حقول الاستجابة

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"

import os
import requests

resp = requests.get(
    "https://query.cometapi.com/user/quota",
    params={"key": os.environ["COMETAPI_KEY"]}
)
data = resp.json()
print(f"Balance: ${data['total_quota']:.2f}")
print(f"Used: ${data['total_used_quota']:.2f}")
print(f"Requests: {data['request_count']}")

const resp = await fetch(
  `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`
);
const data = await resp.json();
console.log(`Balance: $${data.total_quota.toFixed(2)}`);
console.log(`Used: $${data.total_used_quota.toFixed(2)}`);
console.log(`Requests: ${data.request_count}`);

مثال على الاستجابة

{
  "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
      }
    ]
  }
}

ابدأ هنا

أدلة البدء السريع لواجهات برمجة تطبيقات النماذج

أدلة API الأساسية

المكتبات

الأخطاء

التسعير والفوترة

الدعم

الاستعلام عن الرصيد والاستخدام

CometAPI CLI

واجهة برمجة تطبيقات خدمة الاستعلام

معاملات الطلب

حقول الاستجابة

أمثلة التعليمات البرمجية

مثال على الاستجابة

مثال على التفصيل اليومي

​CometAPI CLI

​واجهة برمجة تطبيقات خدمة الاستعلام

​معاملات الطلب

​حقول الاستجابة

​أمثلة التعليمات البرمجية

​مثال على الاستجابة

​مثال على التفصيل اليومي

CometAPI CLI

واجهة برمجة تطبيقات خدمة الاستعلام

معاملات الطلب

حقول الاستجابة

أمثلة التعليمات البرمجية

مثال على الاستجابة

مثال على التفصيل اليومي