Vidu Q4 Preview Image to Video API

POST Base URL: https://api.hiapi.ai /v1/tasks

Image, video, and audio models are called through theUnified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).

Model summary

Model	vidu-q4-preview/image-to-video
Capability	First-frame image-to-video + native audio
Resolution	540p / 720p / 1080p / 2K / 4K
Duration	3-16 seconds

Animate one first-frame image into a 3-16 second video up to 4K, with synchronized dialogue and sound effects; the aspect ratio follows the image.

Production guidance

Calling the API

Upload a portrait first frame for portrait output; the aspect ratio follows the image and needs no extra parameter.
audio=false produces a silent video, good for pure footage.
Use callback.url for task notifications; read the task object from data in query responses and directly from the callback body.
Artifact URLs expire; copy files you need to keep into persistent storage.

Best suited for

Animate a still

Add natural motion to product shots, posters, scenery, or character art.

image_url

Sound-on clips

Generate synchronized dialogue and effects for voiceover and ads.

audio

High-resolution output

Up to 4K for advertising and large displays.

resolution

Request parameters

POST https://api.hiapi.ai/v1/tasks

# Create an async task — returns taskId immediately (generation runs async)
# Replace YOUR_API_KEY with your account API key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "vidu-q4-preview/image-to-video",
  "input": {
    "image_url": "https://example.com/first-frame.jpg",
    "prompt": "The pilot waves, the propeller spins up, ripples spread across the water, slow push-in",
    "duration": 5,
    "resolution": "720p",
    "audio": true
  }
}'

import requests, json

# Business params — fields vary by model (see the model page)
payload = json.loads(r'''
{
  "model": "vidu-q4-preview/image-to-video",
  "input": {
    "image_url": "https://example.com/first-frame.jpg",
    "prompt": "The pilot waves, the propeller spins up, ripples spread across the water, slow push-in",
    "duration": 5,
    "resolution": "720p",
    "audio": true
  }
}
''')

# Create an async task — returns taskId immediately (generation runs async)
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # Returns { code, message, data: { taskId } }

// Create an async task — returns taskId immediately (generation runs async)
// Replace YOUR_API_KEY with your account API key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "vidu-q4-preview/image-to-video",
  "input": {
    "image_url": "https://example.com/first-frame.jpg",
    "prompt": "The pilot waves, the propeller spins up, ripples spread across the water, slow push-in",
    "duration": 5,
    "resolution": "720p",
    "audio": true
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

Model ID.

example vidu-q4-preview/image-to-video

input object required

First-frame image-to-video parameters.

image_url string required

First-frame HTTP(S) URL. JPG/JPEG/PNG/WEBP, up to 50MB; the output keeps the image's aspect ratio, which must be between 1:4 and 4:1.

prompt string optional

Describe the motion, camera work and sound (dialogue, effects) to add — no need to restate the image. Up to 20,000 characters.

duration integer optional

Output duration in seconds. Accepts integers from 3 to 16.

default 5

resolution enum optional

Output resolution.

default 720p enum: 540p720p1080p2k4k

audio boolean optional

Generate dialogue and sound effects synchronized with the picture (native audio).

default true

callback object optional

Sends a notification when the task succeeds or fails; read the task object from data in query responses and directly from the callback body.

url string required

HTTPS URL that receives task success or failure notifications.

example https://your-domain.com/hiapi/callback

when enum optional

Triggers when the task succeeds or fails.

default final enum: final

Example requests

First-frame generation

Pass the first frame and a prompt; the model creates motion and camera work.

Request body

{
  "model": "vidu-q4-preview/image-to-video",
  "input": {
    "image_url": "https://example.com/first-frame.jpg",
    "prompt": "Slow push-in with natural motion",
    "duration": 5,
    "resolution": "720p"
  }
}

Silent video

Turn native audio off for picture only.

Request body

{
  "model": "vidu-q4-preview/image-to-video",
  "input": {
    "image_url": "https://example.com/first-frame.jpg",
    "prompt": "Slow push-in",
    "duration": 8,
    "resolution": "1080p",
    "audio": false
  }
}

Getting the result

Read data.taskId from the create-task response.
Wait for the callback or query GET /v1/tasks/:id; polling puts the task under data.
When status=success, read the video URL from output type=video; a callback reads output directly.

FAQ

Can I set the output aspect ratio?

No need. Image-to-video follows the first-frame image; upload a portrait image for portrait output.

Does turning audio off change the price?

No. Billing is per second and driven by resolution and duration; the audio switch is not priced.