API docs / Video models

Vidu Q3 (Image to video) API

Animate an uploaded image with a prompt.

Model id
fal-ai/vidu/q3/image-to-video
Provider
Vidu
Output
Video
Price
From 122 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "fal-ai/vidu/q3/image-to-video". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "fal-ai/vidu/q3/image-to-video",
  "input": {
    "prompt": "",
    "first_frame": [
      "https://example.com/input.png"
    ]
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptstring

Text prompt for video generation, max 2000 characters

Default:

Up to 2000 characters

first_framerequiredarray of URLs

Up to 1 files · Accepts image/*

last_framearray of URLs

URL of the image to use as the ending frame. When provided, generates a transition video between start and end frames.

Up to 1 files · Accepts image/*

resolutionstring

Output video resolution. Note: 360p is not available when end_image_url is provided.

Default: 360p

One of: 360p, 540p, 720p, 1080p

duration_secondsnumber

Duration of the video in seconds (1-16 for Q3 models)

Default: 5

Min 1 · Max 16

generate_audioboolean

Whether to use direct audio-video generation. When true, outputs video with sound (including dialogue and sound effects).

Default: true

seednumber

Random seed for reproducibility. If None, a random seed is chosen.