Vidu Q3 I2V

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);

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

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.

string

required

URL of the reference image to animate.

string

required

Text description of the desired motion and action.

string

default:"720p"

Output video resolution. Options: 540p, 720p, 1080p.

integer

default:"5"

Video length in seconds (1-16).

string

default:"auto"

Motion intensity control. Options: auto, small, medium, large.

boolean

default:"true"

Enable synchronized audio generation.

boolean

default:"true"

Enable background music.

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

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

string

Unique identifier for the request.

string

Request status. Returns COMPLETED on success, FAILED on error.

integer

Time in milliseconds the request spent in queue before processing began.

integer

Time in milliseconds the model took to generate the video.

object

The generation result containing the video URL and cost.

string

URL of the generated video. This URL expires after 7 days.

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

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

Last modified on October 5, 2026

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);

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

Image models

Video models

Text models

Audio models

Try in playground

Request

Response

Cost calculation