Braiv Capture is available for Mac — record a tutorial once, publish it in every language.

Braiv API

One video API for dubbing, shorts and thumbnails

Import a video once, then add work to it: a dub in another language, a set of shorts, a title and thumbnail. Every long-running action is a job you can poll or receive on a webhook.

Available on Pro, Business and Team plans.

At a glance
REST
JSON over HTTPS Bearer or X-Api-Key auth
4
Job states queued, processing, ready, failed
3.1
OpenAPI spec Generate a client in any language
50+
Dubbing languages Plus and Premium dubs
Why Braiv

What you can build with the Braiv API

Version 1 covers the same production workflow as Braiv Studio.

Ingest from anywhere

Import from YouTube, Dropbox, Google Drive or any HTTPS link, or upload a file with a resumable upload.

Video dubbing and translation

Create Plus or Premium dubs per language, translate captions, and fetch transcripts and subtitles.

Shorts

Generate vertical clips from any imported video.

Thumbnails and packaging

Generate thumbnails, titles and descriptions, read the current thumbnail, or set your own.

Text to speech

Synthesise speech with your cloned voices through the sibling Braiv Speech API.

Webhooks

Signed deliveries for video.ready, video.failed, job.ready and job.failed, so you can skip polling.

Credits you can plan around

Quote a bundle, optionally reserve the credits, then create. A shortfall returns a clear error.

Scoped keys and workspaces

Give each key only the scopes it needs, and bind it to a team workspace for library and billing.

Quickstart

From a YouTube link to a Spanish dub in three requests

Create a video, wait for the import job, then start a dub. Poll the dub job the same way, or register a webhook.

curl -X POST "https://api.braiv.co/v1/videos" \
  -H "Authorization: Bearer $BRAIV_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"source":{"type":"youtube","url":"https://www.youtube.com/watch?v=VIDEO"}}'

# → { "videoId": "...", ... }  and an import_{videoId} job
How it works

How a video flows through the API

  1. 01

    Create

    POST /videos with a source. You get a video ID and an import job.

  2. 02

    Transcribe

    When the import is ready, the source transcript runs automatically.

  3. 03

    Attach products

    Add dubs, shorts, packaging or Pro Hosting to the same video. Each one is a job.

  4. 04

    Deliver

    Request a download as its own job when you need a file, such as a language MP4.

Compare

API or MCP: which should you use?

Both reach the same Braiv platform. Pick by who is doing the work.

Feature Braiv API Braiv MCP
Best for Developers building Braiv into a product or pipeline People working with an AI assistant, and agents acting for them
How you connect Scoped API key in a request header Paste one URL and sign in
How you ask HTTP requests from your code Plain English in a chat
Long-running work Poll jobs or receive webhooks The agent polls jobs for you
Plans Pro, Business and Team Pro, Business and Team
Credits Same credits as Studio Same credits as Studio

A video dubbing and translation API

The dubbing endpoints take a video you have imported and a list of language codes, and return a dubbed version per language. Choose the Plus or Premium dub product per request. Caption translation and subtitle export are available separately when you only need text.

A thumbnail, title and shorts API

Packaging endpoints generate a title, description and thumbnail for a video, on their own or together. Thumbnails can use the characters and Brand Voices saved in your Studio account. The shorts endpoint cuts vertical clips from an imported video.

Built around jobs

Imports, dubs, shorts and downloads take time, so each returns a job with one of four states: queued, processing, ready or failed. Poll GET /jobs/{jobId}, or register a webhook and let Braiv call you. Write requests accept an Idempotency-Key header so retries are safe.

FAQ

Braiv API questions, answered

What can the Braiv API do?
Version 1 covers video import and upload, transcripts and subtitles, caption translation, Plus and Premium dubs, shorts, thumbnails, titles and descriptions, Pro Hosting, downloads, standalone music files, scoped API keys and job webhooks. Text to speech with your cloned voices is available through the sibling Braiv Speech API on the same base URL.
How do I get an API key?
Create a scoped key in Braiv Studio on a Pro, Business or Team plan. Give it a name and only the scopes your integration needs, and optionally bind it to a team workspace. Send it as a Bearer token or in the X-Api-Key header.
How is the API priced?
API access is included on Pro, Business and Team plans. The work you create uses credits at the same rates as Braiv Studio. You can quote a bundle and reserve credits before you create anything.
Is there an OpenAPI spec or SDK?
There is an OpenAPI 3.1 spec you can download from the docs and use to generate a client in your language of choice.
Does the API support webhooks?
Yes. Register an HTTPS endpoint to receive video.ready, video.failed, job.ready and job.failed events. Each delivery is signed with HMAC-SHA256 so you can verify it came from Braiv.
What is the difference between the API and the MCP server?
The API is for code you write: HTTP requests authenticated with an API key. The MCP server is for AI assistants such as Claude, ChatGPT and Cursor: they sign in with OAuth and call the same operations as tools. Both use the same plans and credits.

Build video localisation into your product

Create a Braiv account, generate an API key, and make your first import in a few minutes.