
Pro 및 Turbo 변형으로 이미지 생성 및 편집, 최대 10개의 참조 이미지, 투명한 PNG 출력, 최대 2560x2560 커스텀 크기 지원.
Pro 및 Turbo 변형으로 이미지 생성 및 편집, 최대 10개의 참조 이미지, 투명한 PNG 출력, 최대 2560x2560 커스텀 크기 지원.
다른 이름 Qwen Image, Alibaba Cloud Qwen Image 2.1
qwen-image-2-1/v1/images/generationsqwen-image-2.1qwen-image-2.1-proqwen-image-2.1-turboalibaba/qwen-image-2-1alibaba/qwen-image-2.1EmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.
Qwen Image 2.1은(는) 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-2-1",
"prompt": "Describe what you want Qwen Image 2.1 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-2-1",
"prompt": "Describe what you want Qwen Image 2.1 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 2.1 API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.
| 파라미터 | 유형 | 기본값 | 범위 / 값 | 설명 |
|---|---|---|---|---|
| prompt | string | - | - | 생성할 이미지를 설명하세요. 입력 이미지가 첨부되면 편집 지시가 됩니다. 이미지 전용 편집은 중립 보존 프롬프트를 사용합니다. |
| model_variant | enum | qwen-image-2.1-pro | qwen-image-2.1-pro, qwen-image-2.1-turbo | 최고 화질과 복잡한 편집을 위해 프로를 선택하거나, 더 빠르고 저렴한 생성을 위해 터보를 선택하세요. 이 설정이 없으면 모델 ID "qwen-image-2.1-turbo"이 터보를 선택하고 이 모델의 다른 모든 ID는 프로를 선택합니다. |
| image | array | - | - | 10명에서 10명은 이미지를 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입니다. Auto는 Aspect Ratio가 Auto일 때 모델이 크기를 선택할 수 있게 합니다; 선택한 Aspect Ratio에서는 Auto가 1K 프리셋을 사용합니다. |
| size | string | - | - | 정확한 출력 크기는 WIDTH*HEIGHT, 예를 들어 2048*1536으로 설정됩니다. 이 경우 aspect_ratio와 해상도가 무시됩니다. |
| use_custom_size | boolean | false | - | 아스펙트비와 해상도 프리셋 대신 custom_width 및 custom_height를 사용하세요. |
| custom_width | number | - | 256 ~ 4096 | 픽셀 단위의 맞춤 출력 폭. 총 면적은 512x512에서 2560x2560 사이여야 하며, 화면비는 1:8에서 8:1 사이여야 합니다. |
| custom_height | number | - | 256 ~ 4096 | 픽셀 단위의 맞춤 출력 높이. 총 면적은 512x512에서 2560x2560 사이여야 하며, 화면비는 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 2.1은 Pro와 Turbo 이미지 생성 및 편집을 하나의 모델에 결합한 모델입니다. 기본적으로 Pro가 선택되고, 출력은 2K에서 시작되며, 화면비는 Auto에서 시작됩니다. Turbo는 더 빠르고 저렴한 옵션을 제공합니다.
생성된 이미지는 자동 콘텐츠 안전 검사를 통과합니다. 명시적으로 표시된 이미지는 반환되지 않습니다. 이미지가 검사 실행 전에 생성되기 때문에, 플래그가 붙은 생성은 여전히 청구됩니다.
EmpirioLabs에서 Qwen Image 2.1은(는) 종량제로 청구됩니다: 장점 $0.040 이미지별로; 터보 $0.016 이미지별로. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.
Qwen Image 2.1은(는) api.empiriolabs.ai의 POST /v1/images/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.
네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 Qwen Image 2.1을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.
EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.