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.
Öffne Settings → API.
Klicke auf Generate new token und gib dem Token einen Namen, z. B. „Production“.
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 |
| Legt einen Dub aus einem YouTube-Link an. |
| Legt einen Dub aus einem direkten Link zu einer Videodatei an. Der Link muss die Datei selbst zurückgeben, keine Vorschauseite. |
| 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. |
| Zeigt den Status eines Dubs und, sobald er fertig ist, die Videolinks. |
| Startet Lip-Sync für eine Zielsprache eines fertigen Dubs. |
| Zeigt den Lip-Sync-Status und, sobald er fertig ist, den Videolink. |
| Listet deine Projekte auf. Mit einer ID als |
| Listet die für dein Konto eingerichteten Custom Voices auf. Die ID verwendest du als |
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 |
| Der Dub läuft noch. |
| Der Dub ist fertig. |
| 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 |
| Die Anfrage ist ungültig, z. B. fehlt ein Pflichtfeld, ein Sprachcode ist nicht verfügbar oder der Dub ist noch nicht fertig. |
| Das Token fehlt, ist falsch oder wurde zurückgezogen. |
| Es sind nicht genug Credits vorhanden, oder das Token darf das nicht. |
| Der Dub, das YouTube-Video oder die Google-Drive-Datei wurde nicht gefunden oder ist nicht verfügbar. |
| 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. |
| 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.
