Upload video URL or AI prompt for image generation
scenes[].script
string
Yes
-
Voiceover text for this scene
voiceName
enum
No
Brian (American, deep)
ElevenLabs voice. See voice options below
aiImageModel
enum
No
fal-ai/imagen4/preview/fast
AI model for image generation
animateAiImages
boolean
No
false
Convert AI images to animated videos
captionPosition
enum
No
center
Values: top, center, bottom
highlightColor
color
No
#FFFF00
Highlighted word color in captions
transition
enum
No
none
Values: none, fade, slide, zoom
aspectRatio
enum
No
9:16
Values: 16:9, 1:1, 4:5, 9:16
trimToVoiceover
boolean
No
true
Trim video to match voiceover duration
Available Voices
Alice (British, confident), Aria (American, expressive), Bill (American, trustworthy), Brian (American, deep), Callum (Transatlantic, intense), Charlie (Australian, natural), Charlotte (Swedish, seductive), Chris (American, casual), Daniel (British, authoritative), Eric (American, friendly), George (British, warm), Jessica (American, expressive), Laura (American, upbeat), Liam (American, articulate), Lily (British, warm), Matilda (American, friendly), River (American, confident), Roger (American, confident), Sarah (American, soft), Will (American, friendly)
POST https://backend.blotato.com/v2/videos/from-templates
Content-Type: application/json
blotato-api-key: YOUR_API_KEY
{
"templateId": "/base/v2/ai-story-video/5903fe43-514d-40ee-a060-0d6628c5f8fd/v1",
"inputs": {},
"prompt": "Create a 3-scene video about the history of coffee, from ancient Ethiopia to modern cafes",
"render": true
}
POST https://backend.blotato.com/v2/videos/from-templates
Content-Type: application/json
blotato-api-key: YOUR_API_KEY
{
"templateId": "/base/v2/ai-story-video/5903fe43-514d-40ee-a060-0d6628c5f8fd/v1",
"inputs": {
"scenes": [
{
"mediaSource": "A serene winter landscape with snow-covered mountains and a frozen lake",
"script": "Welcome to this amazing journey. Let me show you something incredible."
},
{
"mediaSource": "A golden retriever playing happily in a sunny meadow",
"script": "Every moment is an opportunity to create something beautiful."
},
{
"mediaSource": "A cozy coffee shop interior with warm lighting and books",
"script": "And remember, the best stories are yet to be told."
}
],
"voiceName": "Brian (American, deep)",
"captionPosition": "center",
"highlightColor": "#FFFF00",
"transition": "fade",
"aspectRatio": "9:16"
},
"render": true
}
POST https://backend.blotato.com/v2/videos/from-templates
Content-Type: application/json
blotato-api-key: YOUR_API_KEY
{
"templateId": "/base/v2/ai-story-video/5903fe43-514d-40ee-a060-0d6628c5f8fd/v1",
"inputs": {
"voiceName": "Alice (British, confident)",
"captionPosition": "bottom",
"highlightColor": "#00FF00",
"animateAiImages": true,
"aspectRatio": "1:1"
},
"prompt": "Create a 4-scene video about the benefits of meditation for busy professionals",
"render": true
}
POST https://backend.blotato.com/v2/videos/from-templates
Content-Type: application/json
blotato-api-key: YOUR_API_KEY
{
"templateId": "/base/v2/ai-story-video/5903fe43-514d-40ee-a060-0d6628c5f8fd/v1",
"inputs": {
"scenes": [
{
"mediaSource": "https://example.com/my-uploaded-video.mp4",
"script": "Here is my introduction using uploaded footage."
},
{
"mediaSource": "A futuristic cityscape with flying cars and neon lights",
"script": "Now imagine what the future could look like."
}
],
"voiceName": "Daniel (British, authoritative)",
"aspectRatio": "16:9"
},
"render": true
}
