Developers · API
Everything Leelo does, behind a key.
Speech, dubbing, transcription, sound effects and clean-up over a plain REST API. Webhooks tell you when long jobs finish, and an MCP server lets AI assistants use Leelo directly.
API, webhooks and MCP on Pro and Business

01Endpoints
Every route, and what it costs.
JSON in, JSON out, one key per app in an Authorization header. Base URL: https://api.leelo-ai.com
| Route | What it does | Credits |
|---|---|---|
| GET/v1/me | Your plan, credits left and storage | free |
| GET/v1/voices | Every voice, yours first. ?locale=fr-FR, ?q=, ?limit=, ?after= | free |
| GET/v1/voices/{id} | One voice | free |
| POST/v1/speech | Text read in a voice → an audio URL. Same text and voice again is free. | 1 / word · 5 in your own voice |
| POST/v1/transcriptions | A media URL → lines with times and speakers | 40 / minute |
| GET/v1/transcriptions/{id} | A transcript you made before | free |
| POST/v1/dubs | A media URL into another language. Returns a job; it finishes on its own. | 5,000 / minute, each language |
| GET/v1/dubs/{id} | Where a dub has got to, and its URL once done | free |
| POST/v1/sounds | A description → sound effects. ?attempts up to 3 | 20 / second, at least 100 |
| POST/v1/cleanups | A recording URL → the voice alone, levelled | 1,300 / minute |
| POST/v1/writing | rewrite · shorten · fix · split · script · translate | 10 / 500 words |
| GET/v1/projects | Your Studio projects | free |
| GET/v1/projects/{id} | A project's lines, speakers and audio | free |
| POST/v1/projects/{id}/exports | The whole project as one mastered file | free |
| GET/v1/files | Exports, dubs, clean-ups, sounds. ?kind= | free |
| GET/v1/usage | Every charge, labelled with the key that made it | free |
| GET/v1/rates | What everything costs, in credits | free |
| POST/v1/webhooks | Register an address: { url, events } | free |
| GET/v1/webhooks | Your webhooks, and every event there is | free |
| GET/v1/webhooks/deliveries | What was sent, and how it went | free |
| DELETE/v1/webhooks/{id} | Stop sending to an address | free |
02Webhooks
Hear about it when it's done.
Register an address and the events you care about. Every delivery is signed, retried if your server is down, and logged so you can see what was sent.
- dub.completedA dub finished; the payload has its URL
- dub.failedA dub couldn't be finished; its credits are back
- transcription.completedA transcript is ready
- export.completedA project export is ready to download
- credits.lowThe month's credits are running low
- credits.depletedThe month's credits have run out
Each request carries Leelo-Signature: t=…,v1=…, an HMAC-SHA256 of `${t}.${body}` with your webhook's secret. Failed deliveries are retried seven times over a day and a half.
import { createHmac, timingSafeEqual } from "node:crypto";
function verify(body, header, secret) {
const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const want = createHmac("sha256", secret).update(`${t}.${body}`).digest("hex");
return timingSafeEqual(Buffer.from(want), Buffer.from(v1));
}03MCP
Leelo inside your AI assistant.
Connect Claude, Cursor or any MCP client and ask in plain words: read this in a warm British voice, dub this video into Spanish. It uses an API key and the same credits, and every call shows in your usage.
Claude Code
claude mcp add --transport http leelo https://api.leelo-ai.com/mcp \
--header "Authorization: Bearer lk_live_…"Cursor, Windsurf and other clients
{
"mcpServers": {
"leelo": {
"url": "https://api.leelo-ai.com/mcp",
"headers": { "Authorization": "Bearer lk_live_…" }
}
}
}04Article player
“Listen to this article”, in one line.
Publish any export as a player with your colours and a light or dark theme, then paste one line of HTML into your page. On every plan, no API key needed.
- Look
- Your accent colour, light or dark, with a waveform and speed control.
- Weight
- Loads lazily, and the audio only when a reader presses play.
- Numbers
- Plays are counted, with a notification when a player passes a milestone.
<iframe src="https://leelo-ai.com/embed/…"
title="Listen: Why cities are getting quieter"
width="100%" height="136" loading="lazy"
style="border:0;max-width:760px;display:block"></iframe>05Questions
Before you build.
Build it with Leelo.
Start free, then upgrade to Pro when you're ready for a key. Same credits, same voices as the app.
Start free: 1,000 creditsNo subscription? Pay once, from $9
