img_uuid를 받고, 폴링하거나 콜백을 사용합니다. GoEnhance는 독립적인 접근 경로를 제공하며 Alibaba의 공식 API가 아닙니다.Qwen-Image 3.0 Pro API
GoEnhance를 통해 Qwen-Image 3.0 Pro를 사용하면 하나의 엔드포인트로 텍스트 기반 이미지 생성과 레퍼런스 기반 편집을 모두 처리할 수 있습니다. 프롬프트를 제출하고 필요하면 이미지 URL을 최대 세 개까지 추가한 뒤
API 키 만들기
생성과 편집을 위한 단일 엔드포인트
제출 전에 요청 모드, 비율, 출력 등급, 선택 제어 항목을 검증합니다.
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 콜백 이벤트를 받아 작업이 성공하거나 실패할 때까지 기다린 뒤, 결과물을 저장하거나 오류를 처리합니다.새로운 이미지 생성과 통제 가능한 레퍼런스 기반 워크플로를 모두 지원합니다.
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초입니다. 폴링은 여전히 현실적인 복구 경로입니다.


