Write code — or just ask.
REST API
Put content generation inside your product, pipeline, or automation. OpenAPI 3.1 spec, typed schemas, copy-paste snippets in 25 languages — and a live client to fire every endpoint before you write a line.
MCP for agents
The same engine, driven in plain language. Claude, ChatGPT, or Cursor plans, prices, and delivers finished content mid-conversation — one-click sign-in, zero code.
Know the cost before you spend.
Create & reserve
The create call reserves the credits and hands back a jobId. The reservation IS the charge — no metering surprises, no bill-shock at the end of the month.
Poll one URL
GET /jobs/{id} every few seconds. When status flips to completed, the same response carries output — the finished MP4, slides, or media file. There is no third step.
Know it first
Every flow has a free /estimate twin: it quotes the exact cost and names every model that will run, before a credit moves. Use it when you want a confirm step; skip it when you don’t.
Failures refund
A failed job releases its reservation automatically — you’re never charged for content you didn’t receive. Output links are signed for 24 hours; re-fetch them any time.
The entire studio, behind one key.
Videos
A topic or a script goes in; a narrated, captioned MP4 comes out. Image-based scenes or premium AI-video clips.
UGC ads
Plan the shot list, review every beat, render only what you approve. The presenter speaks natively to camera, over music.
Music, scored in
One music field adds a background bed to the finished cut — brief it yourself, or let us write the brief from your video. Ads are scored by default.
Slideshows
Carousel-ready slides from your copy — with one locked, consistent character across every image.
Ad-hoc media
One image or one raw clip, straight into the media library. No project, no timeline, no ceremony.
Your own files
A presigned upload handshake turns local files into reference images, start frames, and presenter shots.
Full catalog access
Models with machine-readable capabilities, styles, teams, balances — everything an integration needs to self-serve.
Powered by the best models in AI.
One key, the whole frontier bench. TurboClip routes each step to the model that does it best — or you name the model in the request. New models land behind the same endpoints, so reaching them never costs you an integration rewrite.
Good to know.
How do I get an API key?
Sign in and open your profile menu → API Keys. The full key (tc_sk_…) is shown once at creation — store it securely; only a masked version is retrievable afterwards.
What plan do I need?
API & MCP access are included on the Starter plan and up, checked on every request. One welcome mat: a never-subscribed account can plan UGC ads for free — the paid gate is the generate step.
How does billing work?
Generation reserves credits up front, and the reservation is the charge — only failed jobs refund. Every flow has a free /estimate twin that previews the exact cost and models first.
Can I add music?
Yes — one music field on the video and ad calls. Pass a brief ("warm lo-fi, 82 BPM"), or just music: true and we write the brief from the finished video. The bed is laid on the timeline before the MP4 is stitched, sized to your video and mixed to sit under narration, so one call returns something you can post. Ads are scored by default; music: false opts out.
What are the rate limits?
30 requests per minute per API key. Beyond it you get a 429 with a Retry-After header.
Can I call the API from a browser?
Yes — api.turboclip.ai serves open CORS. That’s safe because auth is key-based, never cookie-based. It’s also what powers the Test Request button in the interactive reference.
Is there a machine-readable spec?
Yes: https://api.turboclip.ai/openapi.json — OpenAPI 3.1, generated from the same schemas that validate every request. Import it into Postman or generate a typed client.
What’s the difference between the API and the MCP?
Same engine, two doors. The API is for wiring TurboClip into your own code; the MCP lets an AI assistant (Claude, ChatGPT, Cursor) drive it in plain language — no code required.
Your first finished video is one request away.
Open the reference, paste your key, and fire a real request from the page. What comes back is ready to post.