MakeAIVideo
Start free trial

API reference

Scripts API

Write or structure a script before rendering.

3 operations · https://app.makeaivideo.ai/api/v1

What the scripts endpoints are for

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.

Script a topic without rendering
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
  }'
POST/videos/scriptai

Write a script from a topic or a brief (no video yet)

POST https://app.makeaivideo.ai/api/v1/videos/script

Responses

  • 200Script
POST/videos/scriptifyai

Structure your own prose into a scene script

POST https://app.makeaivideo.ai/api/v1/videos/scriptify

Responses

  • 200Script
POST/videos/fetch-urlai

Fetch a public article's readable text (for the article tool)

POST https://app.makeaivideo.ai/api/v1/videos/fetch-url

Responses

  • 200Page

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.

Related

  • Quickstart — the create, poll and download loop end to end.
  • Authentication — what the ai scope on this page mean.
  • Agents — calling these endpoints from an autonomous agent.
← Videos APICharacters API →