API 크레딧

API 크레딧

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

최근 검토일 2026/05/10

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

API key 계정의 현재 잔액을 읽으려면 GET /api/v1/credits를 사용하세요.

Endpoint

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

Required header:

Authorization: Bearer rvya_sk_...

Response

{
  "current_credits": 123
}

Generation Billing

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

이미지, 비디오, 오디오 작업의 경우 보통 작업 시작 시 크레딧이 예약되거나 소비됩니다. generation response에는 다음이 포함됩니다.

reserved_credits
final_credits

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

Failed Jobs

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

최종 상태를 확인하려면 Generation Status를 사용하고, 제품 수준의 실패 모델은 Failed Tasks and Credit Refunds를 참고하세요.

Common Credit Errors

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

관련 페이지

Chat API

non-streaming 또는 SSE turn, API가 만든 session, file_id 이미지 첨부, token 기반 크레딧 정산에 Rivya Chat API를 사용하세요.

API 오류와 제한

Rivya API 공개 오류 코드, HTTP status 값, rate limit, idempotency conflict, retry 결정을 처리하세요.