Video script
Send a topic, format and target length, and this endpoint returns a structured video script: an opening hook built to survive the first three seconds, a sequence of paced beats, and a closing call to action. It's built for creators, agencies and content platforms producing video at a pace no single writer can sustain alone.
Run it online
Run this on our servers with your account. Free tools run in your browser; this one bills your KIT balance per the price above.
Why scripts, not just outlines
A lot of script tools stop at a bulleted outline — three talking points and a vague 'wrap up' — and leave the actual writing, the part that decides whether someone keeps watching, to the human. This endpoint goes further: it drafts the opening hook as an actual line, sequences the middle into beats with a sense of pacing rather than a flat list, and writes a specific call to action tied to the stated goal, whether that's a follow, a click, or a purchase. The difference matters most in the first three seconds, which is where most short-form video loses its audience before the topic has even been introduced.
How the request works
POST /text/script with the topic, the target format (short-form, long-form, tutorial, etc.) and rough target length. The task is asynchronous — you receive a task_id right away and the finished script arrives by signed webhook or a signed link valid for 24 hours, which fits naturally into a content pipeline that queues many scripts for a production schedule rather than waiting on one at a time.
The craft this automates
Scriptwriting for video descends from a much older discipline — radio and television writing built around the same constraint of holding attention across time rather than letting a reader's eye wander back to reread a sentence, as text allows. The hook-beats-CTA shape isn't a gimmick; it's the same structural logic broadcast writers have used for decades, adapted to a format where a viewer is one tap away from leaving. Automating it well means respecting that structure rather than producing a paragraph of prose split arbitrarily into scenes.
Where it plugs into a production line
This suits social media teams managing multiple channels, agencies scripting for several clients at once, and content platforms that let users generate a first draft before a human editor takes a pass. Because delivery is async, a content calendar tool can queue a week's worth of topics on Monday and have finished drafts land throughout the day via webhook. Pricing is $0.003 per request plus $0.0135 per script, charged only on a completed script — a failed generation retries automatically up to three times at no cost.
What you can do with it
Weekly content batch
A social media manager queues ten topics on Sunday night and receives ten drafted scripts by webhook before Monday's planning meeting.
Agency serving multiple clients
An agency scripting for five brands at once generates each in the brand's target format and length without a writer starting from a blank page for every client.
Creator tool first-draft mode
A video-editing app offers a 'generate script' button that returns a hook-beats-CTA draft a creator can rewrite in their own voice before recording.
Course and tutorial production
An education platform turns a lesson outline into a paced tutorial script so instructors film from a structure instead of ad-libbing.
FAQ
Is the video script generator API free?
There's no free tier — free tiers get abused and slow everyone down. Access runs on a prepaid ForHosting KIT balance: top up from $10.00 (it never expires) and each request is charged at its published price, so a call with no balance returns HTTP 402. No subscription, no tokens, no invented credits, and a failed task is never charged.
Does it write a full script or just an outline?
A full structured script: an opening hook, paced beats, and a closing call to action — not just bullet points left for you to expand.
Can I set the video length or format?
Yes, send the target format and rough length with your topic and the script is paced to fit, whether that's a short clip or a longer tutorial.
How is the result delivered?
By signed webhook, recommended for content pipelines, or a signed link valid for 24 hours if you'd rather fetch it on demand.
Can I generate scripts for many topics at once?
Yes — every call to /text/script is an independent async task, so a content calendar tool can queue many topics in parallel.
Does the call to action match my goal?
State the goal — follow, click, purchase, subscribe — in the request and the closing beat is written toward that specific action rather than a generic sign-off.
What languages can the script be written in?
The script follows the language of the topic and instructions you send; there's no separate language switch to configure.
Is my topic data kept or used for training?
No — it's deleted after the retention window and never used to train anything; the endpoint only exists to generate your script.
For developers — API access
Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.
API endpoint
Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, and soon from our app, email and Telegram.
Call it from your stack
curl -X POST https://api.kit.forhosting.com/text/script \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/script", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/text/script",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/text/script", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/script", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Example request
{
"input": "…"
}Example response
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "text.script",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.
Pricing
Published price — no tokens, no invented credits. A failed task is never charged.
Limits
max_tokens | 20000 |
Errors
| HTTP | Code | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid API key. |
402 | insufficient_balance | Your balance doesn't cover the task price. |
404 | unknown_type | That task type doesn't exist. |
429 | rate_limited | Too many requests. Use the webhook instead of polling. |
422 | task_failed | The task failed after 3 retries. You are never charged for it. |