No subscription? Pay once.From ⁦$9⁩
Leelo

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

API & MCP · 0:30

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

RouteWhat it doesCredits
GET/v1/meYour plan, credits left and storagefree
GET/v1/voicesEvery voice, yours first. ?locale=fr-FR, ?q=, ?limit=, ?after=free
GET/v1/voices/{id}One voicefree
POST/v1/speechText read in a voice → an audio URL. Same text and voice again is free.1 / word · 5 in your own voice
POST/v1/transcriptionsA media URL → lines with times and speakers40 / minute
GET/v1/transcriptions/{id}A transcript you made beforefree
POST/v1/dubsA 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 donefree
POST/v1/soundsA description → sound effects. ?attempts up to 320 / second, at least 100
POST/v1/cleanupsA recording URL → the voice alone, levelled1,300 / minute
POST/v1/writingrewrite · shorten · fix · split · script · translate10 / 500 words
GET/v1/projectsYour Studio projectsfree
GET/v1/projects/{id}A project's lines, speakers and audiofree
POST/v1/projects/{id}/exportsThe whole project as one mastered filefree
GET/v1/filesExports, dubs, clean-ups, sounds. ?kind=free
GET/v1/usageEvery charge, labelled with the key that made itfree
GET/v1/ratesWhat everything costs, in creditsfree
POST/v1/webhooksRegister an address: { url, events }free
GET/v1/webhooksYour webhooks, and every event there isfree
GET/v1/webhooks/deliveriesWhat was sent, and how it wentfree
DELETE/v1/webhooks/{id}Stop sending to an addressfree

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.
Articles & accessibility →
<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.

The API, webhooks and the MCP server come with Pro and Business. The article player works on every plan.

In the same credits as the app, at the same rates: 1 credit a word in a standard voice, 40 a minute of transcription, 5,000 a minute of dubbing for each language. Asking for the same text in the same voice again costs nothing.

Yes. Your cloned and designed voices are listed first by GET /v1/voices and cost 5 credits a word.

Dubs are jobs: POST starts one and returns its id. Either ask GET /v1/dubs/{id}, or register a webhook and receive dub.completed with the file's URL.

Yes. GET /v1/usage lists every charge labelled with the key that made it, and the app's usage page shows the same.

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