Tín dụng API

Rivya API dùng cùng ví credits tài khoản với Studio.

Dùng GET /api/v1/credits để đọc số dư hiện tại của tài khoản thuộc API key.

Endpoint

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

Header bắt buộc:

Authorization: Bearer rvya_sk_...

Phản hồi

{
  "current_credits": 123
}

Tính phí generation

Khi bạn gửi một generation, Rivya kiểm tra tài khoản có đủ credits hay không.

Với tác vụ hình ảnh, video và âm thanh, credits thường được dự trữ hoặc tiêu thụ khi tác vụ bắt đầu. Phản hồi generation bao gồm:

• reserved_credits
• final_credits

final_credits có thể vẫn là 0 khi tác vụ còn đang queued hoặc processing.

Tác vụ thất bại

Nếu một tác vụ thất bại theo quy tắc thất bại hiện có của Rivya, xử lý hoàn credits sẽ theo cùng chính sách sản phẩm như Studio.

Dùng Trạng thái generation để xác nhận trạng thái cuối và Tác vụ thất bại và hoàn credits để hiểu mô hình thất bại ở cấp sản phẩm.

Lỗi credits thường gặp

• insufficient_credits: tài khoản không có đủ credits
• api_key_invalid: API key không thể xác định tài khoản
• public_api_disabled: public API đang tạm thời bị tắt

Trang liên quan

• Credits & Billing trong Rivya
• Tạo generation
• Lỗi và giới hạn API
• Gói và credit packs