승인된 인물 사진에 필요한 변경이 의상 하나뿐일 때가 있습니다. 예를 들어 얼굴, 모자, 포즈는 그대로 알아볼 수 있게 두고 짜임과 늘어지는 모양이 다른 스카프로 바꾸는 경우입니다. 이미지 편집기는 그런 변경을 제안할 수 있지만, 사진의 나머지 부분을 그대로 보존해야 한다면 알맞은 작업 방식을 고르는 것이 중요합니다.
Qwen Image Edit Spicy는 원본 이미지 하나, 편집 지시문 하나, 선택 사항인 seed를 받습니다. 현재 이미지당 $0.038이며, 기존 구도에 텍스트로 지시한 변경을 적용할 때 사용하세요. 마스크나 원본 강도 조절은 기대하지 마세요. 얼굴과 의상의 모든 가장자리를 보존한 채 정확하게 색만 바꿔야 한다면, 마스크를 쓰는 기존 방식의 색 보정이 더 직접적입니다. 생성형 의상 제안이 필요하다면 아래의 원본과 편집 지시문을 사용하고 결과를 원래 원본과 비교하세요.
성인인 가상의 예시는 자두색 블레이저와 아이보리 셔츠를 입고, 옅은 청록색 스카프를 두른 채 짙은 주황색 펠트 모자를 든 여성입니다. 요청하는 변경은 더 굵은 직조감의 차분한 구릿빛 스카프입니다. 기존 일러스트는 요청 내용을 보여 줄 뿐, Qwen의 보존 성능을 보여 주는 것이 아닙니다.
알맞은 Qwen 작업 고르기
Qwen Image Edit Spicy를 엽니다. 공개 식별자는 alibaba/qwen-image-spicy-edit/edit입니다. 이것은 Qwen Image 2.1 편집이나 Qwen LoRA 작업과는 다릅니다.
| 필드 | 이번 시도의 값 | 의미 |
|---|---|---|
image_url | 승인된 인물 사진 파일 | 원본은 하나이며 image_urls가 아닙니다 |
prompt | 아래의 스카프 지시문 | 필수이며 비어 있으면 안 됩니다 |
seed | 314159 | 선택 사항인 정수, 0–2147483647. 0이면 무작위 seed를 요청합니다 |
이 의상 작업에는 두 가지 제약이 있습니다.
- 영역 제어 없음: 이 작업은 마스크도 원본 강도 설정도 제공하지 않습니다. "이것만 변경"은 의도한 결과를 설명할 뿐, 이미지의 나머지 부분을 고정하지는 않습니다.
- 출력과 세부 조정 제어 없음: 다른 Qwen 작업의 해상도, 화면 비율, 출력 형식, 네거티브 프롬프트, LoRA 필드는 여기서 받지 않습니다. 최종 크롭을 준비하기 전에 반환된 파일을 확인하세요.
더 일반적인 Qwen Image Edit 소개는 의미 기반 편집과 외형 편집을 다룹니다. 이 글은 호스팅되는 이 Spicy 작업의 정확한 기반 버전이나 내부 구조를 밝혀 주지 않습니다. 실제 요청에는 이 작업의 현재 필드를 사용하세요.
스카프 전체가 보이는 원본 하나 준비하기
스카프의 아래쪽 접힌 부분, 블레이저의 양쪽 라펠, 손, 모자의 챙 전체가 들어간 원래 허리 위 인물 사진을 사용하세요. 스카프만 잘라 내지 마세요. 의도하지 않은 변화를 알아차리려면 반환된 같은 이미지에 얼굴과 모자가 있어야 합니다. 머리카락에 일부 가려진 스카프도 편집할 수 있지만, 원본에서 구분되지 않는 경계는 프롬프트로 보호할 수 없습니다.

일러스트이며 대상 모델의 결과가 아닙니다. 스카프 전체, 라펠, 손, 모자가 보이는 구도가 원본 보존을 위한 구체적인 요청 내용입니다.
실제 인물이라면 처리할 권한이 있는 원본을 사용하세요. 캐릭터 시리즈에서는 실패한 수정본 때문에 얼굴이 바뀌었다면 같은 승인된 인물 사진으로 돌아가세요. 실패한 얼굴을 다음 마스터로 쓰지 마세요.
색 변경과 새 의상 구분하기
의상 편집은 서로 다른 세 가지를 요청할 수 있습니다. 색 변경은 솔기 위치, 소재, 늘어지는 모양을 유지합니다. 소재 변경은 의상의 디자인은 유지하되 빛이 반사되는 방식을 바꿉니다. 교체는 칼라, 스트랩, 여밈, 재단까지 바꿉니다. 이 세 가지를 "옷을 더 매력적으로"라는 한마디에 섞으면, 어떤 인물 특징과 포즈 세부를 다시 그릴지 모델이 정하게 됩니다.
스카프라면 "차분한 구릿빛 갈색의 직조 원단"은 색과 표면을 함께 지정합니다. 반면 "구리색 스카프"는 금속을 떠올리게 할 수도 있고, 이것이 아래 표에 나오는 번들거리는 실패의 이유입니다. 새틴이라면 원단의 기본 색과 하이라이트를 구분하세요. 하이라이트는 옅은 채로 두고 원단 본체만 버건디로 바꿀 수 있습니다. 완전히 균일한 색을 요구하면 원단처럼 보이게 하는 빛과 주름의 정보가 사라집니다.
성인인 가상 캐릭터의 의상 시리즈라면, 얼굴과 의상 경계가 선명하게 보이는 승인된 원본에서 시작하세요. 먼저 의상 하나만 바꿔 달라고 요청하세요. 결과 의상은 쓸 만한데 조명이 이상하다면 채택한 변형본에서 조명 수정본을 만드세요. 얼굴이 이상하다면 원본에서 다시 시작하세요. 바뀐 얼굴 위에 편집을 반복하면 점점 그 바뀐 얼굴이 원본이 되어 버립니다.
다른 부위를 덮는 새 의상은 모델이 지어내야 하는 정보도 바꿉니다. 원본에는 다른 의상의 보이지 않는 구조나 가려진 손이 담겨 있지 않습니다. 의상을 탐색하는 동안에는 포즈와 카메라 시점을 안정적으로 유지해서, 새 의상 결과가 새로운 신체 구조나 원근 해결까지 요구하지 않게 하세요. 이는 서로 충돌하는 지시를 줄이기 위해 제안하는 방법이며, 이 엔드포인트에서 검증한 성공률이 아닙니다.
Playground에서 스카프 편집 해 보기
- 모델 페이지에서 Playground 탭을 열고 Input image에 승인된 인물 사진을 추가합니다(JPG, PNG, WEBP 또는 GIF, 최대 10 MB). 파일을 업로드하거나, Asset URL과 Add URL로 바로 다운로드할 수 있는 공개 링크를 붙여 넣으세요. 뷰어 페이지와 유효 시간이 짧은 서명 링크는 실패합니다.
- Prompt에 다음을 입력합니다. "Change only the pale-teal scarf to muted copper woven fabric with heavier texture. Keep its wrap, the face, plum blazer, ivory shirt, hands, orange hat, lighting and framing."
- Seed는 비워 두거나, 같은 seed로 표현을 비교하려면
314159를 입력합니다. Run model을 누르고 얼굴, 스카프, 모자를 원본과 비교하세요.
API로 승인된 설정 사용하기
환경에 SPICY_API_KEY를 설정합니다. SOURCE_IMAGE_URL은 승인된 인물 사진의 직접 HTTPS URL로 설정합니다. 컴퓨터에 있는 파일은 미디어 가이드에 설명된 대로 먼저 업로드하세요. Python 3로 실행하고, 표시된 견적은 새로 유료 시도를 하고 싶을 때만 확인하세요.
import json
import os
import uuid
from pathlib import Path
from urllib.request import Request, urlopen
payload = {"model": 'alibaba/qwen-image-spicy-edit/edit', "input": {
'image_url': os.environ['SOURCE_IMAGE_URL'],
'prompt': "Change the pale-teal scarf to muted copper woven fabric with a heavier weave and soft folds. Keep its wrap and placement around the neck. Retain the adult woman's face, hairstyle, plum blazer, ivory shirt, hand positions, burnt-orange felt hat, studio background, lighting and camera framing. The scarf remains fabric, not metallic jewelry.",
'seed': 314159,
}}
def api(action, body, key=None):
headers = {"Authorization": "Bearer " + os.environ["SPICY_API_KEY"],
"Content-Type": "application/json"}
if key:
headers["Idempotency-Key"] = key
request = Request("https://api.spicyapi.ai/api/v1/jobs/" + action,
data=json.dumps(body).encode(), headers=headers)
with urlopen(request, timeout=60) as response:
result = json.load(response)
if result.get("code") != 200:
raise RuntimeError(result)
return result["data"]
quote = api("quote", payload)
print("Maximum charge (USD):", quote["maxCharge"])
if input("Create this new attempt? Type yes: ").strip() != "yes":
raise SystemExit("No task created")
key = str(uuid.uuid4())
body = {**payload, "quoteId": quote["quoteId"],
"expectedCost": quote["estimatedCost"]}
Path(key + ".json").write_text(json.dumps({"key": key, "request": body}))
task = api("createTask", body, key)
Path(key + ".task.json").write_text(json.dumps(task))
print("Task ID:", task["taskId"])저장된 키는 같은 요청을 재시도할 때를 위해 보관하세요. 결과 가져오기와 파일 처리는 작업 API 가이드에 있습니다.
반복 편집이라면 Agent가 승인된 요청 내용을 맡을 수 있습니다.
- CLI:
npx @spicyapi/cli tasks create --model alibaba/qwen-image-spicy-edit/edit --input-file input.json --wait.input.json에는{"image_url": "...", "prompt": "..."}를 넣습니다. - MCP:
spicyapi_task_create를 사용한 뒤spicyapi_task_wait를 사용하도록 요청하세요. - Skill:
npx skills add spicyapi-ai/spicy-skill로 설치한 다음,spicyapiSkill에 견적을 보여 준 뒤 이 설정을 실행해 달라고 요청하세요.
눈에 보이는 실패에 맞는 수정하기
| 반환된 문제 | 승인된 원래 원본에서 이어 갈 다음 조치 |
|---|---|
| 스카프가 번들거리는 금속처럼 보입니다 | "copper"를 "muted copper-brown woven fabric with soft diffuse highlights"로 바꾸고 원래의 주름은 유지하세요. |
| 모자까지 구리색이 됩니다 | "The burnt-orange felt hat keeps its original color and matte felt texture; only the scarf changes."를 추가하세요. |
| 아래쪽 접힌 부분이 청록색으로 남습니다 | 그 접힌 부분을 명시하세요. "Recolor the entire visible scarf, including the long fold over the ivory shirt." |
| 블레이저 라펠의 색이 바뀝니다 | 마스크를 쓰는 기존 방식의 색 보정이나 영역을 지정할 수 있는 편집기를 사용하세요. "only"를 반복해도 이 엔드포인트에 마스크가 생기지는 않습니다. |
| 얼굴이나 포즈가 바뀝니다 | 그 수정본은 보존 편집으로는 불합격 처리하고 승인된 인물 사진에서 다시 시작하세요. 이어서 편집하지 마세요. |
| 출력 모양이나 파일 형식이 디자인에 맞지 않습니다 | 반환된 결과물을 확인하고 납품용 파생본을 준비하세요. 여기에는 크기나 형식을 바꾸는 옵션이 없습니다. |
색만 바꾸는 단순한 요청이라면 보통의 마무리 작업으로 충분한 경우가 많습니다. 레이어 편집기에서 스카프를 선택하고, 그 선택 영역에 색조 변경을 적용하며, 얼굴과 모자의 원래 레이어는 그대로 둡니다. 스카프의 소재나 늘어지는 모양을 바꾸고 싶다면 생성형 제안이 도움이 될 수 있지만, 그것은 더 넓은 의상 변경이 됩니다.
마스크가 필요할 때
Qwen Image 2.1 edit에는 별도의 mask_url 제어가 있습니다. 흑백 마스크에서 흰색은 다시 그릴 영역, 검은색은 유지할 영역이며, 참조 이미지는 정확히 하나입니다. 마스크는 1k와 2k를 지원하고, 이미지당 요금은 각각 $0.036과 $0.048입니다. 이것은 대체 작업이며 Spicy Edit에 추가할 수 있는 필드가 아닙니다. 원래 인물 사진을 유일한 원본으로 업로드하고, 스카프와 그 경계를 편집 영역에 포함하세요.
영역을 지정할 수 있는 편집기를 쓰더라도 이후에 얼굴, 모자, 라펠을 비교하세요. 실제 납품물에서 스카프 바깥의 원래 픽셀이 똑같아야 한다면, 생성형 보존 지시를 보장으로 내세우지 말고 채택한 스카프 처리를 기존 레이어 마스크로 원본에 합성하세요.

일러스트이며 대상 모델의 결과가 아닙니다. 원단은 색의 방향을 나타내며, 이 별도의 기획용 인쇄물은 짝이 맞는 전후 결과가 아닙니다.
과거 성인 테스트가 보여 주는 것과 보여 주지 않는 것
2026년 9월 테스트에서 Spicy Edit는 성인 콘텐츠 다섯 가지 카테고리 모두에서 요청한 편집을 해냈습니다. 테스트 결과에는 실제 전후 비교 쌍이 들어 있습니다. 무검열 콘텐츠 처리라고 해서 원본 보존이 자동으로 되는 것은 아닙니다. 편집이 끝나도 얼굴이나 손이 바뀔 수 있습니다.
$0.038이면 의도한 후보 두 장의 합계는 $0.076입니다. 후보를 몇 장 만들어도 인물 사진이 보존된다는 보장은 없습니다.
대략적인 생성형 변형으로 충분하다면 원본 하나로 요청하는 것부터 시작하세요. 주변 인물 사진을 정확하게 유지하는 것이 핵심 요건이라면, 실제로 마스크를 지원하는 작업이나 보통의 마무리 작업을 선택하세요.
자주 묻는 질문
Qwen Image Edit Spicy는 Qwen Image 2.1 편집과 같은 작업인가요?
아니요. Spicy Edit는 image_url 하나와 선택 사항인 seed를 사용합니다. 별도의 2.1 편집 작업은 mask_url을 받으며, 그 마스크를 쓸 때는 참조를 정확히 하나만 제공하세요. 두 작업의 필드를 섞지 말고, 요청을 복사하기 전에 작업부터 고르세요.
스카프 바깥의 모든 픽셀을 그대로 유지할 수 있나요?
이 작업에는 그것을 강제하는 마스크가 없습니다. 색만 바꾸는 경우라면 기존 편집기에서 선택 영역을 만드세요. 생성형 소재 변경에서 주변 픽셀을 바꾸지 않아야 한다면, 채택한 스카프 영역을 원본에 다시 합성하세요.
seed를 쓰면 같은 얼굴이 유지되나요?
seed는 생성 시도를 제어할 뿐, 얼굴 보존을 위한 제어가 아닙니다. 승인된 원본을 유지하고, 실제 출력에서 얼굴, 헤어라인, 손, 의상 경계를 비교하세요.
제출 후 응답을 놓쳤을 때 다시 시도할 수 있나요?
같은 요청에 같은 Idempotency-Key를 붙여 보내세요. 위 스크립트는 둘을 <key>.json에 저장합니다. 24시간 기간은 멱등성 가이드에서 설명합니다. 새 시도를 시작하면 유료 이미지가 하나 더 생깁니다.






