소개
이 엔드포인트가 하는 일
Qwen Image 2.1 Turbo Text to Image는 Alibaba가 Qwen Image 2.1을 8스텝으로 가속한 체크포인트로, 글로 쓴 브리프를 요청당 이미지 16장으로 렌더링합니다. 저희 요청은 처음부터 끝까지 1339초가 걸렸습니다.
입력
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, 같은 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자 이하 |
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.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 Text to Image는 글로 쓴 브리프를 이미지로 만듭니다. Alibaba Qwen 팀은 2026년 10월 9일 Qwen Image 2.1의 가속 체크포인트로 Turbo를 오픈 웨이트로 공개했습니다. 같은 7B 비주얼 생성 아키텍처를 쓰되, Alibaba의 2.1 예제가 40스텝인 자리를 8 디노이징 스텝으로 샘플링합니다.
SpicyAPI에서 이용할 수 있습니다. 요청 한 번에 이미지 1~6장이 나오고, 1k, 1.5k, 2k 등급은 이미지당 가격이 같으며, 모델 앞에 콘텐츠 필터가 없습니다. 이 페이지의 모든 이미지는 표시된 프롬프트로 Turbo에서 생성했습니다.
가진 재료에 맞춰 모드 고르기
| 시작 재료 | 모드 |
|---|---|
| 글로 쓴 브리프만 있음 | Qwen Image 2.1 Turbo Text to Image |
| 바꿀 이미지가 한 장 이상 있음 | Qwen Image 2.1 Turbo Image Editing |
저희가 측정한 것
속도
저희 테스트에서 요청당 처음부터 끝까지 13~39초였으며, 2K 이미지 두 장을 한 번에 호출한 경우도 28초였습니다. 프롬프트 확장과 생각 모드를 켜면 시간이 더 걸립니다.
콘텐츠
프롬프트 확장을 끈 기본 상태에서 저희 콘텐츠 테스트는 약함, 보통, 강함, 최대 단계에서 여성과 남성 모두에 대해 쓴 대로 나왔습니다. 매우 강함 테스트는 두 번 돌려 한 번 온전히 그려졌고, 다른 한 번은 요청을 끝까지 처리하지 못했습니다. 확장을 켜면 Alibaba의 재작성이 그런 프롬프트의 수위를 낮췄습니다. 거절된 요청은 하나도 없었습니다.
이미지 속 글자
저희 카바레 포스터에 ‘VELVET HOUR’와 ‘LATE SHOW · FRIDAYS 11 PM’을 요청했더니 두 줄 모두 글자 하나하나 그대로 나왔습니다.
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입니다.
Turbo와 Qwen Image 2.1 비교
| Turbo | Qwen Image 2.1 | |
|---|---|---|
| 디노이징 스텝 | 8 | 40 |
| 요청당 이미지 | 1~6장 | 1장 |
| 등급별 가격 | 균일 | 등급이 오르면 비싸짐 |
| 출력 형식 | PNG | JPEG, PNG, WebP |
| 투명 배경 | 프롬프트로 요청 | 전용 스위치 |
| 콘텐츠 필터 | 없음 | 없음 |
물량과 빠른 변형에는 Turbo를 고르십시오. 출력 형식과 배경 제어가 필요하면 Qwen Image 2.1을 고르십시오.
프롬프트 가이드 및 활용 팁
성인 작업에서는 확장을 끄십시오
재작성은 성인 브리프의 수위를 낮춥니다. 끄면 Turbo는 쓴 것을 그립니다.
짧고 평범한 프롬프트에는 확장을 켜십시오
여섯 단어짜리 아이디어도 더 풍성한 장면이 됩니다. 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-turbo/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 레퍼런스에서 확인하세요.
