LogoQwen API
로그인
API 레퍼런스

Qwen API 문서

인증, Qwen 이미지 생성, 비동기 작업, 모델 ID 및 오류를 다루는 간결한 레퍼런스입니다.

API 키 생성모델

빠른 시작

API는 HTTPS 표준 JSON을 사용합니다. 키를 만들고 생성 요청을 보낸 뒤 작업 ID를 폴링하세요.

  1. 01

    Bearer 키 생성

  2. 02

    생성 요청 전송

  3. 03

    작업 ID 폴링

기본 URL

모든 공개 API 요청은 qwenapi.org 도메인을 사용합니다.

https://qwenapi.org

인증

생성, 상태, 기록 요청마다 Authorization 헤더에 Qwen API 키를 보내세요.

Authorization: Bearer $QWEN_API_KEY

API 키는 서버에 보관하세요. 브라우저 번들, 공개 저장소 또는 클라이언트 로그에 노출하지 마세요.

이미지 생성

지원되는 라이브 모델 ID와 모델별 입력 필드를 보내세요.

POST/api/v1/images/generations
curl https://qwenapi.org/api/v1/images/generations \
  -H "Authorization: Bearer $QWEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3",
    "prompt": "Editorial product photo in soft morning light",
    "aspect_ratio": "16:9",
    "resolution": "1K"
  }'

접수 응답

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n86...qw3",
    "status": "IN_PROGRESS"
  }
}

작업 상태 조회

작업 ID로 진행 상태, 오류 및 최종 출력 URL을 확인하세요.

GET/api/v1/tasks/:task_id
curl "https://qwenapi.org/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $QWEN_API_KEY"

IN_PROGRESS

백엔드가 작업을 접수하고 처리 중입니다.

SUCCESS

출력 URL을 사용할 수 있습니다.

FAILED

작업이 구조화된 오류와 함께 중단되었습니다.

라이브 모델 ID

현재 과금 연동 프로덕션 라우트로 연결되는 ID는 다음과 같습니다.

모델비용입력출력
qwen-image-310 credits / imageText, up to 3 imagesPNG or JPEG
qwen2-image10 credits / imageText or imagePNG or JPEG
qwen-image-25125 credits / imageText or imagesPNG, JPEG, WebP
qwen-multi-angles5 credits / image1-3 imagesPNG or JPEG
qwen-layered10 credits / layerImage and instructionLayer images

오류

HTTP 상태 코드는 구조화된 JSON 오류와 함께 반환됩니다. 지원 문의를 위해 작업 ID를 보관하세요.

400invalid_request모델 ID와 요청 필드를 확인하세요.
401unauthorizedBearer 키가 존재하고 활성 상태인지 확인하세요.
402insufficient_credits결제 대시보드에서 크레딧을 추가하세요.
404not_found작업 ID가 Qwen 라우트에 속하는지 확인하세요.
429rate_limited백오프와 지터를 적용해 다시 시도하세요.
500server_error나중에 다시 시도하고 지원 문의용 작업 ID를 보관하세요.