Skip to main content
POST
/
api
/
v1
/
vidu
/
image-to-video
Image to Video
curl --request POST \
  --url https://api.modelhunter.ai/api/v1/vidu/image-to-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {
    "input.image": "<string>",
    "input.prompt": "<string>",
    "input.duration": 123,
    "input.resolution": "<string>",
    "input.audio": true,
    "input.seed": 123,
    "input.off_peak": true
  },
  "webhookUrl": "<string>",
  "metadata": {}
}
'
{
  "success": true,
  "data": {
    "id": "task_abc123",
    "status": "pending",
    "type": "image-to-video",
    "provider": "vidu",
    "model": "viduq3-turbo",
    "created_at": "2025-01-15T10:00:00Z",
    "estimated_seconds": 30
  }
}
Check out Vidu pricing — enable off_peak: true for 50% off.

​
Body Parameters

​
model
string
required
Vidu model to use. Options:
  • viduq3-pro — Latest flagship, supports audio sync (1–16s), $0.07–$0.16/sec
  • viduq3-turbo — Fast Q3, supports audio sync (1–16s), $0.04–$0.08/sec
Pricing varies by resolution. Enable off_peak: true for 50% off.
​
input
object
required
Provider-specific parameters for the generation request.
​
input.image
string
required
Input image URL to animate into video.
​
input.prompt
string
Text description to guide the video generation. Max 2,000 characters.
​
input.duration
number
Video length in seconds (1–16).
​
input.resolution
string
default:"720p"
Output resolution. Options: 540p, 720p, 1080p
​
input.audio
boolean
Enable audio-video sync output. Supported on viduq3-pro and viduq3-turbo. Default true for Q3 models.
​
input.seed
number
Random seed for reproducibility.
​
input.off_peak
boolean
default:false
Enable off-peak mode for 50% discount.
​
webhookUrl
string
URL to receive a webhook when the task completes.
​
metadata
object
Custom key-value metadata to attach to the task.
{
  "success": true,
  "data": {
    "id": "task_abc123",
    "status": "pending",
    "type": "image-to-video",
    "provider": "vidu",
    "model": "viduq3-turbo",
    "created_at": "2025-01-15T10:00:00Z",
    "estimated_seconds": 30
  }
}