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) 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.

Qwen Image 3.0Qwen-Image-3.0-ProText to ImageImage EditingMultilingualTypography

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.

Shell
export RUNBASE_API_KEY=your-api-key

Create a run

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"
    }
  }'

Runs

Runs are processed asynchronously. Submit a request, then poll for the result.

Create a run

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" }
  }'

Get run status

Shell
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

ParameterTypeRequiredDescription
promptstringRequiredPromptUp to 3000 characters
aspect_ratiostringOptionalAspect ratioOptions: 1:12:33:23:44:39:1616:921:9Default: 1:1
resolutionstringOptionalResolutionOptions: 1k2kDefault: 1k
image_urlsstring[]OptionalReference imagesUp to 14 images

Output Schema

FieldTypeDescription
urlsstring[]Generated output URLs

Errors

The API uses standard HTTP status codes to indicate success or failure.

Status CodeDescription
400Invalid request - missing or malformed parameters
401Authentication failed - missing or invalid API key
402Insufficient credits
403Forbidden - IP not allowed, account banned, or API key credit limit exceeded
404Run not found
429Rate limit exceeded
500Internal server error