Rivya API 모델 ID, 이용 가능 상태, 지원 모드, 매개변수 표, 프롬프트 제한, 참조 미디어 규칙 및 모델 상세 링크를 확인하세요.

이 페이지는 Rivya API v1의 모델별 API 참고 문서입니다.

아래 표는 /api/v1/models와 동일한 모델 카탈로그 및 공개 직렬화 계층에서 생성됩니다. 수동으로 작성한 고정 모델 수에 의존하지 않습니다.

이 참고 문서 읽는 방법

비동기 이미지, 비디오 및 오디오 모델에서 POST /api/v1/generations를 호출할 때 모델 id를 model 값으로 사용하세요.
채팅 모델 ID는 POST /api/v1/chat/completions에서 사용하세요.
생성 프롬프트 텍스트는 최상위 prompt에 넣으세요.
Chat API 대화 차례는 최상위 message에 넣으세요.
비동기 모델별 필드는 params 안에 넣으세요.
연동을 구현하기 전에 api_input_status를 확인하세요. available_text와 available_url_input은 파일 업로드 없이 테스트할 수 있습니다. partial_requires_files는 일부 모드에만 Files API가 필요하다는 뜻이며, requires_files_api는 모델 호출 전에 Files API로 참조 미디어를 업로드해야 한다는 뜻입니다.
Image5 모델 5종은 모두 원래의 모델 지정 Files API 응답에서 width, height, size_bytes, image_dimensions_token을 보존한 뒤 각각 width, height, sizeBytes, imageDimensionsToken으로 전달해야 합니다. 토큰이 없거나 만료되었다면 파일을 다시 업로드하세요. Layer Decomposition은 문서화된 기하 범위 안의 이미지 정확히 1개를 추가로 요구합니다.
Grok Imagine Image 2.0은 표준 이미지 편집용 참조 이미지 1–5개 각각에 동일한 서명 이미지 필드를 사용합니다. 프롬프트만 포함된 요청은 텍스트-이미지 생성을 사용하고, 서명된 참조가 있으면 이미지 편집으로 전환됩니다. auto는 편집 전용이며 Segment Map과 Segment Edit는 계속 사용할 수 없습니다.
Video8 비디오 참조에서는 duration_seconds, duration_token, video_width, video_height, frames_per_second, video_bitrate_mbps, video_file_size_bytes, video_metadata_token을 보존하세요. 생성 요청에는 각각 durationSeconds, durationToken, width, height, framesPerSecond, videoBitrateMbps, sizeBytes, videoMetadataToken으로 전달하고, 두 서명 토큰 중 하나라도 없거나 만료되었다면 파일을 다시 업로드하세요.
Wan 3.0은 서로 배타적인 텍스트, 첫/마지막 프레임 및 멀티모달 참조 장면을 제공하며 Standard 또는 Prime, 480P/720P/1080P, 여섯 가지 가로세로비, 명시적 2–30초 또는 지능형 재생 시간, 생성 오디오와 seed를 지원합니다. 이미지에는 서명된 MIME 형식, 크기와 바이트 크기가 필요합니다. 비디오는 서명된 재생 시간과 비디오 메타데이터도 요구하고, 오디오 재생 시간 토큰은 MIME 형식과 바이트 크기에 바인딩됩니다. 지능형 재생 시간은 30초를 예약하며 참조 비디오와 함께 사용할 수 없습니다. 파일 기반 비디오 생성과 링크 기반 비디오 생성의 단축 경로는 계속 사용할 수 없습니다.
모델별 Files API 제한은 파일 유형별 기본 제한보다 엄격합니다. 업로드할 때 대상 모델 ID를 지정하면 지원되지 않는 유형, MIME 형식, 바이트 크기, 재생 시간, 크기, 프레임 속도 및 비트레이트가 크레딧 예약 전에 거부됩니다.
채팅 모델은 chat_capabilities에서 비스트리밍 지원, SSE 스트리밍 지원, 이미지 file_id 첨부, 웹 검색, 사고 과정 및 추론 강도를 확인하세요.
모델 상세 페이지에서는 제품 수준의 사용 지침과 예시를 제공합니다.

요청 형식

{
  "model": "z-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1"
  }
}

JavaScript 및 Python 예시는 생성 작업 만들기를 참고하세요.

채팅 요청 형식:

{
  "model": "gpt-5-2-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

채팅 예시는 Chat API를 참고하세요.

동적 모델 참고 문서

이 레퍼런스를 디버거와 함께 사용하세요

빠른 시작에서 시작해 여기에서 모델 필드를 확인한 뒤 Developers 디버거에서 모의 요청이나 로그인된 실제 요청을 실행하세요.

API Quickstart 온라인 디버거

Z-Image

z-imageAPI로 사용 가능텍스트 입력 준비됨

이미지 · Alibaba의 가벼운 텍스트-이미지 모델입니다. 5가지 화면비를 갖춘 빠른 단일 이미지 생성으로, 단 1크레딧에 빠른 콘셉트 초안과 소셜 미디어 비주얼에 적합합니다.

API 가이드 모델 페이지

기본 크레딧

per_image · default=0.8 · ⌈total⌉

모드

text-to-image

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

1000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "z-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16

Nano Banana 2

nano-banana-2API로 사용 가능부분 지원: Files API 필요

이미지 · Nano Banana 2는 브랜드 비주얼, 제품 이미지, 참조 기반 창의적 초안을 위한 Rivya의 최신 Nano Banana 이미지 모델입니다. 기본 단계보다 더 최신의 Google 이미지 경로가 필요할 때 사용하세요.

API 가이드 모델 페이지

기본 크레딧

per_image · 1K=5 · 2K=8 · 4K=12 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

20000 자

참조 미디어

image · 14 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "nano-banana-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto",
    "resolution": "1K",
    "output_format": "jpg"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 사용할 이미지 파일을 최대 14개까지 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	auto	-	auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9, 4:1, 1:4, 8:1, 1:8
resolution	select	아니요	1K	-	1K, 2K, 4K
output_format	select	아니요	jpg	-	jpg, png

Nano Banana Pro

nano-banana-proAPI로 사용 가능부분 지원: Files API 필요

이미지 · Google의 프리미엄 이미지 모델로 4K 출력, 11가지 화면비, 최대 8장의 참조 이미지를 지원합니다. 더 뛰어난 디테일과 색 정확도로 고품질 브랜드 및 캠페인 비주얼에 최적화되어 있습니다.

API 가이드 모델 페이지

기본 크레딧

per_image · 1K=8 · 2K=8 · 4K=14 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

10000 자

참조 미디어

image · 8 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "nano-banana-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 사용할 이미지 파일을 최대 8개까지 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	1:1	-	1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto
resolution	select	아니요	1K	-	1K, 2K, 4K
output_format	select	아니요	png	-	png, jpg

Nano Banana

nano-bananaAPI로 사용 가능부분 지원: Files API 필요

이미지 · Google의 유연한 이미지 모델로 텍스트-이미지와 이미지-이미지, 11가지 화면비, 최대 10장의 참조 이미지, PNG/JPEG 출력을 지원합니다. 인물, 제품 구성, 더 넓은 랜딩 페이지 비주얼에 잘 맞습니다.

API 가이드 모델 페이지

기본 크레딧

per_request · text_to_image=3 · image_to_image=3 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 10 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "nano-banana",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "imageSize": "1:1",
    "output_format": "png"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 사용할 이미지 파일을 최대 10개까지 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
imageSize	select	아니요	1:1	-	1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto
output_format	select	아니요	png	-	png, jpeg

GPT Image 2

gpt-image-2API로 사용 가능부분 지원: Files API 필요

이미지 · Rivya에서 제공되는 OpenAI의 더 새로운 GPT Image 모델로, 텍스트-이미지 생성, 이미지-이미지 변환, 최대 16장 참조 이미지, 명확한 1K / 2K / 4K 크레딧 단계를 제공합니다.

API 가이드 모델 페이지

기본 크레딧

per_image · 1K=3 · 2K=5 · 4K=8 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

20000 자

참조 미디어

image · 16 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gpt-image-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}

참조 규칙

참조 이미지: GPT Image 2 이미지-이미지 변환 작업에 최대 16개의 이미지 참조를 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	1:1	-	auto, 1:1, 9:16, 16:9, 4:3, 3:4
resolution	select	아니요	1K	-	1K, 2K, 4K

GPT Image 1.5

gpt-image-1-5API로 사용 가능부분 지원: Files API 필요

이미지 · OpenAI의 이미지 모델로 중간/고화질 품질 단계와 최대 16장 참조 이미지를 지원합니다. 복잡한 지시를 잘 따르고 정확한 공간 관계를 갖춘 일관된 장면을 렌더링하는 데 강합니다.

API 가이드 모델 페이지

기본 크레딧

per_image · medium=4 · high=22 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

참조 미디어

image · 16 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gpt-image-1-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "quality": "medium",
    "aspect_ratio": "1:1"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 최대 16개의 이미지 파일을 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
quality	select	아니요	medium	-	medium, high
aspect_ratio	select	아니요	1:1	-	1:1, 2:3, 3:2

4o Image

4o-imageAPI로 사용 가능텍스트 입력 준비됨

이미지 · OpenAI의 4o Image 모델을 Rivya에서 전용 텍스트-이미지 경로로 사용할 수 있습니다. 현재 페이지 설정은 의도적으로 좁게 유지됩니다. 프롬프트와 지원되는 3가지 화면비만 제공하며 이미지당 고정 3 크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

per_request · text_to_image=3 · ⌈total⌉

모드

text-to-image

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "4o-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "1:1"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
size	select	아니요	1:1	-	1:1, 3:2, 2:3

Seedream 5.0 Lite

seedream-5-liteAPI로 사용 가능부분 지원: Files API 필요

이미지 · ByteDance의 더 가벼운 Seedream 이미지 모델로, 텍스트-투-이미지와 이미지 편집에 동일한 가격을 적용합니다. 8개 화면비, 최대 14장의 참조 이미지를 지원하며 현재 실행 1회당 6크레딧이 듭니다.

API 가이드 모델 페이지

기본 크레딧

per_image · default=5.5 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

3000 자

참조 미디어

image · 14 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedream-5-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic",
    "output_format": "png",
    "nsfw_checker": "true"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트를 위해 이미지 파일을 최대 14장 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspectRatio	select	아니요	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	아니요	basic	-	basic, high, ultra
output_format	select	아니요	png	-	png, jpeg
nsfw_checker	select	아니요	true	-	false, true

Seedream 4.5

seedream-4-5API로 사용 가능부분 지원: Files API 필요

이미지 · ByteDance의 고급 이미지 모델로, 2K/4K 품질 구간, 8개 화면비, 최대 14장의 참조 이미지를 지원합니다. 패션과 라이프스타일 비주얼에서 시네마틱 컬러 그레이딩과 풍부한 텍스처 디테일로 알려져 있습니다.

API 가이드 모델 페이지

기본 크레딧

per_image · default=6.5 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

3000 자

참조 미디어

image · 14 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedream-4-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트를 위해 이미지 파일을 최대 14장 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspectRatio	select	아니요	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	아니요	basic	-	basic, high

Seedream 4.0

seedream-4-0이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

이미지 · Seedream 4.0은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

image · 10 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

image: image

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Seedream 3.0

seedream-3-0이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

이미지 · Seedream 3.0은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Grok Imagine

grok-imagineAPI로 사용 가능부분 지원: Files API 필요

이미지 · xAI의 이미지 모델로 강한 창작 해석력과 5가지 화면비를 제공합니다. 표준 텍스트 요청은 이미지 2장, 품질 요청은 4장을 반환합니다.

API 가이드 모델 페이지

기본 크레딧

per_request · standard=4 · standard_output_images=2 · quality=5 · quality_output_images=4 · image_to_image=4 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "grok-imagine",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "nsfw_checker": "false",
    "enable_pro": "false"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 최대 1개의 이미지 파일을 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	1:1	-	1:1, 2:3, 3:2, 16:9, 9:16
nsfw_checker	select	아니요	false	-	false, true
enable_pro	select	아니요	false	-	false, true

Flux 2 Pro

flux-2-proAPI로 사용 가능부분 지원: Files API 필요

Image · Black Forest Labs의 32B 파라미터 플래그십 모델입니다. 텍스트-이미지와 이미지-이미지를 지원하며, 최대 8장의 참조 이미지, 2K 해상도, 정확한 텍스트 렌더링을 제공해 제품 사진과 브랜드 비주얼에 맞춰 설계되었습니다.

API 가이드 모델 페이지

기본 크레딧

per_image · 1K=5 · 2K=7 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 8 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "flux-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K",
    "nsfw_checker": "false"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 사용할 이미지 파일을 최대 8개까지 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspectRatio	select	아니요	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	아니요	1K	-	1K, 2K
nsfw_checker	select	아니요	false	-	false, true

Flux 2 Flex

flux-2-flexAPI로 사용 가능부분 지원: Files API 필요

Image · Flux 2 제품군의 편집 중심 변형입니다. 최대 8장의 참조 이미지와 2K 해상도를 활용해 구조 조정과 스타일 변환에 특화되어 있으며, 기존 비주얼을 반복 개선하는 작업에 적합합니다.

API 가이드 모델 페이지

기본 크레딧

per_image · 1K=14 · 2K=24 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 8 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "flux-2-flex",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K",
    "nsfw_checker": "false"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 사용할 이미지 파일을 최대 8개까지 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspectRatio	select	아니요	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	아니요	1K	-	1K, 2K
nsfw_checker	select	아니요	false	-	false, true

Flux Kontext Max

flux-kontext-maxAPI로 사용 가능부분 지원: Files API 필요

Image · BFL은 현재 FLUX.1 Kontext [max]를 이전 세대로 표시하고 새 프로젝트에는 FLUX.2를 권장합니다. 까다로운 프롬프트 기반 생성과 이미지 편집을 위한 Black Forest Labs의 향상된 Flux Kontext 모델입니다. Rivya는 한 모델 페이지에서 텍스트-이미지와 이미지-이미지를 모두 제공하며 실행당 고정 8 크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

per_image · default=8 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "flux-kontext-max",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "선택 사항: 워터마크 텍스트"
  }
}

참조 규칙

참조 이미지: 이미지 편집 프로젝트에 사용할 이미지 파일을 최대 1개까지 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspectRatio	select	아니요	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	아니요	jpeg	-	jpeg, png
enableTranslation	select	아니요	true	-	true, false
promptUpsampling	select	아니요	false	-	false, true
safetyTolerance	number	아니요	2	min 0 / max 6	-
watermark	text	아니요	-	-	-

Flux Kontext Pro

flux-kontext-proAPI로 사용 가능부분 지원: Files API 필요

이미지 · BFL은 FLUX.1 Kontext [pro]를 이전 세대로 표시하고 새 프로젝트에는 FLUX.2를 권장합니다. 텍스트-이미지 생성과 단일 이미지 편집을 위한 Black Forest Labs의 저비용 Flux Kontext 모델입니다. Rivya는 한 모델 페이지에서 두 모드를 모두 제공하며 실행당 고정 4 크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

per_image · default=4 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "선택 사항: 워터마크 텍스트"
  }
}

참조 규칙

참조 이미지: 이미지 편집 프로젝트에 사용할 이미지 파일을 최대 1개까지 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspectRatio	select	아니요	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	아니요	jpeg	-	jpeg, png
enableTranslation	select	아니요	true	-	true, false
promptUpsampling	select	아니요	false	-	false, true
safetyTolerance	number	아니요	2	min 0 / max 6	-
watermark	text	아니요	-	-	-

Qwen2 Image

qwen2-imageAPI로 사용 가능부분 지원: Files API 필요

이미지 · Alibaba의 Qwen2 이미지 모델은 현재 Rivya에서 하나의 고정 가격 이미지 프로젝트로 통합되어 있습니다. 공개 문서 양쪽이 공통으로 노출하는 공유 화면비 하위 집합과 함께 텍스트-투-이미지와 이미지-투-이미지를 안전하게 포함하며, PNG/JPEG 출력, seed 재사용, 단순 NSFW 스위치도 제공합니다.

API 가이드 모델 페이지

기본 크레딧

per_image · default=5.6 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

800 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "qwen2-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "16:9",
    "output_format": "png",
    "seed": 0,
    "nsfw_checker": "false"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 사용할 이미지 파일을 최대 1개까지 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
image_size	select	아니요	16:9	-	1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9
output_format	select	아니요	png	-	png, jpeg
seed	number	아니요	-	min 0	-
nsfw_checker	select	아니요	false	-	false, true

Qwen Image

qwen-imageAPI로 사용 가능부분 지원: Files API 필요

이미지 · Alibaba Qwen 제품군의 이미지 모델로 HD 프리셋(Square, Portrait, Landscape)과 PNG/JPEG 출력을 제공합니다. 중국어 프롬프트와 문화적 뉘앙스가 있는 시각 생성에 강합니다.

API 가이드 모델 페이지

기본 크레딧

per_output_megapixel · default=4 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "qwen-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "output_format": "png"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 사용할 이미지 파일을 최대 1개까지 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
image_size	select	아니요	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
output_format	select	아니요	png	-	png, jpeg

Midjourney

midjourney이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

이미지 · Midjourney은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

image · 4 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

참조 이미지: Midjourney은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Recraft Remove Background

recraft-remove-backgroundAPI로 사용 가능Files API 필요

이미지 · 기존 이미지 하나에서 피사체를 분리하는 Rivya의 Recraft 배경 제거 모델입니다. 다음 단계에 투명 자산, 깔끔한 컷아웃, 원래 배경이 없는 소스 이미지가 필요할 때 사용하세요.

API 가이드 모델 페이지

기본 크레딧

per_image · default=1 · ⌈total⌉

모드

image-to-image

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

소스 이미지: JPG, PNG 또는 WebP 이미지 1장만 업로드하세요. 최대 5 MB·16 MP이며 각 변은 256~4096 px여야 합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Recraft Crisp Upscale

recraft-crisp-upscaleAPI로 사용 가능Files API 필요

이미지 · 승인된 스틸 이미지 하나에 낮은 비용으로 선명도와 명료도를 높이는 Rivya의 Recraft 경량 이미지 업스케일 모델입니다. 더 무거운 납품급 업스케일이 아니라, 선택한 이미지에 내보내기 전 저렴한 폴리시 패스만 필요할 때 사용하세요.

API 가이드 모델 페이지

기본 크레딧

per_image · default=0.5 · ⌈total⌉

모드

image-to-image

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

소스 이미지: JPG, PNG 또는 WebP 이미지 1개만 업로드하세요. 최대 10 MB입니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Wan 2.7 Image Pro

wan-2-7-image-proAPI로 사용 가능부분 지원: Files API 필요

이미지 · Rivya에서 Wan 2.7 Image Pro는 현재 텍스트-이미지와 이미지-이미지를 지원합니다. 참고 이미지도 최대 9장까지 받을 수 있습니다. 이미지 1장당 고정 12크레딧; 요청당 이미지 1장.

API 가이드 모델 페이지

기본 크레딧

per_image · default=12 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 9 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "wan-2-7-image-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

참조 규칙

참고 이미지: 이미지 편집 프로젝트를 위해 이미지 파일을 최대 9장 업로드하세요. JPEG / PNG / WebP · ≤ 10 MB · ≥ 240 × 240 px.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	아니요	2K	-	1K, 2K
watermark	select	아니요	false	-	false, true
seed	number	아니요	-	min 0 / max 2147483647 / step 1	-

Wan 2.7 Image

wan-2-7-imageAPI로 사용 가능부분 지원: Files API 필요

이미지 · Rivya에서 Wan 2.7 Image는 현재 텍스트-이미지와 이미지-이미지를 지원합니다. 참고 이미지도 최대 9장까지 받을 수 있습니다. 이미지 1장당 고정 5크레딧; 요청당 이미지 1장.

API 가이드 모델 페이지

기본 크레딧

per_image · default=4.8 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 9 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "wan-2-7-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

참조 규칙

참고 이미지: 이미지 편집 프로젝트를 위해 이미지 파일을 최대 9장 업로드하세요. JPEG / PNG / WebP · ≤ 10 MB · ≥ 240 × 240 px.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	아니요	2K	-	1K, 2K
watermark	select	아니요	false	-	false, true
seed	number	아니요	-	min 0 / max 2147483647	-

Google Imagen4 Ultra

google-imagen4-ultraAPI로 사용 가능텍스트 입력 준비됨

이미지 · Google Imagen4 Ultra는 Rivya의 프리미엄 Imagen 텍스트-이미지 생성 등급입니다. 현재는 고정 12 크레딧, 단일 이미지 프로젝트로 통합되어 있으며 공개 프롬프트, 네거티브 프롬프트, 화면비, 시드 컨트롤을 제공합니다.

API 가이드 모델 페이지

기본 크레딧

per_image · default=12 · ⌈total⌉

모드

text-to-image

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

5000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "google-imagen4-ultra",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "선택 사항: 피하고 싶은 내용",
    "seed": "선택 사항: 시드 값"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3, auto
negative_prompt	text	아니요	-	-	-
seed	text	아니요	-	-	-

Google Imagen4

google-imagen4API로 사용 가능텍스트 입력 준비됨

이미지 · Google Imagen4는 Rivya의 표준 Imagen 텍스트-이미지 생성 등급입니다. 현재는 고정 8 크레딧, 단일 이미지 프로젝트로 통합되어 있으며 공개 프롬프트, 네거티브 프롬프트, 화면비, 시드 컨트롤을 제공합니다.

API 가이드 모델 페이지

기본 크레딧

per_request · default=8 · ⌈total⌉

모드

text-to-image

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

5000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "선택 사항: 피하고 싶은 내용",
    "seed": "선택 사항: 시드 값"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3, auto
negative_prompt	text	아니요	-	-	-
seed	text	아니요	-	-	-

Google Imagen4 Fast

google-imagen4-fastAPI로 사용 가능텍스트 입력 준비됨

이미지 · Google Imagen4 Fast는 Rivya의 가벼운 Imagen 텍스트-이미지 생성 등급입니다. 현재는 단일 이미지 프로젝트를 유지하고, 고정 4 크레딧 가격을 사용하며, 다중 이미지 출력을 열지 않은 상태에서 공개 프롬프트, 네거티브 프롬프트, 화면비, 시드 컨트롤을 제공합니다.

API 가이드 모델 페이지

기본 크레딧

per_request · default=4 · ⌈total⌉

모드

text-to-image

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

5000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "google-imagen4-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "16:9",
    "negative_prompt": "선택 사항: 피하고 싶은 내용",
    "seed": 1
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	16:9	-	1:1, 16:9, 9:16, 3:4, 4:3, auto
negative_prompt	text	아니요	-	-	-
seed	number	아니요	-	-	-

Topaz Image Upscaler

topaz-image-upscaleAPI로 사용 가능Files API 필요

이미지 · Topaz의 납품급 이미지 업스케일러로, 실제 크기 확대가 필요한 승인된 스틸을 위한 Rivya 옵션입니다. 구성이 이미 최종이고 남은 문제가 내보내기 해상도, 검토용 크기, 인쇄 준비일 때 사용하세요.

API 가이드 모델 페이지

기본 크레딧

per_image · 2K=10 · 4K=20 · 8K=40 · ⌈total⌉

모드

image-to-image

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

소스 이미지: JPEG, PNG 또는 WebP 이미지 1장만, 최대 10 MB. 확대 후 긴 변은 8192 px 이하.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
upscale_factor	select	아니요	2	-	1, 2, 4

Ideogram V3

ideogram-v3API로 사용 가능텍스트 입력 준비됨

이미지 · Ideogram V3는 텍스트 렌더링, 포스터 레이아웃, 디자인 우선 이미지 프롬프트를 위한 Rivya의 텍스트-이미지 모델입니다. 현재 가격은 TURBO 4크레딧, BALANCED 7크레딧, QUALITY 10크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉

모드

text-to-image

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

5000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "ideogram-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "seed": 1,
    "negative_prompt": "피하고 싶은 선택적 요소"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
rendering_speed	select	아니요	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	아니요	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	아니요	true	-	true, false
image_size	select	아니요	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	아니요	-	-	-
negative_prompt	text	아니요	-	-	-

Ideogram V3 Reframe

ideogram-v3-reframe이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

이미지 · Ideogram V3 Reframe은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

참조 이미지: Ideogram V3 Reframe은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Ideogram V3 Remix

ideogram-v3-remixAPI로 사용 가능Files API 필요

이미지 · Ideogram V3 Remix: 이미지당 TURBO 4 / BALANCED 7 / QUALITY 10 크레딧. 출력은 1–4장 중 선택합니다. 총액은 이미지당 요금에 선택한 장수를 곱하고 정수 크레딧으로 올림합니다.

API 가이드 모델 페이지

기본 크레딧

per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉

모드

image-to-image

API 입력

Files API 필요

입력

file

프롬프트 제한

5000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

참조 이미지: 이 프로젝트에는 정확히 이미지 파일 1장을 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
rendering_speed	select	아니요	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	아니요	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	아니요	true	-	true, false
image_size	select	아니요	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
num_images	select	아니요	1	-	1, 2, 3, 4
seed	number	아니요	-	-	-
strength	number	아니요	0.8	min 0.01 / max 1	-
negative_prompt	text	아니요	-	-	-

Ideogram Character

ideogram-characterAPI로 사용 가능Files API 필요

이미지 · 승인된 캐릭터 이미지 1장을 새 장면, 의상, 형식으로 확장하기 위한 캐릭터 일관성 옵션입니다. 이미지당 TURBO 12 / BALANCED 18 / QUALITY 24 크레딧. 출력은 1–4장 중 선택합니다. 총액은 이미지당 요금에 선택한 장수를 곱하고 정수 크레딧으로 올림합니다.

API 가이드 모델 페이지

기본 크레딧

per_image · TURBO=12 · BALANCED=18 · QUALITY=24 · ⌈total⌉

모드

image-to-image

API 입력

Files API 필요

입력

file

프롬프트 제한

5000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

캐릭터 참조 이미지: 이 프로젝트에는 정확히 이미지 파일 1장을 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
rendering_speed	select	아니요	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	아니요	AUTO	-	AUTO, REALISTIC, FICTION
expand_prompt	select	아니요	true	-	true, false
image_size	select	아니요	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
num_images	select	아니요	1	-	1, 2, 3, 4
seed	number	아니요	-	-	-
negative_prompt	text	아니요	-	-	-

Seedream 5.0 Pro

seedream-5-proAPI로 사용 가능부분 지원: Files API 필요

이미지 · Seedream 5.0 Pro는 캠페인 프레임, 에디토리얼 장면, 제품 구성을 위한 Rivya의 다중 참조 이미지 모델입니다. 텍스트-투-이미지와 이미지-투-이미지, 1K 또는 2K 출력, 최대 10장의 참조 이미지를 지원합니다.

API 가이드 모델 페이지

기본 크레딧

per_image_plus_reference_image · basic=7 · high=14 · additional_input_image=0.5 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 10 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedream-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "quality": "basic",
    "output_format": "png",
    "nsfw_checker": "false"
  }
}

참조 규칙

참조 이미지: JPEG, PNG 또는 WebP 이미지를 최대 10장까지 업로드하세요. 각 이미지는 10MB 이하여야 합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	아니요	basic	-	basic, high
output_format	select	아니요	png	-	png, jpeg
nsfw_checker	select	아니요	false	-	false, true

Seedream 5.0 Pro Layer Decomposition

seedream-5-pro-layer-decompositionAPI로 사용 가능Files API 필요

이미지 · Seedream 5.0 Pro Layer Decomposition은 소스 이미지 한 장을 기본 이미지와 재사용 가능한 PNG 레이어로 분리합니다. 선택형 프롬프트 또는 바운딩 박스 안내와 Auto, 1K, 1.5K, 2K 크기를 지원합니다.

API 가이드 모델 페이지

기본 크레딧

per_image · 1K=7 · 1.5K=7 · 2K=14 · auto_reserve=14 · ⌈total⌉

모드

image-to-layers

API 입력

Files API 필요

입력

file

프롬프트 제한

5000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

소스 이미지: 30MB 이하의 PNG, JPEG, WebP, BMP, TIFF 또는 GIF 이미지를 정확히 한 장 업로드하세요. HEIC와 HEIF는 지원하지 않습니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
size	select	아니요	auto	-	auto, 1K, 1.5K, 2K
output_format	select	아니요	jpeg	-	jpeg, png

Nano Banana 2 Lite

nano-banana-2-liteAPI로 사용 가능부분 지원: Files API 필요

이미지 · Nano Banana 2 Lite는 빠른 제품 콘셉트, 소셜 이미지 변형, 참조 기반 초안을 위한 Rivya의 저크레딧 Nano Banana 옵션입니다. 생성당 3크레딧의 고정 가격과 15개 화면비를 제공합니다.

API 가이드 모델 페이지

기본 크레딧

per_image · default=3 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

20000 자

참조 미디어

image · 10 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "nano-banana-2-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto"
  }
}

참조 규칙

참조 이미지: JPEG, PNG 또는 WebP 이미지를 최대 10장까지 업로드하세요. 각 이미지는 30MB 이하여야 합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	auto	-	auto, 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9

Qwen Image 3.0

qwen-image-3API로 사용 가능부분 지원: Files API 필요

이미지 · Qwen Image 3.0은 중국어 또는 영어 프롬프트, 참조 기반 레이아웃, 재현 가능한 시각 테스트를 위한 Rivya의 설정형 Qwen 이미지 모델입니다. 1K 또는 2K 출력, 프롬프트 확장, 네거티브 프롬프트, 시드 제어를 지원합니다.

API 가이드 모델 페이지

기본 크레딧

per_output_plus_input_image · output=4.8 · input_image=0.5 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

800 자

참조 미디어

image · 3 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "qwen-image-3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "선택 사항: 피하고 싶은 요소나 실패 유형을 최대 5,000자로 입력하세요.",
    "seed": 1
  }
}

참조 규칙

참조 이미지: JPEG, PNG, WebP, BMP, GIF 또는 TIFF 이미지를 최대 3장까지 업로드하세요. 각 이미지는 10MB 이하여야 합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	예	1K	-	1K, 2K
image_size	select	아니요	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9
output_format	select	아니요	png	-	png, jpeg
prompt_extend	select	아니요	true	-	true, false
nsfw_checker	select	아니요	false	-	false, true
negative_prompt	text	아니요	-	-	-
seed	number	아니요	1	min 0 / max 2147483647 / step 1	-

Qwen Image 3.0 Pro

qwen-image-3-proAPI로 사용 가능부분 지원: Files API 필요

이미지 · Qwen Image 3.0 Pro는 완성도 높은 캠페인 키 비주얼, 제품 장면, 포스터 콘셉트를 위한 Rivya의 별도 Pro 등급 Qwen 이미지 모델입니다. 중국어 또는 영어 프롬프트, 참조 이미지 최대 3장, 구분된 1K와 2K 크레딧 등급을 제공합니다.

API 가이드 모델 페이지

기본 크레딧

per_output_plus_input_image · 1K=6.4 · 2K=12 · input_image=0.5 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

800 자

참조 미디어

image · 3 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "qwen-image-3-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "선택 사항: 피하고 싶은 요소나 실패 유형을 최대 5,000자로 입력하세요.",
    "seed": 1
  }
}

참조 규칙

참조 이미지: JPEG, PNG, WebP, BMP, GIF 또는 TIFF 이미지를 최대 3장까지 업로드하세요. 각 이미지는 10MB 이하여야 합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	예	1K	-	1K, 2K
image_size	select	아니요	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9
output_format	select	아니요	png	-	png, jpeg
prompt_extend	select	아니요	true	-	true, false
nsfw_checker	select	아니요	false	-	false, true
negative_prompt	text	아니요	-	-	-
seed	number	아니요	1	min 0 / max 2147483647 / step 1	-

Grok Imagine Image 2.0

grok-imagine-image-2-0API로 사용 가능부분 지원: Files API 필요

이미지 · Grok Imagine Image 2.0은 텍스트로 이미지 한 장을 생성하는 기능과 표준 이미지 편집을 지원합니다. 편집 요청에서는 서명된 참조 이미지를 한 장에서 다섯 장까지 사용하고, 다섯 가지 고정 화면 비율과 자동 비율 옵션을 선택할 수 있습니다.

API 가이드 모델 페이지

기본 크레딧

per_image · text_to_image=4 · image_edit=4 · ⌈total⌉

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

20000 자

참조 미디어

image · 5 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "grok-imagine-image-2-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1"
  }
}

참조 규칙

참조 이미지: JPEG, PNG 또는 WebP 이미지를 한 장에서 다섯 장까지 업로드할 수 있으며, 각 이미지는 최대 10 MB입니다. 모든 참조 이미지에는 서명된 업로드 메타데이터가 필요합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspect_ratio	select	아니요	1:1	-	1:1, 2:3, 3:2, 16:9, 9:16, auto

Seedance 2.0

seedance-2API로 사용 가능텍스트 입력 준비됨

비디오 · ByteDance의 전체 Seedance 2.0 비디오 모델로, 프롬프트만 사용하는 생성, 프레임 기반 애니메이션, 멀티모달 참조 생성을 명시적으로 지원합니다. Rivya는 프레임 입력과 멀티모달 참조가 하나의 모호한 업로드 묶음으로 합쳐지지 않고 서로 배타적으로 유지되도록 문서화된 역할 분리를 명확히 유지합니다.

API 가이드 모델 페이지

기본 크레딧

per_input_and_output_second · 720p_without_video=41 · 1080p_with_video=62 · 1080p_without_video=102 · 4K_with_video=128 · 4K_without_video=208 · ⌈total⌉

모드

text-to-video, image-to-video, reference-to-video

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedance-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
seedance_scene	select	아니요	text	-	text, frames, reference
resolution	select	아니요	720p	-	720p, 1080p, 4K
aspect_ratio	select	아니요	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	아니요	5	min 4 / max 15	-
generate_audio	select	아니요	true	-	true, false
return_last_frame	select	아니요	false	-	false, true
web_search	select	아니요	false	-	false, true
nsfw_checker	select	아니요	false	-	false, true

Seedance 2.0 Fast

seedance-2-fastAPI로 사용 가능부분 지원: Files API 필요

비디오 · ByteDance의 더 빠른 Seedance 2.0 비디오 모델로, 프롬프트 생성, 프레임 기반 이미지 애니메이션과 멀티모달 참조 비디오를 지원합니다. Rivya에서는 첫·마지막 프레임 입력과 참조 이미지, 비디오, 오디오의 역할을 명확히 구분합니다.

API 가이드 모델 페이지

기본 크레딧

per_input_and_output_second · 480p_with_video=6.8 · 480p_without_video=11.7 · 720p_with_video=15 · 720p_without_video=24.8 · ⌈total⌉

모드

text-to-video, image-to-video, reference-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

20000 자

참조 미디어

image, video, audio · 15 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedance-2-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

참조 규칙

멀티모달 참조: Frames: 1–2 signed images. Reference: up to 9 JPEG/PNG/WebP/BMP/TIFF/GIF images under 30 MB each, 3 MP4/MOV videos of 2–15 seconds under 50 MB each, and 3 MP3/WAV audio clips of 2–15 seconds under 15 MB each. Video and audio each have a separate 15-second total limit.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
seedance_scene	select	아니요	text	-	text, frames, reference
resolution	select	아니요	720p	-	480p, 720p
aspect_ratio	select	아니요	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	아니요	5	min 4 / max 15	-
generate_audio	select	아니요	true	-	true, false
return_last_frame	select	아니요	false	-	false, true
web_search	select	아니요	false	-	false, true
nsfw_checker	select	아니요	false	-	false, true

Seedance 1.5 Pro

seedance-1-5-proAPI로 사용 가능부분 지원: Files API 필요

비디오 · 텍스트-비디오와 이미지-비디오를 위한 Seedance 모델로 네이티브 오디오-비주얼 동기화를 제공합니다. 480p-1080p, 4-12초 클립, 6가지 화면비, 동적 또는 고정 렌즈 제어, 선택적 오디오 생성과 립싱크를 지원합니다.

API 가이드 모델 페이지

기본 크레딧

per_output_second · 480p_without_audio=1.75 · 480p_with_audio=3.5 · 720p_without_audio=3.5 · 720p_with_audio=7 · 1080p_without_audio=7.5 · 1080p_with_audio=15 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

2500 자

참조 미디어

image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedance-1-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": 8,
    "generate_audio": "false",
    "aspectRatio": "1:1",
    "fixed_lens": "false",
    "nsfw_checker": "false"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트를 위해 이미지 파일을 최대 2장 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	아니요	720p	-	480p, 720p, 1080p
duration	number	아니요	8	min 4 / max 12 / step 1	-
generate_audio	select	아니요	false	-	false, true
aspectRatio	select	아니요	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9
fixed_lens	select	아니요	false	-	false, true
nsfw_checker	select	아니요	false	-	false, true

Seedance 1.0 Pro

seedance-1-0-pro이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

비디오 · Seedance 1.0 Pro은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

image: image

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Seedance 1.0 Pro Fast

seedance-1-0-pro-fast이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

비디오 · Seedance 1.0 Pro Fast은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

image: image

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Seedance 1.0 Lite

seedance-1-0-lite이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

비디오 · Seedance 1.0 Lite은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

image: image

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

HappyHorse 1.0

happyhorse-1-0API로 사용 가능부분 지원: Files API 필요

동영상 · Rivya의 HappyHorse 1.0은 하나의 모델 페이지에서 텍스트-투-비디오, 단일 이미지 애니메이션, 다중 이미지 참조 비디오를 지원합니다.

API 가이드 모델 페이지

기본 크레딧

per_output_second · 720p=28 · 1080p=48 · ⌈total⌉

모드

text-to-video, image-to-video, reference-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 9 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "happyhorse-1-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "seed": 0
  }
}

참조 규칙

참조 미디어: 이미지-투-비디오는 이미지 1장, 참조 비디오는 이미지 2~9장을 사용하세요. 이미지는 JPEG, PNG 또는 WebP 형식이고 10MB 이하여야 합니다. 단일 이미지 모드는 가로와 세로가 모두 300px 이상, 참조 모드는 짧은 변이 400px 이상이어야 합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	아니요	1080p	-	720p, 1080p
aspect_ratio	select	아니요	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
duration	number	아니요	5	min 3 / max 15	-
seed	number	아니요	0	min 0 / max 2147483647	-

Wan 2.7 Video

wan-2-7-videoAPI로 사용 가능부분 지원: Files API 필요

비디오 · Wan 2.7 Video: 720p = 16 credits/s; 1080p = 24 credits/s; text/image: integer 2–15 s; video edit: duration=0 or integer 2–10 s; nsfw_checker=true.

API 가이드 모델 페이지

기본 크레딧

per_output_second · 720p=16 · 1080p=24 · ⌈total⌉

모드

text-to-video, image-to-video, video-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image, video · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "wan-2-7-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "negative_prompt": "negative_prompt ≤ 500",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

참조 규칙

참고 미디어: 참고 미디어: image: JPG/PNG/WebP ≤ 30 MB; video edit: 1 MP4/MOV ≤ 30 MB + 0–1 image; maximum 2 assets total.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	아니요	720p	-	720p, 1080p
duration	number	아니요	5	min 0 / max 15	-
aspect_ratio	select	아니요	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
negative_prompt	text	아니요	-	-	-
prompt_extend	select	아니요	true	-	true, false
watermark	select	아니요	false	-	false, true
audio_setting	select	아니요	auto	-	auto, origin
seed	number	아니요	-	min 0 / max 2147483647	-

Wan 2.6

wan-2-6API로 사용 가능부분 지원: Files API 필요

비디오 · Wan 2.6은 미디어 없는 텍스트-비디오, 이미지 정확히 1장의 이미지-비디오, 비디오 1~3개의 비디오 편집을 지원합니다. 이미지와 비디오는 함께 사용할 수 없습니다. 텍스트와 이미지 입력은 5초, 10초, 15초를 지원하고 비디오 입력은 5초 또는 10초만 지원합니다.

API 가이드 모델 페이지

기본 크레딧

per_video · 720p_5=70 · 720p_10=140 · 720p_15=210 · 1080p_5=104.5 · 1080p_10=209.5 · 1080p_15=315 · ⌈total⌉

모드

text-to-video, image-to-video, video-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image, video · 3 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "wan-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1080p",
    "duration": "5",
    "multi_shots": "false",
    "nsfw_checker": "true"
  }
}

참조 규칙

참고 미디어: JPG/PNG/WebP 이미지 정확히 1장(256×256 이상, 10 MB 이하) 또는 MP4/MOV 비디오 1~3개(파일당 10 MB 이하)를 사용하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	아니요	1080p	-	720p, 1080p
duration	select	아니요	5	-	5, 10, 15
multi_shots	select	아니요	false	-	false, true
nsfw_checker	select	아니요	true	-	false, true

Wan 2.5 Video

wan-2-5-videoAPI로 사용 가능부분 지원: Files API 필요

비디오 · Wan 2.5는 이제 Rivya에서 텍스트-비디오와 이미지-비디오를 위한 하나의 공유 진입점으로 제공됩니다. 현재 가격은 `720p_5 = 60`, `720p_10 = 120`, `1080p_5 = 100`, `1080p_10 = 200`크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

per_video · 720p_5=60 · 720p_10=120 · 1080p_5=100 · 1080p_10=200 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

800 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "wan-2-5-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "피하고 싶은 선택 사항인 제외 항목 또는 실패 모드."
  }
}

참조 규칙

참고 이미지: 이미지-비디오 모드를 위해 이미지 파일을 최대 1장 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	아니요	720p	-	720p, 1080p
duration	select	아니요	5	-	5, 10
aspect_ratio	select	아니요	16:9	-	16:9, 9:16, 1:1
enable_prompt_expansion	select	아니요	false	-	false, true
seed	number	아니요	-	min 0 / max 2147483647	-
negative_prompt	text	아니요	-	-	-

Wan 2.2 A14B Turbo

wan-2-2-a14b-turboAPI로 사용 가능부분 지원: Files API 필요

비디오 · Wan 2.2 A14B Turbo는 텍스트, 이미지, 이미지+오디오에서 비디오를 생성합니다. 텍스트 또는 이미지 실행은 고정 5초이며 `480p = 40`, `580p = 60`, `720p = 80`; 이미지+오디오는 출력 1초당 `480p = 12`, `580p = 18`, `720p = 24`크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

per_output_second · 480p_standard_5s=40 · 580p_standard_5s=60 · 720p_standard_5s=80 · 480p_speech=12 · 580p_speech=18 · 720p_speech=24 · ⌈total⌉

모드

text-to-video, image-to-video, speech-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image, audio · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "피하고 싶은 선택 사항인 제외 항목 또는 실패 모드.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

참조 규칙

참고 미디어: 자산을 최대 2개 업로드하세요. 텍스트 모드는 필요하지 않고, 이미지-비디오는 이미지 1장을 사용하며, 이미지+오디오 기반 경로는 이미지 1장과 오디오 클립 1개를 사용합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	아니요	720p	-	480p, 580p, 720p
aspect_ratio	select	아니요	16:9	-	16:9, 9:16
enable_prompt_expansion	select	아니요	false	-	false, true
seed	number	아니요	-	min 0 / max 2147483647	-
acceleration	select	아니요	none	-	none, regular
num_frames	number	아니요	80	min 40 / max 120 / step 4	-
frames_per_second	number	아니요	16	min 4 / max 60 / step 1	-
negative_prompt	text	아니요	-	-	-
num_inference_steps	number	아니요	27	min 2 / max 40 / step 1	-
guidance_scale	number	아니요	3.5	min 1 / max 10 / step 0.1	-
shift	number	아니요	5	min 1 / max 10 / step 0.1	-
enable_safety_checker	select	아니요	true	-	true, false

Wan Animate Replace

wan-2-2-animate-replaceAPI로 사용 가능Files API 필요

비디오 · 소스 클립이 이미 올바른 움직임과 프레이밍을 갖고 있고 보이는 피사체만 바뀌어야 할 때 Wan Animate Replace를 선택하세요. 전체 샷을 다시 상상해야 한다면 프롬프트 기반 생성으로 돌아가고, 피사체 교체보다 더 많은 작업이 필요하다면 더 넓은 편집 프로젝트를 사용하세요.

API 가이드 모델 페이지

기본 크레딧

per_output_second · 480p=6 · 580p=9.5 · 720p=12.5 · ⌈total⌉

모드

video-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

video, image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

video: video, image

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	아니요	480p	-	480p, 580p, 720p

Hailuo 2.3

hailuo-2-3API로 사용 가능Files API 필요

동영상 · MiniMax의 이미지-동영상 변환 모델로 Standard/Pro 품질 단계, 768P/1080P 해상도, 6초 또는 10초 클립을 제공합니다. 정지 이미지에서 더 부드러운 움직임과 자연스러운 전환을 만드는 것으로 알려져 있습니다.

API 가이드 모델 페이지

기본 크레딧

per_video · standard_768P_6=25 · standard_768P_10=40 · standard_1080P_6=40 · pro_768P_6=40 · pro_768P_10=80 · pro_1080P_6=70 · ⌈total⌉

모드

image-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

5000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

참조 이미지: 이미지 프로젝트에 최대 1개의 이미지 파일을 업로드하세요. JPG / PNG / WebP · ≤ 10 MB · 1 image.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
quality	select	아니요	standard	-	standard, pro
resolution	select	아니요	768P	-	768P, 1080P
duration	select	아니요	6	-	6, 10
nsfw_checker	select	아니요	true	-	false, true

Hailuo Pro

hailuo-proAPI로 사용 가능부분 지원: Files API 필요

동영상 · MiniMax의 현재 Hailuo Pro 동영상 모델이 텍스트-동영상 생성과 이미지-동영상 변환을 모두 지원하는 고정 Pro 단계 모델로 연결되어 있습니다. 이미지 모드는 1장 또는 2장의 참조 이미지를 받을 수 있고, 두 번째 이미지는 마지막 프레임으로 사용되며, 각 실행은 현재 57 크레딧이 듭니다. Fixed output: 1080P · 6s · 57 credits.

API 가이드 모델 페이지

기본 크레딧

per_video · 1080P_6=57 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

1500 자

참조 미디어

image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "hailuo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "prompt_optimizer": "true",
    "nsfw_checker": "true"
  }
}

참조 규칙

참조 이미지: 이미지 모드는 최대 2장의 이미지를 받을 수 있으며, 두 번째 이미지는 마지막 프레임이 됩니다. · JPG / PNG / WebP · ≤ 10 MB

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
prompt_optimizer	select	아니요	true	-	false, true
nsfw_checker	select	아니요	true	-	false, true

Hailuo Standard

hailuo-standardAPI로 사용 가능부분 지원: Files API 필요

동영상 · MiniMax의 구형 Hailuo Standard 동영상 모델로, 여기서는 텍스트-동영상 생성과 이미지-동영상 변환을 모두 처리하는 하나의 모델로 통합되어 있습니다. 이미지 모드는 1장 또는 2장의 참조 이미지를 받을 수 있고, 두 번째 이미지는 마지막 프레임으로 사용되며, 현재 확인된 공개 가격 단계는 12~50 크레딧 범위입니다.

API 가이드 모델 페이지

기본 크레딧

per_video · text_6=30 · text_10=50 · image_512P_6=12 · image_512P_10=20 · image_768P_10=50 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

1500 자

참조 미디어

image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "hailuo-standard",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "6",
    "resolution": "768P",
    "prompt_optimizer": "true"
  }
}

참조 규칙

참조 이미지: 이미지 모드는 최대 2장의 이미지를 받을 수 있으며, 두 번째 이미지는 마지막 프레임이 됩니다. JPG / PNG / WebP · ≤ 10 MB.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
duration	select	아니요	6	-	6, 10
resolution	select	아니요	768P	-	512P, 768P
prompt_optimizer	select	아니요	true	-	false, true

Kling 3.0

kling-3-0API로 사용 가능부분 지원: Files API 필요

동영상 · Kuaishou의 프리미엄 동영상 모델로 텍스트-동영상과 이미지-동영상을 지원하며, Standard (720P), Pro (1080P), 4K 티어, 단일 또는 멀티샷 구조, 3~15초 길이, 선택적 오디오 생성, 최대 2장의 참조 이미지를 제공합니다.

API 가이드 모델 페이지

기본 크레딧

per_output_second · 720p_without_audio=14 · 720p_with_audio=20 · 1080p_without_audio=18 · 1080p_with_audio=27 · 4K=67 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

2500 자

참조 미디어

image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "kling-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "pro",
    "multi_shots": "false",
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "16:9"
  }
}

참조 규칙

참조 미디어: 이미지-동영상 프로젝트에는 총 최대 2개의 이미지 파일을 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
mode	select	아니요	pro	-	std, pro, 4k
multi_shots	select	아니요	false	-	false, true
duration	select	아니요	5	-	3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
sound	select	아니요	false	-	false, true
aspect_ratio	select	아니요	16:9	-	16:9, 9:16, 1:1

Kling 3.0 motion-control

kling-3-0-motion-controlAPI로 사용 가능Files API 필요

동영상 · 정확히 이미지 1장 + 모션 동영상 1개 프로젝트라 정체성과 움직임 역할이 명확함 Standard (720P): 20 × 검증된 모션 동영상 초, Pro (1080P): 27 × 초

API 가이드 모델 페이지

기본 크레딧

per_output_second · 720p=20 · 1080p=27 · ⌈total⌉

모드

video-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

2500 자

참조 미디어

image, video · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

참조 이미지 + 모션 동영상: 정확히 이미지 1장 + 모션 동영상 1개 프로젝트라 정체성과 움직임 역할이 명확함 Standard (720P): 20 × 검증된 모션 동영상 초, Pro (1080P): 27 × 초

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
mode	select	아니요	720p	-	720p, 1080p
character_orientation	select	아니요	video	-	video, image

Kling 2.6

kling-2-6API로 사용 가능부분 지원: Files API 필요

동영상 · 선택적 오디오 생성, 5초/10초 클립, 3가지 화면비를 제공하는 Kuaishou의 동영상 모델입니다. 자연스러운 물리 표현과 함께 사람 움직임과 표현력 있는 캐릭터 애니메이션에 강합니다.

API 가이드 모델 페이지

기본 크레딧

per_video · 5s_without_audio=55 · 5s_with_audio=110 · 10s_without_audio=110 · 10s_with_audio=220 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

1000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "kling-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "1:1"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에는 최대 이미지 파일 1장을 업로드하세요. JPEG/PNG ≤ 10 MB.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
duration	select	아니요	5	-	5, 10
sound	select	아니요	false	-	false, true
aspect_ratio	select	아니요	1:1	-	1:1, 16:9, 9:16

Kling 2.6 motion-control

kling-2-6-motion-controlAPI로 사용 가능Files API 필요

동영상 · 참조 이미지 1장과 모션 동영상 1개로 하나의 피사체를 구동하기 위한 전용 모션 전송 프로젝트입니다. 더 저렴한 Kling motion-control 패스를 원하고 Kling 3.0 motion-control의 추가 장면 컨트롤이 없어도 괜찮을 때 사용하세요.

API 가이드 모델 페이지

기본 크레딧

per_output_second · 720p=11 · 1080p=18 · ⌈total⌉

모드

video-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

2500 자

참조 미디어

image, video · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

참조 이미지 + 모션 동영상: 정확히 캐릭터 이미지 1장과 모션 클립 1개를 업로드하세요. 두 소재 모두 머리, 어깨, 몸통이 선명하게 보여야 합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
mode	select	아니요	720p	-	720p, 1080p
character_orientation	select	아니요	video	-	video, image

Kling V2.5 Turbo Pro

kling-v2-5-turbo-proAPI로 사용 가능부분 지원: Files API 필요

동영상 · Kuaishou의 Kling V2.5 Turbo Pro 동영상 모델은 이제 텍스트-동영상과 이미지-동영상을 모두 지원합니다. 공개 가격 근거가 텍스트와 이미지의 5초/10초 구간을 모두 명확히 포함하므로, Rivya는 이를 42 / 84크레딧으로 직접 매핑합니다.

API 가이드 모델 페이지

기본 크레딧

per_video · 5s=42 · 10s=84 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

2500 자

참조 미디어

image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "동영상에서 피해야 할 내용을 설명하세요",
    "cfg_scale": 0.5
  }
}

참조 규칙

참조 이미지: 이미지-동영상 모드로 전환하려면 선택적으로 최대 2장의 이미지를 업로드하세요. 두 번째 이미지는 테일 프레임으로 매핑됩니다. JPEG/PNG ≤ 10 MB.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
duration	select	아니요	5	-	5, 10
aspect_ratio	select	아니요	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	아니요	-	-	-
cfg_scale	number	아니요	0.5	min 0 / max 1 / step 0.1	-

Kling V2.1 Master

kling-v2-1-masterAPI로 사용 가능부분 지원: Files API 필요

동영상 · Kuaishou의 구형 Kling V2.1 Master 동영상 모델은 이제 Rivya에서 텍스트-동영상과 이미지-동영상을 모두 지원합니다. 현재 가격은 5초 160크레딧, 10초 320크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

per_video · 5s=160 · 10s=320 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "kling-v2-1-master",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "동영상에서 피해야 할 내용을 설명하세요",
    "cfg_scale": 0.5
  }
}

참조 규칙

참조 이미지: 이미지-동영상 모드로 전환하려면 선택적으로 이미지 1장을 업로드하세요. 비워 두면 텍스트 모드로 유지됩니다. JPEG/PNG ≤ 10 MB.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
duration	select	아니요	5	-	5, 10
aspect_ratio	select	아니요	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	아니요	-	-	-
cfg_scale	number	아니요	0.5	min 0 / max 1 / step 0.1	-

Kling V2.1 Pro

kling-v2-1-proAPI로 사용 가능Files API 필요

동영상 · Kuaishou의 구형 Kling V2.1 Pro 이미지-동영상 모델은 첫 프레임과 선택형 테일 프레임 이미지를 지원합니다. 현재 가격은 5초 50크레딧, 10초 100크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

per_video · 5s=50 · 10s=100 · ⌈total⌉

모드

image-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

5000 자

참조 미디어

image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

참조 이미지: 이미지 모드는 최대 2개의 이미지 파일을 받을 수 있으며, 두 번째 이미지는 테일 프레임으로 매핑됩니다. JPEG/PNG ≤ 10 MB.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
duration	select	아니요	5	-	5, 10
negative_prompt	text	아니요	-	-	-
cfg_scale	number	아니요	0.5	min 0 / max 1 / step 0.1	-

Kling V2.1 Standard

kling-v2-1-standardAPI로 사용 가능Files API 필요

동영상 · Kuaishou의 구형 Kling V2.1 Standard 이미지-동영상 모델입니다. 현재 가격은 5초 25크레딧, 10초 50크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

per_video · 5s=25 · 10s=50 · ⌈total⌉

모드

image-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

5000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

참조 이미지: 이미지 모드는 첫 프레임으로 사용할 이미지 파일을 최대 1개까지 받을 수 있습니다. JPEG/PNG ≤ 10 MB.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
duration	select	아니요	5	-	5, 10
negative_prompt	text	아니요	-	-	-
cfg_scale	number	아니요	0.5	min 0 / max 1 / step 0.1	-

Kling AI Avatar Pro

kling-ai-avatar-proAPI로 사용 가능Files API 필요

동영상 · Kuaishou의 Kling AI Avatar Pro 고품질 말하는 아바타 모델로, 인물 이미지 1장과 오디오 클립 1개를 사용해 립싱크 아바타 동영상을 생성합니다. Rivya는 검증된 오디오 길이를 기준으로 초당 16크레딧을 청구하며, 최대 300초까지 지원하고 총액은 올림 처리합니다.

API 가이드 모델 페이지

기본 크레딧

per_input_second · default=16 · ⌈total⌉

모드

image-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

5000 자

참조 미디어

image, audio · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

인물 이미지와 오디오: 인물 이미지 1장과 오디오 클립 1개를 함께 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Kling AI Avatar Standard

kling-ai-avatar-standardAPI로 사용 가능Files API 필요

동영상 · Kuaishou의 Kling AI Avatar Standard 말하는 아바타 모델로, 인물 이미지 1장과 오디오 클립 1개를 사용해 립싱크 아바타 동영상을 생성합니다. Rivya는 검증된 오디오 길이를 기준으로 초당 8크레딧을 청구하며, 최대 300초까지 지원하고 총액은 올림 처리합니다.

API 가이드 모델 페이지

기본 크레딧

per_input_second · default=8 · ⌈total⌉

모드

image-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

5000 자

참조 미디어

image, audio · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

인물 이미지와 오디오: 인물 이미지 1장과 오디오 클립 1개를 함께 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Infinitalk

infinitalkAPI로 사용 가능Files API 필요

동영상 · Infinitalk는 인물 이미지와 오디오를 결합하는 말하는 동영상 모델입니다. 현재 가격은 해상도와 오디오 길이에 따라 책정되며, 480p는 초당 3크레딧, 720p는 초당 12크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

per_input_second · 480p=3 · 720p=12 · ⌈total⌉

모드

image-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

5000 자

참조 미디어

image, audio · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

인물 이미지와 오디오: 인물 이미지 1장과 오디오 클립 1개를 함께 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	아니요	480p	-	480p, 720p
seed	number	아니요	-	min 10000 / max 1000000	-

Runway

runwayAPI로 사용 가능부분 지원: Files API 필요

비디오 · Runway는 텍스트-투-비디오와 이미지-투-비디오를 모두 지원하는 독립형 비디오 모델입니다. 현재 공개 가격 근거는 3개 생성 구간만 확인되므로 Rivya는 검증된 세트인 `720p_5 = 12`, `720p_10 = 30`, `1080p_5 = 30`만 유지합니다.

API 가이드 모델 페이지

기본 크레딧

per_video · 720p_5s=12 · 720p_10s=30 · 1080p_5s=30 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

1800 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "runway",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "워터마크를 비활성화하려면 비워 두세요"
  }
}

참조 규칙

참조 이미지: 이미지-투-비디오 모드로 전환하려면 이미지 한 장을 선택적으로 업로드하세요. 비워 두면 텍스트 모드로 유지됩니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
duration	select	아니요	5	-	5, 10
quality	select	아니요	720p	-	720p, 1080p
aspectRatio	select	아니요	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16
waterMark	text	아니요	-	-	-

Runway Aleph

runway-alephAPI로 사용 가능Files API 필요

비디오 · 기존 클립을 새로운 시각 결과로 재작업하는 소스 비디오 변환 프로젝트입니다. 모션은 입력 영상에서 오고 창의적 방향은 프롬프트에서 오며, 고정 90크레딧 가격이 필요할 때 Aleph를 사용하세요.

API 가이드 모델 페이지

기본 크레딧

per_video · default=90 · ⌈total⌉

모드

video-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

5000 자

참조 미디어

video, image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

입력 미디어: Aleph로 변환하려는 소스 클립을 업로드하세요. 추가 스타일 또는 피사체 가이드가 필요할 때만 선택형 스틸 이미지 1장을 추가하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
aspectRatio	select	아니요	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9
waterMark	text	아니요	-	-	-
seed	number	아니요	-	-	-

Luma Modify Video

luma-modify-video이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

동영상 · Luma Modify Video은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

video · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

video: video

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Grok Imagine Video 1.5 Preview

grok-imagine-videoAPI로 사용 가능부분 지원: Files API 필요

동영상 · Grok Imagine Video 1.5 Preview는 1–15초, 480p 또는 720p, 참고 이미지 최대 7장, 4096자 이내 프롬프트를 지원합니다.

API 가이드 모델 페이지

기본 크레딧

per_output_second · 480p=2.4 · 720p=4.5 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

4096 자

참조 미디어

image · 7 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "grok-imagine-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": 8,
    "resolution": "480p",
    "aspect_ratio": "auto",
    "nsfw_checker": "true"
  }
}

참조 규칙

참조 이미지: JPEG, PNG 또는 WebP 이미지를 최대 7장, 각 20MB까지 사용할 수 있습니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
duration	number	아니요	8	min 1 / max 15 / step 1	-
resolution	select	아니요	480p	-	480p, 720p
aspect_ratio	select	아니요	auto	-	auto, 1:1, 16:9, 9:16, 3:2, 2:3
nsfw_checker	select	아니요	true	-	true, false

Sora 2 Pro

sora-2-pro이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

비디오 · Sora 2 Pro은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

image: image

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Sora 2

sora-2이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

비디오 · Sora 2은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

image: image

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Sora Watermark Remover

sora-watermark-remover이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

비디오 · Sora Watermark Remover은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Topaz Video Upscaler

topaz-video-upscaleAPI로 사용 가능Files API 필요

비디오 · 업로드한 동영상 1개, 프롬프트 없음, 업스케일 배율 1x·2x·4x를 지원하며 기본값은 2x입니다.

API 가이드 모델 페이지

기본 크레딧

per_input_second · 1x_or_2x=8 · 4x=14 · ⌈total⌉

모드

video-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

video · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

소스 비디오: Rivya는 최대 10MB의 MP4, MOV 또는 MKV 파일 1개를 받습니다. 상위 인터페이스는 50MB를 허용하므로 Rivya 한도가 더 엄격합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
upscale_factor	select	아니요	2	-	1, 2, 4

Veo3.1 Quality

veo3-1-qualityAPI로 사용 가능부분 지원: Files API 필요

비디오 · 720p는 225, 1080p는 233(232.5 올림), 4K는 285 크레딧입니다. Extend는 225, 조건을 충족한 1080p/4K 결과 작업은 8/60입니다. 오디오는 실험적이며 제공을 보장하지 않습니다. 전달 전에 모든 결과를 직접 확인하세요. 해상도 작업은 본인 소유의 성공한 720p 기본 작업 또는 Extend 결과가 필요하며 직접 1080p/4K 결과에는 다시 적용할 수 없습니다.

API 가이드 모델 페이지

기본 크레딧

per_video · generate_720p=225 · generate_1080p=232.5 · generate_4K=285 · extend_quality=225 · get_1080p=7.5 · get_4K=60 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "veo3-1-quality",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "watermark": "선택 사항인 워터마크 텍스트",
    "enableTranslation": "true"
  }
}

참조 규칙

참고 이미지: 이미지 1장을 시작 프레임으로 사용하거나 이미지 2장을 시작 및 종료 프레임으로 사용합니다. JPEG / PNG · 1–2 · 10 MB.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
generationType	select	아니요	FIRST_AND_LAST_FRAMES_2_VIDEO	-	FIRST_AND_LAST_FRAMES_2_VIDEO
aspectRatio	select	아니요	16:9	-	16:9, 9:16, Auto
resolution	select	아니요	720p	-	720p, 1080p, 4k
duration	select	아니요	8	-	4, 6, 8
watermark	text	아니요	-	-	-
enableTranslation	select	아니요	true	-	true, false

Veo3.1 Fast

veo3-1-fastAPI로 사용 가능부분 지원: Files API 필요

비디오 · 텍스트, 시작/끝 프레임, 참조 이미지 1~3장을 지원하며 720p/1080p/4K와 4/6/8초를 직접 선택할 수 있습니다. 오디오는 실험적이며 제공을 보장하지 않습니다. 전달 전에 모든 결과를 직접 확인하세요.

API 가이드 모델 페이지

기본 크레딧

per_video · generate_720p=30 · generate_1080p=37.5 · generate_4K=90 · extend_fast=30 · get_1080p=7.5 · get_4K=60 · ⌈total⌉

모드

text-to-video, image-to-video, reference-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 3 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "veo3-1-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "generationType": "TEXT_2_VIDEO",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "watermark": "선택 사항인 워터마크 텍스트",
    "enableTranslation": "true"
  }
}

참조 규칙

참고 이미지: 참조 모드는 검증된 JPEG/PNG 1~3장, 장당 최대 10 MB, 16:9/9:16만 허용하며 길이는 8초여야 합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
generationType	select	아니요	TEXT_2_VIDEO	-	TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatio	select	아니요	16:9	-	16:9, 9:16, Auto
resolution	select	아니요	720p	-	720p, 1080p, 4k
duration	select	아니요	8	-	4, 6, 8
watermark	text	아니요	-	-	-
enableTranslation	select	아니요	true	-	true, false

Veo3.1 Lite

veo3-1-liteAPI로 사용 가능부분 지원: Files API 필요

API 가이드 모델 페이지

기본 크레딧

per_video · generate_720p=15 · generate_1080p=22.5 · generate_4K=75 · extend_lite=15 · get_1080p=7.5 · get_4K=60 · ⌈total⌉

모드

text-to-video, image-to-video, reference-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 3 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "veo3-1-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "watermark": "선택 사항인 워터마크 텍스트",
    "enableTranslation": "true"
  }
}

참조 규칙

참고 이미지: 참조 모드는 검증된 JPEG/PNG 1~3장, 장당 최대 10 MB, 16:9/9:16만 허용하며 길이는 8초여야 합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
generationType	select	아니요	FIRST_AND_LAST_FRAMES_2_VIDEO	-	FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatio	select	아니요	16:9	-	16:9, 9:16, Auto
resolution	select	아니요	720p	-	720p, 1080p, 4k
duration	select	아니요	8	-	4, 6, 8
watermark	text	아니요	-	-	-
enableTranslation	select	아니요	true	-	true, false

Wan 3.0 Video

wan-3-0-videoAPI로 사용 가능부분 지원: Files API 필요

비디오 · Wan 3.0 Video는 Standard와 Prime 등급에 텍스트-비디오, 첫·마지막 프레임 가이드, 서명된 멀티모달 참조를 결합합니다. 480P, 720P, 1080P 출력과 명시적인 2~30초 클립 또는 지능형 길이를 지원하며, 이미지·비디오·오디오가 포함된 참조 묶음을 사용할 수 있습니다.

API 가이드 모델 페이지

기본 크레딧

per_input_and_output_second · standard_480P=8 · standard_720P=16 · standard_1080P=32 · prime_480P=12.2 · prime_720P=25.2 · prime_1080P=50.4 · ⌈total⌉

모드

text-to-video, image-to-video, reference-to-video, video-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

20000 자

참조 미디어

image, video, audio · 20 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "wan-3-0-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0
  }
}

참조 규칙

가이드 프레임 또는 서명된 멀티모달 참조: 프레임 장면은 필수 첫 이미지와 선택 사항인 마지막 이미지 한 장을 받습니다. 참조 장면은 파일당 20MB인 JPEG, 비투명 PNG, WebP 또는 BMP 이미지 최대 10장, 파일당 95MB이자 길이 1~15초인 MP4/MOV 비디오 최대 5개, 파일당 15MB이자 길이 1~15초인 MP3/WAV 오디오 클립 최대 5개를 받습니다. 비디오와 오디오의 총길이는 각각 15초로 제한됩니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
seedance_scene	select	아니요	text	-	text, frames, reference
variant	select	아니요	standard	-	standard, prime
resolution	select	아니요	1080P	-	480P, 720P, 1080P
aspect_ratio	select	아니요	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16
duration	number	아니요	5	min -1 / max 30 / step 1	-
audio	select	아니요	true	-	true, false
seed	number	아니요	-	min 0 / max 2147483647 / step 1	-

Flux 3

flux-3이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

비디오 · Flux 3는 출시 예정 비디오 카탈로그에 Text to Video와 Image to Video 라벨로 표시됩니다. Rivya는 공개되지 않은 제어나 동작을 약속하지 않습니다.

모델 페이지

기본 크레딧

이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

모드

API 입력

이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Kling 3.0 Turbo

kling-3-turboAPI로 사용 가능부분 지원: Files API 필요

비디오 · Kling 3.0 Turbo는 텍스트 프롬프트만으로 영상을 생성하거나 한 장의 정지 이미지를 움직이는 데 특화된 Rivya의 Kling 비디오 모델입니다. 두 방식 모두 720p와 1080p 출력을 지원하며, 길이는 3초부터 15초까지 정수 단위로 설정할 수 있습니다. 화면비 제어는 텍스트-비디오 방식에서만 사용할 수 있습니다.

API 가이드 모델 페이지

기본 크레딧

per_output_second · 720p=18 · 1080p=22.5 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

2500 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "kling-3-turbo",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}

참조 규칙

선택 사항인 시작 이미지: 이미지-비디오의 경우 최대 10MB의 JPEG 또는 PNG 이미지 정확히 한 장을 업로드하세요. 텍스트-비디오는 업로드한 미디어를 사용하지 않습니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	아니요	720p	-	720p, 1080p
duration	number	아니요	5	min 3 / max 15 / step 1	-
aspect_ratio	select	아니요	16:9	-	1:1, 9:16, 16:9

Seedance 2.0 Mini

seedance-2-miniAPI로 사용 가능부분 지원: Files API 필요

비디오 · Seedance 2.0 Mini는 프롬프트만 사용하는 비디오, 첫 프레임 또는 첫·마지막 프레임 애니메이션, 이미지·비디오·오디오를 혼합한 참조 작업을 위한 Rivya의 낮은 요율 멀티모달 Seedance 워크플로입니다. 480p와 720p 단계는 4~15초 출력을 지원하며, 세 입력 장면은 서로 배타적으로 유지됩니다.

API 가이드 모델 페이지

기본 크레딧

per_input_and_output_second · 480p_with_video=2.4 · 480p_without_video=3.8 · 720p_with_video=5 · 720p_without_video=8.2 · ⌈total⌉

모드

text-to-video, image-to-video, reference-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

20000 자

참조 미디어

image, video, audio · 15 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedance-2-mini",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "web_search": "false",
    "nsfw_checker": "true"
  }
}

참조 규칙

가이드 프레임 또는 멀티모달 참조 자료: 프레임 장면은 JPEG/PNG/WebP/GIF 이미지를 한두 장 지원하며 파일당 최대 30MB입니다. 참조 장면은 이런 이미지 최대 9장, 파일당 최대 50MB이자 길이 2~15초인 MP4/MOV/MKV 비디오 3개, 파일당 최대 15MB이자 길이 2~15초인 MP3/WAV 오디오 파일 3개를 지원합니다. 비디오와 오디오 총길이는 각각 15초로 제한됩니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
seedance_scene	select	아니요	text	-	text, frames, reference
resolution	select	아니요	720p	-	480p, 720p
aspect_ratio	select	아니요	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	아니요	5	min 4 / max 15 / step 1	-
generate_audio	select	아니요	true	-	true, false
web_search	select	아니요	false	-	false, true
nsfw_checker	select	아니요	true	-	false, true

Seedance 2.5

seedance-2-5API로 사용 가능부분 지원: Files API 필요

비디오 · Seedance 2.5는 프롬프트만 사용하는 비디오, 첫·마지막 프레임 가이드, 멀티모달 참조, 비디오 기반 변환을 위한 Rivya의 대규모 Seedance 워크플로입니다. Mini보다 1080p 단계, 최대 30초 출력, 자동 길이, MP4 또는 MOV 출력, 훨씬 큰 이미지·비디오·오디오 참조 용량을 제공합니다.

API 가이드 모델 페이지

기본 크레딧

per_input_and_output_second · 480p_with_video=17 · 480p_without_video=28 · 720p_with_video=38 · 720p_without_video=63 · 1080p_with_video=68.5 · 1080p_without_video=114 · ⌈total⌉

모드

text-to-video, image-to-video, reference-to-video, video-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

30000 자

참조 미디어

image, video, audio · 50 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedance-2-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "true"
  }
}

참조 규칙

가이드 프레임 또는 대용량 참조 자료: 프레임 장면은 파일당 최대 30MB인 JPEG, PNG, WebP, BMP, GIF 또는 TIFF 이미지 1장이나 2장을 지원합니다. 참조 장면은 이미지 최대 30장, 파일당 최대 95MB이자 길이 2~30초인 MP4/MOV 비디오 10개, 파일당 최대 15MB이자 길이 2~30초인 MP3/WAV 오디오 파일 10개를 지원합니다. 비디오와 오디오 총길이는 각각 30초로, 모든 미디어의 합계는 50개 파일로 제한됩니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
seedance_scene	select	아니요	text	-	text, frames, reference
resolution	select	아니요	720p	-	480p, 720p, 1080p
aspect_ratio	select	아니요	adaptive	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	아니요	5	min -1 / max 30 / step 1	-
output_format	select	아니요	mp4	-	mp4, mov
generate_audio	select	아니요	true	-	true, false
return_last_frame	select	아니요	false	-	false, true
web_search	select	아니요	false	-	false, true
nsfw_checker	select	아니요	true	-	false, true

MiniMax H3

minimax-h3API로 사용 가능부분 지원: Files API 필요

비디오 · MiniMax H3는 프롬프트만 사용하는 생성, 첫·마지막 프레임 애니메이션, 멀티모달 참조 작업을 위한 Rivya의 768P 또는 2K 비디오 모델입니다. 참조 방식은 이미지, MP4 또는 MOV 클립, MP3 또는 WAV 오디오를 조합할 수 있으며, 크레딧 공식은 검증된 입력 비디오 시간과 처음 5장을 초과하는 이미지를 별도로 계산합니다.

API 가이드 모델 페이지

기본 크레딧

per_input_and_output_second · 768P=16 · 2K=26 · additional_image_after_five=8 · ⌈total⌉

모드

text-to-video, image-to-video, reference-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

7000 자

참조 미디어

image, video, audio · 15 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "minimax-h3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6
  }
}

참조 규칙

가이드 프레임 또는 멀티모달 참조 자료: 프레임 장면은 파일당 최대 30MB인 JPEG, PNG 또는 WebP 이미지 1장이나 2장을 지원합니다. 참조 장면은 이런 이미지 최대 9장, 파일당 최대 50MB이자 길이 2~15초인 MP4/MOV 비디오 3개, 파일당 최대 15MB이자 길이 2~15초인 MP3/WAV 오디오 파일 3개를 지원합니다. 비디오와 오디오 총길이는 각각 15초이고, 모든 미디어는 총 15개 파일로 제한되며 오디오는 단독으로 사용할 수 없습니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
seedance_scene	select	아니요	text	-	text, frames, reference
resolution	select	아니요	2K	-	768P, 2K
aspect_ratio	select	아니요	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
minimax_single_frame_role	select	아니요	first	-	first, last
duration	number	아니요	6	min 4 / max 15 / step 1	-

HappyHorse 1.1

happyhorse-1-1API로 사용 가능부분 지원: Files API 필요

비디오 · HappyHorse 1.1은 프롬프트만 사용하는 클립, 단일 이미지 애니메이션, 여러 이미지를 참조하는 비디오를 720p 또는 1080p로 3~15초 동안 출력하는 유연한 AI 비디오 모델입니다.

API 가이드 모델 페이지

기본 크레딧

per_output_second · 720p=22.5 · 1080p=29 · ⌈total⌉

모드

text-to-video, image-to-video, reference-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 9 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "happyhorse-1-1",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5
  }
}

참조 규칙

첫 프레임 또는 참조 이미지: 첫 프레임 애니메이션에는 JPEG, PNG 또는 WebP 이미지 한 장을, 참조 기반 비디오에는 이미지 2~9장을 업로드하세요. 각 파일은 최대 20MB까지 가능합니다.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	아니요	1080p	-	720p, 1080p
aspect_ratio	select	아니요	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9
duration	number	아니요	5	min 3 / max 15 / step 1	-

Gemini Omni Video

gemini-omni-video이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

비디오 · 공식 계약은 계속 문서화되어 있지만 현재 제품 페이지를 사용할 수 없고 로그인 가격표에도 이 모델의 가격이 없습니다. 따라서 생성은 크레딧 예약 전에 차단됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

OmniHuman 1.5

omnihuman-1-5API로 사용 가능Files API 필요

비디오 · OmniHuman 1.5는 인물 이미지 정확히 한 장과 오디오 클립 한 개를 검증된 오디오 길이에 따라 크레딧을 계산하는 720p 또는 1080p 오디오 기반 캐릭터 비디오로 변환합니다.

API 가이드 모델 페이지

기본 크레딧

per_input_second · default=27 · ⌈total⌉

모드

image-audio-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

300 자

참조 미디어

image, audio · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

인물 이미지 및 오디오: 최대 10MB인 JPEG, PNG 또는 WebP 인물 이미지 정확히 한 장과 최대 10MB이고 길이가 60초 미만인 MP3, M4A, WAV, AAC 또는 OGG 오디오 파일 한 개를 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
output_resolution	select	아니요	1080	-	720, 1080
pe_fast_mode	select	아니요	false	-	false, true
seed	number	아니요	-1	-	-

Volcengine Video Lip Sync

volcengine-video-lip-syncAPI로 사용 가능Files API 필요

비디오 · Volcengine Video Lip Sync는 기존 비디오 한 개의 음성 연기를 대상 음성 트랙 한 개로 바꾸며, Lite 또는 Basic 처리와 길이 기반 크레딧을 사용합니다. 출력은 25 FPS의 MP4이며 길이는 대상 오디오를 따릅니다.

API 가이드 모델 페이지

기본 크레딧

per_input_second · default=8 · ⌈total⌉

모드

video-audio-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

video, audio · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

소스 비디오 및 대상 오디오: 최대 95MB인 MP4 또는 MOV 비디오 정확히 한 개와 최대 10MB인 MP3, M4A, WAV, AAC 또는 OGG 음성 트랙 한 개를 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파일 기반 모드는 완전한 API 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
mode	select	예	lite	-	lite, basic
separate_vocal	select	아니요	false	-	false, true
open_scenedet	select	아니요	false	-	false, true
align_audio	select	아니요	true	-	true, false
align_audio_reverse	select	아니요	false	-	false, true
templ_start_seconds	number	아니요	0	min 0	-

Kling O3

kling-o3API로 사용 가능부분 지원: Files API 필요

비디오 · 검증 가능한 범위에서 텍스트, 시작 프레임 1장 또는 시작·종료 프레임 한 쌍을 이용한 단일 샷 생성을 사용할 수 있습니다.

API 가이드 모델 페이지

기본 크레딧

per_output_second · 720p_without_audio=14 · 720p_with_audio=18 · 1080p_without_audio=18 · 1080p_with_audio=23 · 4k_without_audio=67 · 4k_with_audio=67 · ⌈total⌉

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

3072 자

참조 미디어

image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "kling-o3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "audio": "false",
    "aspect_ratio": "16:9"
  }
}

참조 규칙

참조 미디어: 이미지-동영상 프로젝트에는 총 최대 2개의 이미지 파일을 업로드하세요.

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

프롬프트 또는 URL 모드는 지금 호출 가능할 수 있습니다. 참조 미디어 모드는 아직 Files API 업로드 지원이 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
resolution	select	아니요	720p	-	720p, 1080p, 4k
duration	select	아니요	5	-	3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
audio	select	아니요	false	-	false, true
aspect_ratio	select	아니요	16:9	-	16:9, 9:16, 1:1

Wan Animate 2

wan-animate-2이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

비디오 · Wan Animate 2는 Coming Soon 상태의 Video to Video 목록입니다. 공개 캐릭터 애니메이션 설명은 Rivya의 호출 계약이나 가격이 아닙니다.

모델 페이지

기본 크레딧

이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

모드

API 입력

이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

PixVerse V6

pixverse-v6이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

비디오 · PixVerse V6 — 일시적으로 사용 불가. Coming Soon 공지가 아니라 가격 및 통합 안전을 위한 임시 보류입니다. 페이지는 검색 가능하지만 전체 가격 계약이 안정될 때까지 생성과 호출 가능한 가격은 닫힌 상태로 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Wan 2.6 Flash

wan-2-6-flash이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

비디오 · Wan 2.6 Flash / 일시적으로 사용 불가 — Coming Soon 공지가 아니라 가격 및 통합 안전을 위한 임시 보류입니다. 페이지는 검색 가능하지만 전체 가격 계약이 안정될 때까지 생성과 호출 가능한 가격은 닫힌 상태로 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Suno Music

suno-musicAPI로 사용 가능텍스트 입력 준비됨

오디오 · Suno Music은 짧은 브리프 하나를 보컬이 있거나 없는 첫 곡 초안으로 바꾸기 위한 Rivya의 텍스트-투-뮤직 모델입니다. 고정 `12`크레딧 진입점을 유지하며 성공한 트랙 뒤의 다음 단계로 `Extend Music`을 노출합니다.

API 가이드 모델 페이지

기본 크레딧

per_request · default=12 · ⌈total⌉

모드

text-to-audio

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

500 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "suno-music",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V4_5",
    "instrumental": "false"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
model	select	아니요	V4_5	-	V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
instrumental	select	아니요	false	-	false, true

Suno Sounds

suno-soundsAPI로 사용 가능텍스트 입력 준비됨

오디오 · Suno Sounds는 앰비언스 루프, 배경 사운드, 짧은 사운드 스케치를 위한 Rivya의 가벼운 텍스트-투-사운드 모델입니다. 문서화된 고정 가격 `2.5`크레딧을 유지하며 성공한 결과는 `Vocal Separation`으로 이어질 수 있습니다.

API 가이드 모델 페이지

기본 크레딧

per_request · generate_sounds=2.5 · separate_vocal=10 · ⌈total⌉

모드

text-to-audio

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

500 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "suno-sounds",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V5",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
model	select	아니요	V5	-	V5, V5_5
soundLoop	select	아니요	false	-	false, true
soundTempo	number	아니요	-	min 1 / max 300 / step 1	-
soundKey	select	아니요	Any	-	Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B

Suno Lyrics

suno-lyricsAPI로 사용 가능텍스트 입력 준비됨

오디오 · Suno Lyrics는 하나의 테마나 분위기를 노랫말로 바꾸기 위한 Rivya의 가사 생성 모델이며, 요청 1회당 고정 `1`크레딧이 듭니다.

API 가이드 모델 페이지

기본 크레딧

per_request · generate_lyrics=0.4 · ⌈total⌉

모드

text-to-audio

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

200 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "suno-lyrics",
  "prompt": "A clean editorial product image on a soft studio background"
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

추가 모델 파라미터가 필요하지 않습니다.

ElevenLabs Dialogue V3

elevenlabs-dialogue-v3API로 사용 가능텍스트 입력 준비됨

Audio · Rivya에서 사용할 수 있는 ElevenLabs의 다중 화자 대화 모델입니다. 역할 기반 음성 생성을 위해 설계되었으며, 개별 음성 배정, 안정성 제어, 팟캐스트, 인터뷰, 캐릭터 장면에 맞는 대화형 속도감을 제공합니다.

API 가이드 모델 페이지

기본 크레딧

per_1000_characters · dialogue_text=14 · ⌈total⌉

모드

dialogue-to-audio

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

5000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "elevenlabs-dialogue-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "default_voice": "Adam",
    "stability": "0.5"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
default_voice	select	아니요	Adam	-	Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will
stability	select	아니요	0.5	-	0, 0.5, 1
language_code	text	아니요	-	-	-

ElevenLabs Turbo 2.5

elevenlabs-turbo-2-5API로 사용 가능텍스트 입력 준비됨

Audio · Rivya에서 사용할 수 있는 ElevenLabs의 빠른 텍스트 음성 변환 모델입니다. 낮은 지연 시간의 음성 생성과 조절 가능한 안정성, 유사도, 스타일, 속도를 제공하며, 빠른 보이스오버 초안과 인터랙티브 TTS 프로젝트를 위해 설계되었습니다.

API 가이드 모델 페이지

기본 크레딧

per_1000_characters · text=6 · ⌈total⌉

모드

text-to-speech

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

5000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "elevenlabs-turbo-2-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false",
    "previous_text": "선택 사항: 이 줄 앞의 문맥",
    "next_text": "선택 사항: 이 줄 뒤의 문맥",
    "language_code": "선택 사항: en 또는 zh 같은 locale 코드"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
voice	select	예	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	아니요	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	아니요	0.75	min 0 / max 1 / step 0.05	-
style	number	아니요	0	min 0 / max 1 / step 0.05	-
speed	number	아니요	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	아니요	false	-	false, true
previous_text	text	아니요	-	-	-
next_text	text	아니요	-	-	-
language_code	text	아니요	-	-	-

ElevenLabs Multilingual V2

elevenlabs-multilingual-v2API로 사용 가능텍스트 입력 준비됨

Audio · Rivya에서 사용할 수 있는 ElevenLabs의 다국어 텍스트 음성 변환 모델입니다. 자동 감지로 약 30개 언어를 지원하며, 현지화, 다국어 전달, 더 자연스러운 다국어 보이스오버에 더 강한 옵션입니다.

API 가이드 모델 페이지

기본 크레딧

per_1000_characters · text=12 · ⌈total⌉

모드

text-to-speech

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

5000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "elevenlabs-multilingual-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
voice	select	예	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	아니요	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	아니요	0.75	min 0 / max 1 / step 0.05	-
style	number	아니요	0	min 0 / max 1 / step 0.05	-
speed	number	아니요	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	아니요	false	-	false, true
previous_text	text	아니요	-	-	-
next_text	text	아니요	-	-	-

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

Audio · ElevenLabs Sound Effect V2은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

ElevenLabs Audio Isolation

elevenlabs-audio-isolation이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

Audio · ElevenLabs Audio Isolation은 현재 Rivya에서 사용할 수 없습니다. 이 페이지는 과거 기능을 확인하기 위한 참고 자료일 뿐이며 생성, 작업 생성 또는 크레딧 차감이 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

audio · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

audio: audio

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Gemini 3.1 Flash TTS

gemini-3-1-flash-tts이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

오디오 · Gemini 3.1 Flash TTS는 텍스트 음성 변환과 대화문 음성 변환 용도로 등록되어 있지만, 실행 전 최대 오디오 토큰 비용을 안전하게 산정할 수 없어 현재 Rivya에서 일시적으로 사용할 수 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Gemini 2.5 Pro TTS

gemini-2-5-pro-tts이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

오디오 · Gemini 2.5 Pro TTS는 텍스트 음성 변환과 대화문 음성 변환으로 공개 등록되어 있으며, 허용되는 모든 스크립트에 안전한 최대 크레딧 예약을 적용할 수 있을 때까지 Rivya에서는 생성을 일시적으로 사용할 수 없습니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

GPT-5.5

gpt-5-5-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · GPT-5.5는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

GPT-5.4

gpt-5-4-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · GPT-5.4는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

GPT-5.4 Codex

gpt-5.4-codex-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · GPT-5.4 Codex는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

GPT-5.3 Codex

gpt-5-3-codex-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · GPT-5.3 Codex는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

GPT-5.2

gpt-5-2-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · GPT-5.2는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

GPT-5.2 Codex

gpt-5-2-codex-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · GPT-5.2 Codex는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

GPT-5.1 Codex

gpt-5-1-codex-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · GPT-5.1 Codex는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

GPT-5 Codex

gpt-5-codex-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · GPT-5 Codex는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Gemini 3.1 Pro

gemini-3-1-pro-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Gemini 3.1 Pro는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Gemini 3 Pro

gemini-3-pro-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Gemini 3 Pro는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Gemini 3 Flash

gemini-3-flash-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Gemini 3 Flash는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Gemini 2.5 Pro

gemini-2-5-pro-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Gemini 2.5 Pro는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Gemini 2.5 Flash

gemini-2-5-flash-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Gemini 2.5 Flash는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Claude Opus 4.7

claude-opus-4-7-chatAPI로 사용 가능텍스트 입력 준비됨

Chat · Rivya에서 사용할 수 있는 Anthropic의 플래그십 Claude Chat 모델입니다. 깊은 추론, 신중한 종합, 임원용 글쓰기, 영향도가 큰 텍스트 작업에 적합합니다.

API 가이드 모델 페이지

기본 크레딧

per_million_tokens · input=285 · output=1430 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "claude-opus-4-7-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API는 Public API v1에서 비스트리밍 및 SSE 스트리밍 턴을 지원합니다. 이 Chat 모델은 이미지 첨부를 지원하지 않습니다.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Claude Opus 4.6

claude-opus-4-6-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Claude Opus 4.6는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Claude Sonnet 4.6

claude-sonnet-4-6-chatAPI로 사용 가능텍스트 입력 준비됨

Chat · Rivya에서 사용할 수 있는 Anthropic의 균형형 Claude AI Chat 모델입니다. Opus 수준의 비용으로 올라가지 않으면서도 콘텐츠, 리서치, 코딩 프로젝트에 필요한 강한 장문 추론과 신중한 분석을 유지합니다.

API 가이드 모델 페이지

기본 크레딧

per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "claude-sonnet-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API는 Public API v1에서 비스트리밍 및 SSE 스트리밍 턴을 지원합니다. 이 Chat 모델은 이미지 첨부를 지원하지 않습니다.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Claude Opus 4.5

claude-opus-4-5-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Claude Opus 4.5는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Claude Sonnet 4.5

claude-sonnet-4-5-chatAPI로 사용 가능텍스트 입력 준비됨

Chat · Rivya에서 사용할 수 있는 Anthropic의 균형형 Claude AI Chat 모델입니다. 섬세한 글쓰기, 신중한 분석, 안전을 고려한 응답에 강해 콘텐츠 제작과 리서치에 적합한 Claude 옵션입니다.

API 가이드 모델 페이지

기본 크레딧

per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "claude-sonnet-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API는 Public API v1에서 비스트리밍 및 SSE 스트리밍 턴을 지원합니다. 이 Chat 모델은 이미지 첨부를 지원하지 않습니다.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Claude Haiku 4.5

claude-haiku-4-5-chatAPI로 사용 가능텍스트 입력 준비됨

Chat · Rivya에서 사용할 수 있는 Anthropic의 경량 Claude AI Chat 모델입니다. Claude의 톤은 유지하면서 프리미엄 비용은 피하고 싶은 고빈도 프로젝트에서 속도, 비용 효율, 안정적인 일상 Chat 성능에 맞춰져 있습니다.

API 가이드 모델 페이지

기본 크레딧

per_million_tokens · input=55 · output=285 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "claude-haiku-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API는 Public API v1에서 비스트리밍 및 SSE 스트리밍 턴을 지원합니다. 이 Chat 모델은 이미지 첨부를 지원하지 않습니다.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Claude Opus 4.8

claude-opus-4-8-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · 방대한 소스 자료를 검토하고 신중하며 체계적인 의사결정안을 작성하는 데 적합한 Rivya의 텍스트 중심 Claude 채팅 모델입니다.

API 가이드 모델 페이지

기본 크레딧

per_million_tokens · input=400 · output=2000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

모드

claude-messages

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "claude-opus-4-8-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API는 Public API v1에서 비스트리밍 및 SSE 스트리밍 턴을 지원합니다. 이 Chat 모델은 이미지 첨부를 지원하지 않습니다.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Claude Fable 5

claude-fable-5-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · 독자에 맞춘 관점 전환, 초안 작성, 체계적인 편집 작업에 적합한 Rivya의 텍스트 중심 Claude 채팅 모델입니다.

API 가이드 모델 페이지

기본 크레딧

per_million_tokens · input=800 · output=4000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

모드

claude-messages

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "claude-fable-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API는 Public API v1에서 비스트리밍 및 SSE 스트리밍 턴을 지원합니다. 이 Chat 모델은 이미지 첨부를 지원하지 않습니다.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Claude Sonnet 5

claude-sonnet-5-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · 구현 브리프, 요구사항 검토, 간결한 기술 계획에 적합한 Rivya의 텍스트 중심 Claude 채팅 모델입니다.

API 가이드 모델 페이지

기본 크레딧

per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

모드

claude-messages

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "claude-sonnet-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API는 Public API v1에서 비스트리밍 및 SSE 스트리밍 턴을 지원합니다. 이 Chat 모델은 이미지 첨부를 지원하지 않습니다.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Claude Opus 5

claude-opus-5-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · 이사회 수준의 위험 구조화, 시나리오 비교, 의사결정 기록에 적합한 Rivya의 텍스트 중심 Claude 채팅 모델입니다.

API 가이드 모델 페이지

기본 크레딧

per_million_tokens · input=400 · output=2000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

모드

claude-messages

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "claude-opus-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API는 Public API v1에서 비스트리밍 및 SSE 스트리밍 턴을 지원합니다. 이 Chat 모델은 이미지 첨부를 지원하지 않습니다.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

GPT-5.6 Luna

gpt-5-6-luna-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · GPT-5.6 Luna는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

GPT-5.6 Terra

gpt-5-6-terra-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · GPT-5.6 Terra는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

GPT-5.6 Sol

gpt-5-6-sol-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · GPT-5.6 Sol은 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Gemini 3.5 Flash

gemini-3-5-flash-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Gemini 3.5 Flash는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Gemini 3.6 Flash

gemini-3-6-flash-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Gemini 3.6 Flash는 통합 안전성 검토가 진행 중인 모델로 Rivya에 등록되어 있습니다. 채팅 실행은 비활성화되어 있지만 검색 가능한 상태 페이지는 유지됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Gemini 3.7 Flash

gemini-3-7-flash-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Gemini 3.7 Flash는 Rivya에서 통합 안전 보류 상태로 제공됩니다. 검색 색인에 포함되는 상태 페이지에는 확인된 채팅 계약이 기록되지만 실행은 계속 비활성화됩니다.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Grok 4.3

grok-4-3-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Grok 4.3 — 일시적으로 사용 불가. Grok 4.3이 안전 보류 중인 동안 호출 가능한 대안으로 작업을 계속하세요.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Grok 4.5

grok-4-5-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Grok 4.5 — 일시적으로 사용 불가. Grok 4.5이 안전 보류 중인 동안 호출 가능한 대안으로 작업을 계속하세요.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Grok 4.6

grok-4-6-chat이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

채팅 · Grok 4.6 — 일시적으로 사용 불가. Grok 4.6이 안전 보류 중인 동안 호출 가능한 대안으로 작업을 계속하세요.

모델 페이지

기본 크레딧

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

모드

API 입력

이 요청은 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도해 주세요.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 계획 및 비교용으로 표시됩니다. 상태가 API로 사용 가능으로 바뀌기 전에는 Public API v1에서 호출하지 마세요.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

Kimi K3

kimi-k3-chat이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

채팅 · Kimi K3는 출시 예정 Chat 모델입니다. 공개되지 않은 컨텍스트, 도구 또는 응답 동작을 주장하지 않고 상태와 채팅 대안을 안내합니다.

모델 페이지

기본 크레딧

이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

모드

API 입력

이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

입력

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

이 모델에는 실행 가능한 Public API 예시가 표시되지 않습니다.

참조 규칙

결과

생성 응답은 공개 작업 ID를 반환합니다. 상태가 succeeded 또는 failed가 될 때까지 GET /api/v1/generations/{taskId}를 폴링하세요.

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 Public API 지원 예정이지만 아직 호출할 수 없습니다.

파라미터

추가 모델 파라미터가 필요하지 않습니다.

모델 API 참고 문서

이 참고 문서 읽는 방법

요청 형식

동적 모델 참고 문서

이 레퍼런스를 디버거와 함께 사용하세요

Z-Image

본문

파라미터

Nano Banana 2

본문

파라미터

Nano Banana Pro

본문

파라미터

Nano Banana

본문

파라미터

GPT Image 2

본문

파라미터

GPT Image 1.5

본문

파라미터

4o Image

본문

파라미터

Seedream 5.0 Lite

본문

파라미터

Seedream 4.5

본문

파라미터

Seedream 4.0

본문

파라미터

Seedream 3.0

본문

파라미터

Grok Imagine

본문

파라미터

Flux 2 Pro

본문

파라미터

Flux 2 Flex

본문

파라미터

Flux Kontext Max

본문

파라미터

Flux Kontext Pro

본문

파라미터

Qwen2 Image

본문

파라미터

Qwen Image

본문

파라미터

Midjourney

본문

파라미터

Recraft Remove Background

본문

파라미터

Recraft Crisp Upscale

본문

파라미터

Wan 2.7 Image Pro

본문

파라미터

Wan 2.7 Image

본문

파라미터

Google Imagen4 Ultra

본문

파라미터

Google Imagen4

본문

파라미터