AI Script Writer | Pipe2.ai

Back to pipelines

Complete to generate

Topic

What is your video about?

How to use Script Writer

A compact decision guide for placing this pipeline in a workflow.

Best for

Planning a video from scratch, AI writes the script and plans every visual
Automatically deciding which tools to use for each scene
Creating narration scripts with natural pacing for voice generation
Structuring multi-segment videos with consistent style

When to use

Always start here when producing a full video from a topic
When you want AI to plan the visuals, narration, and music for you

Tips

The more detail you provide about the topic, the better the output
Use the instructions field to set style preferences (e.g. cinematic, upbeat, educational)
The output includes a visual diagram showing how all the pieces connect
Each scene specifies which pipelines to use and in what order

Script Writer API

Call this pipeline from your own code. One request dispatches a run; the model is an input field, not a separate endpoint.

Get an API token

inputs: 4
required: 2
Pricing: 4 credits

Language

TypeScript Python Go CLI

bun add @pipe2-ai/sdk

Run a pipeline

import { createClient } from "@pipe2-ai/sdk";

const client = createClient(process.env.PIPE2_TOKEN!);

const { run_pipeline } = await client.RunPipeline({
  pipeline_slug: "script-writer",
  input: {
    topic: "why sourdough starters actually work",
    genre: "documentary",
  },
});

pip install pipe2

Run a pipeline

import asyncio
import os

from pipe2 import Pipe2Client

client = Pipe2Client(token=os.environ["PIPE2_TOKEN"])

run = asyncio.run(client.run_pipeline(
    pipeline_slug="script-writer",
    input={
        "topic": "why sourdough starters actually work",
        "genre": "documentary",
    },
))

go get github.com/pipe2-ai/sdk-go

Run a pipeline

client := pipe2.NewClient(os.Getenv("PIPE2_TOKEN"))

input := json.RawMessage(`{
  "topic": "why sourdough starters actually work",
  "genre": "documentary"
}`)

run, err := pipe2.RunPipeline(context.Background(), client, "script-writer", input)
if err != nil {
    log.Fatal(err)
}

brew install pipe2-ai/tap/pipe2

Run a pipeline

pipe2 pipelines run \
  --pipeline script-writer \
  --input-json '{"topic": "why sourdough starters actually work", "genre": "documentary"}' \
  --wait

Per page

Input	Type	default	Description
`genre`required	enum	defaultdocumentary	Tone and format of the script — drives pacing, structure and voice. documentary · educational · explainer +2 `documentaryeducationalexplainerpromocinematic`
`topic`required	string	default—	What is your video about?
`duration_min`	enum	default1	Target read time in minutes. The script is written to fit. 1 · 3 · 5 +1 `13510`
`instructions`	string	default—	Optional production guidance

Point any MCP client at pipe2 and your agent gets these tools. It finds this pipeline, reads the same schema above, then runs it.

list_pipelines
get_pipeline_schema
run_pipeline
get_pipeline_run_status
request_upload

https://mcp.pipe2.ai/mcp

{
  "mcpServers": {
    "pipe2ai": {
      "url": "https://mcp.pipe2.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

MCP setup

Full API reference CLI reference

Articles about this pipeline

Show all articles

Frequently Asked Questions

How many sections will my script have?

The number of sections scales with your chosen duration: 4-6 sections for 1 minute, 6-10 for 3 minutes, 8-12 for 5 minutes, and 12-18 for 10 minutes.

What is the narration word count?

Scripts are written at 130 words per minute, the standard documentary narration pace. A 10-minute script contains approximately 1,300 words across all sections.

Can I edit the script after generating it?

Yes, the output is plain JSON you can copy and edit. The structured format makes it easy to adjust individual sections without rewriting the whole script.

How do I use this with other tools?

Copy each section's narration into the Audio Generator for voiceover, the query from any visual_strategy step marked footage-search into Footage Search for b-roll, and each section's title into the Text Card tool for title cards.

How many credits does it cost?

4 credits per script. AI generates the full script in a single call, so the cost is fixed regardless of script length.