Skip to main content
POST
  • Unified async image generation API
  • Supports the Vidu reference-image family
  • Works for text-to-image and reference-image-to-image flows
  • Query task status with the returned task ID

Body

string
required
Supported models:
  • vidu-image
  • viduq3-fast
  • viduq2-pro
  • viduq2-fast
string
required
Text prompt for image generation
string[]
Reference image URLs, up to 7 images
string
default:"1:1"
Aspect ratio. Supported values:
  • 1:1
  • 4:3
  • 3:4
  • 16:9
  • 9:16
  • 3:2
  • 2:3
string
default:"1K"
Resolution when size is given as a ratio.Supported values:
  • 1K
  • 2K
  • 4K
viduq2-fast only supports 1K.
integer
default:1
Only 1 is supported
integer
Random seed
boolean
default:false
Whether to add watermark

Model Matrix

Request Example

Response

Notes

  • All four models use the same async endpoint: POST /v1/images/generations
  • Successful results are returned in result.data[].url
  • viduq2-fast is the lightweight tier and stays on 1K only