소개
Qwen Image 3.0 Pro 이미지 편집은 레퍼런스 이미지 1~3장을 지시문에 따라 편집합니다. 레퍼런스가 한 장이면 표지 문구, 옷, 조명 같은 정밀한 변경입니다. 두세 장이면 합치는 작업이 되며, 프롬프트가 각 원본이 무엇을 제공하는지 말해야 합니다.
Qwen Image 3.0 Pro는 Alibaba Qwen 이미지 라인의 고디테일 등급입니다. 5,000자 프롬프트, 화면비 8종, 1K 또는 2K 등급, 레퍼런스 1~3장 편집을 지원합니다. 납품할 이미지를 위해 만들어졌으며 무검열입니다.
출발 소재로 고르는 Qwen Image 3.0 Pro 모드
| 출발 소재 | 모드 |
|---|---|
| 글로 쓴 아트 디렉션이나 디자인 브리프 | Qwen Image 3.0 Pro 텍스트→이미지 |
| 손봐야 할 승인된 원본 이미지 | Qwen Image 3.0 Pro 이미지 편집 |
핵심 기능 및 하이라이트
글자를 고려한 이미지 구성
Qwen Image 3.0 Pro 모델은 제공한 문구, 구도, 이미지 처리를 함께 고려해야 하는 시각 콘셉트에 유용합니다. 생성된 글자는 디자인 초안으로 다루고 게시 전에 교정하십시오.
새로 구성하는 일과 원본을 고치는 일은 다른 작업입니다
글로 쓴 브리프에서 이미지를 세울 때는 텍스트→이미지를 쓰십시오. 기존 이미지가 정해진 변경 중에도 지켜야 할 정체성, 레이아웃, 소재를 제공한다면 이미지 편집을 쓰십시오.
장식보다 위계를 먼저 검토하십시오
포스터, 패키지, 캠페인 콘셉트에서는 메시지의 위계와 초점 영역을 먼저 정하십시오. 보기 좋은 결과라도 승인된 문구나 제품 정보가 정확히 표현되지 않았다면 과제를 해낸 것이 아닙니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자입니다. 변경 내용과 똑같이 남아야 할 것을 짚으세요. 1자 이상 · 5000자 이하 |
image_urls | 예 | 권리를 가진 이미지의 공개적으로 가져올 수 있는 URL을 한 개에서 세 개까지 넣습니다. 순서가 의미를 가집니다. 1개 이상 · 3개 이하 |
aspect_ratio | 아니요 | 원본이 아니라 결과에 적용되니, 형태가 다른 레퍼런스는 바뀌어 돌아옵니다. 원래 구도가 살아남아야 한다면 의식적으로 맞추세요. |
resolution | 아니요 | 1k 또는 2k이고 기본값은 2k입니다. 가격을 바꾸는 등급 선택은 이것이고, image_urls의 레퍼런스 이미지도 장마다 견적에 더해집니다. |
num_outputs | 아니요 | 1로 고정되어 요청마다 편집 결과 한 장이 돌아옵니다. seed 없이 같은 편집을 두세 번 병렬로 보내면 지시문이 애매했는지 뽑기 하나가 나빴는지 금방 알 수 있습니다. |
enable_prompt_expansion | 아니요 | 이 패밀리에서는 기본으로 켜져 있습니다. 얄팍한 브리프는 채워 주고 자세한 브리프는 다시 써 버리니, 프롬프트가 정밀한 컷 묘사가 되면 꺼 두세요. 기본값: |
negative_prompt | 아니요 | 제외할 내용을 최대 2,000자까지 적습니다. 여기서는 옷의 이음매, 남아 있는 글자, 중복된 액세서리처럼 편집이 불러들이는 오류에 가장 쓸모 있습니다. 2000자 이하 |
seed | 아니요 | 같은 지시문의 두 가지 문장을 똑같은 뽑기 위에서 비교하려면 고정하고, 진짜 다양성을 원하면 빼 두세요. |
요금
| 사양 | 요금 |
|---|---|
| $0.04 / 장 |
| $0.075 / 장 |
활용 사례
받은 이미지 다듬기
승인된 이미지 1~3장을 결과로 이어 가야 할 때 이 모드를 씁니다. 프롬프트에서 부르는 순서대로 image_urls에 넣고, 첫째에서는 얼굴, 둘째에서는 옷처럼 각각에 역할을 주십시오. 역할은 절대 추론되지 않습니다.
잡지 표지와 무검열 에디토리얼
승인된 표지를 유지하고 한 번에 요소 하나만 바꾸십시오. 표지 문구, 옷, 조명 중 하나입니다. 스타일 변경과 문구 교체를 한 호출에서 하면 얼굴이 흔들리므로 두 요청으로 나누십시오.
포스터와 옥외 광고 시안
승인된 포스터 이미지를 가져와 다음 게재에 맞게 날짜 줄이나 법적 고지를 바꿉니다. 기존 문자열과 새 문자열을 인용하고, aspect_ratio는 이미지 형태 그대로 두며, 나머지는 모두 바뀌지 않는다고 적으십시오.
패키지와 라벨 목업
제품 렌더링을 보내 라벨을 바꿉니다. 브랜드 이름과 짧은 문구를 인용하고, 어느 면에 놓이는지 적고, 예전 라벨의 남은 글자에는 negative_prompt를 쓰십시오.
프롬프트 가이드 및 실전 팁
표지 형태를 고르고 2k를 유지하기
표지와 포스터에는 3:4나 2:3을 고르십시오. 이미지는 그 형태에 맞춰 구성되며 안쪽을 잘라 낸 것이 아닙니다. 글자가 들어가는 것은 해상도를 2k로 두십시오. 이 등급의 장점은 1k에서 사라집니다.
모든 문자열을 인용하고 위치를 적으십시오
글자 편집에서는 기존 문자열과 새 문자열을 인용하고 위치를 적은 뒤, 제호처럼 손대면 안 되는 요소를 밝히십시오. 지시문이 언급하지 않은 것은 다시 그려질 수 있습니다.
포함된 예시 고쳐 쓰기
공개된 예시에서 시작하고 aspect_ratio는 3:4, resolution은 2k로 둡니다. 피사체와 연출은 바꾸되 이 모드의 입력 규칙은 그대로 유지합니다.
Keep the portrait, wardrobe, lighting and grade exactly as they are. Change the cover line from 'THE LATE SHIFT' to 'AFTER HOURS' in the same small caps and the same position, and leave the masthead untouched.
레퍼런스 한 장으로 하는 글자 편집입니다. 두 문자열을 모두 인용하고 제호는 명시적으로 보호했습니다. 표지는 직접 준비해야 합니다. image_urls 값은 자리표시자이며 호스팅된 샘플이 아닙니다.
반복하기 전에 결과 확인하기
합치기는 프롬프트가 레퍼런스마다 역할을 줄 때 성공합니다. 원본이 세 장인데 역할을 적지 않으면 아무도 원하지 않은 혼합이 나옵니다. 제자리에서 글자를 바꾸려면 기존 문자열과 새 문자열을 모두 인용해야 합니다. 스타일 변경과 글자 교체를 한 호출에서 하면 얼굴이 흔들리므로 두 번에 나누십시오.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0-pro/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.


















