Kredit API
Fahami cara panggilan Rivya API menggunakan kredit akaun, semakan baki, kredit ditempah, refund tugasan gagal, dan penyelesaian isu kredit.
Terakhir disemak pada 2026/05/10
Rivya API menggunakan dompet kredit akaun yang sama seperti Studio.
Gunakan GET /api/v1/credits untuk membaca baki semasa bagi akaun milik API key.
Endpoint
GET https://rivya.ai/api/v1/creditsHeader diperlukan:
Authorization: Bearer rvya_sk_...Respons
{
"current_credits": 123
}Pengebilan Generation
Apabila anda menghantar generation, Rivya menyemak sama ada akaun mempunyai kredit yang mencukupi.
Untuk kerja imej, video, dan audio, kredit biasanya ditempah atau digunakan pada permulaan tugasan. Respons generation menyertakan:
reserved_creditsfinal_credits
final_credits mungkin kekal 0 semasa kerja masih dalam queue atau sedang diproses.
Kerja Gagal
Jika tugasan gagal di bawah peraturan kegagalan Rivya yang sedia ada, pengendalian refund mengikut dasar produk yang sama seperti Studio.
Gunakan Status Generation untuk mengesahkan status akhir dan Tugasan Gagal dan Refund Kredit untuk model kegagalan peringkat produk.
Ralat Kredit Lazim
insufficient_credits: akaun tidak mempunyai kredit yang mencukupiapi_key_invalid: API key tidak dapat mengenal pasti akaunpublic_api_disabled: API awam dilumpuhkan sementara