Create image-to-video job

​

Vidu image-to-video

​

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

​

Image rules

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

​

Response

​

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.