소개
Qwen Image Edit Spicy는 원본 이미지 한 장을 쉬운 영어 지시문 하나로 편집합니다. 마스크도, 영역 선택도, 얼마나 바꿀지 정하는 조절도 없습니다. 문장이 조작의 전부이며, 지켜지는 것은 이름을 댄 것뿐입니다.
요청은 image_url, prompt, 선택 항목인 seed로 이루어집니다. seed를 0으로 두면 무작위 추첨을 요청합니다. 요청당 이미지 한 장이 돌아옵니다.
핵심 기능 및 하이라이트
마스크도, 강도도, 인페인팅 절차도 없습니다
대부분의 편집기는 무엇이든 바꾸기 전에 영역과 변경 정도부터 고르게 합니다. 이 모델은 문장 하나를 받습니다. 바뀔 것과 남아야 할 것을 적어 보내십시오. 강도 조절이 없는 것은 설계의 일부입니다. 무엇을 지킬지 말로 표현하므로, 나중에 편집을 검토할 때도 그 말로 확인할 수 있습니다.
대담한 의상 편집, 필터 없이
필터가 걸린 편집기들이 거부하는 의상 변경도 여기서는 특별한 경우가 아니라 평범한 지시입니다. 설정할 성인 플래그도, 요청이 우회되는 다른 엔드포인트도 없습니다. 지시문 속 표현은 쓴 그대로 전달됩니다.
방을 다시 그리지 않고 간판 문구 바꾸기
Qwen Image 계열의 타이포그래피를 물려받았기 때문에 이미 이미지 안에 있는 문구를 바꿀 수 있습니다. 문고리 안내판, 메뉴 보드, 병 라벨 같은 것입니다. 지금 있는 문자열과 원하는 문자열을 인용하고, 자세, 프레이밍, 색 보정은 그대로라고 밝히십시오.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 권리를 가진 이미지의 공개된, 바로 내려받을 수 있는 링크입니다. 뷰어 페이지나 수명이 짧은 서명 URL은 실패합니다. 1자 이상 |
prompt | 예 | 편집의 양쪽을 담은 지시문 하나입니다. 바뀔 내용을 적고, 그다음 똑같이 남아야 할 포즈와 구도, 조명, 색보정을 적으세요. 1자 이상 |
seed | 아니요 | 같은 이미지와 지시문에 같은 seed를 넣으면 편집 두 번의 뽑기가 같아져서, 차이가 직접 바꾼 부분만 남습니다. 비교를 위한 값이지 같은 편집을 그대로 돌려준다는 약속은 아닙니다. |
요금
$0.038 / 장
활용 사례
받은 이미지 다듬기
기존 사진은 그대로 두고 한 가지만 바꾸고 싶을 때 이 엔드포인트를 씁니다. 사진을 image_url로 보내고, 바꿀 것과 남겨야 할 요소, 즉 자세, 프레이밍, 조명, 색 보정을 적은 뒤, 결과를 원본과 비교하십시오.
다른 편집기가 거절하는 지시
필터가 있는 편집 API가 돌려보내는 과감한 의상 지시도 여기서는 평범한 편집으로 실행됩니다. 요청은 달라지지 않습니다. 같은 필드 이름, 같은 작업 흐름, 같은 비동기 폴링으로 결과를 받습니다.
승인된 이미지에서 의상 바꾸기
자세와 조명이 맞는 인물 사진이 이미 있다면, 장면을 다시 생성하지 않고 옷을 이브닝웨어나 더 대담한 룩으로 바꾸십시오. 얼굴, 방, 색 보정이 그대로 남아 세트의 일관성도 유지됩니다.
이미 비용을 들인 사진으로 문구 변형 만들기
간판, 안내판, 라벨의 글자만 바꾸고 사진은 똑같이 유지합니다. 언어마다, 캠페인 문구마다 장면 전체를 다시 생성하는 것보다 싸고 훨씬 일관됩니다.
프롬프트 가이드 및 실전 팁
원본 이미지는 가져갈 수 있는 곳에 두십시오
image_url은 공개되어 있고 바로 내려받을 수 있는 링크여야 합니다. 뷰어 페이지나, 작업이 실행되기 전에 만료되는 서명된 URL은 안 됩니다. 구도와 품질의 상한은 원본이 정합니다.
편집의 양쪽을 모두 적은 지시문 하나 쓰기
바뀔 것과 똑같이 남아야 할 것을 각각 한 문장으로 적으십시오. 이 엔드포인트의 편집은 다음 지시에서 나왔습니다. ‘Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.’
포함된 예시 고쳐 쓰기
공개된 예시에서 시작하고, image_url에는 공개적으로 접근할 수 있는 URL을 넣습니다. 피사체와 연출은 바꾸되 이 모드의 입력 규칙은 그대로 유지합니다.
Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.
이 엔드포인트에서 보여 주는 편집 뒤에 있는 지시 그대로입니다. 옷을 바꾸고 문고리 안내판 문구도 바꾸면서, 자세, 프레이밍, 조명, 색 보정은 바꾸지 않는다고 명시했습니다. 원본 이미지는 직접 준비해야 합니다. 여기 image_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-spicy-edit/edit",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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 레퍼런스에서 확인하세요.
