Skip to main content

​
Vidu image-to-video

One start image plus a prompt for coherent video. Supports synced audio, custom voice, off-peak.

​
Quick flow

1. Submit job → get task_id
2. Poll status → wait until completed for a public URL

​
Basics

  • Endpoint: POST /v1/video/generations
  • Auth: Bearer Token (Authorization: Bearer {{YOUR_API_KEY}})
  • Content-Type: application/json

​
Request body

FieldTypeRequiredDescription
modelstringYesviduq3-turbo, viduq3-pro, viduq2, viduq1.
promptstringYesMotion description, max 5000 chars.
imagesarrayYesStart frame—exactly 1 image (URL or base64).
durationintegerNoDefault 5s. Q3: 1–16s; Q2: 1–10s.
seedintegerNoDefault 0 = random.
metadataobjectNoExtra options.
└─ audiobooleanNoAudio sync (default true).
└─ audio_typestringNoall, speech_only, sound_effect_only.
└─ voice_idstringNoVoice id (voice clone; Q3 not supported).
└─ off_peakbooleanNoOff-peak, 48h window, lower credits.
└─ callback_urlstringYesStatus webhook.
└─ is_recbooleanNoSystem prompt suggestions (+10 credits).

​
Image rules

  • Formats: PNG, JPEG, JPG, WebP
  • Size: ≤ 50MB file (POST body limit 20MB)
  • Aspect: between 1:4 and 4:1

​
Response

200 OK (submitted)
FieldTypeDescription
idstringInstance id.
task_idstringPoll id.
statusstringe.g. queued.
progressintegerPercent.
created_atintegerCreated at.

​
Example

{
"model": "viduq3-turbo",
"prompt": "Contemporary dance, the people in the picture are performing contemporary dance.",
"images": [
"https://example.com/dance_start_frame.png"
],
"duration": 7,
"metadata": {
"audio": true,
"audio_type": "all",
"callback_url": "https://your-api.com/callback/vidu-i2v",
"off_peak": false
}
}

​
Notes

  1. audio_type: Fine-grained split only on Q2 / Q1.
  2. Off-peak: Auto-cancel and refund if not done in 48h; you can cancel earlier.
  3. is_rec: Turn on if you want the system to refine the prompt (+10 credits).
  4. Callback signing: Verify Vidu signatures on your server.