01
키 생성
로그인한 뒤 설정의 API 키 화면을 열고 범위가 지정된 키를 생성한 다음 전체 비밀값을 즉시 저장하세요.
빠른 시작 형태
모델 계층
동적 카탈로그
청구
공유 크레딧
첫 버전
작업 + Chat
액세스
API 키
요청 방법POST
엔드포인트/api/v1/generations
실제 요청에는 Rivya API 키와 사용 가능한 계정 크레딧이 필요합니다. 공개 예시는 자리표시자 비밀값을 사용하며 익명으로 모델을 호출하지 않습니다.
요청 예시
curl https://rivya.ai/api/v1/generations \
-H "Authorization: Bearer rvya_sk_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: demo-job-001" \
-d '{
"model": "z-image",
"prompt": "Editorial product photo on a clean studio set"
}'응답 예시
{
"id": "task_public_id",
"status": "queued",
"model": "z-image",
"reserved_credits": 20,
"result": null,
"error": null
}첫 출시 범위
Rivya 제품과 계속 맞춰지는 공개 API 계층
API는 Rivya 제품 표면으로 설계되었습니다. Rivya 모델 ID, Rivya 크레딧, 공개 작업 상태, 모델 카탈로그와 연결된 문서를 사용합니다.
이미지 생성 API
프롬프트와 지원되는 모델 파라미터로 이미지 작업을 제출한 뒤 공개 결과를 폴링하세요.
비디오 생성 API
Studio에서 쓰는 것과 같은 작업 및 크레딧 제어로 비동기 비디오 작업을 실행하세요.
오디오 생성 API
같은 계정, 잔액, 기록 범위 안에서 API로 접근 가능한 오디오 모델을 사용하세요.
공유 크레딧 지갑
API 호출과 Studio 사용은 같은 Rivya 잔액에서 차감되며 예약 크레딧과 실패 처리를 사용합니다.
시작 경로
계정에서 첫 API 요청까지
02
모델 선택
제출하기 전에 API 모델 레퍼런스를 읽거나 /api/v1/models를 호출해 모델 ID, 파라미터, Chat 지원 여부, 입력 준비 상태를 확인하세요.
03
제출, 폴링 또는 구독
멱등 생성 요청을 보내고, 공개 작업 엔드포인트를 폴링하고, 생성 콜백에는 서명된 웹훅을 사용하거나, 선택적 SSE 스트리밍이 있는 Chat API 요청을 보내세요.
버전 경계
명확한 범위, 숨은 약속 없음
랜딩 페이지는 향후 표면을 언급할 수 있지만 현재 제품 문구가 아직 완성되지 않은 API가 이미 공개되었다고 암시해서는 안 됩니다.
Chat API
사용 가능API에서 생성한 세션, 계정 크레딧, 선택적 Files API 이미지 첨부와 함께 비스트리밍 및 SSE 스트리밍 요청을 사용할 수 있습니다.
Files API
사용 가능참조 이미지, 비디오, 오디오 업로드에 사용할 수 있습니다. 모델 페이지가 params.referenceMediaItems를 요구할 때 생성 전에 사용하세요.
사용자 웹훅
사용 가능성공 또는 실패한 생성 작업에 대해 서명된 콜백을 받으려는 프로덕션 연동에서 사용할 수 있습니다.
온라인 디버거
요청을 미리 본 뒤 자신의 API 키로 실행하세요
디버거는 모든 방문자에게 모의 모드로 시작합니다. 생성 선택기는 파일 업로드 없이 테스트할 수 있는 비 Chat 모델을 보여주고, Files 패널은 로그인 사용자가 임시 API 키로 /api/v1/files를 테스트할 수 있게 합니다. Chat 예시는 API 문서에 있습니다.
계정 상태
계정 확인 중
활성 키 접두사
먼저 키를 생성하세요
현재 크레딧
확인하려면 로그인하세요
모의 미리보기실제 Public API활성 API 키 없음
모의 모드는 모델을 호출하지 않고 크레딧을 소비하지 않습니다.
이 요청에만 키를 붙여넣으세요. 디버거는 새로고침 후 이를 저장하지 않습니다.
Files API 업로드 테스트
POST /api/v1/files를 통해 참조 미디어를 업로드한 뒤 반환된 URL과 재생시간 토큰을 참조 입력을 지원하는 모델의 params.referenceMediaItems에 복사하세요.
모의 모드는 업로드하지 않습니다실제 모드는 /api/v1/files를 사용합니다
선택한 모델이 허용 MIME 유형, 크기, 재생시간 규칙을 제어합니다. 실제 업로드에는 임시 API 키가 필요하며 실제 업로드 서비스를 호출할 수 있습니다.
요청 미리보기
{
"model": "z-image",
"prompt": "깔끔한 스튜디오 세트의 에디토리얼 제품 사진",
"params": {
"aspect_ratio": "1:1"
}
}응답
{
"id": "mock_task_001",
"status": "queued",
"model": "z-image",
"reserved_credits": 1,
"final_credits": 0,
"result": null,
"error": null
}Files API 응답
{
"id": "file_mock_001",
"object": "file",
"kind": "image",
"file_name": "reference.png",
"mime_type": "image/png",
"size_bytes": 245760,
"url": "https://media.example/reference.png",
"duration_seconds": null,
"duration_token": null,
"created_at": "2026-05-11T00:00:00.000Z",
"expires_at": null
}생성 파라미터
{
"params": {
"referenceMediaItems": [
{
"url": "https://media.example/reference.png",
"kind": "image",
"name": "reference.png",
"mimeType": "image/png"
}
]
}
}작업 상태
예상 기본 크레딧
1
상태
queued
API 문서
인증, 요청 본문, 응답, 멱등성, 모델 파라미터, 오류 코드를 읽어보세요.
문서 열기API 키 관리
보호된 설정 영역에서 API 키를 생성하고, 한 번 복사하고, 폐기하고, 교체하세요.
키 관리온라인 디버깅
먼저 모의 예시를 사용하세요. 실제 디버깅에는 로그인, API 키, 계정 크레딧이 필요합니다.
흐름 미리보기