요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 21:9 · 기본값: 1:1 |
image_urls | 예 | 편집하거나 합칠 사진. 각 사진의 역할을 프롬프트에 적어 주세요. |
prompt | 예 | Describe the image to produce from the source: subject, composition, style, and lighting. |
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 5.25 | US$0.053 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 6크레딧/장(US$0.06)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Qwen Image 2 API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 alibaba/qwen-image-2/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/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"
}
}'
# 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 API 질문
Qwen Image 2 API 요금은 얼마인가요?
Qwen Image 2 가격은 가장 저렴한 이미지 편집 기준 6크레딧(US$0.06) /장부터입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Qwen Image 2의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 이미지 만들기: alibaba/qwen-image-2/text-to-image; 이미지 편집: alibaba/qwen-image-2/edit을(를) 넣으세요.
프롬프트가 정말 중국어로도 되나요?
네, 바로 읽습니다. 언어 파라미터도 번역 단계도 없습니다. 800자 상한도 어느 언어든 같고, 스키마의 나머지도 전부 같습니다.
이미지 편집은 text-to-image와 뭐가 다른가요?
편집은 레퍼런스 이미지를 정확히 한 장 받고, 3:2, 2:3, 21:9를 더한 여덟 가지 화면비를 제공합니다. aspect_ratio 기본값은 레퍼런스를 따르지 않고 1:1이니 원본 형태에 맞춰 지정하세요. text-to-image는 프롬프트만으로 시작하며 화면비는 다섯 가지입니다.
레퍼런스 이미지를 두 장 이상 넣을 수 있나요?
이 패밀리에서는 안 됩니다. image_urls는 이미지를 정확히 한 장만 받고, 두 번째 이미지는 요청이 플랫폼을 떠나기 전에 거부됩니다. 한 사진의 피사체와 다른 사진의 의상을 한 번에 가져오려면 Qwen Image 3.0처럼 여러 레퍼런스를 받는 편집 엔드포인트를 쓰세요.
요청 하나로 여러 장을 받을 수 있나요?
아니요. 두 엔드포인트 모두 정확히 한 장을 돌려줍니다. num_outputs 필드가 없습니다. 변화를 원하면 seed를 바꿔 가며 호출을 반복하세요.
이미지 안에 글자를 그릴 수 있나요?
안정적이지는 않습니다. 짧은 문자열은 가끔 맞지만, 간판과 제호, 포장 문구는 이 모델이 아니라 Qwen Image 3.0 라인의 몫입니다.
Qwen Image 2 API의 제한은 무엇인가요?
화면 비율: 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 +2; 참조 이미지: 1; 프롬프트 길이(글자): 800. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Qwen Image 2을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Qwen Image 2을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 Qwen Image 모델
Qwen Image 2.1은 5,000자 프롬프트와 참고 최대 10장으로 하는 편집을 지원해요.
- 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크레딧부터 /장

