Zum Hauptinhalt springen

Dubly-API: Dokumentation, Token und Möglichkeiten

So findest du die API-Dokumentation von Dubly, erstellst ein API-Token und siehst, was die öffentliche API kann: Dubs anlegen, Status abfragen, Lip-Sync starten.

Mit der öffentlichen API von Dubly legst du Dubs aus deinen eigenen Tools an und holst die fertigen Videos ab. Jedes Dubly-Konto kann sie nutzen. Die vollständige Dokumentation findest du in der App unter Settings → API. Dieser Artikel zeigt dir den Einstieg und was die API abdeckt.


Wo du die Dokumentation findest

Öffne Settings → API und scrolle unter deinen Tokens zu API Documentation. Dort findest du:

  • Authentifizierung, Basis-URL und Antwortformat

  • Alle Endpunkte mit Parametern und Beispielen zum Kopieren

  • Fehlercodes

  • Unterstützte Zielsprachen

Dafür musst du eingeloggt sein. Die Dokumentation gibt es nur auf Englisch.


API-Token erstellen

Nur Owner und Admins können Tokens erstellen und zurückziehen.

  1. Öffne Settings → API.

  2. Klicke auf Generate new token und gib dem Token einen Namen, z. B. „Production“.

  3. Kopiere es sofort. Es wird nur ein einziges Mal angezeigt und lässt sich später nicht erneut einsehen.

Ein Token bleibt gültig, bis du es zurückziehst. Wer es hat, kann in deinem Konto Dubs anlegen und Credits verbrauchen. Behandle es also wie ein Passwort. Zum Zurückziehen klickst du neben dem Token auf Revoke. Tools, die es nutzen, verlieren dann den Zugriff.


Was die API kann

Die Basis-URL ist https://app.dubly.ai. Jede Anfrage braucht diesen Header: Authorization: Bearer YOUR_API_TOKEN.

Endpunkt

Was er macht

POST /api/v1/dubs/youtube

Legt einen Dub aus einem YouTube-Link an.

POST /api/v1/dubs/url

Legt einen Dub aus einem direkten Link zu einer Videodatei an. Der Link muss die Datei selbst zurückgeben, keine Vorschauseite.

POST /api/v1/dubs/google-drive

Legt einen Dub aus einer einzelnen Google-Drive-Datei an. Die Freigabe muss auf „Jeder, der über den Link verfügt“ stehen, und das Herunterladen muss erlaubt sein.

GET /api/v1/dubs/{id}

Zeigt den Status eines Dubs und, sobald er fertig ist, die Videolinks.

POST /api/v1/dubs/{id}/lipsync

Startet Lip-Sync für eine Zielsprache eines fertigen Dubs.

GET /api/v1/dubs/{id}/lipsync?target_language=de

Zeigt den Lip-Sync-Status und, sobald er fertig ist, den Videolink.

GET /api/v1/projects

Listet deine Projekte auf. Mit einer ID als project_id legst du einen Dub in dieses Projekt.

GET /api/v1/custom-voices

Listet die für dein Konto eingerichteten Custom Voices auf. Die ID verwendest du als custom_voice_id.

Sprachcodes sind die kurzen, zum Beispiel en, de oder fr. Siehe Unterstützte Sprachen und Dialekte.


Beispiel: Dub anlegen und Ergebnis abholen

Dub anlegen:

curl -X POST https://app.dubly.ai/api/v1/dubs/youtube \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"yt_link": "https://www.youtube.com/watch?v=VIDEO_ID",
"source_language": "en",
"target_languages": ["de", "fr"]
}'

Die Antwort enthält die ID des neuen Dubs. Damit fragst du den Status ab:

curl https://app.dubly.ai/api/v1/dubs/DUB_ID \
-H "Authorization: Bearer YOUR_API_TOKEN"

Der Status ist einer von diesen:

Status

Bedeutung

Processing

Der Dub läuft noch.

Dubbed

Der Dub ist fertig. url enthält einen Videolink pro Zielsprache.

Error

Der Dub ist fehlgeschlagen.

Die API hat keine Webhooks. Dein Tool muss den Status also selbst abfragen. Dubs brauchen etwas Zeit (siehe Wie lange dauert das Dubben eines Videos?), du musst also nicht alle paar Sekunden nachsehen.

Über die API angelegte Dubs erscheinen wie alle anderen in deinem Dubly-Konto. Dort kannst du sie prüfen und bearbeiten.


So funktionieren Credits bei der API

  • YouTube und Google Drive: Die vollen Kosten werden beim Anlegen des Dubs abgebucht, abhängig von der Videolänge.

  • Direkte Links: Zum Start wird 1 Credit pro Zielsprache abgebucht, der Rest, sobald die Videolänge feststeht. Reicht dein Guthaben dafür nicht, endet der Dub mit dem Status Error.

  • Zielsprachen: Jede wird einzeln abgerechnet. Siehe Preismodell und Übersetzungskosten.

  • Lip-Sync: 1 Credit pro Videominute und Zielsprache, aufgerundet.

  • Free Trial: Dubs sind wie in der App auf die erste Minute begrenzt.


Was die API nicht kann

  • Dateien direkt hochladen. Das Video muss von einem YouTube-Link, aus einer Google-Drive-Datei oder von einem direkten Link kommen. Siehe Ein Video hochladen: unterstützte Formate.

  • Google-Drive-Ordner verarbeiten. Jede Datei braucht eine eigene Anfrage.

  • Dubs bearbeiten. Übersetzungen und Stimmen bearbeitest du in der App.

  • Untertitel herunterladen. Die API liefert nur Videolinks.

  • Dubs auflisten oder löschen. Du kannst einen Dub nur über seine ID abfragen.


Fehlercodes

Jede Fehlerantwort enthält ein Feld message mit dem genauen Grund.

Status

Bedeutung

400

Die Anfrage ist ungültig, z. B. fehlt ein Pflichtfeld, ein Sprachcode ist nicht verfügbar oder der Dub ist noch nicht fertig.

401

Das Token fehlt, ist falsch oder wurde zurückgezogen.

403

Es sind nicht genug Credits vorhanden, oder das Token darf das nicht.

404

Der Dub, das YouTube-Video oder die Google-Drive-Datei wurde nicht gefunden oder ist nicht verfügbar.

409

Lip-Sync läuft bereits, das Audio dafür ist noch nicht bereit, oder ein früherer Lauf ist fehlgeschlagen. Ist ein früherer Lauf fehlgeschlagen, wende dich an den Support.

500

Bei uns ist etwas schiefgelaufen, oder Google Drive war nicht erreichbar. Versuch es später noch einmal.


Viele Videos auf einmal dubben

Die API nimmt pro Video eine Anfrage entgegen. Siehe Mehrere Videos auf einmal dubben. Große oder einmalige Batches können wir für dich übernehmen: Anfrage für ein benutzerdefiniertes Batch-Projekt.

Kommst du nicht weiter? Kontaktiere den Support und nenne die Dub-ID und die Fehlermeldung.

Hat dies deine Frage beantwortet?