Qwen Image 3.0
qwen/qwen-image-3Qwen Image 3.0 (Qwen-Image-3.0-Pro) is Alibaba's advanced image generation model for realistic visuals, structured layouts, rich detail, and high-quality typography. Generate and edit images with accurate small text, multilingual rendering, and complex compositions through one Qwen Image 3.0 API.
Overview
Qwen Image 3.0 (Qwen-Image-3.0-Pro) is Alibaba's advanced image generation model for realistic visuals, structured layouts, rich detail, and high-quality typography. Generate and edit images with accurate small text, multilingual rendering, and complex compositions through one Qwen Image 3.0 API.
Authentication
All API requests require a valid API key passed via the Authorization header using the Bearer scheme.
Quickstart
Credentials
Set the RUNBASE_API_KEY environment variable.
export RUNBASE_API_KEY=your-api-keyCreate a run
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"
}
}'Runs
Runs are processed asynchronously. Submit a request, then poll for the result.
Create a run
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" }
}'Get run status
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"Get result
Poll the status endpoint until status is "succeeded", then read output.urls from the response.
Input Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Required | PromptUp to 3000 characters |
| aspect_ratio | string | Optional | Aspect ratioOptions: 1:12:33:23:44:39:1616:921:9Default: 1:1 |
| resolution | string | Optional | ResolutionOptions: 1k2kDefault: 1k |
| image_urls | string[] | Optional | Reference imagesUp to 14 images |
Output Schema
| Field | Type | Description |
|---|---|---|
| urls | string[] | Generated output URLs |
Errors
The API uses standard HTTP status codes to indicate success or failure.
| Status Code | Description |
|---|---|
| 400 | Invalid request - missing or malformed parameters |
| 401 | Authentication failed - missing or invalid API key |
| 402 | Insufficient credits |
| 403 | Forbidden - IP not allowed, account banned, or API key credit limit exceeded |
| 404 | Run not found |
| 429 | Rate limit exceeded |
| 500 | Internal server error |

