سجل الرصيد والاستخدام

‏GET /v1/balance — رصيدك المدفوع مسبقًا المتبقي. ‏GET /api/key/usage — الرصيد إضافة إلى الإنفاق اليومي/الشهري وعدد الطلبات لكل مفتاح. ‏GET /v1/generations — سجل الاستخدام مُقسَّم إلى صفحات. أمثلة بلغة curl وPython.

خدمة ذاتية: تحقق من رصيدك، واجلب الأسعار برمجيًا، واعرض سجل الاستخدام الخاص بمفتاحك.

الرصيد

GEThttps://getvibeapi.com/v1/balance

يعيد رصيدك المدفوع مسبقاً المتبقي.

curl https://getvibeapi.com/v1/balance \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# → {"balance_rub": 1234.56, "currency": "RUB"}

الأسعار البرمجية: /v1/pricing

GEThttps://getvibeapi.com/v1/pricing

مصدر الأسعار الرسمي لحسابك: الطُرز والمتغيّرات، وأسعار الوسائط لكل وحدة. يُعيد كائنًا يحتوي على data (طُرز النصوص) وmedia (الصور والفيديو). الأسعار حيّة، وتراعي التجاوزات البعيدة.

curl https://getvibeapi.com/v1/pricing \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

يحمل كل سجل متغيّر حقل addressAs — وهو القيمة الدقيقة لحقل model في الطلب (مثل claude-opus-4.8:yellow). ولا يوجد حقل cacheReadRub إلا للمتغيّرات المفعّلة لذاكرة التخزين المؤقت، وهو يعرض سعر قراءة ذاكرة التخزين المؤقت للمطالبة. وتُوسم سجلات الوسائط بـestimated: true — إذ تعتمد رسوم الوسائط الفعلية على حجم التوليد الفعلي وتُعاد في x-pv-cost-rub؛ وفي البثّات، يتطلب حقل الجسم x-pv-cost: 1.

ملخص المفتاح

GEThttps://getvibeapi.com/api/key/usage

يعيد الرصيد بالإضافة إلى مصروف اليوم ومصروف هذا الشهر وعدد الطلبات اليوم. يتم التفويض بالمفتاح نفسه sk-pv-… عبر الترويسة Authorization: Bearer أو x-api-key.

curl https://getvibeapi.com/api/key/usage \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# the same key is also accepted in the x-api-key header

سجلّ الاستخدام

إذا انقطع اتصالك أثناء بثّ ردّ، فإنك تدفع فقط مقابل الرموز التي أكّد المزوّد معالجتها فعليًا. وإذا انتهى البثّ قبل أي رمز إخراج وأكّد المزوّد رموز الإدخال، فلا يُحتسب عليك سوى الإدخال؛ وفي حال عدم تأكيد الاستخدام، تكون التكلفة صفرًا. ولا تُحتسب عليك الردود الفارغة، ولا أخطاء المزوّد، ولا عمليات الإلغاء لدينا بسبب حدّ التكلفة، ولا المحاولات الفاشلة التي استُبدلت بمحاولة ناجحة.

GEThttps://getvibeapi.com/v1/generations

المعلمة	النوع	الوصف
`page`	number	رقم الصفحة. الافتراضي 1.
`limit`	number	حجم الصفحة، حتى 100. الافتراضي 20.
`dateFrom`	string (ISO)	تصفية: من هذا التاريخ.
`dateTo`	string (ISO)	تصفية: حتى هذا التاريخ.
`request_id`	string	سجلات هذا الطلب فقط. تأتي القيمة من ترويسة معرّف الطلب الخاصة بالمشروع (x-getvibe-request-id).

curl "https://getvibeapi.com/v1/generations?page=1&limit=20" \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# optional filters: dateFrom, dateTo (ISO 8601), request_id
# request_id is the x-getvibe-request-id header value on getvibeapi.com
# curl "https://getvibeapi.com/v1/generations?request_id=$REQUEST_ID"

استجابة مثال:

{
  "data": [
    {
      "id": "...",
      "request_id": "8d4b6b3a-4f7c-4a4e-9a61-2f0c1d3e5b7a",
      "model": "gpt-6.1-sol",
      "route": "yellow",
      "address_as": "gpt-6.1-sol:yellow",
      "type": "text",
      "prompt_tokens": 120,
      "completion_tokens": 340,
      "total_tokens": 460,
      "units": 0,
      "cost_rub": 0.42,
      "created_at": "2026-06-15T10:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}

الحقل request_id هو المعرّف نفسه الذي تلقيته في الترويسة x-getvibe-request-id في الاستجابة الأصلية. وهو موجود أيضًا في الاستجابات المتدفقة، لذا يمكن مطابقة التدفق بسجله بدقة. في سجل الوسائط يكون هو jobId من استجابة بدء التوليد.

الحقل cost_rub هو المبلغ الذي خصمناه مقابل الحدث. ويوضح الحقلان route وaddress_as أي مسار عام خدم الطلب فعلًا (انظر التوجيه → تفصيل الرحلات). ولا تُعاد إلا حقول الاستخدام الخاصة بالعميل نفسه.

سجل محدَّد: /v1/generations/{id}

GEThttps://getvibeapi.com/v1/generations/{id}

يعيد سجل استخدام واحداً بحسب id الخاص به. الطلب مقيّد بالمالك: لن تحصل إلا على أحداثك أنت. يأتي id من استجابة GET /v1/generations (حقل id) أو من ترويسة x-pv-generation-id لاستجابة /v1/chat/completions غير متدفقة.

curl https://getvibeapi.com/v1/generations/USAGE_EVENT_ID \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
# USAGE_EVENT_ID comes from the /v1/generations response (the id field)
# or from the x-pv-generation-id header of a non-streaming response
# find the record by request id: GET /v1/generations?request_id=$REQUEST_ID

استجابة مثال:

{
  "id": "cmpl_abc123",
  "request_id": "8d4b6b3a-4f7c-4a4e-9a61-2f0c1d3e5b7a",
  "model": "gpt-6.1-sol",
  "route": "yellow",
  "address_as": "gpt-6.1-sol:yellow",
  "type": "text",
  "prompt_tokens": 120,
  "completion_tokens": 340,
  "total_tokens": 460,
  "units": 0,
  "cost_rub": 0.42,
  "created_at": "2026-06-15T10:00:00.000Z"
}

المعلمة	النوع	الوصف
`id`req.	string (path)	معرّف السجل.
`mediaType`	string	النوع: TEXT, IMAGE, VIDEO, AUDIO, MUSIC, MODEL_3D.

بالنسبة إلى طلبات البث (stream: true) يُنشأ معرّف السجل بشكل غير متزامن — ويكون الترويسة x-pv-generation-id غائبة. ويظهر السجل في السجلّ التاريخي فور انتهاء البث.

← السابقWebhooks الوسائط التالي →التوجيه والحدود