Vidu Q3 I2V

Animate reference images into videos with text-driven motion and optional audio generation.

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.

Endpoint	https://api.runpod.ai/v2/vidu-q3-i2v/runsync
Pricing	$0.15 per second
Type	Video 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

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
    }
  }'

import requests

response = requests.post(
    "https://api.runpod.ai/v2/vidu-q3-i2v/runsync",
    headers={
        "Authorization": f"Bearer {RUNPOD_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
        "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,
        }
    },
)

result = response.json()
print(result["output"]["video_url"])

const response = await fetch(
  "https://api.runpod.ai/v2/vidu-q3-i2v/runsync",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${RUNPOD_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      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,
      },
    }),
  }
);

const result = await response.json();
console.log(result.output.video_url);

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.

200

{
  "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
  }
}

{
  "id": "sync-a1b2c3d4-e5f6-7890-abcd-ef1234567890-u1",
  "status": "FAILED",
  "error": "Invalid image URL"
}

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.

Duration	Cost
5 seconds	$0.75
10 seconds	$1.50
16 seconds	$2.40