Skip to main content
POST
https://api.modelhunter.ai
/
v1
/
vidu
/
text-to-video
Text to Video
curl --request POST \
  --url https://api.modelhunter.ai/v1/vidu/text-to-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {
    "input.prompt": "<string>",
    "input.duration": 123,
    "input.aspect_ratio": "<string>",
    "input.resolution": "<string>",
    "input.style": "<string>",
    "input.audio": true,
    "input.seed": 123,
    "input.off_peak": true
  },
  "webhookUrl": "<string>",
  "metadata": {}
}
'
{
  "success": true,
  "data": {
    "id": "task_abc123",
    "status": "pending",
    "type": "text-to-video",
    "provider": "vidu",
    "model": "viduq2-pro-fast",
    "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.08/sec
  • viduq2-pro — High quality (1–10s), $0.05/sec
  • viduq2-turbo — Balanced speed/quality (1–10s), $0.03/sec
​
input
object
required
Provider-specific parameters for the generation request.
​
input.prompt
string
required
Text description of the video to generate. Max 2,000 characters.
​
input.duration
number
Video length in seconds. Range depends on model:
  • Q3 Pro: 1–16 seconds
  • Q2 models: 1–10 seconds
  • Q1: 5 seconds
  • v2.0: 4 or 8 seconds
​
input.aspect_ratio
string
default:"16:9"
Output aspect ratio. Options: 16:9, 9:16, 1:1, 4:3, 3:4
​
input.resolution
string
default:"720p"
Output resolution. Options: 540p, 720p, 1080p
​
input.style
string
default:"general"
Visual style. Options: general, anime
​
input.audio
boolean
Enable audio-video sync output. Only supported on viduq3-pro. Default true for Q3.
​
input.seed
number
Random seed for reproducibility.
​
input.off_peak
boolean
default:false
Enable off-peak mode for 50% discount. Tasks complete within 48 hours.
​
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": "text-to-video",
    "provider": "vidu",
    "model": "viduq2-pro-fast",
    "created_at": "2025-01-15T10:00:00Z",
    "estimated_seconds": 30
  }
}