TurboClip API

Video production, reduced to an API call.

Most video APIs return a raw clip and leave the production to you. TurboClip returns the deliverable — narrated, captioned videos, UGC-style ads, slideshows, and images, ready to post. Typed schemas, a live test client, and the exact cost quoted before a credit moves.

A presenter-led product ad — shot list, native lip-synced dialogue, your product in every shot, music under the cut. No shoot, no editor: two calls to a finished ad.

  1. 1

    Send the brief.

    API docs

    One POST — a 24-second vertical product ad: three shots, your real product in frame, music under the cut, captions burned in. The AI writes it, renders it, cuts it. No questionnaire, no shoot.

    Request

    curl -X POST https://api.turboclip.ai/v1/ad \
      -H "Content-Type: application/json" \
      -H "x-api-key: tc_sk_..." \
      -d '{
        "brief": "Launch ad for the Ridgeline Pro hiking jacket. Follow one hiker from a dark trailhead to a sunrise summit. Waterproof, featherlight, built for cold alpine starts. End on the jacket and the tagline: Made for the way up.",
        "settings": {
          "adType": "product",
          "videoModel": "gemini-omni-flash-preview",
          "aspectRatio": "9:16",
          "duration": 24,
          "shots": 3
        },
        "referenceImageUrls": ["https://cdn.ridgelinegear.com/ridgeline-pro/product.jpg"],
        "music": true,
        "captions": true
      }'

    Response · 200

    { "success": true, "data": { "projectId": "3f2a1b4c-…", "jobId": "9b1c7e2d-…",
        "processType": "full_pipeline_video", "creditsReserved": 801, "creditsRemaining": 199 } }

    Output AI Ad · 9:16

    The ad this brief produced — captions burned in, music under the cut. Nothing filmed.
  2. 2

    Poll one URL.

    That’s the whole loop — no render call, no second endpoint. When status flips to completed, the finished MP4 is right there in the same response, music already under the cut.

    Request

    curl https://api.turboclip.ai/v1/jobs/{jobId} \
      -H "x-api-key: tc_sk_..."

    Response · 200

    { "success": true, "data": { "status": "completed", "creditsConsumed": 801,
        "output": { "type": "video", "videoUrl": "https://…/ridgeline-pro-launch.mp4" } } }
Predictable billing

Know the cost before you spend.

Step 1

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.

Step 2

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.

Optional

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.

Safety net

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.

What you can ship

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.

Under the hood

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.

Script
Opus 5 · GPT-6 Astra · Gemini 3.1 Pro
Briefs, scripts, and timecoded shot lists
Imagery
GPT Image 2 · Nano Banana (3 Pro)
Scene images and slides, up to 4K
Motion
MiniMax H3 · Gemini Omni Flash · Seedance 2.0 + 2.5 · Kling V3
AI video with native audio
Voice & score
ElevenLabs · Lyria 3 Pro
Narration and a music bed, already mixed
GET /models returns the live catalog — every model and its capabilities, machine-readable.
Questions

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.

Build with TurboClip

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.

API & MCP access on Creator and up · spec at api.turboclip.ai/openapi.json