API кредити
Зрозумійте, як виклики Rivya API використовують кредити акаунта, перевірки балансу, зарезервовані кредити, повернення за невдалі задачі та усунення проблем із кредитами.
Востаннє переглянуто 2026/05/10
Rivya API використовує той самий кредитний гаманець акаунта, що й Studio.
Використовуйте GET /api/v1/credits, щоб прочитати поточний баланс акаунта, до якого належить API-ключ.
Ендпойнт
GET https://rivya.ai/api/v1/creditsОбов'язковий заголовок:
Authorization: Bearer rvya_sk_...Відповідь
{
"current_credits": 123
}Білінг генерації
Коли ви надсилаєте генерацію, Rivya перевіряє, чи має акаунт достатньо кредитів.
Для задач із зображеннями, відео та аудіо кредити зазвичай резервуються або списуються на старті задачі. Відповідь генерації містить:
reserved_creditsfinal_credits
final_credits може залишатися 0, поки задача ще стоїть у черзі або обробляється.
Невдалі задачі
Якщо задача завершується невдало за чинними правилами помилок Rivya, обробка повернення кредитів відбувається за тією самою продуктовою політикою, що й у Studio.
Використовуйте статус генерації, щоб підтвердити фінальний статус, і невдалі задачі та повернення кредитів, щоб перевірити продуктову модель помилок.
Поширені помилки кредитів
insufficient_credits: в акаунті недостатньо кредитівapi_key_invalid: API-ключ не може ідентифікувати акаунтpublic_api_disabled: публічний API тимчасово вимкнено
Пов'язані сторінки
Chat API
Використовуйте Rivya Chat API для non-streaming або SSE turn, сесій, створених через API, вкладень зображень file_id і кредитного списання на основі токенів.
Помилки та ліміти API
Обробляйте публічні коди помилок Rivya API, HTTP-статуси, ліміти частоти, конфлікти ідемпотентності та рішення щодо повторних спроб.