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

API로 사용 가능텍스트 또는 URL 준비됨; 참조 모드는 Files API 사용이미지

API 모델 ID

qwen-image-3-pro

입력

text, file

Files API

참조 모드에 필요

기본 크레딧

크레딧은 입력과 설정에 따라 달라집니다. 생성 전에 예상 비용을 확인하세요. 최종 작업 비용은 정수 크레딧으로 올림 처리됩니다.

기능

이미지

과금

FIXED

프롬프트 제한

800 자

요청 계약

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

Key	유형	필수	기본값	설명
model	string	예	qwen-image-3-pro	qwen-image-3-pro을 API 모델 ID로 사용합니다.
prompt	string	예	-	이 모델은 최대 800자까지 사용할 수 있습니다.
params	object	예	-	모델별 파라미터 객체입니다. 허용되는 키는 아래 행을 확인하세요.
client_request_id	string	아니요	-	자체 시스템에서 요청을 추적하기 위한 선택적 클라이언트 ID입니다.

모델 파라미터

Key	유형	필수	기본값	범위	옵션	설명
resolution	select	예	1K	-	1K, 2K	해상도
image_size	select	아니요	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	이미지 크기
output_format	select	아니요	png	-	png, jpeg	출력 형식
prompt_extend	select	아니요	true	-	true, false	생성 전에 모델이 간단한 포지티브 프롬프트를 다시 작성하도록 하거나, 문구를 더 세밀하게 제어하려면 비활성화하세요.
nsfw_checker	select	아니요	false	-	false, true	모델의 선택형 콘텐츠 필터를 활성화합니다. 자동 필터는 완전한 감지를 보장할 수 없습니다.
negative_prompt	text	아니요	-	-	-	네거티브 프롬프트
seed	number	아니요	1	min 0 / max 2147483647 / step 1	-	매번 새로운 무작위 결과를 원하면 비워두세요. 같은 정수를 다시 사용하면 이전 결과를 재현하거나 미세 조정하기가 더 쉬워집니다. 프롬프트와 다른 핵심 설정도 비슷하게 유지될 때만 더 가까워지며, 1:1 일치를 보장하지는 않습니다.

업로드 정책

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

참조 규칙

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

최대 파일 수

허용되는 파일 종류

image

재생시간 토큰

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

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

최소 요청

{
  "model": "qwen-image-3-pro",
  "prompt": "밝은 회색 배경 앞에 놓인 제품이 담긴 병. 왼쪽에서 부드러운 빛이 비친다.",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "선택 사항: 피하고 싶은 요소나 실패 유형을 최대 5,000자로 입력하세요.",
    "seed": 1
  }
}

참조 파일 요청

{
  "model": "qwen-image-3-pro",
  "prompt": "밝은 회색 배경 앞에 놓인 제품이 담긴 병. 왼쪽에서 부드러운 빛이 비친다.",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "선택 사항: 피하고 싶은 요소나 실패 유형을 최대 5,000자로 입력하세요.",
    "seed": 1,
    "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_qwen_image_3_pro_example",
  "status": "queued",
  "model": "qwen-image-3-pro",
  "reserved_credits": 7,
  "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 참조 업로드가 필요합니다.

Qwen Image 3.0 Pro API 연동