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