Skip to main content
POST

Supported Models

Authorizations

string
required
All endpoints require Bearer Token authenticationGet API Key:Visit API Key Management to get your API KeyAdd to request header:

Body

string
required
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
string
required
Text description for image generation, up to 800 characters
string
default:"1:1"
Image aspect ratioSupported 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
string
default:"1K"
Resolution tier
  • 1K - Standard resolution (default)
  • 2K - High definition resolution
integer
default:"1"
Number of images to generateRange: 1-6
string
Negative prompt (content you don’t want to appear), up to 500 characters
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).
  • 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)
Specify ratio and count
High definition 2K tier
Image-to-Image (reference image + text description)

Response

integer
Response status code
array
Response data array

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