Vidu Q3 Pro

Text-to-Video • Vidu

Vidu Q3 Pro is a high-quality video generation model supporting text-to-video, image-to-video, and start/end-frame-to-video workflows with audio and up to 16-second clips.

Model Info
Terms and License	link ↗
More information	link ↗
Pricing	View pricing in the Cloudflare dashboard ↗

Usage

TypeScript
cURL

const response = await env.AI.run(
  'vidu/q3-pro',
  {
    prompt: 'A golden retriever running through a sunlit meadow in slow motion',
    duration: 5,
    resolution: '720p',
  },
)
console.log(response)

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "vidu/q3-pro",
  "input": {
    "prompt": "A golden retriever running through a sunlit meadow in slow motion",
    "duration": 5,
    "resolution": "720p"
  }
}'

Output
Raw response

{
  "gatewayMetadata": {
    "keySource": "Unified"
  },
  "result": {
    "video": "https://video.cf.vidu.com/infer_64/tasks/26/0417/05/942597991691198464/creation-01/video.mp4"
  },
  "state": "Completed"
}

Examples

Portrait Aspect Ratio — Vertical video for social media

TypeScript
cURL

const response = await env.AI.run(
  'vidu/q3-pro',
  {
    prompt:
      'A busy street in Tokyo at night with neon signs reflecting on wet pavement, rain falling',
    aspect_ratio: '9:16',
    duration: 5,
    resolution: '720p',
  },
)
console.log(response)

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "vidu/q3-pro",
  "input": {
    "prompt": "A busy street in Tokyo at night with neon signs reflecting on wet pavement, rain falling",
    "aspect_ratio": "9:16",
    "duration": 5,
    "resolution": "720p"
  }
}'

Output
Raw response

{
  "gatewayMetadata": {
    "keySource": "Unified"
  },
  "result": {
    "video": "https://video.cf.vidu.com/infer_88/tasks/26/0417/05/942598607041753088/creation-01/video.mp4"
  },
  "state": "Completed"
}

Silent Video — Generate video without audio

TypeScript
cURL

const response = await env.AI.run(
  'vidu/q3-pro',
  {
    audio: false,
    prompt: 'Abstract paint swirls slowly mixing in water, vivid blues and golds',
    duration: 8,
    resolution: '720p',
  },
)
console.log(response)

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "vidu/q3-pro",
  "input": {
    "audio": false,
    "prompt": "Abstract paint swirls slowly mixing in water, vivid blues and golds",
    "duration": 8,
    "resolution": "720p"
  }
}'

Output
Raw response

{
  "gatewayMetadata": {
    "keySource": "Unified"
  },
  "result": {
    "video": "https://video.cf.vidu.com/infer_76/tasks/26/0417/05/942599305355595776/creation-01/final_video.mp4"
  },
  "state": "Completed"
}

Square Format — Square video for product demos or social posts

TypeScript
cURL

const response = await env.AI.run(
  'vidu/q3-pro',
  {
    prompt:
      'A sleek wireless headphone rotating on a pedestal with soft studio lighting and a white background',
    aspect_ratio: '1:1',
    duration: 5,
    resolution: '720p',
  },
)
console.log(response)

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "vidu/q3-pro",
  "input": {
    "prompt": "A sleek wireless headphone rotating on a pedestal with soft studio lighting and a white background",
    "aspect_ratio": "1:1",
    "duration": 5,
    "resolution": "720p"
  }
}'

Output
Raw response

{
  "gatewayMetadata": {
    "keySource": "Unified"
  },
  "result": {
    "video": "https://video.cf.vidu.com/infer_40/tasks/26/0417/05/942599364482723840/creation-01/video.mp4"
  },
  "state": "Completed"
}

aspect_ratio

stringenum: 16:9, 9:16, 3:4, 4:3, 1:1Video aspect ratio (text-to-video only). Default: 16:9

audio

booleanEnable audio-video synchronization. Default: true for Q3 models. When false, outputs silent video

duration

integerrequireddefault: 5maximum: 16minimum: 1Video duration in seconds (1-16)

end_image

stringEnd image for start/end-to-video generation. Must be used together with start_image. Accepts public URL or Base64 data URI (data:image/png;base64,...)

prompt

stringmaxLength: 5000Text prompt describing what should appear in the video

resolution

stringrequireddefault: 720penum: 540p, 720p, 1080pVideo resolution

start_image

stringStart image for video generation. Use alone for image-to-video, or with end_image for start/end-to-video. Accepts public URL or Base64 data URI (data:image/png;base64,...)

video

stringformat: uriURL to the generated video

API Schemas (Raw)

Input

Output