Rivya API model IDs, availability, supported modes, parameter tables, prompt limits, reference media rules, model detail links를 확인하세요.

이 페이지는 Rivya API v1의 model-level API reference입니다.

아래 표는 /api/v1/models가 사용하는 동일한 model catalog와 public serializer에서 생성됩니다. 손으로 고정한 model count가 아닙니다.

이 Reference 읽는 방법

비동기 image, video, audio models에서 POST /api/v1/generations를 사용할 때 model id를 model로 사용하세요.
chat model IDs는 POST /api/v1/chat/completions에서 사용하세요.
generation prompt text에는 top-level prompt를 사용하세요.
Chat API turns에는 top-level message를 사용하세요.
asynchronous model-specific fields는 params 안에 넣으세요.
integration을 만들기 전에 api_input_status를 읽으세요. available_text와 available_url_input은 file upload 없이 테스트할 수 있습니다. partial_requires_files는 일부 mode만 Files API가 필요하다는 뜻이고, requires_files_api는 model을 호출하기 전에 Files API를 통해 reference media를 업로드해야 한다는 뜻입니다.
chat models의 경우 chat_capabilities를 읽어 non-streaming support, SSE streaming support, image file_id attachments, web search, thoughts, reasoning effort를 확인하세요.
model detail pages는 product-level guidance와 examples를 제공합니다.

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

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

API Quickstart 온라인 디버거

Z-Image

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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 필요

이미지 · Google의 차세대 이미지 모델로 4K 해상도, 극단적인 8:1을 포함한 15가지 화면비, Google Search 그라운딩, 최대 14장의 참조 이미지를 지원합니다. Rivya에서 가장 유연한 이미지 생성기입니다.

API 가이드 모델 페이지

기본 크레딧

모드

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",
    "google_search": "false"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 사용할 이미지 파일을 최대 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
google_search	select	아니요	false	-	false, true

Nano Banana Pro

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트를 위해 이미지 파일을 최대 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.5

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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-0API로 사용 가능부분 지원: Files API 필요

이미지 · Seedream 4.0은 텍스트-투-이미지 생성, 참조 이미지 편집, 명시적인 출력 제어를 위한 Rivya의 균형 잡힌 ByteDance 이미지 모델입니다.

API 가이드 모델 페이지

기본 크레딧

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 10 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedream-4-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1,
    "seed": 0,
    "nsfw_checker": "false"
  }
}

참조 규칙

참조 이미지: Seedream 4.0 편집 경로를 위해 이미지를 최대 10장 업로드하세요.

결과

생성 응답은 공개 작업 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_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9
image_resolution	select	아니요	1K	-	1K, 2K, 4K
max_images	number	아니요	1	min 1 / max 6 / step 1	-
seed	number	아니요	-	min 0 / max 2147483647 / step 1	-
nsfw_checker	select	아니요	false	-	false, true

Seedream 3.0

seedream-3-0API로 사용 가능텍스트 입력 준비됨

이미지 · Seedream 3.0은 Rivya에서 독립형 레거시 이미지 모델로 다시 제공됩니다. 현재 공개 텍스트-투-이미지 경로만 유지하며 실행 1회당 5크레딧이 듭니다.

API 가이드 모델 페이지

기본 크레딧

모드

text-to-image

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

5000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedream-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "guidance_scale": 2.5,
    "seed": 0
  }
}

참조 규칙

결과

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

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
image_size	select	아니요	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
guidance_scale	number	아니요	2.5	min 1 / max 10 / step 0.1	-
seed	number	아니요	-	min 0 / max 2147483647	-

Grok Imagine

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

이미지 · xAI의 이미지 모델로 강한 창작 해석력과 5가지 화면비를 제공합니다. 예술적 표현과 비전형적인 시각 스타일에 초점을 둔 단일 이미지 생성에 적합합니다.

API 가이드 모델 페이지

기본 크레딧

모드

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",
    "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
enable_pro	select	아니요	false	-	false, true

Flux 2 Pro

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 사용할 이미지 파일을 최대 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

Flux 2 Flex

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트에 사용할 이미지 파일을 최대 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

Flux Kontext Max

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

Image · Black Forest Labs의 향상된 Flux Kontext 모델로, 더 까다로운 프롬프트 기반 생성과 이미지 편집 작업을 위한 모델입니다. Rivya는 현재 텍스트-이미지와 이미지-이미지를 같은 비동기 프로젝트로 유지하며, 플랫폼의 현재 정책에 따라 실행당 고정 8 크레딧으로 책정합니다.

API 가이드 모델 페이지

기본 크레딧

모드

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 필요

이미지 · Black Forest Labs의 더 저렴한 Flux Kontext 프로젝트로, 텍스트-이미지 생성과 단일 이미지 편집에 적합합니다. Rivya는 현재 두 모드를 같은 비동기 이미지 프로젝트에서 제공하며, 현재 플랫폼 가격 정책에 따라 두 모드 모두 고정 4 크레딧으로 책정합니다.

API 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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, 3:4, 4:3, 9:16, 16: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 가이드 모델 페이지

기본 크레딧

모드

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

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

이미지 · Midjourney의 V7 이미지 모델은 텍스트-이미지와 이미지-이미지를 지원하며, Niji 애니메이션 모드, 3가지 속도 단계(Relaxed/Fast/Turbo), 스타일 참조, Omni Reference 기반 일관성을 제공합니다. 시네마틱 아트, 일러스트, 무드보드의 기준점으로 여전히 강합니다.

API 가이드 모델 페이지

기본 크레딧

모드

text-to-image, image-to-image

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

2000 자

참조 미디어

image · 4 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "midjourney",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "speed": "relaxed",
    "aspectRatio": "1:1",
    "version": "7"
  }
}

참조 규칙

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

결과

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

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

파라미터

key	유형	필수	기본값	범위	옵션
speed	select	아니요	relaxed	-	relaxed, fast, turbo
aspectRatio	select	아니요	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
version	select	아니요	7	-	7, 6.1, 6, niji7, niji6

Recraft Remove Background

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

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

API 가이드 모델 페이지

기본 크레딧

모드

image-to-image

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

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

파라미터

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

Recraft Crisp Upscale

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

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

API 가이드 모델 페이지

기본 크레딧

모드

image-to-image

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

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

파라미터

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

Wan 2.7 Image Pro

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

이미지 · Alibaba의 상위 Wan 2.7 이미지 모델로, 현재 Rivya에서 텍스트-이미지와 이미지 편집을 위한 별도 이미지 슬롯으로 제공됩니다. 생성을 단일 출력 이미지로 명확히 유지해 실행당 가격을 12크레딧으로 고정합니다.

API 가이드 모델 페이지

기본 크레딧

모드

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장 업로드하세요.

결과

생성 응답은 공개 작업 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 필요

이미지 · Alibaba의 표준 Wan 2.7 이미지 모델은 Rivya에서 텍스트-이미지와 이미지 편집을 위한 자체 이미지 슬롯으로 제공되며, 현재 실행당 5크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

모드

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장 업로드하세요.

결과

생성 응답은 공개 작업 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 가이드 모델 페이지

기본 크레딧

모드

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
negative_prompt	text	아니요	-	-	-
seed	text	아니요	-	-	-

Google Imagen4

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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
negative_prompt	text	아니요	-	-	-
seed	text	아니요	-	-	-

Google Imagen4 Fast

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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": 0
  }
}

참조 규칙

결과

생성 응답은 공개 작업 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
negative_prompt	text	아니요	-	-	-
seed	number	아니요	-	min 0	-

Topaz Image Upscaler

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

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

API 가이드 모델 페이지

기본 크레딧

모드

image-to-image

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

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	유형	필수	기본값	범위	옵션
upscale_factor	select	아니요	1	-	1, 2, 4, 8

Ideogram V3

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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": 0,
    "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	아니요	-	min 0	-
negative_prompt	text	아니요	-	-	-

Ideogram V3 Reframe

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

이미지 · Ideogram V3 Reframe은 현재 Rivya에서 렌더링 속도 기반 가격이 붙은 단일 이미지 리프레이밍 프로젝트로 통합되어 있습니다. 현재 가격은 TURBO 4크레딧, BALANCED 7크레딧, QUALITY 10크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

모드

image-to-image

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

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
image_size	select	아니요	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	아니요	-	min 0	-

Ideogram V3 Remix

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

이미지 · Ideogram V3 Remix는 현재 Rivya에서 렌더링 속도 기반 가격이 붙은 단일 이미지 리믹스 프로젝트로 통합되어 있습니다. 현재 가격은 TURBO 4크레딧, BALANCED 7크레딧, QUALITY 10크레딧입니다.

API 가이드 모델 페이지

기본 크레딧

모드

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
seed	number	아니요	-	min 0	-
strength	number	아니요	0.8	min 0.01 / max 1	-
negative_prompt	text	아니요	-	-	-

Ideogram Character

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

이미지 · 승인된 캐릭터 이미지 1장을 새 장면, 의상, 형식으로 확장하기 위한 캐릭터 일관성 옵션입니다. 넓은 이미지 편집보다 정체성 유지가 더 중요하고, 한 번에 출력 이미지 1장만 필요할 때 사용하세요.

API 가이드 모델 페이지

기본 크레딧

모드

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
seed	number	아니요	-	min 0	-
negative_prompt	text	아니요	-	-	-

Seedance 2.0

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

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

API 가이드 모델 페이지

기본 크레딧

175

모드

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

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

2500 자

참조 미디어

요청

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	-	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 2.0 Fast

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

비디오 · ByteDance의 더 빠른 Seedance 2.0 비디오 모델로, 프롬프트만 사용하는 생성, 프레임 기반 이미지 애니메이션, 멀티모달 참조 비디오 생성을 위한 전체 장면 라우팅을 제공합니다. Rivya는 첫/마지막 프레임 입력이 참조 이미지, 비디오, 오디오 역할과 충돌하지 않도록 문서화된 장면 분리를 명확히 유지합니다.

API 가이드 모델 페이지

기본 크레딧

140

모드

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

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

2500 자

참조 미디어

요청

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"
  }
}

참조 규칙

결과

생성 응답은 공개 작업 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	-	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 필요

비디오 · ByteDance의 플래그십 비디오 모델로, 네이티브 오디오-비주얼 동기화가 포함된 텍스트-투-비디오와 이미지-투-비디오를 지원합니다. 480p-1080p, 4-12s 클립, 6개 화면비, 동적/고정 렌즈 제어, 선택적 오디오 생성, 립싱크를 지원합니다.

API 가이드 모델 페이지

기본 크레딧

모드

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"
  }
}

참조 규칙

참조 이미지: 이미지 프로젝트를 위해 이미지 파일을 최대 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	select	아니요	8	-	4, 8, 12
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

Seedance 1.0 Pro

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

비디오 · ByteDance의 Seedance 1.0 Pro 모델은 Rivya에서 텍스트-투-비디오와 이미지-투-비디오를 모두 위한 표준 1.0 Pro 옵션으로 노출됩니다. 현재 페이지 설정은 공개 V1 Pro 문서에 맞춰 해상도, 길이, 카메라 잠금, seed, 안전 검사 제어를 유지합니다.

API 가이드 모델 페이지

기본 크레딧

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

10000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedance-1-0-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

참조 규칙

참조 이미지: 이미지-투-비디오 실행을 위해 이미지 파일 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, 720p, 1080p
duration	select	아니요	5	-	5, 10
aspect_ratio	select	아니요	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
camera_fixed	select	아니요	false	-	false, true
seed	number	아니요	-1	min -1 / max 2147483647	-
enable_safety_checker	select	아니요	true	-	true, false

Seedance 1.0 Pro Fast

seedance-1-0-pro-fastAPI로 사용 가능Files API 필요

비디오 · ByteDance의 빠른 이미지-투-비디오 모델입니다. 단일 참조 이미지를 720p/1080p의 5s 또는 10s 클립으로 애니메이션화하며, 스틸컷에서 빠르게 비디오가 필요할 때 속도에 최적화되어 있습니다.

API 가이드 모델 페이지

기본 크레딧

모드

image-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

10000 자

참조 미디어

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	유형	필수	기본값	범위	옵션
resolution	select	아니요	720p	-	720p, 1080p
duration	select	아니요	5	-	5, 10

Seedance 1.0 Lite

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

비디오 · ByteDance의 Seedance 1.0 Lite 모델은 Rivya에서 텍스트-투-비디오와 이미지-투-비디오를 모두 위한 더 가벼운 1.0 옵션으로 노출됩니다. 공개 V1 Lite 파라미터 세트를 따르며 현재 Seedance 1.0 Pro보다 낮은 가격 구간을 사용합니다.

API 가이드 모델 페이지

기본 크레딧

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

10000 자

참조 미디어

image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "seedance-1-0-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

참조 규칙

참조 이미지: 이미지-투-비디오용 소스 이미지 1장을 업로드하거나, 선택적 끝 프레임도 제공하려면 이미지 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	select	아니요	5	-	5, 10
aspect_ratio	select	아니요	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16, 9:21
camera_fixed	select	아니요	false	-	false, true
seed	number	아니요	-1	min -1 / max 2147483647	-
enable_safety_checker	select	아니요	true	-	true, false

HappyHorse 1.0

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

동영상 · Rivya에서 텍스트-동영상, 단일 이미지 모션, 다중 이미지 참조 동영상, 동영상 편집을 하나의 공개 모델 페이지에서 처리하는 유연한 AI 동영상 모델입니다.

API 가이드 모델 페이지

기본 크레딧

모드

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

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image, video · 10 파일

요청

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,
    "audio_setting": "auto",
    "seed": 0
  }
}

참조 규칙

참조 미디어: 동영상 없이 최대 9장의 이미지를 사용하거나, 동영상 편집을 위해 동영상 1개와 최대 5장의 이미지 참조를 사용하세요.

결과

생성 응답은 공개 작업 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	-
audio_setting	select	아니요	auto	-	auto, origin
seed	number	아니요	0	min 0 / max 2147483647	-

Wan 2.7 Video

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

비디오 · 해상도와 길이에 따라 가격이 정해지는 Alibaba의 더 새로운 Wan 비디오 라인입니다. Rivya는 하나의 모델 슬롯에서 텍스트-비디오, 이미지-비디오, 비디오 편집을 제공하며 5초 720p는 80크레딧부터입니다.

API 가이드 모델 페이지

기본 크레딧

모드

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": "피하고 싶은 선택 사항인 제외 항목 또는 실패 모드.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

참조 규칙

참고 미디어: 자산을 최대 2개 업로드하세요. 이미지-비디오에는 이미지 최대 2장을 사용하거나, 비디오 편집에는 비디오 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	-	720p, 1080p
duration	select	아니요	5	-	5, 10, 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 필요

비디오 · Rivya에서 제공되는 Alibaba의 세 가지 모드 Wan 옵션입니다. 하나의 프로젝트에서 텍스트-비디오, 이미지-비디오, 소스 비디오 편집을 다룹니다. 720p/1080p, 5~15초 클립, 그리고 한 번에 이미지 1장 또는 소스 비디오 1개를 지원합니다.

API 가이드 모델 페이지

기본 크레딧

모드

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

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image, video · 1 파일

요청

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": "720p",
    "duration": "5"
  }
}

참조 규칙

참고 미디어: 이미지 / 비디오 프로젝트를 위해 이미지 / 비디오 파일을 최대 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, 15

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 가이드 모델 페이지

기본 크레딧

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

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": "피하고 싶은 선택 사항인 제외 항목 또는 실패 모드.",
    "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	유형	필수	기본값	범위	옵션
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	아니요	-	-	-
nsfw_checker	select	아니요	false	-	false, true

Wan 2.2 A14B Turbo

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

비디오 · Wan 2.2 A14B Turbo는 이제 Rivya에서 텍스트-비디오, 이미지-비디오, 이미지와 오디오 기반 비디오 경로를 모두 포함합니다. 현재 가격은 텍스트 또는 이미지 실행의 경우 `480p = 8`, `720p = 12`이며, 이미지 1장과 오디오 클립 1개가 결과를 구동할 때는 `480p = 16`, `580p = 20`, `720p = 24`입니다.

API 가이드 모델 페이지

기본 크레딧

모드

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 1	-
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로 사용 가능URL 입력 준비됨

비디오 · Rivya에서 기존 클립에 등장하는 인물을 교체하기 위한 Wan의 캐릭터 교체 비디오 모델입니다. 움직임은 이미 맞고 보이는 피사체만 바뀌어야 할 때 공개 소스 비디오 URL 1개, 공개 교체 이미지 URL 1개, 해상도 구간을 사용하세요.

API 가이드 모델 페이지

기본 크레딧

모드

video-to-video

API 입력

URL 입력 준비됨

입력

url

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "wan-2-2-animate-replace",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://...",
    "image_url": "https://...",
    "resolution": "480p"
  }
}

참조 규칙

결과

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

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 모델 파라미터를 통해 공개 URL 입력을 받습니다.

파라미터

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

Hailuo 2.3

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

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

API 가이드 모델 페이지

기본 크레딧

모드

image-to-video

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	유형	필수	기본값	범위	옵션
quality	select	아니요	standard	-	standard, pro
resolution	select	아니요	768P	-	768P, 1080P
duration	select	아니요	6	-	6, 10

Hailuo Pro

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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": "false"
  }
}

참조 규칙

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

결과

생성 응답은 공개 작업 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	아니요	false	-	false, true

Hailuo Standard

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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": "512P",
    "prompt_optimizer": "false"
  }
}

참조 규칙

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

결과

생성 응답은 공개 작업 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	아니요	512P	-	512P, 768P
prompt_optimizer	select	아니요	false	-	false, true

Kling 3.0

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

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

API 가이드 모델 페이지

기본 크레딧

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

2000 자

참조 미디어

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
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개로 하나의 피사체를 구동하면서 명시적인 배경 소스 선택을 제공하는 최신 Kling motion-control 옵션입니다. 모션 전송과 함께 장면이 동영상에서 와야 하는지 이미지에서 와야 하는지 더 강하게 제어하고 싶을 때 사용하세요.

API 가이드 모델 페이지

기본 크레딧

모드

video-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

2500 자

참조 미디어

image, video · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

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

참조 규칙

참조 이미지 + 모션 동영상: 정확히 캐릭터 이미지 1장과 모션 클립 1개를 업로드하세요. 방향 컨트롤과 배경 소스 선택이 모두 필요할 때 3.0을 사용하세요.

결과

생성 응답은 공개 작업 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	아니요	pro	-	std, pro
character_orientation	select	아니요	video	-	video, image
background_source	select	아니요	input_video	-	input_video, input_image

Kling 2.6

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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장을 업로드하세요.

결과

생성 응답은 공개 작업 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 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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장의 이미지를 업로드하세요. 두 번째 이미지는 테일 프레임으로 매핑됩니다.

결과

생성 응답은 공개 작업 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	-

Kling V2.1 Master

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

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

API 가이드 모델 페이지

기본 크레딧

160

모드

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장을 업로드하세요. 비워 두면 텍스트 모드로 유지됩니다.

결과

생성 응답은 공개 작업 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	-

Kling V2.1 Pro

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

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

API 가이드 모델 페이지

기본 크레딧

모드

image-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

5000 자

참조 미디어

image · 2 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

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

참조 규칙

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

결과

생성 응답은 공개 작업 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	-

Kling V2.1 Standard

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

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

API 가이드 모델 페이지

기본 크레딧

모드

image-to-video

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	유형	필수	기본값	범위	옵션
duration	select	아니요	5	-	5, 10
negative_prompt	text	아니요	-	-	-
cfg_scale	number	아니요	0.5	min 0 / max 1	-

Kling AI Avatar Pro

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

동영상 · Kuaishou의 Kling AI Avatar Pro 고품질 말하는 아바타 모델로, 인물 이미지 1장과 오디오 클립 1개를 사용해 립싱크 아바타 동영상을 생성합니다. Rivya는 현재 생성당 고정 16크레딧으로 가격을 책정합니다.

API 가이드 모델 페이지

기본 크레딧

모드

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크레딧으로 가격을 책정합니다.

API 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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

API 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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	아니요	-	min 0 / max 2147483647	-

Luma Modify Video

luma-modify-videoAPI로 사용 가능Files API 필요

동영상 · 기존 클립 하나를 새로운 시각 방향으로 밀어붙이는 독립형 소스 동영상 재작성 프로젝트입니다. 프롬프트가 내보내기 결과를 단순히 선명하게 하는 것이 아니라, 영상 자체를 변환해야 할 때 사용하세요.

API 가이드 모델 페이지

기본 크레딧

모드

video-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

video · 1 파일

요청

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 준비 예시로 표시되기 전에 /api/v1/files가 필요합니다. Files API

파라미터

key	유형	필수	기본값	범위	옵션
watermark	text	아니요	-	-	-

Grok Imagine Video

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

동영상 · xAI의 동영상 모델로 Fun/Normal/Spicy 창작 모드와 5가지 화면비를 제공합니다. 장난스러운 톤부터 영화적 톤, 더 날카로운 톤까지 서로 다른 창작 분위기에 맞는 독특한 스타일 프리셋을 갖추고 있습니다.

API 가이드 모델 페이지

기본 크레딧

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

5000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "grok-imagine-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "normal",
    "duration": 6,
    "resolution": "480p",
    "aspect_ratio": "2:3"
  }
}

참조 규칙

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

결과

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

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

파라미터

key	유형	필수	기본값	범위	옵션
mode	select	아니요	normal	-	fun, normal, spicy
duration	number	아니요	6	min 6 / max 30 / step 1	-
resolution	select	아니요	480p	-	480p, 720p
aspect_ratio	select	아니요	2:3	-	1:1, 16:9, 9:16, 2:3, 3:2

Sora 2 Pro

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

비디오 · Sora 2의 프리미엄 구간으로 Standard/High 품질 모드, 10s/15s 클립, 워터마크 제거를 제공합니다. 전문 비디오 제작을 위해 디테일, 조명, 모션 충실도가 강화되었습니다.

API 가이드 모델 페이지

기본 크레딧

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

10000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "sora-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "standard",
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

참조 규칙

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

결과

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

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

파라미터

key	유형	필수	기본값	범위	옵션
size	select	아니요	-	-	standard, high
n_frames	select	아니요	10	-	10, 15
aspect_ratio	select	아니요	landscape	-	landscape, portrait
remove_watermark	select	아니요	false	-	false, true
upload_method	select	아니요	s3	-	s3, oss

Sora 2

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

비디오 · OpenAI의 비디오 모델로, 사실적인 세계 시뮬레이션, 동기화 오디오, 10s/15s 클립, 가로/세로 출력, 선택적 워터마크 제거를 갖춘 텍스트-투-비디오와 이미지-투-비디오를 지원합니다.

API 가이드 모델 페이지

기본 크레딧

모드

text-to-video, image-to-video

API 입력

부분 지원: Files API 필요

입력

text, file

프롬프트 제한

10000 자

참조 미디어

image · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "sora-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

참조 규칙

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

결과

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

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

파라미터

key	유형	필수	기본값	범위	옵션
n_frames	select	아니요	10	-	10, 15
aspect_ratio	select	아니요	landscape	-	landscape, portrait
remove_watermark	select	아니요	false	-	false, true
upload_method	select	아니요	s3	-	s3, oss

Sora Watermark Remover

sora-watermark-removerAPI로 사용 가능URL 입력 준비됨

비디오 · 완성된 공개 Sora 공유 링크를 위한 Rivya의 Sora 워터마크 제거 후처리 모델입니다. 비디오가 이미 완료되었고 남은 작업이 워터마크 제거와 S3 또는 OSS 전달 선택뿐일 때 사용하세요.

API 가이드 모델 페이지

기본 크레딧

모드

video-to-video

API 입력

URL 입력 준비됨

입력

url

프롬프트 제한

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "sora-watermark-remover",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://sora.chatgpt.com/p/...",
    "upload_method": "s3"
  }
}

참조 규칙

결과

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

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

이 모델은 모델 파라미터를 통해 공개 URL 입력을 받습니다.

파라미터

key	유형	필수	기본값	범위	옵션
video_url	text	예	-	-	-
upload_method	select	예	s3	-	s3, oss

Topaz Video Upscaler

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

비디오 · Topaz의 납품급 비디오 업스케일러로, 내보내기 단계에서 더 높은 선명도만 필요한 승인된 클립을 위한 Rivya 옵션입니다. 샷, 움직임, 타이밍은 이미 맞고 남은 문제가 해상도나 최종 파일 선명도일 때 사용하세요.

API 가이드 모델 페이지

기본 크레딧

모드

video-to-video

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

video · 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	유형	필수	기본값	범위	옵션
upscale_factor	select	아니요	2	-	1, 2, 4

Veo3.1 Quality

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

비디오 · Google Veo 3.1의 품질 우선 변형으로, 프리미엄 텍스트-비디오와 이미지 기반 생성에 맞춰져 있습니다. 더 높은 충실도의 비주얼, 더 강한 모션 리얼리즘, 기본 포함 배경 오디오 덕분에 Rivya의 상위 Veo 옵션입니다.

API 가이드 모델 페이지

기본 크레딧

150

모드

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": {
    "aspectRatio": "16:9",
    "watermark": "선택 사항인 워터마크 텍스트",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

참조 규칙

참고 이미지: 지원되는 이미지 기반 프로젝트를 위해 이미지 파일을 최대 2장 업로드하세요.

결과

생성 응답은 공개 작업 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	-	16:9, 9:16, Auto
watermark	text	아니요	-	-	-
seeds	number	아니요	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	아니요	true	-	true, false

Veo3.1 Fast

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

비디오 · Google Veo 3.1의 빠른 변형으로, 텍스트-비디오, 이미지-비디오, 레퍼런스-비디오의 세 가지 모드를 지원합니다. 최대 3장의 참고 이미지, 네이티브 오디오, 모드 인식 화면비 제어 덕분에 빠른 시네마틱 클립에 유용합니다.

API 가이드 모델 페이지

기본 크레딧

모드

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": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "watermark": "선택 사항인 워터마크 텍스트",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

참조 규칙

참고 이미지: 이미지 및 레퍼런스 기반 프로젝트를 위해 이미지 파일을 최대 3장 업로드하세요.

결과

생성 응답은 공개 작업 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
watermark	text	아니요	-	-	-
seeds	number	아니요	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	아니요	true	-	true, false

Veo3.1 Lite

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

비디오 · Google Veo 3.1의 최저 비용 변형입니다. Rivya는 현재 가장 작은 안정 범위만 제공합니다. 텍스트-비디오와 이미지-비디오를 생성 1회당 고정 `10`크레딧으로 사용할 수 있습니다.

API 가이드 모델 페이지

기본 크레딧

모드

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-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "선택 사항인 워터마크 텍스트",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

참조 규칙

참고 이미지: 지원되는 이미지 기반 프로젝트를 위해 이미지 파일을 최대 2장 업로드하세요.

결과

생성 응답은 공개 작업 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	-	16:9, 9:16, Auto
watermark	text	아니요	-	-	-
seeds	number	아니요	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	아니요	true	-	true, false

Suno Music

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

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

API 가이드 모델 페이지

기본 크레딧

모드

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의 가벼운 텍스트-투-사운드 모델입니다. 문서화된 고정 가격 `3`크레딧을 유지하며 성공한 결과는 `Vocal Separation`으로 이어질 수 있습니다.

API 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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	아니요	-	-	-
language_code	text	아니요	-	-	-

ElevenLabs Sound Effect V2

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

Audio · Rivya에서 사용할 수 있는 ElevenLabs의 텍스트-사운드 모델로, 짧은 효과음, 전환음, 앰비언스 루프에 적합합니다. 조절 가능한 프롬프트 영향도, 루프 모드, 편집, 제품, 게임 프로젝트용 19가지 출력 형식으로 0.5~22초 오디오 클립을 생성할 수 있습니다.

API 가이드 모델 페이지

기본 크레딧

모드

text-to-audio

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

5000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "elevenlabs-sound-effect-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "loop": "false",
    "duration_seconds": 3,
    "prompt_influence": 0.3,
    "output_format": "mp3_44100_128"
  }
}

참조 규칙

결과

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

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

파라미터

key	유형	필수	기본값	범위	옵션
loop	select	아니요	false	-	false, true
duration_seconds	number	아니요	3	min 0.5 / max 22 / step 0.5	-
prompt_influence	number	아니요	0.3	min 0 / max 1 / step 0.05	-
output_format	select	아니요	mp3_44100_128	-	mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192

ElevenLabs Audio Isolation

elevenlabs-audio-isolationAPI로 사용 가능Files API 필요

Audio · Rivya에서 사용할 수 있는 ElevenLabs의 오디오 정리 및 음성 분리 모델입니다. 기존 녹음 파일 하나를 업로드해 보컬을 분리하고, 배경 소음을 제거하고, 편집이나 게시 전에 말소리 오디오를 정리하세요.

API 가이드 모델 페이지

기본 크레딧

모드

audio-to-audio

API 입력

Files API 필요

입력

file

프롬프트 제한

참조 미디어

audio · 1 파일

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

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

참조 규칙

원본 오디오: 오디오 파일 하나를 업로드하면 Rivya가 대상 트랙을 분리하고 정리합니다.

결과

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

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

파라미터

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

GPT-5.5

gpt-5-5-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 제공되는 OpenAI의 고급 GPT 채팅 모델로, 브리프에 더 많은 여지가 필요할 때 복잡한 추론, 이미지 인식 분석, 연구 종합, 구조화된 글쓰기에 적합합니다.

API 가이드 모델 페이지

기본 크레딧

모드

responses

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gpt-5-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

GPT-5.4

gpt-5-4-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 제공되는 OpenAI의 고급 AI 채팅 모델로, 더 강한 구조화 입력 처리, 추론 제어, 도구 지향 대화 프로젝트를 통해 더 복잡한 분석과 작성 작업을 지원합니다.

API 가이드 모델 페이지

기본 크레딧

모드

responses

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gpt-5-4-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

GPT-5.4 Codex

gpt-5.4-codex-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 제공되는 OpenAI의 고급 Codex 모델로, 까다로운 저장소 규모 개발 프로젝트를 위해 더 강한 코딩, 구조화된 추론, 도구 지향 협업을 제공합니다.

API 가이드 모델 페이지

기본 크레딧

모드

responses

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gpt-5.4-codex-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

GPT-5.3 Codex

gpt-5-3-codex-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 제공되는 OpenAI의 최신이자 가장 강력한 Codex 모델입니다. 가장 까다로운 개발 프로젝트를 위해 최첨단 코드 생성과 더 깊은 에이전트형 추론을 결합합니다.

API 가이드 모델 페이지

기본 크레딧

모드

responses

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gpt-5-3-codex-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

GPT-5.2

gpt-5-2-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 제공되는 OpenAI의 플래그십 AI 채팅 모델로, 고급 추론, 최대 6장 이미지 비전 지원, 20K 문자 컨텍스트 창을 제공합니다. 연구, 계획, 작성, 이미지 인식 분석에 강한 범용 GPT 옵션입니다.

API 가이드 모델 페이지

기본 크레딧

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gpt-5-2-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

GPT-5.2 Codex

gpt-5-2-codex-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 제공되는 OpenAI의 더 고급 Codex 모델로, 복잡한 엔지니어링 작업을 위한 추론이 더 강합니다. 단순 코드 생성만으로 부족한 장기 에이전트형 코딩, 아키텍처 결정, 더 큰 리팩터링에 최적화되어 있습니다.

API 가이드 모델 페이지

기본 크레딧

모드

responses

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gpt-5-2-codex-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

GPT-5.1 Codex

gpt-5-1-codex-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 제공되는 OpenAI의 업그레이드된 Codex 모델로, 에이전트형 코딩 작업에서 코드 정확도와 추론이 더 강해졌습니다. 긴 출력과 저장소 맥락을 이해하는 프로젝트 구조는 유지하면서, 다중 파일 리팩터링과 더 안전한 코드 수정을 개선합니다.

API 가이드 모델 페이지

기본 크레딧

모드

responses

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gpt-5-1-codex-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

GPT-5 Codex

gpt-5-codex-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 제공되는 OpenAI의 코드 특화 GPT-5 Codex 모델로, 비전 지원과 함께 디버깅, 구현 계획, 리팩터링, 기술 문제 해결에 적합합니다.

API 가이드 모델 페이지

기본 크레딧

모드

responses

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gpt-5-codex-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

Gemini 3.1 Pro

gemini-3-1-pro-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 사용할 수 있는 Google의 최신이자 가장 강력한 Gemini AI 채팅 모델입니다. 최상위 추론, 비전, 지시 따르기 성능을 갖춰 높은 요구 수준의 분석 및 창의적 작업에 가장 강한 Gemini 옵션입니다.

API 가이드 모델 페이지

기본 크레딧

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gemini-3-1-pro-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

Gemini 3 Pro

gemini-3-pro-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 사용할 수 있는 Google의 더 깊은 Gemini AI 채팅 모델입니다. Gemini 2.5 Pro보다 강한 추론과 비전 지원을 제공해 리서치 종합, 기술 글쓰기, 더 신중한 멀티모달 분석에 더 잘 맞습니다.

API 가이드 모델 페이지

기본 크레딧

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gemini-3-pro-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

Gemini 3 Flash

gemini-3-flash-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 사용할 수 있는 Google의 차세대 빠른 AI 채팅 모델입니다. Gemini 2.5 Flash보다 더 낮은 토큰 비용과 더 강한 추론을 제공하며, 대량 멀티모달 채팅, 스크린샷 선별, 빠른 보조 작업을 위해 설계되었습니다.

API 가이드 모델 페이지

기본 크레딧

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gemini-3-flash-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

Gemini 2.5 Pro

gemini-2-5-pro-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 사용할 수 있는 Google의 더 고급 Gemini AI 채팅 모델입니다. Flash보다 더 강한 추론, 비전 지원, 20K 문맥을 제공하며, 2 크레딧으로 리서치 종합, 문서 분석, 구조화 글쓰기에 더 잘 맞습니다.

API 가이드 모델 페이지

기본 크레딧

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gemini-2-5-pro-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

Gemini 2.5 Flash

gemini-2-5-flash-chatAPI로 사용 가능텍스트 입력 준비됨

채팅 · Rivya에서 사용할 수 있는 Google의 가장 빠르고 저렴한 AI 채팅 모델입니다. 사용당 1 크레딧이며 최대 6장의 이미지를 지원해 빠른 질의응답, 1차 요약, 스크린샷 선별, 일상적인 AI 지원에 적합합니다.

API 가이드 모델 페이지

기본 크레딧

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text, file

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "gemini-2-5-flash-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 스트리밍 턴을 지원합니다. 이미지 첨부는 Files API의 file_id 값을 사용해야 합니다.

파라미터

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

Claude Opus 4.7

claude-opus-4-7-chatAPI로 사용 가능텍스트 입력 준비됨

Chat · Rivya에서 사용할 수 있는 Anthropic의 플래그십 Claude Chat 모델입니다. 깊은 추론, 신중한 종합, 임원용 글쓰기, 영향도가 큰 텍스트 작업에 적합합니다.

API 가이드 모델 페이지

기본 크레딧

모드

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-chatAPI로 사용 가능텍스트 입력 준비됨

Chat · Rivya에서 사용할 수 있는 Anthropic의 플래그십 Claude AI Chat 모델입니다. 까다롭고 중요한 프로젝트에서 깊은 추론, 복잡한 분석, 고품질 글쓰기를 위해 설계되었습니다.

API 가이드 모델 페이지

기본 크레딧

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "claude-opus-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 Sonnet 4.6

claude-sonnet-4-6-chatAPI로 사용 가능텍스트 입력 준비됨

Chat · Rivya에서 사용할 수 있는 Anthropic의 균형형 Claude AI Chat 모델입니다. Opus 수준의 비용으로 올라가지 않으면서도 콘텐츠, 리서치, 코딩 프로젝트에 필요한 강한 장문 추론과 신중한 분석을 유지합니다.

API 가이드 모델 페이지

기본 크레딧

모드

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-chatAPI로 사용 가능텍스트 입력 준비됨

Chat · Rivya에서 사용할 수 있는 Anthropic의 플래그십 Claude AI Chat 모델입니다. 깊은 추론, 복잡한 분석, 전문가 수준의 글쓰기에 뛰어나며 중요한 AI 작업을 위한 프리미엄 선택지입니다.

API 가이드 모델 페이지

기본 크레딧

모드

chat-completion

API 입력

텍스트 입력 준비됨

입력

text

프롬프트 제한

20000 자

참조 미디어

요청

POST /api/v1/generations

인증

Bearer API 키

Idempotency-Key

권장

본문

{
  "model": "claude-opus-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 Sonnet 4.5

claude-sonnet-4-5-chatAPI로 사용 가능텍스트 입력 준비됨

Chat · Rivya에서 사용할 수 있는 Anthropic의 균형형 Claude AI Chat 모델입니다. 섬세한 글쓰기, 신중한 분석, 안전을 고려한 응답에 강해 콘텐츠 제작과 리서치에 적합한 Claude 옵션입니다.

API 가이드 모델 페이지

기본 크레딧

모드

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 가이드 모델 페이지

기본 크레딧

모드

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 모델은 이미지 첨부를 지원하지 않습니다.

파라미터

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

Model API Reference

이 Reference 읽는 방법

Request Pattern

Dynamic Model Reference

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

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

본문

파라미터