개발자 리소스

Qwen-Image-2512 API 문서

Alibaba의 Qwen-Image-2512 AI 모델을 애플리케이션에 통합하세요. 단순한 REST API를 통해 텍스트 프롬프트에서 고품질 이미지를 생성합니다.

1

인증

Qwen-Image-2512 API는 Bearer Token 인증을 사용합니다. 요청 헤더에 API 키를 포함하여 전달하세요.

인증
Authorization: Bearer sk-your-api-key-here

API 키를 안전하게 보관하세요. 클라이언트 측 코드에 노출되지 않도록 주의하십시오.

가격 정책

유형비용설명
텍스트-투-이미지5 크레딧Qwen-Image-2512 AI를 사용하여 텍스트 프롬프트에서 이미지를 생성합니다.
2

작업 생성

POSThttps://qwen-image-2512.org/api/generate
비동기 생성

가격 정책

각 이미지 생성에는 5 크레딧이 소요됩니다.

생성 작업을 시작합니다. API는 즉시 task_id를 반환하며, 이를 사용하여 결과를 폴링할 수 있습니다.

바디 파라미터

파라미터유형필수설명
promptstring필수이미지 생성을 위한 텍스트 설명입니다. 최대 2000자.
sizestring선택이미지 크기. 지원: 1024*1024, 1024*1536, 1536*1024, 768*1024, 1024*768. 기본값: 1024*1024
seednumber선택재현 가능한 결과를 위한 랜덤 시드. -1은 랜덤. 기본값: -1
output_formatstring선택출력 형식: jpeg, png 또는 webp. 기본값: jpeg
callback_urlstring선택작업 완료 알림을 받을 웹훅(Webhook) URL입니다.

요청 예시

텍스트-투-이미지 예시 (cURL)
curl -X POST https://qwen-image-2512.org/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape at sunset",
    "size": "1024*1024",
    "output_format": "png"
  }'
성공 응답
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS"
  }
}
오류 응답
{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}
3

상태 확인

GEThttps://qwen-image-2512.org/api/status

이 엔드포인트를 폴링하여 작업 진행 상황을 확인하세요. 5~10초 간격으로 폴링하는 것을 권장합니다.

쿼리 파라미터

파라미터유형설명
task_idstring생성 엔드포인트에서 받은 작업 ID입니다. 필수

상태 값

PENDING작업 대기 중
IN_PROGRESS처리 중
SUCCESS완료됨
FAILED오류 발생
cURL
curl -X GET "https://qwen-image-2512.org/api/status?task_id=n43abc123def456qwenimg" \
  -H "Authorization: Bearer YOUR_API_KEY"
응답 (진행 중)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}
응답 (완료됨)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "SUCCESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": ["https://cdn.example.com/image.png"]
  }
}
응답 (실패)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

오류 코드

코드설명
200성공
400잘못된 요청 - 유효하지 않은 파라미터 (프롬프트 누락, 잘못된 크기 등)
401권한 없음 - API 키가 누락되었거나 유효하지 않음
404찾을 수 없음 - 해당 작업 ID가 존재하지 않음
500내부 서버 오류 - 다시 시도하거나 고객 지원에 문의하세요

도움이 필요하신가요?

지원 채널을 확인하거나 이메일로 문의해 주세요.

고객 지원 문의