Create an AI Video
Generate high-quality AI videos from text, topics, or blog URLs.
Tutorial
Endpoint
Method: POST
URL: https://aiapi.vadoo.tv/api/generate_video
Request Headers
| Header | Type | Required | Description |
|---|---|---|---|
| X-Api-Key | string | Yes | Your API key |
Request Body
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| topic | string | No | Random AI Story | Topic of the video. See Video Topics |
| duration | string | No | 30-60 | Duration code: "30-60", "60-90", "90-120", "120-180", "5 min", "10 min" |
| prompt | string | Conditional | - | Required if topic is "Custom". Details of the story to generate. |
| voice | string | No | Onyx | AI Voice name. See Available Voices |
| language | string | No | English | Video language. See Supported Languages |
| aspect_ratio | string | No | 9:16 | "9:16", "1:1", or "16:9" |
| style | string | No | None | Visual style theme. See AI Image Styles |
| theme | string | No | Hormozi_1 | Subtitle theme name. See Caption Themes |
| bg_music | string | No | - | Background music name. See Background Music |
| bg_music_volume | number | No | 100 | Volume for background music (0-100) |
| speed | number | No | 1.0 | Voiceover playback speed (0.5 to 2.0) |
| use_ai | number | No | 1 | Set to 0 to provide a complete script manually in the prompt. |
| include_voiceover | number | No | 1 | Set to 0 to disable voiceover. |
| custom_instructions | string | No | - | Additional creative instructions for the AI. |
| url | string | No | - | Blog/Article URL if converting a web page to video. |
Script Character Limits
If you are providing a custom script (using topic="Custom" and use_ai=0), please ensure the prompt (your script) does not exceed these character limits based on the selected duration:
| Duration | Max Characters |
|---|---|
| 30-60 | 1000 |
| 60-90 | 1500 |
| 90-120 | 2000 |
| 120-180 | 2500 |
| 5 min | 5000 |
| 10 min | 10000 |
Response
{
"vid": "123456789012"
}
Notes
- Returns a
vidfor status tracking via Get Video URL. - If
topicis "Custom" anduse_ai_scriptis 1, thepromptwill be used as a guideline for the AI to write a script. - If
topicis "Custom" anduse_ai_scriptis 0, thepromptwill be used as the exact script for the voiceover.