요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
prompt | 예 | Describe the subject, composition, lighting, and any wording to render. There is no negative prompt: write what to leave out directly in the prompt. |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 1k · 1.5k · 2k · 기본값: 2k |
num_outputs | 아니요 | 한 번에 만들 결과 수. ≥ 1 · ≤ 6 · 기본값: 1 |
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. 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 · 기본값: 1:1 |
enable_thinking | 아니요 | Spend extra reasoning on the rewrite for better images, at the cost of a longer wait. Only works while prompt expansion is on. 기본값: true |
enable_prompt_expansion | 아니요 | 짧은 프롬프트에 모델이 디테일을 덧붙입니다. 기본값: false |
prompt_optimization_mode | 아니요 | How prompt expansion rewrites the brief: direct is a single pass that suits most prompts; agent is a multi-step rewrite with finer detail. direct · agent · 기본값: direct |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 5.4 | US$0.054 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 6크레딧/장(US$0.06)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Qwen Image 2.1 Pro API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 alibaba/qwen-image-2.1-pro/text-to-image, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $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",
"aspect_ratio": "1:1",
"resolution": "2k",
"num_outputs": 1
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Qwen Image 2.1 Pro API 질문
Qwen Image 2.1 Pro API 요금은 얼마인가요?
Qwen Image 2.1 Pro 가격은 가장 저렴한 이미지 만들기 기준 6크레딧(US$0.06) /장부터입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Qwen Image 2.1 Pro의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 이미지 만들기: alibaba/qwen-image-2.1-pro/text-to-image; 이미지 편집: alibaba/qwen-image-2.1-pro/edit을(를) 넣으세요.
Qwen Image 2.1 Pro는 얼마나 빠른가요?
저희 테스트에서 처음부터 끝까지 텍스트 투 이미지 한 장은 14~31초, 한 번의 호출로 2K 두 장은 39~43초, 편집은 39~48초였습니다. 프롬프트 확장과 생각 모드를 켜면 시간이 더 걸립니다.
Qwen Image 2.1 Pro는 이미지 안에 글자를 넣을 수 있나요?
네. Alibaba는 Pro의 타이포그래피가 개선되었다고 밝히며, 저희 잡지 표지 테스트에서 맨 위 제호 "AFTER DARK"와 그 아래 "THE SILK ISSUE · NO. 07"은 요청의 두 이미지 모두 글자 하나하나 그대로 나왔습니다. 문구를 따옴표로 묶고 놓을 위치를 적으십시오.
요청 하나에 이미지와 참조를 몇 장까지 받나요?
두 엔드포인트 모두 출력 이미지 1~6장, 편집은 참조 이미지 1~10장입니다. 프롬프트에서 참조는 Image 1, Image 2처럼 부르십시오.
Qwen Image 2.1 Pro 웨이트를 내려받을 수 있나요?
아니요. Alibaba는 Pro를 호스팅 API로만 제공하며 웨이트를 공개하지 않았습니다. 2.1 라인에서 오픈 웨이트로 공개된 것은 Qwen Image 2.1과 Qwen Image 2.1 Turbo입니다.
Qwen Image 2.1 Pro API의 제한은 무엇인가요?
해상도: 1K · 1.5K · 2K; 화면 비율: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; 호출당 출력 수: 1–6; 프롬프트 길이(글자): 5,000. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Qwen Image 2.1 Pro을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Qwen Image 2.1 Pro을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 Qwen Image 모델
- Qwen Image 2.1 Pro API프롬프트 하나로 정교한 2K 이미지 최대 6장6크레딧부터 /장
- Qwen Image 2.1 Turbo API8단계 빠른 렌더, 한 번에 최대 6장3크레딧부터 /장
- Qwen Image 2.1 API2K 출력과 투명 배경을 지원하는 오픈 모델4크레딧부터 /장
- Qwen Image 2.1 LoRA APIQwen Image 2.1 생성·편집, 내 LoRA 최대 3개5크레딧부터 /장
- Qwen Image 3.0 Pro API섬세한 타이포그래피에 실감 나는 피부·원단·유리6크레딧부터 /장
- Qwen Image 3.0 API간판과 제목 글자를 읽히게 그려 넣어요5크레딧부터 /장
- Qwen Image 2 API간단한 텍스트 이미지 생성과 사진 한 장 편집6크레딧부터 /장
- Qwen Image 2512 LoRA APIQwen Image 2512 생성·편집, 내 LoRA 사용5크레딧부터 /장
- Qwen Image Edit 2509 LoRA API여러 사진을 쓰는 Qwen 편집, 내 LoRA 불러오기5크레딧부터 /장
- Qwen Image 1.0 LoRA API깔끔한 글자의 원조 Qwen-Image, 내 LoRA 사용5크레딧부터 /장

