MakeAIVideo Scripts API

When to use the Scripts API

Scripting is separable from rendering. These endpoints produce or normalise a script without spending render credits, which matters when a human or an agent wants to approve the words before any video is made.

Three entry points depending on what you start with. A topic becomes a script with POST /videos/script. Prose you already wrote becomes a structured scene script with POST /videos/scriptify. A published article becomes readable text with POST /videos/fetch-url, ready to feed either of the other two.

The output slots straight into the script field on POST /videos, so the approve-then-render workflow is: script, review, create.

curl -X POST https://app.makeaivideo.ai/api/v1/videos/script \
  -H "Authorization: Bearer $MAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "How compound interest works",
    "mode": "cinematic",
    "target_duration": 30
  }'

Scripts API questions

Can I review a script before spending credits on the video?

Yes, and this is the main reason these endpoints exist. Generate the script first, show it to whoever needs to approve it, then pass the approved script object to POST /videos.

What is the difference between script and scriptify?

POST /videos/script writes a script from a topic or brief. POST /videos/scriptify takes prose you already have and structures it into numbered scenes with narration and visual directions.

Can I turn a blog post into a video script?

Yes. POST /videos/fetch-url extracts the readable text from a public article, which you then pass through scriptify to get a scene script.

More MakeAIVideo documentation