Docs Rivya AI

Credits API

Pahami bagaimana panggilan Rivya API memakai credits akun, pemeriksaan saldo, credits yang direservasi, refund tugas gagal, dan troubleshooting credits.

Terakhir ditinjau pada 2026/05/10

Rivya API menggunakan wallet credits akun yang sama dengan Studio.

Gunakan GET /api/v1/credits untuk membaca saldo saat ini milik akun API key.

Endpoint

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

Header wajib:

Authorization: Bearer rvya_sk_...

Respons

{
  "current_credits": 123
}

Penagihan Generasi

Saat Anda mengirim generasi, Rivya memeriksa apakah akun memiliki credits yang cukup.

Untuk pekerjaan gambar, video, dan audio, credits biasanya direservasi atau dipakai pada awal tugas. Respons generasi menyertakan:

  • reserved_credits
  • final_credits

final_credits dapat tetap 0 saat pekerjaan masih dalam antrean atau sedang diproses.

Pekerjaan Gagal

Jika sebuah tugas gagal berdasarkan aturan kegagalan Rivya yang ada, penanganan refund mengikuti kebijakan produk yang sama seperti Studio.

Gunakan Status Generasi untuk mengonfirmasi status akhir dan Tugas Gagal dan Refund Credits untuk memahami model kegagalan tingkat produk.

Error Credits Umum

  • insufficient_credits: akun tidak memiliki credits yang cukup
  • api_key_invalid: API key tidak dapat mengidentifikasi akun
  • public_api_disabled: API publik sedang dinonaktifkan sementara

Halaman Terkait

Chat API

Gunakan Rivya Chat API untuk turn non-streaming atau SSE, session yang dibuat API, lampiran gambar file_id, dan penyelesaian credits berbasis token.

Error dan Limit API

Tangani kode error publik Rivya API, nilai HTTP status, rate limit, konflik idempotensi, dan keputusan retry.

Daftar Isi

Endpoint
Respons
Penagihan Generasi
Pekerjaan Gagal
Error Credits Umum
Halaman Terkait