Leelo

Desenvolvedores · API

Tudo o que o Leelo faz, a uma chave de distância.

Fala, dublagem, transcrição, efeitos sonoros e limpeza de áudio numa API REST simples. Webhooks avisam quando os trabalhos longos terminam, e um servidor MCP deixa os assistentes de IA usarem o Leelo diretamente.

Criar uma chave de APIVer os endpoints

API, webhooks e MCP nos planos Pro e Business

API e MCP · 0:33

01Endpoints

Cada rota, e quanto ela custa.

Entra JSON, sai JSON, com uma chave por app num cabeçalho Authorization. URL base: https://api.leelo-ai.com

RotaO que fazCréditos
GET/v1/meSeu plano, os créditos restantes e o armazenamentográtis
GET/v1/voicesTodas as vozes, as suas primeiro. ?locale=fr-FR, ?q=, ?limit=, ?after=grátis
GET/v1/voices/{id}Uma vozgrátis
POST/v1/speechTexto lido numa voz → uma URL de áudio. Repetir o mesmo texto na mesma voz é grátis.1 / palavra · 5 na sua própria voz
POST/v1/transcriptionsUma URL de mídia → falas com tempos e falantes40 / minuto
GET/v1/transcriptions/{id}Uma transcrição que você já fezgrátis
POST/v1/dubsUma URL de mídia para outro idioma. Retorna uma tarefa, que termina sozinha.5.000 / minuto, por idioma
GET/v1/dubs/{id}Em que ponto está uma dublagem, e a URL dela quando terminagrátis
POST/v1/soundsUma descrição → efeitos sonoros. ?attempts até 320 / segundo, no mínimo 100
POST/v1/cleanupsUma URL de gravação → só a voz, com o volume nivelado1.300 / minuto
POST/v1/writingrewrite · shorten · fix · split · script · translate10 / 500 palavras
GET/v1/projectsSeus projetos do Studiográtis
GET/v1/projects/{id}As falas, os falantes e o áudio de um projetográtis
POST/v1/projects/{id}/exportsO projeto inteiro num único arquivo masterizadográtis
GET/v1/filesExportações, dublagens, limpezas, sons. ?kind=grátis
GET/v1/usageCada cobrança, identificada com a chave que a fezgrátis
GET/v1/ratesQuanto custa cada coisa, em créditosgrátis
POST/v1/webhooksRegistre um endereço: { url, events }grátis
GET/v1/webhooksSeus webhooks, e todos os eventos que existemgrátis
GET/v1/webhooks/deliveriesO que foi enviado, e como foigrátis
DELETE/v1/webhooks/{id}Parar de enviar para um endereçográtis

02Webhooks

Saiba na hora em que ficar pronto.

Registre um endereço e os eventos que interessam a você. Cada entrega é assinada, reenviada se o seu servidor estiver fora do ar e registrada, para você ver o que foi enviado.

  • dub.completedUma dublagem terminou; o payload traz a URL dela
  • dub.failedNão deu para terminar uma dublagem; os créditos voltaram
  • transcription.completedUma transcrição está pronta
  • export.completedA exportação de um projeto está pronta para baixar
  • credits.lowOs créditos do mês estão acabando
  • credits.depletedOs créditos do mês acabaram

Cada requisição traz Leelo-Signature: t=…,v1=…, um HMAC-SHA256 de `${t}.${body}` feito com o segredo do seu webhook. As entregas que falham são reenviadas sete vezes ao longo de um dia e meio.

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

O Leelo dentro do seu assistente de IA.

Conecte o Claude, o Cursor ou qualquer cliente MCP e peça com palavras simples: leia isto numa voz britânica acolhedora, duble este vídeo para o espanhol. Ele usa uma chave de API e os mesmos créditos, e cada chamada aparece no seu histórico de uso.

Claude Code

claude mcp add --transport http leelo https://api.leelo-ai.com/mcp \
  --header "Authorization: Bearer lk_live_…"

Cursor, Windsurf e outros clientes

{
  "mcpServers": {
    "leelo": {
      "url": "https://api.leelo-ai.com/mcp",
      "headers": { "Authorization": "Bearer lk_live_…" }
    }
  }
}

04Player de artigos

“Ouça este artigo”, numa linha só.

Publique qualquer exportação como um player com as suas cores e tema claro ou escuro, e cole uma linha de HTML na sua página. Em todos os planos, sem chave de API.

Visual
A sua cor de destaque, claro ou escuro, com forma de onda e controle de velocidade.
Peso
Carrega sob demanda, e o áudio só quando o leitor aperta o play.
Números
As reproduções são contadas, e você recebe uma notificação quando um player passa de um marco.
Artigos e acessibilidade →
<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>

05Perguntas

Antes de integrar.

A API, os webhooks e o servidor MCP vêm com os planos Pro e Business. O player de artigos funciona em todos os planos.

Nos mesmos créditos do app, com os mesmos preços: 1 crédito por palavra numa voz padrão, 40 por minuto de transcrição, 5.000 por minuto de dublagem em cada idioma. Pedir o mesmo texto na mesma voz de novo não custa nada.

Sim. As suas vozes clonadas e criadas aparecem primeiro em GET /v1/voices e custam 5 créditos por palavra.

Dublagens são tarefas: o POST inicia uma e retorna o id dela. Consulte GET /v1/dubs/{id} ou registre um webhook e receba dub.completed com a URL do arquivo.

Sim. GET /v1/usage lista cada cobrança identificada com a chave que a fez, e a página Usage do app mostra o mesmo.

Construa com o Leelo.

Comece grátis e mude para o Pro quando precisar de uma chave. Os mesmos créditos e as mesmas vozes do app.

Comece grátis: 1.000 créditos