소개
Qwen Image 3.0 이미지 편집은 레퍼런스 이미지 1~3장과 지시문을 받아 편집된 결과를 돌려줍니다. 레퍼런스가 한 장이면 목표를 좁힌 편집이고, 두세 장이면 합치는 작업이 됩니다. 한 장에서는 얼굴, 다른 장에서는 옷이나 배경을 가져오는 식입니다. 단, 어느 이미지가 무엇을 맡는지 프롬프트에 적어야 합니다.
Qwen Image 3.0은 이미지 속 글자 표현에 강한 Alibaba의 이미지 모델입니다. 5,000자 프롬프트, 화면비 8종, 1K 또는 2K 등급을 지원하며, 편집 엔드포인트는 레퍼런스를 1~3장 읽습니다. 무검열이며 설정할 플래그도 없습니다.
출발 소재로 고르는 Qwen Image 3.0 모드
| 출발 소재 | 모드 |
|---|---|
| 글로 쓴 아트 디렉션이나 디자인 브리프 | Qwen Image 3.0 텍스트→이미지 |
| 손봐야 할 승인된 원본 이미지 | Qwen Image 3.0 이미지 편집 |
핵심 기능 및 하이라이트
글자를 고려한 이미지 구성
Qwen Image 3.0 모델은 제공한 문구, 구도, 이미지 처리를 함께 고려해야 하는 시각 콘셉트에 유용합니다. 생성된 글자는 디자인 초안으로 다루고 게시 전에 교정하십시오.
새로 구성하는 일과 원본을 고치는 일은 다른 작업입니다
글로 쓴 브리프에서 이미지를 세울 때는 텍스트→이미지를 쓰십시오. 기존 이미지가 정해진 변경 중에도 지켜야 할 정체성, 레이아웃, 소재를 제공한다면 이미지 편집을 쓰십시오.
장식보다 위계를 먼저 검토하십시오
포스터, 패키지, 캠페인 콘셉트에서는 메시지의 위계와 초점 영역을 먼저 정하십시오. 보기 좋은 결과라도 승인된 문구나 제품 정보가 정확히 표현되지 않았다면 과제를 해낸 것이 아닙니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
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.03 / 장 |
| $0.03 / 장 |
활용 사례
받은 이미지 다듬기
기존 이미지 1~3장으로 피사체, 레이아웃, 소재를 정하고 싶을 때 이 모드를 씁니다. 프롬프트에서 부르는 순서대로 첫째, 둘째, 셋째로 image_urls에 넣고, 각각이 무엇을 제공하는지 적으십시오.
캐릭터 세트와 패션 시리즈
승인된 이미지에서 캐릭터를 유지하고 요청마다 세부 하나만 바꾸십시오. 의상, 조명, 자세 중 하나입니다. 같은 변경의 두 가지 표현을 비교할 때는 seed를 고정해, 달라진 것이 추첨이 아니도록 하십시오.
문구를 현지화한 변형
승인된 이미지를 편집 엔드포인트로 보내 간판의 문구만 바꿉니다. 자세, 의상, 조명, 색 보정은 바꾸지 않는다고 적으므로, 변형은 이미지 전체가 아니라 문구에서만 달라집니다.
호텔과 공간 연출용 배경
승인된 객실이나 바 이미지를 보내 사인을 더하거나 바꿉니다. 문고리 안내판, 메뉴 보드, 네온 한 줄 같은 것입니다. 새 문구를 인용하고, 이미 간판이 있다면 기존 문자열도 인용하십시오.
프롬프트 가이드 및 실전 팁
비율과 등급을 먼저 고르기
aspect_ratio는 원본이 아니라 결과에 적용됩니다. 형태가 다른 레퍼런스는 모양이 바뀌어 돌아오므로, 원래 프레이밍을 지켜야 한다면 일부러 맞추십시오. 글자가 들어가는 것은 해상도를 2k로 두십시오. 레퍼런스 이미지는 장마다 견적에도 더해집니다.
장면을 쓰고 문구는 그대로 인용하기
먼저 그대로 둘 것을, 다음으로 바꿀 것을 적으십시오. 언급하지 않은 부분은 다시 그려질 수 있습니다. 글자 편집에서는 기존 문자열과 새 문자열을 모두 인용하십시오. negative_prompt는 2,000자까지 받으며, 남은 글자 흔적이나 중복된 장신구를 막는 데 유용합니다.
포함된 예시 고쳐 쓰기
공개된 예시에서 시작하고 aspect_ratio는 3:4, resolution은 2k로 둡니다. 피사체와 연출은 바꾸되 이 모드의 입력 규칙은 그대로 유지합니다.
Keep the bathroom, the mirror, the steam, the woman's reflection, the basin, the lighting and the whole composition exactly as they are. On the blank fogged area of the mirror to the left of her reflection, add two lines of writing drawn in bold red lipstick, thick glossy strokes with clear dark glass showing through where the fog is wiped away, slightly dripping at the ends: the first line reads 'WAIT UP' and the second line below reads 'FOR ME'. The lettering is large, hand-drawn, neatly spelled and clearly legible, and catches the warm bathroom light. Change nothing else.
평평하지도 깨끗하지도 않은 면에 더한 글자입니다. 김 서린 유리에서는 획마다 물기를 닦아 어두운 유리를 드러내야 하고, 끝에는 작은 물방울이 흘러내립니다. 지시문은 편집을 반사된 모습 왼쪽의 빈 영역으로 한정하고 나머지는 모두 그대로 두라고 명시합니다. 이미지는 직접 준비해야 합니다. URL은 자리표시자입니다.
반복하기 전에 결과 확인하기
어느 레퍼런스가 무엇을 제공하는지 프롬프트에 적어야 합니다. 두세 장이 있어도 모델은 역할을 스스로 추론하지 않습니다. 글자를 제자리에서 바꾸는 편집은 기존 문구와 새 문구를 모두 적으면 잘 됩니다. 큰 편집에서는 인물이 흔들리므로, 스타일 변경과 문구 교체를 한 호출에서 하지 말고 한 번에 하나씩 바꾸십시오.
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/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 레퍼런스에서 확인하세요.


















