Qwen Image 2.1 API

Pro 및 Turbo 변형으로 이미지 생성 및 편집, 최대 10개의 참조 이미지, 투명한 PNG 출력, 최대 2560x2560 커스텀 크기 지원.

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

Qwen Image 2.1 소개

Pro 및 Turbo 변형으로 이미지 생성 및 편집, 최대 10개의 참조 이미지, 투명한 PNG 출력, 최대 2560x2560 커스텀 크기 지원.

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

image generationimage editingmulti imagemulti referencetransparent backgroundtext rendering

Qwen Image 2.1 사양

모델 ID
qwen-image-2-1
개발사
Alibaba Cloud
카테고리
이미지 생성
출시
2026년 10월 2일
입력
텍스트이미지
출력
이미지
리전
Singapore
엔드포인트
POST/v1/images/generations
대체 모델 ID
qwen-image-2.1qwen-image-2.1-proqwen-image-2.1-turboalibaba/qwen-image-2-1alibaba/qwen-image-2.1

Qwen Image 2.1 API 요금

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

유형
사양
요금
장점
이미지별로
$0.040
터보
이미지별로
$0.016
전체 가격 페이지에서 비교

Qwen Image 2.1 API 호출 방법

Qwen Image 2.1은(는) 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-2-1",
    "prompt": "Describe what you want Qwen Image 2.1 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-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)
Qwen Image 2.1 API 전체 레퍼런스

Qwen Image 2.1 API 파라미터

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

파라미터유형기본값범위 / 값설명
promptstring--생성할 이미지를 설명하세요. 입력 이미지가 첨부되면 편집 지시가 됩니다. 이미지 전용 편집은 중립 보존 프롬프트를 사용합니다.
model_variantenumqwen-image-2.1-proqwen-image-2.1-pro, qwen-image-2.1-turbo최고 화질과 복잡한 편집을 위해 프로를 선택하거나, 더 빠르고 저렴한 생성을 위해 터보를 선택하세요. 이 설정이 없으면 모델 ID "qwen-image-2.1-turbo"이 터보를 선택하고 이 모델의 다른 모든 ID는 프로를 선택합니다.
imagearray--10명에서 10명은 이미지를 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입니다. Auto는 Aspect Ratio가 Auto일 때 모델이 크기를 선택할 수 있게 합니다; 선택한 Aspect Ratio에서는 Auto가 1K 프리셋을 사용합니다.
sizestring--정확한 출력 크기는 WIDTH*HEIGHT, 예를 들어 2048*1536으로 설정됩니다. 이 경우 aspect_ratio와 해상도가 무시됩니다.
use_custom_sizebooleanfalse-아스펙트비와 해상도 프리셋 대신 custom_width 및 custom_height를 사용하세요.
custom_widthnumber-256 ~ 4096픽셀 단위의 맞춤 출력 폭. 총 면적은 512x512에서 2560x2560 사이여야 하며, 화면비는 1:8에서 8:1 사이여야 합니다.
custom_heightnumber-256 ~ 4096픽셀 단위의 맞춤 출력 높이. 총 면적은 512x512에서 2560x2560 사이여야 하며, 화면비는 1:8에서 8:1 사이여야 합니다.
num_imagesnumber11 ~ 6출력 이미지 수. 각 출력은 별도로 청구됩니다.
negative_promptstring--출력물에서 피해야 할 시각적 요소나 특성을 설명하세요.
prompt_extendbooleantrue-더 강한 구도와 디테일을 위해 자동으로 프롬프트를 확장하세요. 투명한 배경을 요청하면 꺼버리세요.
prompt_extend_modeenumdirectdirect, agentDirect는 생성과 편집에 적합합니다. 에이전트는 더 깊은 프롬프트 정제를 수행하며 text-to-image 요청에만 사용할 수 있습니다.
문서에 파라미터 3개 더 있음

알아두면 좋은 점

Qwen Image 2.1은 Pro와 Turbo 이미지 생성 및 편집을 하나의 모델에 결합한 모델입니다. 기본적으로 Pro가 선택되고, 출력은 2K에서 시작되며, 화면비는 Auto에서 시작됩니다. Turbo는 더 빠르고 저렴한 옵션을 제공합니다.

변형 모델

  • 최고 화질과 복잡한 편집을 위해 qwen-image-2.1-pro를 선택하세요.
  • 더 빠르고 저렴한 생성과 일상적인 편집을 위해 qwen-image-2.1-turbo를 선택하세요.
  • model_variant로 선택하세요. 없으면 모델 ID는 Turbo를 qwen-image-2.1-turbo 실행하고, 이 모델의 다른 모든 ID는 Pro를 실행합니다.

모드

  • 프롬프트에서 이미지로 텍스트를 변환하는 것.
  • 이미지 편집과 10장에서 10장까지의 참조 유도 생성.
  • 직접 프롬프트 확장은 생성 및 편집에 적합합니다. 에이전트 프롬프트 확장은 text-to-image 요청에만 대해 더 깊이 정교하게 다듬어집니다.

투명 이미지

  • 출력 이미지는 PNG 파일입니다. 투명 배경의 경우 prompt_extend를 false로 설정하고 이미지를 다음과 같이 설명하세요: "이것은 투명도가 있는 RGBA 이미지입니다. 유리 향수 병입니다. 이미지는 알파 채널을 가지고 있고 배경은 투명합니다."

출력 한계

  • 요청당 1개에서 6개의 이미지를 출력할 수 있습니다.
  • 1K, 2K, 자동, 종횡비 프리셋, 또는 정확한 맞춤 크기 등이 있습니다.
  • 정확한 크기와 맞춤 크기는 총 면적이 512x512에서 2560x2560 픽셀 사이이며, 화면 비율은 1:8에서 8:1 사이입니다.

청구

  • 각 출력 이미지는 해당 변형의 요금으로 청구됩니다. 참조 이미지는 청구되지 않습니다.

내용물 안전

생성된 이미지는 자동 콘텐츠 안전 검사를 통과합니다. 명시적으로 표시된 이미지는 반환되지 않습니다. 이미지가 검사 실행 전에 생성되기 때문에, 플래그가 붙은 생성은 여전히 청구됩니다.

Qwen Image 2.1 API: 자주 묻는 질문

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

EmpirioLabs에서 Qwen Image 2.1은(는) 종량제로 청구됩니다: 장점 $0.040 이미지별로; 터보 $0.016 이미지별로. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.

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

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

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

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

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

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

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

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