---
title: "POST /videos/script | MakeAIVideo"
description: "Write a script from a topic or a brief (no video yet). POST /videos/script in the MakeAIVideo API, with request fields and every response code. Needs an AP..."
canonical: https://makeaivideo.ai/docs/api/scripts/generate-script
format: markdown
generator: makeaivideo-marketing build-time HTML→MD
---

[Documentation](/docs)v1.2

Guides

-   [Overview](/docs)
-   [Quickstart](/docs/quickstart)
-   [Authentication](/docs/authentication)
-   [Webhooks](/docs/webhooks)

Integrations

-   [MCP server](/docs/mcp)
-   [Agents](/docs/agents)
-   [CLI](/docs/cli)
-   [TypeScript SDK](/docs/sdk)

API reference

-   [All endpoints](/docs/api)
-   [Introspection](/docs/api/introspection)
-   [Videos](/docs/api/videos)
-   [Scripts](/docs/api/scripts)
-   [Characters](/docs/api/characters)
-   [Voices](/docs/api/voices)
-   [Music](/docs/api/music)
-   [Uploads](/docs/api/uploads)
-   [Brand kit](/docs/api/brand-kit)
-   [Workspace](/docs/api/workspace)
-   [Ideas](/docs/api/ideas)
-   [Publishing](/docs/api/publishing)
-   [Webhooks](/docs/api/webhooks)
-   [Auth](/docs/api/auth)

# POST`/videos/script`

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

## Request

Send to `https://app.makeaivideo.ai/api/v1/videos/script` with a bearer API key. The key needs the `ai` scope; a key without it gets `403 forbidden` naming the scope it lacks.

## Responses

Every v1 response is `{ data, error, meta }`. On failure `error` carries a stable `code` and `meta.request_id` identifies the call, which is the thing to quote in a support mail.

Status

Meaning

200

Script

## Other scripts endpoints

-   [POST`/videos/scriptify`Structure your own prose into a scene script](/docs/api/scripts/scriptify)
-   [POST`/videos/fetch-url`Fetch a public article's readable text (for the article tool)](/docs/api/scripts/fetch-url)

[All scripts](/docs/api/scripts) · [Full API reference](/docs/api) · [TypeScript SDK](/docs/sdk) · [Quickstart](/docs/quickstart)
