Rivya Public API v1에서 Topaz Image Upscaler을 모델 ID topaz-image-upscale, 지원 입력, 파라미터, Files API 규칙, 크레딧, 응답 예시와 함께 사용하세요.

API로 사용 가능준비 상태이미지

API 모델 ID

topaz-image-upscale

입력

file

Files API

참조 모드에 필요

기본 크레딧

크레딧 요율: 10–40 / 이미지 1장 최종 작업 비용은 정수 크레딧으로 올림 처리됩니다.

기능

이미지

과금

FIXED

프롬프트 제한

문서화된 프롬프트 제한 없음

요청 계약

모델 ID는 최상위 수준에 보냅니다. 모델별 제어값은 params에 넣습니다.

Key	유형	필수	기본값	설명
model	string	예	topaz-image-upscale	topaz-image-upscale을 API 모델 ID로 사용합니다.
prompt	string	아니요	-	텍스트 입력을 지원하는 모델에 보내는 프롬프트 텍스트입니다.
params	object	예	-	모델별 파라미터 객체입니다. 허용되는 키는 아래 행을 확인하세요.
client_request_id	string	아니요	-	자체 시스템에서 요청을 추적하기 위한 선택적 클라이언트 ID입니다.

모델 파라미터

Key	유형	필수	기본값	범위	옵션	설명
upscale_factor	select	아니요	2	-	1, 2, 4	업스케일 배율

업로드 정책

참조 파일을 먼저 업로드한 다음 반환된 URL과 durationToken을 params.referenceMediaItems 안에 넣으세요.

참조 규칙

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

최대 파일 수

허용되는 파일 종류

image

재생시간 토큰

재생시간 검증이 필요한 경우 비디오 및 오디오 참조는 /api/v1/files의 durationToken을 포함해야 합니다.

kind	최대 크기	MIME 유형
image	10 MB	image/jpeg, image/png, image/webp

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

참조 파일 요청

{
  "model": "topaz-image-upscale",
  "params": {
    "upscale_factor": "2",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

생성 응답

생성 엔드포인트는 공개 작업 ID를 반환합니다. 작업이 성공하거나 실패할 때까지 상태 엔드포인트를 폴링하세요.

{
  "id": "task_topaz_image_upscale_example",
  "status": "queued",
  "model": "topaz-image-upscale",
  "reserved_credits": 40,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

일부 모드는 Files API 참조 업로드가 필요합니다.

Topaz Image Upscaler API 연동