Qwen Image 3.0
ID:
qwen/qwen-image-3Qwen 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를 읽으세요.
입력 스키마
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
| prompt | string | 필수 | Prompt최대 3000자 |
| aspect_ratio | string | 선택 | Aspect ratio옵션: 1:12:33:23:44:39:1616:921:9기본값: 1:1 |
| resolution | string | 선택 | Resolution옵션: 1k2k기본값: 1k |
| image_urls | string[] | 선택 | Reference images최대 14장의 이미지 |
출력 스키마
| 필드 | 유형 | 설명 |
|---|---|---|
| urls | string[] | 생성된 출력 URL |
오류
API는 표준 HTTP 상태 코드를 사용하여 성공 또는 실패를 나타냅니다.
| 상태 코드 | 설명 |
|---|---|
| 400 | Ungültige Anfrage – fehlende oder fehlerhafte Parameter |
| 401 | Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel |
| 402 | Unzureichendes Guthaben |
| 403 | Zugriff verweigert – IP nicht erlaubt, Konto gesperrt oder Ausgabenlimit des API-Schlüssels überschritten |
| 404 | Ausführung nicht gefunden |
| 429 | Rate-Limit überschritten |
| 500 | Interner Serverfehler |

