소개
이 엔드포인트가 하는 일
Qwen Image 2.1 Pro Image Editing은 Alibaba가 호스팅하는 Qwen Image 2.1 Pro 등급으로, 글로 쓴 지시에 맞춰 원본 이미지를 고치고 새 프레임 16장을 돌려줍니다. 저희 편집은 처음부터 끝까지 3948초가 걸렸습니다.
입력
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, Alibaba의 호스팅 Pro 등급 |
| 요청당 이미지 | 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 재작성, 선택적으로 생각 모드 추가 |
| 측정한 대기 시간 | 저희 테스트에서 텍스트 투 이미지 14 |
| 콘텐츠 정책 | 무검열: 플랫폼 필터 없음, 성인 콘텐츠 플래그 없음 |
| 웨이트 | 공개되지 않음. Alibaba는 Pro를 호스팅 API로 제공 |
핵심 기능 및 하이라이트
제호 철자가 처음부터 정확하게
문구를 따옴표로 묶고 놓을 위치를 말하십시오. 맨 위의 "AFTER DARK"와 그 아래 작은 표지 문구가 요청의 두 이미지 모두에서 글자 하나하나 그대로 나왔습니다.
인물 사진 두 장, 촛불 켜진 한 테이블
따로 촬영한 남성과 여성을 Image 1과 Image 2로 지정하면, 포도밭 테라스의 한 테이블에 함께 앉은 이미지가 됩니다. 두 얼굴은 알아볼 수 있게 남고 그녀의 드레스는 요청대로 바뀝니다.
Pro와 Turbo, 한 줄도 고치지 않고
SpicyAPI에서 Pro와 Turbo는 같은 필드를 읽으므로, 한쪽에서 통한 프롬프트를 그대로 다른 쪽에 보낼 수 있습니다. Turbo로 빠르게 초안을 잡고 중요한 프레임은 Pro로 남겨도 되고, 그 반대로 해도 됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
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.036 / 장
활용 사례
무검열 이미지 작업
SpicyAPI는 Pro 앞에 콘텐츠 필터를 두지 않습니다. 프롬프트 확장을 끈 상태에서 저희 테스트는 실행한 모든 강도 단계, '약함'부터 '최대'까지, 여성과 남성 피사체 모두 쓴 그대로 나왔습니다.
정확한 문구가 들어가는 표지와 포스터
Alibaba는 Pro의 타이포그래피가 개선되었다고 밝힙니다. 제호와 표지 문구를 따옴표로 묶고 각각 놓을 위치를 말한 뒤 사진을 묘사하십시오. 저희 잡지 표지는 요청의 두 이미지 모두에서 두 줄이 정확한 철자로 나왔습니다.
한 세트에 걸친 한 명의 인물
인물을 한 번 생성한 뒤 그 프레임을 참조로 다시 보내 의상, 방, 빛을 따로따로 바꾸십시오. 편집마다 새로 뽑는 대신 승인한 프레임에서 출발하므로 얼굴이 세트 전체로 이어집니다.
두 장의 인물 사진으로 만드는 커플
인물 사진 두 장을 Image 1과 Image 2로 보내고 둘이 함께하는 장면을 묘사하십시오. 저희 테스트에서는 따로 촬영한 남성과 여성이 해 질 녘 포도밭 테라스의 촛불 켜진 테이블에 함께 앉았고, 두 사람 모두 알아볼 수 있었습니다.
분위기 있는 인물과 조명
Alibaba는 인물 조명과 세부 묘사를 Pro의 강점으로 꼽습니다. 폭풍 속 등불, 높은 창, 벽등처럼 광원 하나와 빛이 닿는 곳을 적으면 프레임이 그 빛을 중심으로 짜입니다.
하나를 고르기 전의 많은 초안
호출당 최대 6장을 같은 가격으로 받아 저렴하게 선택지를 넓히십시오. 의상, 포즈, 빛을 요청 하나로 탐색하고, 잘 나온 프레임을 남겨 그 한 장에 편집을 쓰십시오.
프롬프트 가이드 및 실전 팁
표현이 중요할 때는 프롬프트 확장을 끄십시오
확장을 켜면 이미지를 그리기 전에 프롬프트가 Alibaba의 재작성기로 넘어가고, 그 재작성으로 대담한 지시가 누그러질 수 있습니다. 여기서는 기본값이 꺼짐이며, 꺼둔 상태로 돌린 콘텐츠 테스트는 모두 쓴 대로 나왔습니다. 켠 상태로 해 본 Pro 실행은 한 번뿐이었는데, 공식 앱에서 막히는 내용의 프롬프트도 통과했습니다. 다만 표현이 정확해야 할 때는 언제나 꺼 두십시오.
짧고 평범한 프롬프트에는 켜십시오
여섯 단어짜리 브리프도 확장을 켜면 더 풍성한 장면이 됩니다. direct는 한 번에 다시 쓰며 대부분의 프롬프트에 맞고, agent는 여러 단계로 다시 써서 더 섬세한 결과를 냅니다. 생각 모드는 그 재작성에 추가 추론을 쓰는 대신 시간이 더 걸리며, 확장이 꺼져 있을 때는 아무 효과가 없습니다.
2K를 쓰십시오, 가격이 같습니다
모든 등급이 이미지당 가격이 같아서 기본값이자 현명한 선택은 2K입니다. 파일을 작게 받고 싶거나 조금 더 빨리 받고 싶을 때만 1k로 낮추십시오.
여러 장을 한꺼번에 요청하십시오
num_outputs를 1~6으로 설정하면 한 프롬프트의 변형을 한 번의 호출로 받습니다. 돌려받은 이미지마다 과금되므로 6장은 1장의 여섯 배입니다. 편집에 들어가기 전에 마음에 드는 포즈나 구도를 가장 저렴하게 찾는 방법입니다.
편집은 바꿀 것을 먼저, 유지할 것을 그다음에
바뀌어야 할 한 가지를 먼저 쓰고, 그다음 그대로 남아야 할 모든 것을 적으십시오. 예: "그녀의 벨벳 드레스를 아이보리 이브닝 가운으로 바꾸고, 얼굴·머리·표정은 그대로 유지." 참조는 번호로 지정하십시오. 인물 두 명을 쓴 저희 테스트에서 촛불이 켜진 테이블을 두고 "이미지 1의 남자와 이미지 2의 여자"라고 쓰자 한 프레임 안에서 두 얼굴 모두 알아볼 수 있었습니다.
꼭 들어가야 할 글자는 따옴표로 묶으십시오
정확한 문구를 따옴표로 묶고 어디에 놓을지 적으십시오. 위쪽 전체에 ‘AFTER DARK’, 아래 작은 글씨로 ‘THE SILK ISSUE · NO. 07’을 요청한 저희 잡지 표지는 글자 하나하나 그대로 나왔습니다. 한 줄은 짧게 쓰고, 게시하기 전에 원본 크기로 확인하십시오.
프롬프트는 정해진 순서로 쓰십시오
피사체, 의상, 포즈, 빛, 렌즈, 팔레트 순서로 평범한 문장으로 적습니다. 분위기를 나타내는 단어 대신 광원과 방향(왼쪽의 기름등 하나, 그녀 뒤에서 도는 빛줄기)을 적으십시오. 확장을 끄면 Pro는 쓴 것만 그리고 빈틈을 대신 채워 주지 않습니다.
소개
Qwen Image 2.1 Pro Image Editing은 평범한 말로 쓴 지시로 기존 이미지를 바꿉니다. Pro는 Alibaba의 Qwen Image 2.1을 호스팅하는 등급으로, 이 모델은 생성과 편집을 하나로 통합했습니다. Alibaba는 참조 최대 10장의 편집, 인물과 제품을 그대로 두는 부분 편집, 개선된 인물 조명과 세부 묘사를 내세웁니다.
SpicyAPI에서 이용할 수 있습니다. 요청 한 번에 참조 이미지를 110장 받아 결과 16장을 이미지당 같은 가격으로 돌려주며, 모델 앞에 콘텐츠 필터가 없습니다. 이 페이지의 모든 예시는 표시된 프롬프트로 Pro에서 생성했습니다.
가진 재료에 맞춰 모드 고르기
| 시작 재료 | 모드 |
|---|---|
| 바꿀 이미지가 한 장 이상 있음 | Qwen Image 2.1 Pro Image Editing |
| 글로 쓴 브리프만 있음 | Qwen Image 2.1 Pro Text to Image |
저희가 측정한 것
속도
저희 테스트에서 편집당 처음부터 끝까지 39~48초였으며, 참조 두 장으로 한 번의 호출에 결과 두 장을 받은 경우도 포함됩니다.
모양
화면 비율을 지정하지 않으면 2:3 세로 사진이 약 2K의 2:3 프레임(1664 × 2496)으로 돌아왔습니다. 고정 크기가 필요하면 화면 비율을 지정하십시오.
콘텐츠
기본값인 프롬프트 확장을 끈 상태에서는 저희가 테스트한 모든 편집이 요청한 그대로 나왔고, '약함'부터 '최대'까지 다섯 강도 단계 모두에서 확인했습니다. 거절된 편집은 하나도 없었습니다.
참조 두 장
따로 촬영한 남성과 여성이 촛불 켜진 한 테이블에 나란히 앉은 이미지로 돌아왔고, 두 사람 모두 알아볼 수 있었으며 요청대로 그녀의 의상이 바뀌었습니다.
Pro와 Turbo 편집 비교
| Pro | Turbo | |
|---|---|---|
| 정체 | Alibaba의 호스팅 Pro 등급 | 8스텝 체크포인트 |
| 웨이트 | 공개되지 않음 | 오픈, Qwen Research License |
| 요청당 결과 | 1~6장 | 1~6장 |
| 참조 추가당 가격 | 없음 | 없음 |
| 이미지당 가격 | 더 높음 | 더 낮음 |
| 콘텐츠 필터 | 없음 | 없음 |
요청이 같으므로 지시 하나를 양쪽에서 돌려 마음에 드는 결과를 고를 수 있습니다.
프롬프트 가이드 및 활용 팁
바꿀 것을 먼저, 유지할 것을 그다음에
"그녀의 벨벳 드레스를 아이보리 이브닝 가운으로 바꾸고, 얼굴·머리·표정은 그대로 유지"는 편집입니다. "더 좋게 해 줘"는 다시 뽑기입니다.
모든 참조에 이름을 붙이십시오
모델은 참조에 역할을 알아서 나누어 주지 않습니다. 어느 이미지가 인물이고, 어느 것이 의상이고, 어느 것이 장소인지 말하십시오.
확장은 꺼 두십시오
재작성이 모델이 보기 전에 지시의 수위를 낮출 수 있습니다. 끄면 지시가 쓴 그대로 모델에 전달됩니다.
패스당 변경은 하나
변경이 하나면 판단하기 쉽습니다. 다섯 가지를 한꺼번에 바꾸면 어느 지시가 얼굴이나 손을 움직였는지 알기 어렵습니다.
몇 번 편집한 뒤에는 원본으로 돌아가십시오
편집이 길게 이어지면 얼굴이 흐트러질 수 있습니다. 디테일이 움직이기 시작하면 처음 승인한 프레임으로 돌아가십시오.
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-pro/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 레퍼런스에서 확인하세요.
