Rivya API 개요
API 키, 계정 크레딧, 선택형 SSE 스트리밍을 이용해 자체 제품에서 Rivya API v1의 생성 및 채팅 모델을 호출하세요.
최근 검토일 2026년 8월 29일
배포에서 Public API가 활성화되어 있고 계정에 접근 권한이 있다면, Rivya API v1은 자체 제품에서 Rivya의 지원 모델 기능을 호출하기 위한 개발자 계약입니다.
구현된 계약은 비동기 이미지·동영상·오디오 생성과 비스트리밍 또는 SSE 스트리밍 응답을 지원하는 Chat API 대화를 다룹니다. Rivya 모델 ID와 계정 크레딧을 사용하며, 생성에는 공개 작업 ID를, Chat API에는 서버 측 채팅 세션을 사용합니다. 문서에 경로가 있다고 해서 모든 환경, 계정, 카탈로그 모델에서 호출할 수 있는 것은 아닙니다. 통합하기 전에 현재 접근 권한과 모델 준비 상태를 확인하세요.
API가 적합한 작업
다음이 필요할 때 API를 사용하세요.
자체 앱에서 이미지, 동영상 또는 오디오 생성 작업 제출
비스트리밍 또는 스트리밍 채팅 대화 전송 및 API에서 만든 채팅 세션 이어가기
동일한 Rivya 계정 크레딧 지갑에서 결제 관리
공개 작업 ID로 작업 상태 조회
안전한 프로덕션 요청을 위한 멱등 재시도 사용
Studio와 API 사용량을 동일한 계정 범위에서 관리
API는 Rivya 제품 계층입니다. 공개 응답에는 Rivya 명칭과 공개 필드만 사용됩니다.
현재 버전 범위
구현된 v1 엔드포인트는 다음과 같습니다.
GET /api/v1/modelsPOST /api/v1/generationsPOST /api/v1/filesGET /api/v1/files/{fileId}POST /api/v1/chat/completionsGET /api/v1/chat/sessionsGET /api/v1/chat/sessions/{sessionId}GET /api/v1/generations/{taskId}GET /api/v1/creditsGET /api/v1/webhooksPOST /api/v1/webhooksGET /api/v1/webhook-eventsGET /api/v1/openapi.json
현재 계약에는 비동기 생성 결과용 서명된 웹훅, Chat API, 서버 측 스트리밍을 지원하는 TypeScript SDK 베타가 포함됩니다. 웹훅 엔드포인트를 호출하려면 배포에서 웹훅 기능과 Public API 접근이 모두 활성화되어 있어야 합니다.
인증
생성, 상태, 크레딧 엔드포인트에는 다음 인증이 필요합니다.
Authorization: Bearer rvya_sk_...API 키 설정에서 키를 만들고 교체하세요. 운영 환경에서 키를 사용하기 전에 API 인증을 읽으세요.
결제 모델
API 호출은 Studio와 동일한 Rivya 계정 크레딧을 사용합니다.
생성 작업은 작업이 시작될 때 크레딧을 예약하거나 소비합니다. Chat 대화는 모델 호출 전에 크레딧을 예약하고, 어시스턴트 메시지가 저장될 때 토큰 사용량에 따라 최종 크레딧을 정산합니다. 생성 또는 채팅 대화가 기존 Rivya 실패 규칙에 따라 실패하면 동일한 환불 처리가 적용됩니다.
사용자에게 표시되는 지갑 방식은 API 크레딧과 Rivya의 크레딧과 결제를 참고하세요.
첫 통합 경로
Settings에서 API 키를 만듭니다.
API 모델 목록을 호출해 공개 모델 ID를 선택합니다.
모델 API 레퍼런스에서 모델 파라미터를 확인합니다.
모델에 참조 미디어가 필요하면 Files API로 업로드합니다.
생성 만들기로 작업을 제출합니다.
작업이 성공하거나 실패할 때까지 생성 상태를 조회합니다. 배포와 계정에서 웹훅이 활성화된 경우에는 API 웹훅을 구독해 서명된 완료 이벤트를 받을 수도 있습니다.
채팅 모델은 생성 엔드포인트 대신 Chat API를 사용하세요. Chat 이미지 첨부는 Files API의
file_id값을 참조해야 합니다.