소개
Qwen Image 2.1 이미지 편집은 원본 이미지 1~10장을 문장으로 쓴 지시에 따라 고쳐 새로운 화면 한 장을 돌려줍니다. Alibaba Qwen 팀이 2026년 9월 21일에 이 모델을 오픈웨이트로 공개했고, 이 엔드포인트도 같은 날 여기에서 가동을 시작했습니다.
콘텐츠 필터도 성인 플래그도 없이 돌아갑니다. 자체 인수 검증에서는 무검열 원본 화면을 받아 지시를 끝까지 수행하면서도 피사체에 옷을 입히거나, 무언가를 흐리거나, 더 안전한 구도로 물러서지 않았습니다. 대부분의 편집 엔드포인트를 무검열 작업에 쓸 수 없게 만드는 바로 그 실패 방식입니다.
출발 소재로 고르는 Qwen Image 2.1 모드
| 출발 소재 | 모드 |
|---|---|
| 작업할 원본 이미지가 1~10장 있을 때 | Qwen Image 2.1 이미지 편집 |
| 문장으로 된 브리프만 있을 때 | Qwen Image 2.1 텍스트-이미지 |
| 원본에 직접 만든 LoRA 가중치를 더할 때 | Qwen Image 2.1 LoRA 이미지 편집 |
핵심 기능 및 하이라이트
한 요청에 참조 이미지 10장
대부분의 편집 엔드포인트는 원본을 한 장, 많아야 세 장 받습니다. 이쪽은 10장까지 읽습니다. 일관된 시리즈가 현실적으로 가능해지는 이유가 여기에 있습니다. 캐릭터를 확정한 화면을 붙잡아 두고, 의상을 담은 참조와 장소를 담은 참조를 더한 뒤, 한 번에 변수 하나씩만 바꾸면 됩니다.
원본은 보낸 그대로 남습니다
피사체에 조용히 옷을 다시 입히는 편집 엔드포인트는 거절하는 쪽보다 나쁩니다. 원하지 않은 그림에 요금을 매기기 때문입니다. 저희는 무검열 원본에 그대로 유지하면서 새 요소를 더하라는 지시를 함께 보냈고, 요청한 요소가 전부 들어간 결과를 그대로 받았습니다.
참조 이미지마다 값이 매겨지므로 견적이 요청을 그대로 따라갑니다
원본을 더하면 비용은 직선으로 올라가고, 보내기 전에 표시되는 견적이 그대로 정산됩니다. 같은 단계라면 원본 10장짜리 요청은 1장짜리 요청의 몇 배입니다. 효과가 있는 참조만 남기고 나머지를 빼야 하는 이유입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자입니다. 이 계열에는 네거티브 프롬프트가 없으므로 제외할 내용도 여기에 적습니다. 1자 이상 · 5000자 이하 |
image_urls | 예 | 참조 이미지 1~10장입니다. 모델이 스스로 역할을 배정하지 않으므로 각 원본이 무엇을 맡는지 프롬프트에 적어 주십시오. 1개 이상 · 10개 이하 |
mask_url | 아니요 | 편집을 부분 편집 모드로 바꾸는 선택 사항인 흑백 이미지입니다. 흰색은 다시 그릴 영역, 검은색은 그대로 두는 영역이며, 경계를 몇 픽셀 부드럽게 두면 자연스럽게 섞입니다. |
aspect_ratio | 아니요 | 생성 후에 잘라 내는 것이 아니라 생성 전에 구도를 그 비율로 짭니다. 실제로 게시할 형태를 고르십시오. |
resolution | 아니요 | 출력 크기와 가격을 정하는 단계입니다. 1k가 기본값이자 가장 저렴하고, 1.5k가 그 사이이며, 2k는 피부 질감과 머리카락, 직물의 짜임이 버텨 주는 지점입니다. |
enable_prompt_expansion | 아니요 | 기본값은 켜짐입니다. 생성 전에 프롬프트를 더 풍부한 장면 묘사로 다시 씁니다. 기본값: |
background | 아니요 | 기본값은 opaque입니다. transparent는 실제 알파 채널 위에 피사체만 담아 돌려줍니다. |
output_format | 아니요 | 기본값은 JPEG입니다. 합성 단계로 넘어가는 화면에는 PNG를, 페이지에 바로 올리는 화면에는 WebP를 쓰십시오. |
seed | 아니요 | 결과를 비슷한 범위 안에 붙잡아 시리즈의 결을 맞춰 줍니다. 재현을 보장하지는 않습니다. |
요금
| 사양 | 요금 |
|---|---|
| $0.036 / 장 |
| $0.048 / 장 |
| $0.072 / 장 |
활용 사례
세트 전체의 캐릭터 일관성
승인된 화면 하나를 동일성 참조로 두고, 이미지마다 새 지시를 붙여 다시 돌리십시오. seed가 얼굴을 재현해 주기를 바라는 것보다 훨씬 안정적입니다.
기존 인물에서 쌓아 올리는 장면
이미 가지고 있는 인물에서 시작해 두 번째 인물, 소품, 배경을 더하십시오. 지시는 적힌 그대로 수행됩니다.
의상과 배경 교체
참조 두 장, 하나는 인물이고 하나는 의상이나 공간입니다. 그리고 어느 쪽이 무엇인지 적은 프롬프트면 됩니다.
맥락을 지킨 채 키우기
장면 전체를 다시 뽑지 않고 디테일만 올리고 싶을 때, 1k 화면을 구도를 유지하라는 지시와 함께 2k 편집으로 다시 돌리십시오.
프롬프트 가이드 및 실전 팁
참조 이미지가 각각 무엇을 맡는지 적으십시오
모델은 역할을 추론하지 않습니다. '첫 번째 이미지가 여성이고, 두 번째는 그가 서 있는 공간입니다'라는 한 문장이 편집과 뒤섞기를 가릅니다.
바뀌면 안 되는 것을 적으십시오
여기에는 네거티브 프롬프트가 없으므로 지켜야 할 것은 본 지시문에 적습니다. '원본과 똑같이 유지하고 의상에 아무것도 더하지 마십시오'가 바로, 가려야 한다고 판단한 피사체를 편집 모델이 덮어 버리는 것을 막는 문장입니다.
참조는 적게, 대신 좋은 것으로 보내십시오
동일성은 깨끗한 원본 한 장에서 잘 유지되고 원본을 쌓을수록 흔들립니다. 참조마다 가격도 올라가므로 대개는 적을수록 싸고 또 선명합니다.
단계만 보지 말고 견적을 확인하십시오
이 엔드포인트에서는 참조 이미지 수가 해상도 단계만큼이나 가격을 움직입니다. 보내기 전 견적이 기준이니, 원본 10장짜리 요청은 보내기 전에 읽어 보십시오.
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-2.1/edit",
"input": {
"aspect_ratio": "1:1",
"background": "opaque",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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 레퍼런스에서 확인하세요.
