Qwen Image 3.0 Pro 이미지 편집 API：생성·편집 최대 2K

Name: Qwen Image 3.0 Pro API
SKU: alibaba/qwen-image-3.0-pro/edit
Price: 0.06 USD
Availability: InStock

요청 파라미터

파라미터	필수	설명
`aspect_ratio`	아니요	화면 모양: 가로, 정사각형, 세로. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 기본값: 1:1
`enable_prompt_expansion`	아니요	짧은 프롬프트에 모델이 디테일을 덧붙입니다. 기본값: true
`image_urls`	예	편집하거나 합칠 사진. 각 사진의 역할을 프롬프트에 적어 주세요.
`negative_prompt`	아니요	나오지 않았으면 하는 것.
`num_outputs`	아니요	한 번에 만들 결과 수. ≥ 1 · ≤ 1 · 기본값: 1
`prompt`	예	Describe the subject, composition, lighting, and any text to render.
`resolution`	아니요	출력 크기. 클수록 선명하고 가격도 올라갑니다. 1k · 2k · 기본값: 2k
`seed`	아니요	같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션	크레딧 /장	≈ USD
resolution 1K	6	US$0.06
resolution 2K	11.25	US$0.11

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

Qwen Image 3.0 Pro API를 3단계로 호출하기

API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
요청 보내기. POST /jobs/createTask에 model은 alibaba/qwen-image-3.0-pro/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-3.0-pro/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": "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 3.0 Pro API 질문

Qwen Image 3.0 Pro API 요금은 얼마인가요?

Qwen Image 3.0 Pro 가격은 가장 저렴한 이미지 편집 기준 6크레딧(US$0.06) /장부터입니다. 옵션별 가격: 1K 6크레딧/장, 2K 11.25크레딧/장. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

API에서 Qwen Image 3.0 Pro의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 이미지 만들기: alibaba/qwen-image-3.0-pro/text-to-image; 이미지 편집: alibaba/qwen-image-3.0-pro/edit을(를) 넣으세요.

Qwen Image 3.0 Pro는 Qwen Image 3.0과 뭐가 다른가요?

요청 모양도 필드도 같고 디테일 상한이 더 높습니다. 그 차이는 특히 여러 글자 요소와 미세한 재질에서 눈에 띕니다. 탐색은 3.0에서, 납품은 Pro에서 하세요. 둘 사이에 프롬프트를 다시 쓸 필요가 없습니다.

표지 하나에 글자 요소를 몇 개까지 넣을 수 있나요?

제호, 호수 줄, 표지 문구 한두 줄처럼 짧은 문자열 서너 개가 안정적인 범위입니다. 각각 따로 따옴표를 씌우고 위치를 적으세요. 본문 문단은 여전히 무너집니다.

표지에는 어떤 화면비를 써야 하나요?

3:4나 2:3을 쓰세요. 둘 다 처음부터 그 형태에 맞춰 구성되는데, 정사각을 잘라내는 것과는 다릅니다. 피사체와 글자가 요청한 프레임에 맞춰 배치됩니다.

표지를 다시 생성하는 대신 편집할 수 있나요?

네, image-to-image 엔드포인트에서 할 수 있습니다. 프레임을 image_urls에 넣고 기존 문구와 새 문구를 따옴표로 적은 다음, 포즈와 구도, 색보정처럼 똑같이 남아야 할 것을 전부 짚으세요.

레이아웃 하나의 변형을 여러 개 받을 수 있나요?

호출 한 번으로는 안 됩니다. num_outputs가 1로 고정이기 때문입니다. seed 없이 같은 브리프를 병렬 요청으로 보내세요. 요청마다 한 장이 돌아오고 견적도 따로 잡히지만, 뽑기만 다르니 결과끼리 곧바로 비교할 수 있습니다.

Qwen Image 3.0 Pro API의 제한은 무엇인가요?

해상도: 1K · 2K; 화면 비율: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2; 참조 이미지: 3; 프롬프트 길이(글자): 5,000; 최대 업로드 크기: 10 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

코드 없이 Qwen Image 3.0 Pro을(를) 써 볼 수 있나요?

네. Playground에서는 API 키 없이 PopNow 크레딧으로 Qwen Image 3.0 Pro을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

모든 Qwen Image 모델

Qwen Image 3.0은 같은 프롬프트를 조금 더 저렴하게 쓸 수 있고 아이디어 탐색에 좋아요. Pro는 타이포그래피와 세밀한 질감의 한계가 더 높아요.

다른 이미지 API

Qwen Image 3.0 Pro 더 알아보기

사용해 보기: Qwen Image 3.0 Pro AI 이미지 생성기 온라인 PopNow에서 Qwen Image 3.0 Pro(으)로 이미지 만들기
문서: API 문서의 Qwen Image 3.0 Pro 모델 ID와 입력 스키마 PopNow API 빠른 시작: 5분 만에 첫 요청 보내기 PopNow API 이미지 생성 가이드 Webhook: 폴링 없이 Qwen Image 3.0 Pro 결과 받기