Leelo

Développeurs · API

Tout ce que fait Leelo, derrière une clé.

Voix, doublage, transcription, effets sonores et nettoyage audio via une simple API REST. Des webhooks vous préviennent quand les tâches longues sont terminées, et un serveur MCP permet aux assistants IA d’utiliser Leelo directement.

Obtenir une clé d’APIVoir les endpoints

API, webhooks et MCP avec Pro et Business

API et MCP · 0:32

01Endpoints

Chaque route, et ce qu’elle coûte.

Du JSON en entrée, du JSON en sortie, une clé par application dans un en-tête Authorization. URL de base : https://api.leelo-ai.com

RouteCe qu’elle faitCrédits
GET/v1/meVotre formule, vos crédits restants et votre stockagegratuit
GET/v1/voicesToutes les voix, les vôtres d’abord. ?locale=fr-FR, ?q=, ?limit=, ?after=gratuit
GET/v1/voices/{id}Une voixgratuit
POST/v1/speechUn texte lu par une voix → une URL audio. Le même texte avec la même voix, une seconde fois, est gratuit.1 / mot · 5 avec votre propre voix
POST/v1/transcriptionsUne URL de média → des lignes avec minutage et intervenants40 / minute
GET/v1/transcriptions/{id}Une transcription faite précédemmentgratuit
POST/v1/dubsUne URL de média vers une autre langue. Renvoie une tâche, qui se termine d’elle-même.5 000 / minute, par langue
GET/v1/dubs/{id}Où en est un doublage, et son URL une fois terminégratuit
POST/v1/soundsUne description → des effets sonores. ?attempts jusqu’à 320 / seconde, 100 minimum
POST/v1/cleanupsL’URL d’un enregistrement → la voix seule, nivelée1 300 / minute
POST/v1/writingrewrite · shorten · fix · split · script · translate10 / 500 mots
GET/v1/projectsVos projets du Studiogratuit
GET/v1/projects/{id}Les lignes, les intervenants et l’audio d’un projetgratuit
POST/v1/projects/{id}/exportsTout le projet en un seul fichier masteriségratuit
GET/v1/filesExports, doublages, nettoyages, sons. ?kind=gratuit
GET/v1/usageChaque débit, étiqueté avec la clé qui l’a effectuégratuit
GET/v1/ratesLe prix de chaque chose, en créditsgratuit
POST/v1/webhooksEnregistrer une adresse : { url, events }gratuit
GET/v1/webhooksVos webhooks, et tous les événements existantsgratuit
GET/v1/webhooks/deliveriesCe qui a été envoyé, et comment ça s’est passégratuit
DELETE/v1/webhooks/{id}Arrêter les envois vers une adressegratuit

02Webhooks

Soyez prévenu quand c’est fini.

Enregistrez une adresse et les événements qui vous intéressent. Chaque envoi est signé, renvoyé si votre serveur est indisponible, et journalisé pour que vous voyiez ce qui a été envoyé.

  • dub.completedUn doublage est terminé ; le payload contient son URL
  • dub.failedUn doublage n’a pas pu être terminé ; ses crédits sont rendus
  • transcription.completedUne transcription est prête
  • export.completedL’export d’un projet est prêt à être téléchargé
  • credits.lowLes crédits du mois commencent à manquer
  • credits.depletedLes crédits du mois sont épuisés

Chaque requête porte Leelo-Signature: t=…,v1=…, un HMAC-SHA256 de `${t}.${body}` calculé avec le secret de votre webhook. Les envois en échec sont retentés sept fois sur un jour et demi.

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 dans votre assistant IA.

Connectez Claude, Cursor ou n’importe quel client MCP et demandez simplement : lis ce texte avec une voix britannique chaleureuse, double cette vidéo en espagnol. Il utilise une clé d’API et les mêmes crédits, et chaque appel apparaît dans votre consommation.

Claude Code

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

Cursor, Windsurf et autres clients

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

04Lecteur d’articles

« Écouter cet article », en une ligne.

Publiez n’importe quel export sous forme de lecteur, à vos couleurs, avec un thème clair ou sombre, puis collez une ligne de HTML dans votre page. Avec toutes les formules, sans clé d’API.

Apparence
Votre couleur d’accent, en clair ou en sombre, avec une forme d’onde et un réglage de vitesse.
Légèreté
Chargement différé, et l’audio seulement quand quelqu’un appuie sur lecture.
Statistiques
Les écoutes sont comptées, avec une notification quand un lecteur franchit un cap.
Articles et accessibilité →
<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

Avant de vous lancer.

L’API, les webhooks et le serveur MCP sont inclus dans Pro et Business. Le lecteur d’articles fonctionne avec toutes les formules.

Avec les mêmes crédits que l’application, aux mêmes tarifs : 1 crédit par mot avec une voix standard, 40 par minute de transcription, 5 000 par minute de doublage et par langue. Redemander le même texte avec la même voix ne coûte rien.

Oui. Vos voix clonées et créées apparaissent en premier dans GET /v1/voices et coûtent 5 crédits par mot.

Les doublages sont des tâches : un POST en lance une et renvoie son id. Interrogez GET /v1/dubs/{id}, ou enregistrez un webhook et recevez dub.completed avec l’URL du fichier.

Oui. GET /v1/usage liste chaque débit avec la clé qui l’a effectué, et la page Usage de l’application affiche la même chose.

Construisez avec Leelo.

Commencez gratuitement, puis passez à Pro quand vous êtes prêt à obtenir une clé. Les mêmes crédits, les mêmes voix que dans l’application.

Commencer gratuitement : 1 000 crédits