Create multi-scene videos combining avatars, video clips, and AI-generated transitions
/v1/music/list.ratio_9_16: Vertical (TikTok, Reels, Shorts) - Recommendedratio_16_9: Horizontal (YouTube)ratio_1_1: Square (Instagram)en, esscript, avatarId, voiceId
mediaId
script, avatarId, voiceId, mediaId
startFrameMediaId, endFrameMediaId, framePrompt
200 status code. We’ll retry up to 3 times if the request fails.| Scene Type | Required Fields | Optional Fields |
|---|---|---|
avatar | script, avatarId, voiceId | |
video | mediaId | script, voiceId, |
picture_in_picture | script, avatarId, voiceId, mediaId | |
start_end_frame | startFrameMediaId, endFrameMediaId, framePrompt | frameModel, frameDuration |
| Model | Description | Best For |
|---|---|---|
kling_2_5 | Kling 2.5 model | Fast generation, general transitions |
veo_3_1 | Google Veo 3.1 | High quality, complex camera movements |
caption.preset field:
| Preset | Description |
|---|---|
default | Default caption style with bold text and shadow effects |
beast | Bold uppercase style with Komika font |
umi | Yellow glowing text style |
tiktok | Viral & trendy style, perfect for social media |
wrap1 | Wrapped style with red background highlight |
wrap2 | Wrapped style with blue background highlight (uppercase) |
ariel | Bold uppercase style with purple highlight |
hooked | Brand style with purple background |
classic | Clean, simple captions with black background |
active | Green background with bold text |
bubble | White background bubble style |
glass | Glassmorphic transparency effect |
comic | Comic Sans font with colorful style |
glow | Pink and orange glow effects |
pastel | Soft pastel pink background |
neon | Green neon glow effect |
retroTV | Retro TV style with cyan glow |
red | Red glow effect with white text |
marker | Yellow marker/highlighter style |
modern | Contemporary white background style |
blue | Blue background style |
vivid | Vibrant pink background with uppercase text |
| Error | Description | Solution |
|---|---|---|
At least one scene is required | Empty scenes array | Add at least one scene to the array |
Cannot have more than 50 scenes | Too many scenes | Reduce the number of scenes to 50 or fewer |
Script is required for avatar scenes | Missing script in avatar scene | Add the script field |
Avatar ID is required for avatar scenes | Missing avatarId | Add a valid avatarId from /v1/avatar/list |
Voice ID is required for avatar scenes | Missing voiceId | Add a valid voiceId from /v1/voice/list |
Media ID is required for video scenes | Missing mediaId in video scene | Add a valid mediaId |
Not enough credits | Insufficient credits | Top up your account credits |
Array of scene objects (1-50 scenes)
1 - 50 elementsVideo name (max 100 characters)
100Background music ID from /v1/music/list
30Video aspect ratio
ratio_9_16, ratio_16_9, ratio_1_1 Add AI-generated stickers to enhance video engagement
Language code (2 characters)
2HTTPS URL to receive completion notification
500Custom metadata object (max 5KB)