Qwen Image 3.0
Qwen Image 3.0 이미지 생성
- 비동기 처리 모드, 후속 조회를 위한 작업 ID 반환
- 텍스트-이미지, 이미지-이미지(1-3장 참조 이미지 편집) 지원
- 1K / 2K 해상도 지원, 요청당 최대 6장
- 표준 및 Pro 변형(Pro는 밀집 레이아웃과 텍스트에 더 강함)
POST
지원 모델
Authorizations
string
필수
Body
string
필수
모델 이름
qwen-image-3.0- 표준qwen-image-3.0-pro- Pro (밀집 텍스트 / 레이아웃)
string
필수
이미지 생성용 텍스트 설명, 최대 약 4.5k 토큰
string[]
참조 이미지 URL 배열 (이미지-이미지 / 편집), 1-3장
- 공개
http(s)://URL 또는data:image/png;base64,...(base64는 먼저 재업로드됨) - 형식: JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF
- 파일당 ≤ 10MB, 너비/높이는 384-2048 px 권장
string
기본값:"1K"
해상도 등급 (과금 등급에 영향)
1K(기본값, 소문자 허용)2K
size에 픽셀을 직접 전달할 수 있습니다 (예: 1600x900). 원시 픽셀 사용 시 면적 > 2.25M 픽셀이면 2K로 과금됩니다.string
기본값:"1:1"
종횡비 또는 명시적 픽셀 크기지원 비율:
1:1(기본값)4:3/3:416:9/9:163:2/2:3
16x9 형식 또는 1024x1024 같은 픽셀도 허용. 커스텀 픽셀일 때 각 변(너비·높이)은 512 ~ 2048, 종횡비 1:8 ~ 8:1.size와 resolution을 모두 설정하지 않으면 출력은 1024×1024로 고정됩니다.integer
기본값:"1"
이미지 수, 1-6. 6을 초과하면 6으로 클램프됩니다.
string
네거티브 프롬프트: 피하고 싶은 내용
boolean
기본값:"false"
지능형 프롬프트 재작성기본값은 꺼짐 (결과 예측 가능성 유지). 지능형 재작성을 쓰려면
true로 설정하세요.string
재작성 모드 (3.0 시리즈만,
prompt_extend: true 필요)direct- 텍스트-이미지 및 이미지-이미지 모두 가능agent- 텍스트-이미지만, 더 적극적인 재작성
크기 참조표
resolution(등급) + size(비율) 조합:
사용 사례
텍스트-이미지 (여러 장)
밀집 레이아웃 + 재작성
이미지-이미지 (편집)
네거티브 프롬프트
제한
Response
integer
상태 코드, 성공 시 200
array
응답 데이터 배열
2.0과의 차이
참고 사항
- 비동기: 제출 후
task_id가 반환됩니다. 작업 상태 조회를 3~5초마다 폴링하세요. 클라이언트 타임아웃 약 3분 (2K + 다중 이미지는 더 느림). - 저장: 이미지는 플랫폼 CDN에 미러되어 장기 접근 가능합니다.
- 과금: 납품 이미지 수 × 해상도 등급. 실제 픽셀 면적 기준 (> 2.25M 픽셀 = 2K).
qwen-image-3.0은 1K/2K 동일 요금,-pro2K는 1K의 2배. 실패 시 전액 환불, 참조 이미지는 무료. - 오류: 잘못된 size/비율, 이미지-이미지에서
agent, 접근 불가/과대 참조 이미지 → 400, 속도 제한 → 429.
결과 조회진행 상황과
result.images는 작업 상태 조회를 사용하세요.