Get API Key Get API
Docs

Qwen Image 2.0 Image Generation

- Asynchronous processing mode, returns task ID for subsequent queries

  • Supports text-to-image, image-to-image and other generation modes
  • Supports 1K/2K resolution tiers, generate up to 6 images

Request example

curl --request POST \
  --url https://api.openveer.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image-2.0",
    "prompt": "A cute orange cat napping in the sunshine"
  }'

Response example

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JGXYZ1234567890ABCDEF"
    }
  ]
}

Supported Models

Model Description Max Images Pricing
qwen-image-2.0 Standard version, balanced quality and performance 6 Fixed price
qwen-image-2.0-pro Pro version, stronger text rendering, more refined realistic textures 6 Fixed price

Authorizations

Authorization string

All endpoints require Bearer Token authentication

Get API Key:

Visit API Key Management to get your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

model string

Model name

  • qwen-image-2.0 - Standard version, balanced quality and performance
  • qwen-image-2.0-pro - Pro version, stronger text rendering, more refined realistic textures
nsfw_check boolean

Whether to run content moderation before submitting the image task.

  • true: use omni-moderation-latest to review prompts and input images
  • false or omitted: do not send a moderation request, adding no moderation cost or latency (default)
prompt string

Text description for image generation, up to 800 characters

size string

Image aspect ratio

Supported aspect ratios:

  • 1:1 - Square (default)
  • 4:3 - Landscape 4:3
  • 3:4 - Portrait 3:4
  • 16:9 - Landscape widescreen
  • 9:16 - Portrait vertical
  • 3:2 - Landscape 3:2
  • 2:3 - Portrait 2:3
resolution string

Resolution tier

  • 1K - Standard resolution (default)
  • 2K - High definition resolution
n integer

Number of images to generate

Range: 1-6

negative_prompt string

Negative prompt (content you don't want to appear), up to 500 characters

image_urls array

Reference image URL array (image-to-image mode)

Limitations:

  • Must be publicly accessible URLs
  • Base64 format not supported

Resolution Reference Table

Output size is controlled by the combination of size (ratio) + resolution (resolution tier).

Ratio 1K Tier 2K Tier
1:1 1024×1024 2048×2048
4:3 1152×864 2048×1536
3:4 864×1152 1536×2048
16:9 1280×720 2048×1152
9:16 720×1280 1152×2048
3:2 1248×832 2048×1360
2:3 832×1248 1360×2048
  • Only size → defaults to 1K tier: {"size": "16:9"} → 1280×720
  • size + resolution → specified tier: {"size": "16:9", "resolution": "2K"} → 2048×1152

Usage Examples

Text-to-Image (minimal request)

{
  "model": "qwen-image-2.0",
  "prompt": "A cute orange cat napping in the sunshine"
}

Specify ratio and count

{
  "model": "qwen-image-2.0-pro",
  "prompt": "Cyberpunk-style futuristic city nightscape with flickering neon lights",
  "size": "16:9",
  "n": 4
}

High definition 2K tier

{
  "model": "qwen-image-2.0-pro",
  "prompt": "Exquisite food photography, sushi platter",
  "size": "4:3",
  "resolution": "2K",
  "n": 2
}

Image-to-Image (reference image + text description)

{
  "model": "qwen-image-2.0",
  "prompt": "Change the background to a seaside sunset",
  "image_urls": ["https://example.com/my-photo.jpg"]
}

Response

code integer

Response status code

data array
Response data array
status string

Task status

  * submitted - Submitted
task_id string

Task unique identifier

Notes

  1. Asynchronous Processing: After submission, a task_id is returned. Poll /v1/tasks/{task_id} to get results
  2. Image Storage: Generated images are mirrored to platform CDN and are valid long-term
  3. Billing Rules: Billed per successfully generated image, no charge for failures
  4. Image URL Requirements: Input images must be publicly accessible URLs, base64 not supported

This documentation is built and hosted on Mintlify, a developer documentation platform.