افهم كيف تستخدم استدعاءات Rivya API رصيد الحساب، وفحوصات الرصيد، والرصيد المحجوز، واسترداد مهام الفشل، واستكشاف مشكلات الرصيد.

تستخدم Rivya API محفظة رصيد الحساب نفسها التي يستخدمها Studio.

استخدم GET /api/v1/credits لقراءة الرصيد الحالي لحساب مفتاح API.

Endpoint

GET https://rivya.ai/api/v1/credits

Header مطلوب:

Authorization: Bearer rvya_sk_...

الاستجابة

{
  "current_credits": 123
}

عندما ترسل طلب توليد، تتحقق Rivya مما إذا كان الحساب يملك رصيدا كافيا.

بالنسبة إلى مهام الصور والفيديو والصوت، عادة يحجز الرصيد أو يستهلك عند بدء المهمة. تتضمن استجابة التوليد:

قد يبقى final_credits بقيمة 0 بينما لا تزال المهمة في قائمة الانتظار أو قيد المعالجة.

إذا فشلت مهمة بموجب قواعد الفشل الحالية في Rivya، فإن معالجة الاسترداد تتبع سياسة المنتج نفسها في Studio.

استخدم حالة التوليد لتأكيد الحالة النهائية، والمهام الفاشلة واسترداد الرصيد لفهم نموذج الفشل على مستوى المنتج.