Videos

Create a video from a brief or your own script

post/videos

Request

  • Base URL: https://app.makeaivideo.ai/api/v1
  • URL: https://app.makeaivideo.ai/api/v1/videos
  • Auth: HTTP bearer

Request body

toolstring

Path A: a tool id from GET /tools; we write the script

fieldsobject
duration_secondsinteger
titlestring
topicstring
mode'talking-head' | 'cinematic' | 'hybrid' | 'stock-narrated' | 'smart-mix'
style'talking-head' | 'cinematic'
character_idinteger nullable
voice_idstring
music_idstring
caption_stylestring
aspect_ratio'9:16' | '1:1' | '16:9'
languagestring
start_generationboolean
idempotency_keystring

Same key = same video. Set it when retrying.

video_modelstring

Optional. Leave it unset and MakeAIVideo picks the best video model for each scene.

Response

Accepted. status is generating, or draft when start_generation is false

errorunknown

Changes

No recorded changes to this operation across all 1 revision of this API.