qwen-image-3 모델로 이미지 한 장을 생성하거나 편집합니다. 프롬프트만 사용하면 텍스트 기반 이미지 생성이고, 참조 이미지 URL을 1~3개 추가하면 이미지 편집이 됩니다. GoEnhance는 독립적인 API 접근을 제공하며, Alibaba의 공식 API도 아니고 Alibaba의 계열사도 아닙니다.Qwen-Image 3.0 API
GoEnhance에서
API 키 만들기
생성과 편집을 하나의 워크플로로
하나의 엔드포인트, 두 가지 모드
/api/v1/images/generations에 model: qwen-image-3을 지정해 POST 요청을 보냅니다. 프롬프트만 보내면 텍스트 기반 이미지 생성이고, 접근 가능한 참조 이미지 URL을 1~3개 포함하면 편집이 됩니다. 모든 요청은 이미지 한 장을 반환합니다.
설계부터 비동기인 결과 처리
제출에 성공하면 img_uuid가 반환됩니다. 이 값을 저장한 뒤 GET /api/v1/jobs/detail을 폴링하거나, 공개된 HTTPS 콜백 URL을 제공해 processing, success, failed 상태 변경을 수신합니다.
생성 또는 편집 작업을 제출하기 전에 문서에 명시된 필드를 확인합니다.
Qwen-Image 3.0 API 파라미터
모델 ID
<code>model</code>에 <code>qwen-image-3</code> 값을 그대로 지정합니다.
프롬프트
원하는 이미지나 편집 내용을 1~2000자로 작성합니다.
가로세로 비율
<code>auto</code>를 쓰거나, 1:1부터 1:8, 8:1까지 문서에 명시된 비율을 지정합니다.
출력 등급
<code>1K</code> 또는 <code>2K</code>를 선택합니다. 문서상 기본값은 2K입니다.
참조 이미지
편집용으로 각 10 MB 미만인 이미지 URL을 1~3개까지 선택적으로 넣을 수 있습니다.
프롬프트 제어
네거티브 프롬프트, 시드, direct 또는 agent 프롬프트 확장 모드를 선택적으로 설정합니다.
가격은 출력 비용에 참조 이미지 추가 요금을 더해 산정됩니다.
Qwen-Image 3.0 API 가격
출력 가격
1K 또는 2K 출력 한 장당 1.75 토큰이 들며, 생성 이미지당 $0.035에 해당합니다.
참조 이미지 추가 요금
참조 이미지 한 장마다 0.19 토큰, 즉 장당 $0.0039가 추가됩니다.
작업 비용 계산
참조 이미지 두 장이 포함된 요청은 2.13 토큰입니다: 1.75 + (2 × 0.19).
Qwen-Image 3.0 API 연동하기
1
요청 만들기
Authorization 헤더에 API 자격 증명을 담고,
model과 prompt가 포함된 JSON 본문을 POST합니다. 비율, 이미지 크기, 참조 URL은 필요할 때만 추가합니다. 2
작업 ID 저장
code: 0인지 확인하고 반환된 img_uuid를 저장합니다. 토큰 부족이나 인증 오류 응답은 이미지 결과가 아니라 실패로 처리해야 합니다. 3
완료 확정
작업 상세 엔드포인트를 폴링하거나 공개 HTTPS 콜백을 사용합니다. 작업이 success에 도달한 뒤에만 결과물을 사용하고, failed 상태는 명시적으로 처리합니다.
모델 서빙 인프라를 직접 구축하지 않고도 이미지 생성과 제어된 편집을 실제 워크플로에 추가합니다.
개발자 활용 사례
제품 비주얼
구조화된 프롬프트로 바로 사용할 수 있는 제품 콘셉트를 만듭니다.
크리에이티브 변형
광고, 게시물, 랜딩 페이지에 쓸 새로운 비주얼 방향을 생성합니다.
참조 기반 편집
프롬프트 의도를 유지한 채 제공된 참조 이미지 1~3장을 변환합니다.
현지화 캠페인
현지화된 크리에이티브 브리프에서 시장별 비주얼 콘셉트를 만듭니다.
에셋 파이프라인
자동화된 콘텐츠 워크플로 안에서 비동기 생성 작업을 큐에 넣습니다.
디자인 프로토타이핑
최종 제작 전에 구도, 재질, 색상 아이디어를 탐색합니다.
가격, 입력, 연동에 관해 자주 묻는 질문에 대한 답변입니다.