
Qwen 이미지 생성 및 편집, Base 및 Pro 변형, 다국어 타이포그래피, 다중 이미지 참조, 그리고 제어 가능한 1K 또는 2K 출력.
Qwen 이미지 생성 및 편집, Base 및 Pro 변형, 다국어 타이포그래피, 다중 이미지 참조, 그리고 제어 가능한 1K 또는 2K 출력.
다른 이름 Qwen Image, Alibaba Cloud Qwen Image 3.0
qwen-image-3-0/v1/images/generationsqwen-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-proEmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.
Qwen Image 3.0은(는) POST /v1/images/generations로 실행됩니다. 요청은 즉시 job_id를 반환하며, 작업이 완료될 때까지 GET /v1/jobs/{job_id}을 폴링한 뒤 결과에서 출력 URL을 읽으세요. 또는 "sync": true를 추가해 폴링을 생략할 수 있습니다. 요청이 열린 상태로 완성된 OpenAI 스타일 이미지 응답을 바로 반환하므로 OpenAI SDK가 그대로 동작합니다. EmpirioLabs 대시보드에서 API 키를 발급받으세요.
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 https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"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)EmpirioLabs에서 Qwen Image 3.0 API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.
| 파라미터 | 유형 | 기본값 | 범위 / 값 | 설명 |
|---|---|---|---|---|
| prompt | string | - | - | 생성할 이미지를 설명하세요. 입력 이미지가 첨부되면 편집 지시가 됩니다. 이미지 전용 편집은 중립 보존 프롬프트를 사용합니다. |
| model_variant | enum | qwen-image-3.0-pro | qwen-image-3.0-pro, qwen-image-3.0 | 더 강한 포토리얼리즘, 밀도 높은 레이아웃, 다국어 타이포그래피, 복잡한 편집을 원한다면 Pro를, 저렴한 생성을 위해 Base를 선택하세요. |
| image | array | - | - | 1에서 3개는 URL, 데이터 URI, 또는 업로드된 이미지 객체로 이미지를 참조합니다. |
| images | array | - | - | 여러 이미지 참조를 위한 복수 별칭. |
| aspect_ratio | enum | auto | auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5 | 선택 출력 화면 비율. 기본값은 자동입니다. 고정된 1K 또는 2K 해상도에서는 자동이 해당 티어의 제곱 크기를 사용합니다. 해상도가 자동으로 설정되면 모델이 전체 출력 크기를 선택합니다. |
| resolution | enum | 2K | auto, 1K, 2K | 출력 픽셀 등급. 기본값은 최대 지원 등급인 2K입니다. 1K 등급은 2.25메가픽셀 이하로 유지되며, 2K는 2.25메가픽셀 이상입니다. Auto는 모델이 화면비를 Auto로 전환할 때 선택할 수 있게 합니다; 선택한 화면비에서는 Auto가 1K 프리셋을 사용합니다. |
| size | string | - | - | 정확한 출력 크기는 WIDTH*HEIGHT, 예를 들어 2048*1536으로 설정됩니다. 이 경우 aspect_ratio와 해상도가 무시됩니다. |
| use_custom_size | boolean | false | - | 아스펙트비와 해상도 프리셋 대신 custom_width 및 custom_height를 사용하세요. |
| custom_width | number | - | 256 ~ 2048 | 픽셀 단위의 맞춤 출력 폭. 총 면적은 512x512에서 2048x2048 사이여야 하며, 종횡비는 1:8에서 8:1 사이여야 합니다. |
| custom_height | number | - | 256 ~ 2048 | 픽셀 단위의 맞춤 출력 높이. 전체 면적은 512x512에서 2048x2048 사이여야 하며, 종횡비는 1:8에서 8:1 사이여야 합니다. |
| num_images | number | 1 | 1 ~ 6 | 출력 이미지 수. 각 출력은 별도로 청구됩니다. |
| negative_prompt | string | - | - | 출력물에서 피해야 할 시각적 요소나 특성을 설명하세요. |
| prompt_extend | boolean | true | - | 더 강한 구성과 세부 사항을 위해 프롬프트를 자동으로 확장하세요. |
| prompt_extend_mode | enum | direct | direct, agent | Direct는 생성과 편집에 적합합니다. 에이전트는 더 깊은 프롬프트 정제를 수행하며 text-to-image 요청에만 사용할 수 있습니다. |
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 편집은 몇 분이 소요될 수 있습니다. 콘텐츠 안전 생성된 이미지는 자동 콘텐츠 안전 검사를 통과합니다. 명시적으로 표시된 이미지는 반환되지 않습니다. 이미지가 검사 실행 전에 생성되기 때문에, 표시된 생성은 여전히 청구됩니다.
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은(는) api.empiriolabs.ai의 POST /v1/images/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.
네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 Qwen Image 3.0을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.
EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.