Runbase

Command Palette

Search for a command to run...

Qwen

Qwen Image 3.0

ID:qwen/qwen-image-3

Qwen Image 3.0(Qwen-Image-3.0-Pro)은 Alibaba의 고급 이미지 생성 모델로, 리얼한 비주얼, 구조화된 레이아웃, 풍부한 디테일, 고품질 타이포그래피를 제공합니다. 정확한 소형 텍스트, 다국어 렌더링, 복잡한 구도의 이미지를 단일 Qwen Image 3.0 API로 생성하고 편집하세요.

Qwen Image 3.0Qwen-Image-3.0-Pro텍스트 투 이미지이미지 편집다국어타이포그래피

개요

Qwen Image 3.0(Qwen-Image-3.0-Pro)은 Alibaba의 고급 이미지 생성 모델로, 리얼한 비주얼, 구조화된 레이아웃, 풍부한 디테일, 고품질 타이포그래피를 제공합니다. 정확한 소형 텍스트, 다국어 렌더링, 복잡한 구도의 이미지를 단일 Qwen Image 3.0 API로 생성하고 편집하세요.

인증

모든 API 요청은 Authorization 헤더에 Bearer 방식으로 유효한 API 키를 전달해야 합니다.

빠른 시작

인증 정보

RUNBASE_API_KEY 환경 변수를 설정하세요.

Shell
export RUNBASE_API_KEY=your-api-key

실행 생성

Shell
curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen-image-3",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

실행

실행은 비동기로 처리됩니다. 요청을 제출한 후 결과를 폴링하세요.

실행 생성

Shell
curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen-image-3",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

실행 상태 조회

Shell
curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

결과 조회

status가 "succeeded"가 될 때까지 상태 엔드포인트를 폴링한 후 응답에서 output.urls를 읽으세요.

입력 스키마

매개변수유형필수설명
promptstring필수Prompt최대 3000자
aspect_ratiostring선택Aspect ratio옵션: 1:12:33:23:44:39:1616:921:9기본값: 1:1
resolutionstring선택Resolution옵션: 1k2k기본값: 1k
image_urlsstring[]선택Reference images최대 14장의 이미지

출력 스키마

필드유형설명
urlsstring[]생성된 출력 URL

오류

API는 표준 HTTP 상태 코드를 사용하여 성공 또는 실패를 나타냅니다.

상태 코드설명
400Ungültige Anfrage – fehlende oder fehlerhafte Parameter
401Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel
402Unzureichendes Guthaben
403Zugriff verweigert – IP nicht erlaubt, Konto gesperrt oder Ausgabenlimit des API-Schlüssels überschritten
404Ausführung nicht gefunden
429Rate-Limit überschritten
500Interner Serverfehler