소개
이 엔드포인트가 하는 일
Qwen Image 2.1 Turbo Image Editing은 Alibaba가 Qwen Image 2.1을 8스텝으로 가속한 체크포인트로, 원본 이미지를 글로 쓴 지시에 맞게 수정하고 새 프레임을 16장 반환합니다. 저희 편집은 처음부터 끝까지 2659초가 걸렸습니다.
입력
image_urls에 참조 이미지를 110장 담으며, 순서대로 Image 1, Image 2처럼 부릅니다. 6장을 요청하고, prompt는 지시문입니다. aspect_ratio를 비우면 원본의 모양을 약 2K로 유지하고, resolution과 함께 지정하면 고정 크기가 됩니다. num_outputs로 결과 1enable_prompt_expansion(기본값 꺼짐)과 enable_thinking이 Alibaba의 재작성을 조절하며, seed는 시리즈를 안정시킵니다.
콘텐츠
플랫폼 필터가 없습니다. 확장을 끄면 옷을 바꾸거나 더 드러내는 편집이 요청대로 나왔고, 켜면 같은 지시가 변화 없이 돌아왔습니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| SpicyAPI 현황 | 이용 가능: 텍스트 투 이미지와 이미지 편집 |
| 기반 | Qwen Image 2.1, 같은 7B 모델을 8스텝으로 가속한 체크포인트 |
| 요청당 이미지 | 1~6장, 돌려받은 이미지마다 과금 |
| 가격 | 1k, 1.5k, 2k 등급 모두 이미지당 가격이 같음. 실시간 견적은 이 페이지에 표시 |
| 화면 비율 | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| 2K 크기 | 1:1 2048 × 2048, 16:9 2688 × 1536, 9:16 1536 × 2688, 4:3 2368 × 1760, 3:2 2496 × 1664, 2:3 1664 × 2496 |
| 편집 | 참조 이미지 1~10장. 화면 비율을 지정하지 않으면 출력이 원본을 따라 약 2K |
| 프롬프트 | 최대 5,000자. 네거티브 프롬프트는 없으므로 빼고 싶은 것은 프롬프트에 작성 |
| 프롬프트 확장 | 기본값은 꺼짐. 켜면 direct 또는 agent 재작성, 선택적으로 생각 모드 추가 |
| 측정한 대기 시간 | 저희 테스트에서 텍스트 투 이미지 13 |
| 콘텐츠 정책 | 무검열: 플랫폼 필터 없음, 성인 콘텐츠 플래그 없음 |
| 오픈 웨이트 | Qwen/Qwen-Image-2.1-Turbo, Qwen Research License Agreement |
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 편집 지시이며 최대 5,000자입니다. 무엇이 바뀌는지를 먼저, 그다음 얼굴, 머리, 포즈, 빛처럼 그대로여야 하는 것을 쓰십시오. 1자 이상 · 5000자 이하 |
image_urls | 예 | 원본 이미지 1~10장이며, 부르는 순서대로 보냅니다. 참조 장수는 가격을 바꾸지 않습니다. 1개 이상 · 10개 이하 |
aspect_ratio | 아니요 | 비우면 결과가 원본의 모양을 약 2K로 유지합니다. 고정 프레임이 필요하면 열다섯 가지 모양 중 하나를 지정하십시오. |
resolution | 아니요 | 1k, 1.5k, 2k이며 화면 비율을 지정했을 때만 쓰입니다. 모든 등급이 이미지당 가격이 같습니다. |
num_outputs | 아니요 | 한 요청으로 같은 지시에서 결과 1~6장을 받습니다. 돌려받은 이미지마다 과금됩니다. |
enable_prompt_expansion | 아니요 | 기본값은 꺼짐입니다. 켜면 Alibaba가 먼저 지시문을 다시 쓰는데, 저희 테스트에서는 그 재작성이 더 드러내 달라는 요청을 빼 버려 원본이 그대로 돌아왔고 과금도 되었습니다. 기본값: |
enable_thinking | 아니요 | 재작성에 추가 추론을 쓰는 대신 대기 시간이 길어집니다. 프롬프트 확장이 켜져 있을 때만 작동합니다. 기본값: |
seed | 아니요 | 한 번에 하나의 변화만 비교할 수 있도록 추출을 안정시킵니다. 픽셀까지 똑같은 이미지를 보장하지는 않으므로, 그 프레임이 다시 필요하면 반환된 파일을 보관하십시오. |
요금
$0.014 / 장
활용 사례
무검열 이미지 작업
SpicyAPI는 Turbo 앞에 콘텐츠 필터를 두지 않습니다. 프롬프트 확장을 끄면 저희 테스트는 여성과 남성 모두에 대해 저희가 돌린 모든 콘텐츠 단계에서, 약함부터 최대까지 쓴 대로 나왔습니다. 매우 강함 단계에서는 두 번 중 한 번이 통과했고, 다른 한 번은 요청을 끝까지 처리하지 못했습니다.
한 장을 고르기 위한 많은 시안
8스텝에 호출당 최대 6장이면 저렴하게 다양한 선택지를 펼칠 수 있습니다. 의상, 포즈, 빛을 한 번의 요청으로 탐색하고, 잘 나온 프레임만 남겨 편집은 그 한 장에 쓰십시오.
한 세트에 이어지는 하나의 캐릭터
캐릭터를 생성한 다음 그 프레임을 참조로 다시 보내, 드레스, 방, 빛을 각각 다른 패스에서 바꾸십시오. 편집마다 새로 뽑는 대신 승인한 프레임에서 시작하므로 세트 전체에서 얼굴이 이어집니다.
두 인물 사진으로 만드는 커플
두 인물 사진을 Image 1과 Image 2로 보내고 둘이 함께 있는 장면을 설명하십시오. 저희 테스트에서는 따로 촬영한 남성과 여성이 해 질 녘 옥상에서 나란히 웃는 모습이 되었고, 두 사람 모두 알아볼 수 있었습니다.
포스터와 타이포그래피
Turbo는 짧은 헤드라인을 깔끔하게 그립니다. 문구를 따옴표로 묶고, 놓을 위치와 포스터 스타일을 설명하십시오. 저희 카바레 포스터는 두 줄 모두 철자 그대로 나왔습니다.
제품 컷과 커버
2K까지 균일한 가격과 호출당 6장은 썸네일, 커버, 제품 컷에 잘 맞습니다. 한 아이디어의 여러 크롭과, 줄여 쓸 수 있는 원본 크기 마스터를 함께 얻을 수 있습니다.
프롬프트 가이드 및 실전 팁
성인 작업에서는 프롬프트 확장을 끄십시오
확장을 켜면 이미지를 그리기 전에 프롬프트가 Alibaba의 재작성기로 넘어가고, 이 재작성기가 필터 없는 지시의 수위를 낮춥니다. 저희 테스트에서는 강함 단계 이미지를 순하게 만들었고, 매우 강함 장면을 암시만 남은 장면으로 바꿨으며, 더 나아가 달라고 한 편집은 아무것도 바꾸지 않고 돌려보냈습니다. 확장을 끄면 같은 프롬프트가 쓴 대로 나왔습니다. 이곳의 기본값은 꺼짐이니, 재작성이 필요하지 않다면 그대로 두십시오.
짧고 평범한 프롬프트에는 켜십시오
여섯 단어짜리 브리프도 확장을 켜면 더 풍성한 장면이 됩니다. direct는 한 번에 다시 쓰며 대부분의 프롬프트에 맞고, agent는 여러 단계로 다시 써서 더 섬세한 결과를 냅니다. 생각 모드는 그 재작성에 추가 추론을 쓰는 대신 시간이 더 걸리며, 확장이 꺼져 있을 때는 아무 효과가 없습니다.
2K를 쓰십시오, 가격이 같습니다
모든 등급이 이미지당 가격이 같아서 기본값이자 현명한 선택은 2K입니다. 파일을 작게 받고 싶거나 조금 더 빨리 받고 싶을 때만 1k로 낮추십시오.
여러 장을 한꺼번에 요청하십시오
num_outputs를 1~6으로 설정하면 한 프롬프트의 변형을 한 번의 호출로 받습니다. 돌려받은 이미지마다 과금되므로 6장은 1장의 여섯 배입니다. 편집에 들어가기 전에 마음에 드는 포즈나 구도를 가장 저렴하게 찾는 방법입니다.
편집은 바꿀 것을 먼저, 유지할 것을 그다음에
바뀌는 한 가지를 먼저 쓰고, 그대로여야 하는 것을 이어서 쓰십시오. ‘Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression.’(어두운 벨벳 드레스를 등이 파인 진홍색 새틴 가운으로 바꾸고, 얼굴·머리·표정은 유지)처럼요. 참조는 번호로 부르십시오. 저희의 두 인물 테스트에서는 ‘the man from Image 1 and the woman from Image 2’라고 쓰자 한 프레임 안에서 두 얼굴이 모두 알아볼 수 있게 유지되었습니다.
꼭 들어가야 할 글자는 따옴표로 묶으십시오
정확한 문구를 따옴표로 묶고 어디에 놓을지 적으십시오. 위에 ‘VELVET HOUR’, 아래에 ‘LATE SHOW · FRIDAYS 11 PM’을 요청한 저희 포스터 테스트는 글자 하나하나 그대로 나왔습니다. 한 줄은 짧게 쓰고, 게시하기 전에 원본 크기로 확인하십시오.
프롬프트는 정해진 순서로 쓰십시오
피사체, 의상, 포즈, 빛, 렌즈, 팔레트 순서로 평범한 문장으로 적습니다. 분위기를 나타내는 단어 대신 광원과 방향(왼쪽의 따뜻한 램프 하나, 그녀 뒤의 빗물 맺힌 유리)을 적으십시오. 확장을 끄면 Turbo는 쓴 것만 그리고 빈틈을 대신 채워 주지 않습니다.
소개
Qwen Image 2.1 Turbo Image Editing은 평범한 말로 쓴 지시로 기존 이미지를 바꿉니다. Alibaba Qwen 팀은 2026년 10월 9일 Turbo를 오픈 웨이트로 공개하며, 액세서리 추가부터 장면 교체까지 자연어 편집으로 작업을 이어 가도록 만들었고, Qwen Image 2.1과 같은 7B 아키텍처에서 8 디노이징 스텝으로 동작합니다.
SpicyAPI에서 이용할 수 있습니다. 요청 한 번에 참조 이미지를 110장 받아 결과 16장을 이미지당 같은 가격으로 돌려주며, 모델 앞에 콘텐츠 필터가 없습니다. 이 페이지의 모든 예시는 표시된 프롬프트로 Turbo에서 생성했습니다.
가진 재료에 맞춰 모드 고르기
| 시작 재료 | 모드 |
|---|---|
| 바꿀 이미지가 한 장 이상 있음 | Qwen Image 2.1 Turbo Image Editing |
| 글로 쓴 브리프만 있음 | Qwen Image 2.1 Turbo Text to Image |
저희가 측정한 것
속도
저희 테스트에서 편집당 처음부터 끝까지 26~59초였습니다.
모양
화면 비율을 지정하지 않으면 2:3 세로 사진이 약 2K의 2:3 프레임(1680 × 2512)으로 돌아왔습니다. 고정 크기가 필요하면 화면 비율을 지정하십시오.
콘텐츠
프롬프트 확장을 끈 기본 상태에서는 저희가 테스트한 모든 콘텐츠 수위의 편집이 요청한 대로 나왔고, 여성과 남성 초상 모두 해당했습니다. 확장을 켜면 더 나아간 요청은 두 번 모두 원본 그대로 돌아왔고, 완료된 것으로 청구되었습니다.
참조 두 장
따로 촬영한 남성과 여성이 한 옥상에 나란히 서 있는 이미지로 돌아왔고, 두 사람 모두 알아볼 수 있었으며 요청대로 그녀의 의상이 바뀌었습니다.
Turbo와 Qwen Image 2.1 편집 비교
| Turbo | Qwen Image 2.1 | |
|---|---|---|
| 디노이징 스텝 | 8 | 40 |
| 요청당 결과 | 1~6장 | 1장 |
| 참조 추가당 가격 | 없음 | 한 장마다 가격이 더해짐 |
| 부분 편집용 마스크 | 없음 | 있음 |
| 출력 형식 | PNG | JPEG, PNG, WebP |
| 콘텐츠 필터 | 없음 | 없음 |
균일한 가격으로 빠르게 편집을 이어 가거나 여러 참조를 쓰려면 Turbo를 고르십시오. 마스크가 필요하면 Qwen Image 2.1을 고르십시오.
프롬프트 가이드 및 활용 팁
바꿀 것을 먼저, 유지할 것을 그다음에
‘Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression’(어두운 벨벳 드레스를 등이 파인 진홍색 새틴 가운으로 바꾸고, 얼굴·머리·표정은 유지)는 편집입니다. ‘Make it better’(더 좋게 만들어 줘)는 다시 뽑기입니다.
모든 참조에 이름을 붙이십시오
모델은 참조에 역할을 알아서 나누어 주지 않습니다. 어느 이미지가 인물이고, 어느 것이 의상이고, 어느 것이 장소인지 말하십시오.
확장은 꺼 두십시오
재작성이 지시를 빼 버리고 원본을 돌려줄 수 있습니다. 끄면 지시가 쓴 그대로 모델에 전달됩니다.
패스당 변경은 하나
변경이 하나면 판단하기 쉽습니다. 다섯 가지를 한꺼번에 바꾸면 어느 지시가 얼굴이나 손을 움직였는지 알기 어렵습니다.
몇 번 편집한 뒤에는 원본으로 돌아가십시오
편집이 길게 이어지면 얼굴이 흐트러질 수 있습니다. 디테일이 움직이기 시작하면 처음 승인한 프레임으로 돌아가십시오.
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-turbo/edit",
"input": {
"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 레퍼런스에서 확인하세요.
