Skip to main content

Documentation Index

Fetch the complete documentation index at: https://runpod-b18f5ded-promptless-remove-flash-beta-notification.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Vidu Q3 Image-to-Video animates a reference image into a video with motion driven by a text prompt. It supports multiple resolutions up to 1080p, adjustable duration up to 16 seconds, and optional synchronized audio generation with background music.

Try in playground

Test Vidu Q3 I2V in the Runpod Hub playground.
Endpointhttps://api.runpod.ai/v2/vidu-q3-i2v/runsync
Pricing$0.15 per second
TypeVideo generation

​
Request

All parameters are passed within the input object in the request body.
​
input.image
string
required
URL of the reference image to animate.
​
input.prompt
string
required
Text description of the desired motion and action.
​
input.resolution
string
default:"720p"
Output video resolution. Options: 540p, 720p, 1080p.
​
input.duration
integer
default:"5"
Video length in seconds (1-16).
​
input.movement_amplitude
string
default:"auto"
Motion intensity control. Options: auto, small, medium, large.
​
input.generate_audio
boolean
default:"true"
Enable synchronized audio generation.
​
input.bgm
boolean
default:"true"
Enable background music.
​
input.seed
integer
default:"-1"
Random seed for reproducibility. Set to -1 for random.
curl -X POST "https://api.runpod.ai/v2/vidu-q3-i2v/runsync" \
  -H "Authorization: Bearer $RUNPOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "image": "https://example.com/portrait.jpg",
      "prompt": "Person turns head slowly and smiles at camera",
      "resolution": "720p",
      "duration": 5,
      "movement_amplitude": "medium",
      "generate_audio": true,
      "bgm": true,
      "seed": -1
    }
  }'

​
Response

​
id
string
Unique identifier for the request.
​
status
string
Request status. Returns COMPLETED on success, FAILED on error.
​
delayTime
integer
Time in milliseconds the request spent in queue before processing began.
​
executionTime
integer
Time in milliseconds the model took to generate the video.
​
output
object
The generation result containing the video URL and cost.
​
output.video_url
string
URL of the generated video. This URL expires after 7 days.
​
output.cost
float
Cost of the generation in USD.
{
  "id": "sync-a1b2c3d4-e5f6-7890-abcd-ef1234567890-u1",
  "status": "COMPLETED",
  "delayTime": 32,
  "executionTime": 45678,
  "output": {
    "video_url": "https://video.runpod.ai/abc123/output.mp4",
    "cost": 0.75
  }
}
Video URLs expire after 7 days. Download and store generated videos immediately if you need to keep them.

​
Cost calculation

Vidu Q3 I2V charges $0.15 per second of video generated.
DurationCost
5 seconds$0.75
10 seconds$1.50
16 seconds$2.40