소개
이 엔드포인트가 하는 일
Qwen Image 2.1 Pro Text to Image는 Alibaba가 호스팅하는 Qwen Image 2.1의 Pro 등급으로, 글로 쓴 브리프를 요청당 이미지 16장으로 그려 냅니다. 저희 요청은 처음부터 끝까지 1443초가 걸렸습니다.
입력
prompt에 브리프 전체를 최대 5,000자로 담습니다. num_outputs는 이미지 1~6장을 요청합니다. aspect_ratio는 열다섯 가지 모양 중 하나를, resolution은 1k, 1.5k, 2k 등급을 고르며 이미지당 가격은 모두 같습니다. enable_prompt_expansion(기본값 꺼짐)은 Alibaba가 먼저 프롬프트를 다시 쓰게 하며, prompt_optimization_mode와 enable_thinking이 그 재작성 방식을 정합니다. 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자 이하 |
aspect_ratio | 아니요 | 3:1과 21:9 와이드부터 1:3과 9:21 세로까지 열다섯 가지 모양입니다. 정사각형을 잘라 내는 것이 아니라 그 모양으로 구도를 잡습니다. |
resolution | 아니요 | 1k, 1.5k, 2k입니다. 모든 등급이 이미지당 가격이 같아서 기본값은 2k입니다. |
num_outputs | 아니요 | 한 요청으로 같은 프롬프트에서 이미지 1~6장을 받습니다. 돌려받은 이미지마다 과금되므로 6장은 1장의 여섯 배입니다. |
enable_prompt_expansion | 아니요 | 기본값은 꺼짐이라 쓴 표현 그대로 그려집니다. 켜면 Alibaba가 먼저 프롬프트를 더 풍부한 장면으로 다시 씁니다. 기본값: |
enable_thinking | 아니요 | 재작성에 추가 추론을 써서 더 나은 이미지를 얻는 대신 대기 시간이 길어집니다. 프롬프트 확장이 켜져 있을 때만 작동합니다. 기본값: |
prompt_optimization_mode | 아니요 | 확장을 켰을 때 브리프를 다시 쓰는 방식입니다. direct는 한 번에 쓰는 방식으로 대부분의 프롬프트에 맞고, agent는 여러 단계로 더 섬세하게 씁니다. |
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 Text to Image는 글로 쓴 브리프를 이미지로 만듭니다. Pro는 Alibaba의 Qwen Image 2.1을 호스팅하는 등급으로, Alibaba는 2026년 10월 9일 Turbo API와 함께 정식 출시를 발표했으며 생성 품질, 추론 효율, 비용의 균형을 잡고 타이포그래피, 인물 조명, 세부 묘사를 개선했다고 설명합니다. Alibaba는 이를 API로 제공하며 웨이트는 공개하지 않았습니다.
SpicyAPI에서 이용할 수 있습니다. 요청 한 번에 이미지 1~6장이 나오고, 1k, 1.5k, 2k 등급은 이미지당 가격이 같으며, 모델 앞에 콘텐츠 필터가 없습니다. 이 페이지의 모든 이미지는 표시된 프롬프트로 Pro에서 생성했습니다.
가진 재료에 맞춰 모드 고르기
| 시작 재료 | 모드 |
|---|---|
| 글로 쓴 브리프만 있음 | Qwen Image 2.1 Pro Text to Image |
| 바꿀 이미지가 한 장 이상 있음 | Qwen Image 2.1 Pro Image Editing |
저희가 측정한 것
속도
저희 테스트에서 처음부터 끝까지 이미지 한 장은 1431초, 한 번의 호출로 2K 두 장은 3943초였습니다. 프롬프트 확장과 생각 모드를 켜면 시간이 더 걸립니다.
콘텐츠
기본값인 프롬프트 확장을 끈 상태에서 모든 콘텐츠 테스트는 쓴 그대로 나왔습니다. '약함'부터 '최대' 강도 단계까지, 여성 피사체와 남성 피사체 모두 해당합니다. 거절된 요청은 하나도 없었습니다. 확장을 켜고 한 번 돌린 실행에서는 필터 없는 프롬프트도 요청한 그대로 나왔습니다.
이미지 속 글자
저희 잡지 표지에 제호 "AFTER DARK"와 그 아래 "THE SILK ISSUE · NO. 07"을 요청했더니, 요청의 두 이미지 모두에서 두 줄이 글자 하나하나 그대로 나왔습니다.
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 |
비율은 3:1부터 1:3까지 모두 열다섯 가지이며 1k, 1.5k, 2k에서 쓸 수 있습니다. 출력은 PNG입니다.
Pro와 Turbo 비교
| Pro | Turbo | |
|---|---|---|
| 정체 | Alibaba의 호스팅 Pro 등급 | 8스텝 체크포인트 |
| 웨이트 | 공개되지 않음 | 오픈, Qwen Research License |
| 요청당 이미지 | 1~6장 | 1~6장 |
| 등급별 가격 | 균일 | 균일 |
| 이미지당 가격 | 더 높음 | 더 낮음 |
| 콘텐츠 필터 | 없음 | 없음 |
요청이 같으므로 프롬프트 하나를 양쪽에 보내 마음에 드는 결과를 고를 수 있습니다. Alibaba는 둘 사이의 품질 비교를 공개하지 않았습니다.
프롬프트 가이드 및 활용 팁
표현을 정확히 지키려면 확장을 끄십시오
재작성은 대담한 지시를 누그러뜨릴 수 있습니다. 끄면 Pro는 쓴 그대로 그립니다.
짧고 평범한 프롬프트에는 확장을 켜십시오
여섯 단어짜리 아이디어도 더 풍성한 장면이 됩니다. direct는 대부분의 프롬프트에 맞고, agent는 더 섬세하게 다시 쓰며, 생각 모드는 더 나은 재작성을 위해 시간을 더 씁니다.
정해진 순서로 쓰십시오
피사체, 의상, 포즈, 빛, 렌즈, 팔레트 순서로 평범한 문장으로 적습니다. 분위기 단어 대신 광원과 방향을 적으십시오.
꼭 나와야 하는 글자는 따옴표로 묶으십시오
정확한 문구를 따옴표로 묶고, 한 줄은 짧게 쓰고, 놓을 위치를 적으십시오.
여섯 장 요청해서 하나 고르십시오
변형은 한 장마다 같은 값이므로, 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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "1:1",
"prompt_optimization_mode": "direct"
}
}'
# 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 레퍼런스에서 확인하세요.
