Rivya AI Docs

เครดิต API

ทำความเข้าใจว่า Rivya API ใช้เครดิตบัญชีอย่างไร รวมถึงการตรวจยอดคงเหลือ เครดิตที่กันไว้ การคืนเครดิตเมื่องานล้มเหลว และการแก้ปัญหาเครดิต

ตรวจล่าสุดเมื่อ 2026/05/10

Rivya API ใช้กระเป๋าเครดิตบัญชีเดียวกับ Studio

ใช้ GET /api/v1/credits เพื่ออ่านยอดคงเหลือปัจจุบันของบัญชีที่ผูกกับ API key

Endpoint ของ API

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

header ที่จำเป็น:

Authorization: Bearer rvya_sk_...

Response ของ API

{
  "current_credits": 123
}

การคิดเครดิตสำหรับงานสร้าง

เมื่อคุณส่งงานสร้าง Rivya จะตรวจว่าบัญชีมีเครดิตเพียงพอหรือไม่

สำหรับงานภาพ วิดีโอ และเสียง โดยทั่วไปเครดิตจะถูกกันไว้หรือใช้ตอนเริ่มงาน response ของงานสร้างมี:

  • reserved_credits
  • final_credits

final_credits อาจยังเป็น 0 ขณะที่งานยังอยู่ในคิวหรือกำลังประมวลผล

งานที่ล้มเหลว

หาก task ล้มเหลวภายใต้กฎความล้มเหลวปัจจุบันของ Rivya การจัดการคืนเครดิตจะใช้นโยบายผลิตภัณฑ์เดียวกับ Studio

ใช้ สถานะงานสร้าง เพื่อยืนยันสถานะสุดท้าย และอ่าน งานที่ล้มเหลวและการคืนเครดิต สำหรับโมเดลความล้มเหลวในระดับผลิตภัณฑ์

ข้อผิดพลาดเครดิตที่พบบ่อย

  • insufficient_credits: บัญชีมีเครดิตไม่พอ
  • api_key_invalid: API key ไม่สามารถระบุบัญชีได้
  • public_api_disabled: public API ถูกปิดชั่วคราว

หน้าที่เกี่ยวข้อง

สารบัญ