Qwen Image 3.0 API

Qwen 이미지 생성 및 편집, Base 및 Pro 변형, 다국어 타이포그래피, 다중 이미지 참조, 그리고 제어 가능한 1K 또는 2K 출력.

Alibaba Cloud이미지 생성출시 2026년 7월 21일Singapore독점 엔드포인트신규

Qwen Image 3.0 소개

Qwen 이미지 생성 및 편집, Base 및 Pro 변형, 다국어 타이포그래피, 다중 이미지 참조, 그리고 제어 가능한 1K 또는 2K 출력.

다른 이름 Qwen Image, Alibaba Cloud Qwen Image 3.0

image generationimage editingmulti imagetext renderingmultilingual textdense layoutsphotorealism

Qwen Image 3.0 사양

모델 ID
qwen-image-3-0
개발사
Alibaba Cloud
카테고리
이미지 생성
출시
2026년 7월 21일
입력
텍스트이미지
출력
이미지
리전
Singapore
엔드포인트
POST/v1/images/generations
대체 모델 ID
qwen-image-3.0qwen-image-3-0-proqwen-image-3.0-proalibaba/qwen-image-3-0alibaba/qwen-image-3.0alibaba/qwen-image-3-0-proalibaba/qwen-image-3.0-pro

Qwen Image 3.0 API 요금

EmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.

유형
사양
요금
기본 출력 (1K 또는 2K)
이미지별로
$0.030
프로 출력 최대 2.25MP (1K)
이미지별로
$0.040
프로 출력 2.25MP 이상(2K)
이미지별로
$0.075
입력 이미지 (1K 또는 2K)
입력 이미지당
$0.003
전체 가격 페이지에서 비교

Qwen Image 3.0 API 호출 방법

Qwen Image 3.0은(는) POST /v1/images/generations로 실행됩니다. 요청은 즉시 job_id를 반환하며, 작업이 완료될 때까지 GET /v1/jobs/{job_id}을 폴링한 뒤 결과에서 출력 URL을 읽으세요. 또는 "sync": true를 추가해 폴링을 생략할 수 있습니다. 요청이 열린 상태로 완성된 OpenAI 스타일 이미지 응답을 바로 반환하므로 OpenAI SDK가 그대로 동작합니다. EmpirioLabs 대시보드에서 API 키를 발급받으세요.

cURL: 작업 제출
curl https://api.empiriolabs.ai/v1/images/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3-0",
    "prompt": "Describe what you want Qwen Image 3.0 to generate."
  }'
cURL: 결과 폴링
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "qwen-image-3-0",
        "prompt": "Describe what you want Qwen Image 3.0 to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)
Qwen Image 3.0 API 전체 레퍼런스

Qwen Image 3.0 API 파라미터

EmpirioLabs에서 Qwen Image 3.0 API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.

파라미터유형기본값범위 / 값설명
promptstring--생성할 이미지를 설명하세요. 입력 이미지가 첨부되면 편집 지시가 됩니다. 이미지 전용 편집은 중립 보존 프롬프트를 사용합니다.
model_variantenumqwen-image-3.0-proqwen-image-3.0-pro, qwen-image-3.0더 강한 포토리얼리즘, 밀도 높은 레이아웃, 다국어 타이포그래피, 복잡한 편집을 원한다면 Pro를, 저렴한 생성을 위해 Base를 선택하세요.
imagearray--1에서 3개는 URL, 데이터 URI, 또는 업로드된 이미지 객체로 이미지를 참조합니다.
imagesarray--여러 이미지 참조를 위한 복수 별칭.
aspect_ratioenumautoauto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5선택 출력 화면 비율. 기본값은 자동입니다. 고정된 1K 또는 2K 해상도에서는 자동이 해당 티어의 제곱 크기를 사용합니다. 해상도가 자동으로 설정되면 모델이 전체 출력 크기를 선택합니다.
resolutionenum2Kauto, 1K, 2K출력 픽셀 등급. 기본값은 최대 지원 등급인 2K입니다. 1K 등급은 2.25메가픽셀 이하로 유지되며, 2K는 2.25메가픽셀 이상입니다. Auto는 모델이 화면비를 Auto로 전환할 때 선택할 수 있게 합니다; 선택한 화면비에서는 Auto가 1K 프리셋을 사용합니다.
sizestring--정확한 출력 크기는 WIDTH*HEIGHT, 예를 들어 2048*1536으로 설정됩니다. 이 경우 aspect_ratio와 해상도가 무시됩니다.
use_custom_sizebooleanfalse-아스펙트비와 해상도 프리셋 대신 custom_width 및 custom_height를 사용하세요.
custom_widthnumber-256 ~ 2048픽셀 단위의 맞춤 출력 폭. 총 면적은 512x512에서 2048x2048 사이여야 하며, 종횡비는 1:8에서 8:1 사이여야 합니다.
custom_heightnumber-256 ~ 2048픽셀 단위의 맞춤 출력 높이. 전체 면적은 512x512에서 2048x2048 사이여야 하며, 종횡비는 1:8에서 8:1 사이여야 합니다.
num_imagesnumber11 ~ 6출력 이미지 수. 각 출력은 별도로 청구됩니다.
negative_promptstring--출력물에서 피해야 할 시각적 요소나 특성을 설명하세요.
prompt_extendbooleantrue-더 강한 구성과 세부 사항을 위해 프롬프트를 자동으로 확장하세요.
prompt_extend_modeenumdirectdirect, agentDirect는 생성과 편집에 적합합니다. 에이전트는 더 깊은 프롬프트 정제를 수행하며 text-to-image 요청에만 사용할 수 있습니다.
문서에 파라미터 3개 더 있음

알아두면 좋은 점

Qwen Image 3.0은 Base와 Pro 이미지 생성 및 편집을 하나의 모델로 결합합니다. 기본적으로 Pro가 선택되며, 출력은 2K에서 시작하고, 화면비는 Auto에서 시작합니다. Base는 빠른 반복을 위한 저렴한 옵션을 제공합니다. 변형 - 포토리얼리즘, 밀도 높은 레이아웃, 다국어 타이포그래피, 복잡한 다중 이미지 편집을 위해 qwen-image-3.0-pro를 선택하세요. - 저비용 생성과 일상적인 편집을 위해 qwen-image-3.0을 선택하세요. 모드 - 프롬프트에서 텍스트에서 이미지로 변환. - 이미지 편집 및 참조 가이드 생성이 1장에서 3장까지. - 직접 프롬프트 확장은 생성 및 편집에 적합합니다. 에이전트 프롬프트 확장은 text-to-image 요청에만 더 깊이 있는 정제를 제공합니다. 출력 및 입력 제한 - 요청당 1장에서 6장의 출력 이미지. - 1K, 2K, 자동, 아스펙트비 프리셋, 또는 정확한 맞춤 크기 - 프리셋 및 커스텀 크기는 512x512에서 2048x2048 픽셀 사이를 유지하며, 선택한 면은 최대 2048 픽셀, 화면 비율은 1:8에서 8:1 사이입니다. 자동 크기 조절은 1K 또는 2K 출력 계층 내에서 자체 크기를 선택할 수 있습니다. - 입력 이미지는 JPG, JPEG, PNG, BMP, TIFF, WEBP, GIF 일 수 있으며, 각 이미지는 최대 10MB까지 가능합니다. - 프롬프트는 최대 4,500개의 토큰을 지원합니다. 청구 - Base는 1K와 2K 모두에서 하나의 출력 속도를 사용합니다. - Pro 출력은 최대 2.25메가픽셀까지 1K 속도를 사용합니다. 더 큰 Pro 출력은 2K 속도를 사용합니다. - 모든 참조 이미지는 위에 표시된 입력 이미지 전송률을 더합니다. 성능 - 1K 세대는 인터랙티브 반복에 최적화되어 있습니다. 복잡한 2K 편집은 몇 분이 소요될 수 있습니다. 콘텐츠 안전 생성된 이미지는 자동 콘텐츠 안전 검사를 통과합니다. 명시적으로 표시된 이미지는 반환되지 않습니다. 이미지가 검사 실행 전에 생성되기 때문에, 표시된 생성은 여전히 청구됩니다.

Qwen Image 3.0 API: 자주 묻는 질문

Qwen Image 3.0 API 비용은 얼마인가요?

EmpirioLabs에서 Qwen Image 3.0은(는) 종량제로 청구됩니다: 기본 출력 (1K 또는 2K) $0.030 이미지별로; 프로 출력 최대 2.25MP (1K) $0.040 이미지별로; 프로 출력 2.25MP 이상(2K) $0.075 이미지별로; 입력 이미지 (1K 또는 2K) $0.003 입력 이미지당. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.

Qwen Image 3.0은(는) 어떤 엔드포인트를 사용하나요?

Qwen Image 3.0은(는) api.empiriolabs.ai의 POST /v1/images/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.

통합하기 전에 브라우저에서 Qwen Image 3.0을(를) 사용해 볼 수 있나요?

네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 Qwen Image 3.0을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.

Qwen Image 3.0 API 키는 어떻게 발급받나요?

EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.

더 나은 엔드포인트를 사용할 준비가 되셨나요?

저희 가격을 확인하시거나 저희 스택에 자체 모델을 배포하고 싶으시면 연락해 주세요.