Leelo

Entwickler · API

Alles, was Leelo kann, hinter einem Schlüssel.

Sprache, Synchronisation, Transkription, Soundeffekte und Bereinigung über eine schlichte REST-API. Webhooks melden dir, wenn lange Jobs fertig sind, und über einen MCP-Server nutzen KI-Assistenten Leelo direkt.

API-Schlüssel holenEndpunkte ansehen

API, Webhooks und MCP bei Pro und Business

API & MCP · 0:34

01Endpunkte

Jede Route und was sie kostet.

JSON rein, JSON raus, ein Schlüssel pro App im Authorization-Header. Basis-URL: https://api.leelo-ai.com

RouteWas sie machtCredits
GET/v1/meDein Tarif, verbleibende Credits und Speicherkostenlos
GET/v1/voicesAlle Stimmen, deine zuerst. ?locale=fr-FR, ?q=, ?limit=, ?after=kostenlos
GET/v1/voices/{id}Eine Stimmekostenlos
POST/v1/speechText, gelesen von einer Stimme → eine Audio-URL. Derselbe Text mit derselben Stimme ist beim zweiten Mal kostenlos.1 / Wort · 5 mit deiner eigenen Stimme
POST/v1/transcriptionsEine Medien-URL → Zeilen mit Zeiten und Sprechern40 / Minute
GET/v1/transcriptions/{id}Ein Transkript, das du schon erstellt hastkostenlos
POST/v1/dubsEine Medien-URL in eine andere Sprache. Gibt einen Job zurück, der von selbst fertig wird.5.000 / Minute, pro Sprache
GET/v1/dubs/{id}Wie weit eine Synchronisation ist, und ihre URL, sobald sie fertig istkostenlos
POST/v1/soundsEine Beschreibung → Soundeffekte. ?attempts bis 320 / Sekunde, mindestens 100
POST/v1/cleanupsEine Aufnahme-URL → nur die Stimme, mit ausgeglichenem Pegel1.300 / Minute
POST/v1/writingrewrite · shorten · fix · split · script · translate10 / 500 Wörter
GET/v1/projectsDeine Studio-Projektekostenlos
GET/v1/projects/{id}Zeilen, Sprecher und Audio eines Projektskostenlos
POST/v1/projects/{id}/exportsDas ganze Projekt als eine gemasterte Dateikostenlos
GET/v1/filesExporte, Synchronisationen, Bereinigungen, Sounds. ?kind=kostenlos
GET/v1/usageJede Abbuchung, mit dem Schlüssel, der sie ausgelöst hatkostenlos
GET/v1/ratesWas alles kostet, in Creditskostenlos
POST/v1/webhooksEine Adresse registrieren: { url, events }kostenlos
GET/v1/webhooksDeine Webhooks und alle verfügbaren Eventskostenlos
GET/v1/webhooks/deliveriesWas gesendet wurde und wie es liefkostenlos
DELETE/v1/webhooks/{id}Keine Zustellungen mehr an eine Adressekostenlos

02Webhooks

Erfahr es, sobald es fertig ist.

Registrier eine Adresse und die Events, die dich interessieren. Jede Zustellung ist signiert, wird wiederholt, wenn dein Server nicht erreichbar ist, und protokolliert, damit du siehst, was gesendet wurde.

  • dub.completedEine Synchronisation ist fertig; der Payload enthält ihre URL
  • dub.failedEine Synchronisation konnte nicht fertiggestellt werden; die Credits sind zurück
  • transcription.completedEin Transkript ist fertig
  • export.completedEin Projektexport steht zum Download bereit
  • credits.lowDie Credits des Monats werden knapp
  • credits.depletedDie Credits des Monats sind aufgebraucht

Jede Anfrage enthält Leelo-Signature: t=…,v1=…, einen HMAC-SHA256 von `${t}.${body}` mit dem Secret deines Webhooks. Fehlgeschlagene Zustellungen werden innerhalb von anderthalb Tagen siebenmal wiederholt.

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 in deinem KI-Assistenten.

Verbinde Claude, Cursor oder einen anderen MCP-Client und frag in ganz normalen Worten: Lies das mit einer warmen deutschen Stimme vor, synchronisiere dieses Video auf Spanisch. Das läuft über einen API-Schlüssel und dieselben Credits, und jeder Aufruf erscheint in deiner Nutzung.

Claude Code

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

Cursor, Windsurf und andere Clients

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

04Artikel-Player

„Artikel anhören“, in einer Zeile.

Veröffentliche jeden Export als Player in deinen Farben, mit hellem oder dunklem Design, und füg dann eine Zeile HTML in deine Seite ein. In jedem Tarif, ohne API-Schlüssel.

Aussehen
Deine Akzentfarbe, hell oder dunkel, mit Wellenform und Tempoeinstellung.
Ladezeit
Lädt erst bei Bedarf, und das Audio erst, wenn jemand auf Play drückt.
Zahlen
Wiedergaben werden gezählt, mit einer Benachrichtigung, wenn ein Player einen Meilenstein erreicht.
Artikel & Barrierefreiheit →
<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>

05Fragen

Bevor du loslegst.

API, Webhooks und der MCP-Server sind bei Pro und Business dabei. Der Artikel-Player funktioniert in jedem Tarif.

In denselben Credits wie die App, zu denselben Preisen: 1 Credit pro Wort mit einer Standardstimme, 40 pro Minute Transkription, 5.000 pro Minute Synchronisation und Sprache. Fragst du denselben Text noch einmal mit derselben Stimme an, kostet das nichts.

Ja. Deine geklonten und gestalteten Stimmen stehen bei GET /v1/voices ganz oben und kosten 5 Credits pro Wort.

Synchronisationen sind Jobs: POST startet einen und gibt seine ID zurück. Frag entweder GET /v1/dubs/{id} ab, oder registrier einen Webhook und empfange dub.completed mit der URL der Datei.

Ja. GET /v1/usage listet jede Abbuchung mit dem Schlüssel auf, der sie ausgelöst hat, und die Nutzungsseite der App zeigt dasselbe.

Bau es mit Leelo.

Starte kostenlos und wechsle zu Pro, sobald du einen Schlüssel brauchst. Dieselben Credits, dieselben Stimmen wie in der App.

Kostenlos starten: 1.000 Credits