BrainrotAPI
Generate short-form videos with a single POST request. The engine behind Brainrot Shorts — AI voiceover, gameplay backgrounds, and word-by-word captions — exposed as a clean REST API.
X-API-Key auth · Idempotent writes · 9:16 MP4 out
$ curl https://www.brainrotshorts.com/api/v1/voiceover/projects \
-H "X-API-Key: brs_•••" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: launch-clip-001" \
-d '{
"title": "Daily AI news",
"voiceId": "peter_griffin",
"backgroundVideoUrl": "https://cdn.example.com/gameplay.mp4",
"scenes": [
{ "text": "Everyone thinks AI replaces video editors." },
{ "text": "The real edge is shipping ten variants before lunch." }
]
}'
{ "data": { "project": { "id": "proj_a1b2c3", "status": "draft" } },
"requestId": "req_5f3c0e9d" }
$ # approve + render, then poll until it's done
$ curl https://www.brainrotshorts.com/api/v1/projects/proj_a1b2c3/render \
-H "X-API-Key: brs_•••" -d '{ "approved": true }'
{ "data": { "render": { "status": "rendering", "progress": 0.0 } } }Overview
What is the Brainrot API?
The Brainrot API is a REST interface for generating short-form, vertical videos programmatically. It exposes the same engine that powers the Brainrot Shorts app — AI voiceover, gameplay backgrounds, and burned-in word-by-word captions — so you can create TikTok, Reels, and YouTube Shorts videos from your own code instead of clicking through a UI.
Instead of editing software, you send JSON. Authenticate with a scoped X-API-Key header, POST a project describing your script and style, start a render, and poll until your watermark-free 9:16 MP4 is ready. Every response is a predictable { data, requestId } envelope, mutating requests are idempotent, and rate limits are reported on every call.
It's built for faceless channel automation, agencies producing video at scale, no-code pipelines, and developers embedding short-form video generation inside their own products — anywhere a programmatic ai video api beats manual production.
Workflows
Three video engines, one API
Each workflow is a small set of endpoints that take a script and settings and hand back a render. Mix them in the same integration.
AI Brainrot videos
Gameplay background, AI voiceover, and word-by-word captions. Generate a script from a niche or post your own dialogue, then render.
POST /brainrot/projectsReddit story videos
Turn a Reddit URL or a raw prompt into a narrated story short — fetch the post, generate the script, and create the project in one call.
POST /reddit/videos/from-urlAI voice-over videos
Drop in scenes of text over any background video, pick a voice, tune captions and playback rate, and export a clean 9:16 MP4.
POST /voiceover/projectsLifecycle
Key → project → render → MP4
- 01
Generate a key
Create a scoped REST key in the dashboard. Send it in the X-API-Key header — that's the entire auth model.
- 02
POST a project
Pick a workflow — brainrot, Reddit, or voice-over — and send your script and settings as JSON. You get back a project ID.
- 03
Start the render
Approve the project and kick off a render. Mutating calls take an Idempotency-Key so retries never double-charge.
- 04
Poll & download
Poll the render until status is done, then grab the output URL — a watermark-free vertical MP4 ready to publish.
Quickstart
Create a video in any language
Same call, your stack. Set BRS_API_KEY and POST a voice-over project — the response hands back a project ID you can render.
curl https://www.brainrotshorts.com/api/v1/voiceover/projects \
-H "X-API-Key: $BRS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: clip-001" \
-d '{
"title": "Daily AI news",
"voiceId": "peter_griffin",
"backgroundVideoUrl": "https://cdn.example.com/gameplay.mp4",
"scenes": [
{ "text": "Everyone thinks AI replaces video editors." },
{ "text": "The real edge is shipping ten variants before lunch." }
]
}'Built for developers
Predictable, by design
Scoped API keys
Issue and revoke as many keys as you need from the dashboard. Each key is independently rate-limited and auditable.
Stable response envelope
Every response is { data, requestId } — and every error is { error: { code, message } }. Predictable to parse and log.
Idempotent writes
Send an Idempotency-Key on any POST and a retried request replays the original response instead of creating a duplicate.
Transparent rate limits
Every response carries X-RateLimit-* headers so you always know your remaining quota and when the window resets.
Full catalog access
List characters, voices, gameplay backgrounds, and caption styles over the API — no hardcoding IDs from the UI.
Typed JSON schemas
Request bodies are validated field-by-field. Validation errors return the exact path and reason so failures are easy to fix.
Use cases
What people ship with it
Faceless channel automation
Wire a content pipeline that turns a spreadsheet of ideas into a daily batch of brainrot shorts — no human in the loop.
Agencies & white-label
Generate on-brand short-form video for dozens of client accounts programmatically and plug the output into your own dashboard.
No-code workflows
Trigger renders from n8n, Make, or Zapier with a single HTTP node. The polling model fits webhook-free automations cleanly.
Build a product on top
Embed short-form video generation inside your own SaaS — your users describe a video, your backend calls the Brainrot API.
FAQ
Brainrot API questions
Is there an API for generating brainrot videos?
Yes. The Brainrot Shorts REST API lets you generate short-form videos programmatically — AI brainrot dialogue videos, Reddit story videos, and AI voice-over videos. You authenticate with a scoped API key, POST a project as JSON, start a render, and poll for a watermark-free 9:16 MP4. It's the same engine that powers the Brainrot Shorts app, exposed over HTTP.
How do I get a Brainrot API key?
API access is available on the Creator and Pro plans. Open the API dashboard, create a REST key (it's shown once, prefixed with brs_), and send it in the X-API-Key header on every request. You can issue multiple keys and revoke any of them at any time.
What can the Brainrot API create?
Three video workflows today: AI Brainrot (gameplay background + AI voiceover + word-by-word captions), Reddit story videos (from a Reddit URL or a text prompt), and AI Voice Over videos (your scenes of text over any background video). You can also generate scripts, list the character/voice/background/caption catalogs, and manage projects and renders.
How does authentication work?
A single header. Send X-API-Key: brs_your_key with each request. Keys are scoped specifically to the REST API (separate from MCP/agent keys), stored hashed, and tied to your plan's entitlements. No OAuth flow or token exchange is required.
What are the rate limits?
REST requests are metered per key on a rolling 24-hour UTC window: 50 requests/day on Creator and 200 requests/day on Pro. Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers, and a 429 includes Retry-After. Renders, script generation, and narration audio also consume your account's credits.
Is the API idempotent?
Mutating POST requests accept an optional Idempotency-Key header. If you retry a request with the same key and body within 24 hours, the API replays the original response (flagged with X-Idempotent-Replay) instead of creating a duplicate project or render — so network retries are always safe.
Does the API support webhooks or is it polling-based?
v1 is polling-based. After you start a render, poll GET /projects/{projectId}/render (or GET /renders/{renderId}) until the status is done and read the output URL. Use conservative polling intervals because status checks count toward your daily request quota.
What format are the generated videos?
Every render is a vertical 9:16 MP4 with burned-in captions — the native format for TikTok, Instagram Reels, and YouTube Shorts. Exports on paid plans are watermark-free, so the output is ready to publish or hand off to clients directly.
Ship video. by request.
Spin up a scoped key, paste the quickstart, and render your first brainrot short in minutes. Available on Creator and Pro.