Skip to main content
POST

지원 모델

밀집 텍스트/레이아웃에는 -pro를 권장합니다. 일반 이미지는 qwen-image-3.0을 사용하세요. 프롬프트 최대 약 4.5k 토큰. 모델명은 2.0 시리즈와 호환되지 않습니다.

Authorizations

string
필수
모든 엔드포인트는 Bearer Token 인증이 필요합니다API Key 관리 페이지에서 API Key를 받으세요:

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:4
  • 16:9 / 9:16
  • 3:2 / 2:3
16x9 형식 또는 1024x1024 같은 픽셀도 허용. 커스텀 픽셀일 때 각 변(너비·높이)은 512 ~ 2048, 종횡비 1:8 ~ 8:1.sizeresolution을 모두 설정하지 않으면 출력은 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과의 차이

참고 사항

  1. 비동기: 제출 후 task_id가 반환됩니다. 작업 상태 조회3~5초마다 폴링하세요. 클라이언트 타임아웃 약 3분 (2K + 다중 이미지는 더 느림).
  2. 저장: 이미지는 플랫폼 CDN에 미러되어 장기 접근 가능합니다.
  3. 과금: 납품 이미지 수 × 해상도 등급. 실제 픽셀 면적 기준 (> 2.25M 픽셀 = 2K). qwen-image-3.0은 1K/2K 동일 요금, -pro 2K는 1K의 2배. 실패 시 전액 환불, 참조 이미지는 무료.
  4. 오류: 잘못된 size/비율, 이미지-이미지에서 agent, 접근 불가/과대 참조 이미지 → 400, 속도 제한 → 429.
결과 조회진행 상황과 result.images작업 상태 조회를 사용하세요.