Die öffentliche Lumean API — Stimme, Sound und Musik über HTTP

Wie die Pipeline funktioniert

Schlüssel, Berechtigungen, Stimme und Vorlage richten Sie einmal ein. Danach entsteht jeder Auftrag aus einer fertigen Vorlage: Der Server vertont den Text in Chunks, die Dateien erscheinen im Auftrag, und den Download-Link liefert eine eigene Anfrage.

Womit anfangen

• Den Schnellstart machenText zu Sprache, von der Stimmauswahl bis zur heruntergeladenen mp3, Anfrage für Anfrage.Erstes mp3
• Die Referenz öffnenParameter, Antwortfelder und Fehlercodes jeder Operation. Anfragen lassen sich direkt von der Seite senden.Alle Operationen
• Die Grundlagen verstehenSchlüssel und Berechtigungen, Antwortformat, asynchrone Aufträge, Vorlagen, Limits und Abrechnung.Schlüssel, Rechte und Header

Was ein Schlüssel darf

Mit einem API-Schlüssel lassen sich Aufträge von vier Typen erstellen. Auf jeden anderen Typ antwortet die API mit 422 und reason service_not_found.

Ein tts-Auftrag hat kein Feld voice_id. Die Stimme steht in der Vorlage, in config.tts_settings.voice_id, deshalb braucht die Vertonung eine template_id. Vorlagen sind für TTS Pflicht

API-Schlüssel und Doku für KI

Vor der Integration

Was Sie vor der ersten Anfrage wissen sollten. Details stehen in den Leitfäden.

• Die Stimme steht in der Vorlage

  Ein Auftrag hat kein Feld voice_id. Die Stimme steht in config.tts_settings.voice_id der Vorlage, und der Auftrag verweist per template_id auf die Vorlage. Um einen einzelnen Auftrag mit einer anderen Stimme zu vertonen, übergeben Sie config_override.tts_settings.voice_id. Der zu vertonende Text kommt in input_text.

• Aufträge laufen asynchron

  POST /orders antwortet mit 201 und Status created, ein Ergebnis gibt es noch nicht. Den Status erfahren Sie per Abfrage von GET /orders/{order} oder über WebSocket. partially_completed ist kein Endstatus: Ein Teil der Chunks ist fehlgeschlagen, Sie können sie wiederholen oder den Auftrag abbrechen.

• In result.files[] stehen Pfade, keine Links

  Den Download-Link liefert POST /storage/url, er gilt eine Stunde. Die Dateien eines Auftrags werden 7 Tage nach seinem Abschluss aufbewahrt.

• Eine Wiederholung ist ein neuer Auftrag

  POST /orders/{order}/retry erstellt einen neuen Auftrag mit denselben Parametern und wird erneut berechnet. Fehlgeschlagene Chunks werden im ursprünglichen Auftrag wiederholt: POST /orders/{order}/items/retry-failed. POST /orders hat keinen Idempotenzschlüssel, suchen Sie den Auftrag nach einem Verbindungsabbruch deshalb zuerst in der Liste.

• Ein 429 hat mehrere Ursachen

  Das kann das Limit der Anfragerate sein, das Token-Kontingent des Schlüssels, ein Abo-Limit, das Limit gleichzeitiger Aufgaben oder eine Pause nach Sperren durch die Inhaltsrichtlinie. Die Ursache nennt das Feld reason. Enthält die Antwort einen Header Retry-After, warten Sie die angegebene Zeit. concurrency_limit_exceeded kommt ohne ihn und endet, sobald Ihre aktiven Aufträge abgeschlossen sind. limit_exceeded ist das Abo-Limit: Ein erneuter Versuch hilft erst nach dem Zurücksetzen des Zeitraums oder einem Tarifwechsel.

Die erste Anfrage

GET /key erstellt nichts, berechnet nichts und braucht kein Recht, deshalb eignet sich der Aufruf zum Prüfen des Schlüssels. 200 — der Schlüssel funktioniert, die Antwort zeigt seinen Namen und seine Rechte. 401 — der Schlüssel fehlt oder ist ungültig.

{
  "success": true,
  "message": "string",
  "data": {
    "id": "string",
    "name": "string",
    "permissions": [
      "string"
    ],
    "is_active": true,
    "expires_at": "string",
    "limits": {
      "requests": {
        "per_minute": 1,
        "per_hour": 1,
        "per_day": 1
      },
      "tokens": {
        "per_minute": 1,
        "per_hour": 1,
        "per_day": 1,
        "per_month": 1,
        "quota": {
          "limit": 1,
          "used": 1,
          "remaining": 1
        }
      }
    }
  }
}