Qwen Image 3.0 API 가격 및 연동 가이드

Qwen Image 3.0 API의 가격, 인증, 이미지 생성·편집 파라미터, 비동기 작업 제출과 폴링, 재시도와 결과 저장을 예제로 설명합니다. Standard와 Pro 차이, 1K·2K 선택 기준, Python·JavaScript 서버 연동, 출시 전 점검 사항도 확인하세요.

튜토리얼

Qwen Image 3.0은 텍스트 기반 이미지 생성과 참조 이미지 편집을 하나의 비동기 API로 제공합니다. APIMart에서는 작업을 제출하고 상태를 폴링한 뒤, 작업이 완료되면 한 장 이상의 생성 이미지를 가져옵니다.

이 가이드에서는 연동 전에 알아야 할 Standard 및 Pro의 현재 가격, 인증, 요청 파라미터, 응답 파싱, 폴링, 재시도, 결과 저장 방식을 설명합니다. 모델 기능과 벤치마크는 Qwen Image 3.0 출시 가이드에서 더 자세히 확인할 수 있습니다.

Qwen Image 3.0 가격과 접근 방법

APIMart는 두 가지 Qwen Image 3.0 모델 ID를 제공합니다.

qwen-image-3.0: Standard
qwen-image-3.0-pro: Pro

요금은 입력 Token이 아니라 생성된 이미지 수를 기준으로 부과됩니다. 아래 금액은 2026년 8월 27일 APIMart 가격 페이지에 표시된 값이며 추후 변경될 수 있습니다.

Standard 및 Pro 가격 비교

모델	해상도	이미지당 예상 가격	1,000장 예상 비용
Qwen Image 3.0 Standard	1K	$0.0205712	$20.57
Qwen Image 3.0 Standard	2K	$0.0205712	$20.57
Qwen Image 3.0 Pro	1K	$0.0285712	$28.57
Qwen Image 3.0 Pro	2K	$0.0571432	$57.14

Standard는 현재 1K와 2K 가격이 같습니다. Pro 2K는 Pro 1K의 두 배입니다. Qwen Image 3.0 API 문서에 따르면 생성 실패 시 요금이 환불되며, 참조 이미지에는 별도의 생성 요금이 붙지 않습니다.

실제 워크로드 비용 계산

기본 계산식은 다음과 같습니다.

월간 비용 = 완료된 이미지 수 × 이미지당 가격

n은 출력 수를 제어하므로 n: 4인 요청은 이미지 네 장에 대한 요금이 발생할 수 있습니다. 프롬프트 실험, 변형, 재생성까지 예산에 포함해야 합니다.

대부분의 초안과 일반 에셋에는 Standard를 사용하세요. 텍스트 렌더링, 구도 또는 세부 묘사의 향상이 추가 비용을 정당화할 때 Pro를 평가하면 됩니다. Pro를 사용한다면 반복 작업에는 1K, 승인된 고해상도 결과에는 2K를 권장합니다.

접근 권한과 인증

APIMart 계정을 만들고 충분한 잔액을 충전한 다음 콘솔에서 API 키를 생성합니다. 키는 서버 측 Secret 저장소나 환경 변수에 보관하고, 브라우저 코드 또는 NEXT_PUBLIC_* 변수에 절대 노출하지 마세요.

Base URL과 Bearer Token

이 가이드의 Base URL은 다음과 같습니다.

https://api.apimart.ai/v1

API 키를 Bearer Token으로 전송합니다.

Authorization: Bearer <your_api_key>
Content-Type: application/json

키가 없거나 유효하지 않으면 보통 401, 잔액이 부족하면 402, 속도 제한에 걸리면 429가 반환됩니다. 서버에서 응답 본문과 요청 컨텍스트를 기록하되, 로그를 저장하기 전에 API 키를 반드시 마스킹하세요.

이미지 생성·편집과 비동기 작업 흐름

생성과 편집은 모두 POST /v1/images/generations를 사용합니다. API는 이미지가 완성될 때까지 기다리지 않고 작업 ID를 먼저 반환합니다.

핵심 요청 파라미터

필드	필수 여부	설명
`model`	필수	`qwen-image-3.0` 또는 `qwen-image-3.0-pro`
`prompt`	필수	생성 또는 편집 지시, 최대 약 4,500 Token
`image_urls`	편집 시 필수	1~3개의 HTTPS URL 또는 지원되는 Base64 Data URL
`resolution`	선택	`1K` 또는 `2K`
`size`	선택	지원되는 화면 비율 또는 사용자 지정 크기
`n`	선택	출력 이미지 수, 1~6
`prompt_extend`	선택	APIMart의 프롬프트 확장 여부

사용자 지정 크기는 각 변이 512~~2,048픽셀이고 화면 비율은 1:8~~8:1이어야 합니다. 참조 이미지는 JPEG, PNG, BMP, TIFF, WebP, GIF를 지원하며 문서상 장당 최대 크기는 10MB입니다. 제한은 바뀔 수 있으므로 출시 전에 생성 API 문서를 다시 확인하세요.

Qwen Image 3.0 공식 발표는 12개 언어의 네이티브 텍스트 렌더링을 설명합니다. 텍스트가 많은 이미지는 정확히 표시할 문구를 따옴표로 묶고, 목표 해상도에서 철자, 글꼴 스타일, 레이아웃을 검증하세요.

텍스트-이미지 생성 예시

{
  "model": "qwen-image-3.0",
  "prompt": "‘여름 할인’ 문구를 정확히 표시한 상품 배너, 굵은 기하학적 글꼴, 따뜻한 주황색 배경",
  "resolution": "1K",
  "size": "16:9",
  "n": 1,
  "prompt_extend":