Qwen-Image 3.0 Pro API

GoEnhance를 통해 Qwen-Image 3.0 Pro를 사용하면 하나의 엔드포인트로 텍스트 기반 이미지 생성과 레퍼런스 기반 편집을 모두 처리할 수 있습니다. 프롬프트를 제출하고 필요하면 이미지 URL을 최대 세 개까지 추가한 뒤 img_uuid를 받고, 폴링하거나 콜백을 사용합니다. GoEnhance는 독립적인 접근 경로를 제공하며 Alibaba의 공식 API가 아닙니다.
API 키 만들기
Qwen-Image 3.0 Pro API의 이미지 생성을 나타내는, 브랜드 표기가 없는 스튜디오 스타일 아트워크

생성과 편집을 위한 단일 엔드포인트

프롬프트로 생성하기

순수한 텍스트 기반 생성에서는 image_list를 생략합니다. 지원되는 비율과 1K 또는 2K 출력을 고르거나, ratio: auto에 구도를 맡기면 됩니다.
텍스트 기반 이미지 생성을 나타내는, 디테일이 풍부한 단일 장면 판타지 풍경

레퍼런스 최대 3장으로 편집

image_list에 접근 가능한 이미지 URL을 한 개에서 세 개까지 넣습니다. 순서에 따라 프롬프트가 각 소스를 어떻게 지칭할지 결정되며, 모든 레퍼런스는 10MB 미만이어야 합니다.
레퍼런스 기반 이미지 편집을 나타내는, 통일감 있는 스튜디오 정물 촬영
제출 전에 요청 모드, 비율, 출력 등급, 선택 제어 항목을 검증합니다.

Qwen-Image 3.0 Pro API 파라미터

필수 모델

model을 qwen-image-3-pro로 설정합니다.

프롬프트

1자에서 2000자 사이의 텍스트 프롬프트가 필수입니다.

화면 비율

auto를 쓰거나, 1:1부터 8:1까지 문서에 명시된 13가지 비율 중 하나를 고릅니다.

출력 등급

image_size를 1K 또는 2K로 설정하며, 기본값은 2K입니다.

레퍼런스 이미지

선택적으로 image_list에 URL 객체를 한 개에서 세 개까지 전달할 수 있고, 각각 10MB 미만이어야 합니다.

프롬프트 제어

선택적으로 네거티브 프롬프트, 0부터 2147483647까지의 시드, prompt_extend_mode를 추가할 수 있습니다. agent 모드는 텍스트 기반 생성에서만 사용할 수 있습니다.
비용은 출력 등급에 레퍼런스 이미지당 추가 요금을 더해 산정됩니다.

Qwen-Image 3.0 Pro API 가격

1K 출력

문서에 명시된 가격은 생성된 1K 이미지 한 장당 2.43 tokens($0.049)입니다.

2K 출력

문서에 명시된 가격은 생성된 2K 이미지 한 장당 4.85 tokens($0.097)입니다. ratio: auto를 쓴 요청은 이 등급으로 과금됩니다.

레퍼런스 추가 요금

레퍼런스 이미지 한 장마다 0.19 tokens($0.0039)가 추가됩니다. 1:8과 8:1 비율은 1K 등급으로만 제공되며 과금도 1K 등급을 따릅니다.

세 단계로 Qwen-Image 3.0 Pro 연동하기

1

1. 구성과 검증

텍스트 기반 생성과 레퍼런스 편집 중 하나를 고르고, 프롬프트를 작성하고, 비율과 이미지 URL을 검증한 뒤 인증 헤더를 추가합니다.
2

2. 제출과 저장

model: qwen-image-3-pro를 넣어 요청을 POST하고 반환된 img_uuid를 저장합니다.
3

3. 완료 처리

GET /api/v1/jobs/detail을 폴링하거나 HTTPS 콜백 이벤트를 받아 작업이 성공하거나 실패할 때까지 기다린 뒤, 결과물을 저장하거나 오류를 처리합니다.
API 키 만들기
새로운 이미지 생성과 통제 가능한 레퍼런스 기반 워크플로를 모두 지원합니다.

Qwen-Image 3.0 Pro API 활용 사례

제품 비주얼

캠페인에 바로 쓸 수 있는 장면 콘셉트를 생성하거나, 승인된 제품 레퍼런스를 새로운 환경에 편집해 넣습니다.

광고 변형

배너, 유료 매체, 시즌 크리에이티브 테스트를 위한 프롬프트 중심의 비주얼 방향을 만들어 냅니다.

디자인 프로토타입

본 제작에 들어가기 전에 글로 정리한 아트 디렉션을 이미지 콘셉트로 옮깁니다.

레퍼런스 기반 리스타일링

순서가 있는 레퍼런스를 최대 세 장까지 사용해 구도, 피사체 디테일, 시각적 처리 방식을 유도합니다.

지역화 캠페인

연동 규격은 그대로 둔 채 지역별 장면 변형을 만듭니다.

콘텐츠 파이프라인

비동기 생성을 애플리케이션의 모더레이션, 검수, 저장, 배포 시스템에 연결합니다.
가격, 입력값, 비동기 전달, Alibaba API 관련 검색 의도에 대한 답변입니다.

Qwen-Image 3.0 Pro API 자주 묻는 질문

Qwen-Image 3.0 Pro API 요금은 얼마인가요?

GoEnhance 문서 기준으로 1K 출력은 장당 2.43 tokens($0.049), 2K 출력은 장당 4.85 tokens($0.097)이며, 레퍼런스 이미지마다 0.19 tokens($0.0039)가 추가됩니다.

Alibaba의 공식 API인가요?

아닙니다. Qwen은 Alibaba와 연관된 모델이지만, 이 페이지는 GoEnhance가 제공하는 독립적인 API 접근을 설명합니다. 제휴나 보증을 의미하지 않습니다. Alibaba가 직접 운영하는 API가 필요한 개발자는 Alibaba Cloud 문서를 참고하시기 바랍니다.

한 엔드포인트로 생성과 편집이 모두 되나요?

됩니다. 텍스트 기반 생성에서는 image_list를 생략하고, 편집에서는 레퍼런스 이미지 URL을 한 개에서 세 개까지 넣습니다. 엔드포인트는 생성 이미지 한 장을 반환합니다.

어떤 비율을 지원하나요?

문서에 명시된 값은 auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 1:2, 2:1, 1:4, 4:1, 1:8, 8:1입니다.

프롬프트 확장은 어떻게 동작하나요?

기본값인 direct 모드는 프롬프트를 그대로 사용합니다. agent는 더 폭넓게 다시 쓰지만, image_list가 없는 텍스트 기반 요청에서만 유효합니다.

API가 이미지를 즉시 반환하나요?

아닙니다. 제출에 성공하면 img_uuid가 반환됩니다. 작업 상세 엔드포인트를 폴링하거나 콜백 이벤트로 최종 결과를 받으세요.

콜백 주소를 쓸 수 없으면 어떻게 되나요?

엔드포인트가 HTTP 200을 반환하지 않으면, GoEnhance 문서 기준으로 콜백을 최대 세 번까지 재시도하며 시도마다 타임아웃은 3초입니다. 폴링은 여전히 현실적인 복구 경로입니다.

Qwen-Image 3.0 Pro API로 개발 시작하기