요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
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 |
background | 아니요 | 배경을 유지, 제거 또는 교체. opaque · transparent · 기본값: opaque |
enable_prompt_expansion | 아니요 | 짧은 프롬프트에 모델이 디테일을 덧붙입니다. 기본값: true |
image_urls | 예 | 편집하거나 합칠 사진. 각 사진의 역할을 프롬프트에 적어 주세요. |
mask_url | 아니요 | 바꿀 영역을 칠합니다. |
output_format | 아니요 | 결과 파일 형식. jpeg · png · webp · 기본값: jpeg |
prompt | 예 | Describe the subject, composition, lighting, and any wording to render. |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 1k · 1.5k · 2k · 기본값: 1k |
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| resolution 1K | 5.4 | US$0.054 |
| resolution 2K | 7.2 | US$0.072 |
| resolution 1.5K | 10.8 | US$0.11 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 6크레딧/장(US$0.06)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Qwen Image 2.1 API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 alibaba/qwen-image-2.1/edit, 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/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "1:1",
"resolution": "1k",
"background": "opaque",
"output_format": "jpeg"
}
}'
# 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 API 질문
Qwen Image 2.1 API 요금은 얼마인가요?
Qwen Image 2.1 가격은 가장 저렴한 이미지 편집 기준 6크레딧(US$0.06) /장부터입니다. 옵션별 가격: 1K 5.4크레딧/장, 2K 7.2크레딧/장, 1.5K 10.8크레딧/장. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Qwen Image 2.1의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 이미지 만들기: alibaba/qwen-image-2.1/text-to-image; 이미지 편집: alibaba/qwen-image-2.1/edit을(를) 넣으세요.
Alibaba가 방금 오픈소스로 공개한 그 모델입니까?
그렇습니다. Qwen-Image-2.1은 2026년 9월 21일에 오픈웨이트로 공개되었고 같은 날 여기에서 가동을 시작했습니다. 설치도, GPU도, 내려받을 가중치도 필요 없는 호스팅 API입니다.
화면 전체가 아니라 이미지의 한 부분만 편집할 수 있습니까?
가능하며 저희가 직접 확인했습니다. 참조 이미지 위에 원을 그리거나 해당 영역을 칠해 표시한 뒤, 그 안에서 무엇을 바꿀지와 표시 자체를 지우라는 지시를 함께 적으면 됩니다. 검증에서는 표시한 영역 안에만 변경이 들어갔고 나머지 화면은 그대로였습니다.
이미지 편집은 참조 이미지를 몇 장까지 받습니까?
1~10장입니다. 모델이 스스로 역할을 배정하지 않으므로 각 이미지가 무엇을 맡는지 프롬프트에 적어 주십시오. 참조 이미지를 추가할 때마다 견적이 올라가므로 실제로 일하는 이미지만 보내십시오.
seed를 고정하면 같은 이미지가 다시 나옵니까?
아닙니다. 같은 프롬프트에 같은 seed로 두 번 보냈지만 서로 다른 두 장이 나왔습니다. seed는 한 시리즈의 결을 비슷하게 유지하는 데 쓰시고, 바로 그 이미지가 다시 필요하다면 반환된 에셋을 보관해 두십시오.
네거티브 프롬프트가 있습니까?
이 계열에는 없습니다. 제외할 내용은 본 프롬프트에 적으십시오. 5,000자까지 들어가므로 화면에 들어갈 것과 들어가지 말아야 할 것을 모두 적기에 충분합니다.
Qwen Image 2.1 API의 제한은 무엇인가요?
해상도: 1K · 1.5K · 2K; 화면 비율: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; 참조 이미지: 10; 프롬프트 길이(글자): 5,000; 최대 업로드 크기: 10 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Qwen Image 2.1을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Qwen Image 2.1을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 Qwen Image 모델
Qwen Image 2.1 Turbo는 초안용으로 더 빠르고 저렴하고, Pro는 인물 디테일이 더 섬세해요. 기본 모델은 그 중간으로, 마스크 편집과 투명 배경 제거를 지원해요.
- 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크레딧부터 /장

