API 크레딧

API 크레딧

Rivya API 호출이 계정 크레딧, 잔액 확인, 예약 크레딧, 실패 작업 환불, 크레딧 문제 해결을 어떻게 사용하는지 이해하세요.

최근 검토일 2026년 5월 10일

Rivya API는 Studio와 같은 계정 크레딧 지갑을 사용합니다.

API 키가 연결된 계정의 현재 잔액을 확인하려면 GET /api/v1/credits를 사용하세요.

엔드포인트

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

필수 헤더:

Authorization: Bearer rvya_sk_...

응답

{
  "current_credits": 123
}

생성 작업의 크레딧 처리

생성 작업을 제출하면 Rivya는 계정에 충분한 크레딧이 있는지 확인합니다.

이미지, 동영상, 오디오 작업의 경우 보통 작업을 시작할 때 크레딧이 예약되거나 차감됩니다. 생성 응답에는 다음 필드가 포함됩니다.

reserved_credits
final_credits

작업이 아직 queued 또는 processing 상태라면 final_credits가 0으로 남아 있을 수 있습니다.

실패한 작업

작업이 Rivya의 기존 실패 규칙에 따라 실패하면 환불 처리는 Studio와 같은 제품 정책을 따릅니다.

최종 상태를 확인하려면 생성 상태를 사용하고, 제품 수준의 실패 처리 방식은 실패한 작업과 크레딧 환불을 참고하세요.

자주 발생하는 크레딧 오류

insufficient_credits: 계정에 충분한 크레딧이 없습니다.
api_key_invalid: API 키로 계정을 식별할 수 없습니다.
public_api_disabled: Public API가 일시적으로 비활성화되었습니다.