Entwicklerdokumentation

Weydub API für Medienlokalisierung, menschliche Entwickler und Automatisierungsagenten.

Beginnen Sie mit einer signierten Anfrage und wechseln Sie anschließend zu Produktions-Workflows für die Entfernung von Untertiteln und Text, die Videoübersetzung, die Untertitel-Extraktion, die Bildübersetzung, Callbacks und Automatisierung. Angemeldete Weydub-Nutzer können den API Zugriff kostenlos unter „Mein Konto“ aktivieren.

Kostenlosen API Zugriff aktivieren API Schlüssel verwalten Erste Anfrage ausführen API Referenz öffnen Markdown-Dokumentation kopieren Agent-Skill öffnen

Basis-URL https://api.zhaoli.com

Authentifizierung AppKey plus AppSign. Behalten Sie AppSecret serverseitig.

Zugriff Kostenlosen API Zugriff öffnen oder API Schlüssel verwalten in Mein Konto; bestätigen Sie vor dem Produktionseinsatz die Bild-API, die Entfernung von Advanced Lite/Pro, Dubbing mit hoher emotionaler Intensität und Batch-Limits.

Asynchron Erstellen Sie eine Aufgabe, speichern Sie die IDs und verwenden Sie anschließend einen Callback oder Polling, um den Abschluss zu erkennen.

Agenten Laden llms.txt und weydub-api-skill.md vor der Implementierung.

Starten wie eine Entwicklerplattform

Holen Sie sich Zugangsdaten, führen Sie einen signierten Aufruf aus, prüfen Sie den Status und wählen Sie anschließend die Workflow-Seite. So bleibt der Weg für Menschen schnell, während Agenten genügend Struktur erhalten, um sicher zu entwickeln.

Zugang erhaltenMelden Sie sich an, öffnen Sie den API Zugriff kostenlos über „Mein Konto“ und bestätigen Sie die Workflow-Berechtigungen für Ihr Konto.
Referenz lesenPrüfen Sie Endpunkte, Anfrageformate, Statusfelder und Hinweise zur Fehlerbehebung.
Schnellstart ausführenErstellen Sie eine Demoaufgabe mit Umgebungsvariablen und kompakter JSON Signierung.
Ergebnisse überprüfenStatus abfragen oder einen Callback empfangen und anschließend Ausgabe-URLs und Fehler speichern.

Zentrale Workflows

Die API Startseite konzentriert sich auf vier Aufgaben für den Produktionseinsatz: Text aus Videos bereinigen, Videos übersetzen, Untertiteldateien extrahieren und Bilder übersetzen.

Untertitel und Text entfernen

Eingebrannte Untertitel, Captions, Wasserzeichen, Bauchbinden, Logos, Handlungshinweise, Registrierungsnummern und sichtbaren Text bereinigen.

Endpunkt: /v-w-c/gateway/ve/work/free
Basic: needChineseOcclude: 1|2|3
Lite/Pro: advanced_lite, advanced_large_box, advanced_full
Masken: videoInpaintMasks
CRF: extraOptions.write_options.crf wenn aktiviert

API Dokumentation lesen Entfernung online testen

Video übersetzen

Erstellen Sie übersetzte Untertitel, optionales AI Dubbing und gerenderte lokalisierte Video-Assets.

Endpunkt: /v-w-c/gateway/ve/work/free
Synchronisation: needWanyin: 1, wyTaskType: FULL
Text im Bild: needChineseOcclude: 11
Starke Emotionen: /voice/incorporate

API Dokumentation lesen Videotranslation ausprobieren

Untertitel extrahieren

SRT/VTT aus sichtbaren Untertiteln per OCR oder aus gesprochenem Dialog per ASR generieren.

OCR: needChineseOcclude: 14
OCR Masken: type: trans_only_ocr
ASR: wyTaskType: ONLY_ASR, wyNeedText: 0

API Dokumentation lesen Untertitelgenerierung testen

Bilder übersetzen

Lokalisieren Sie Produktbilder, Screenshots, Comic-Panels, UI Aufnahmen und kreative Assets.

Endpunkt: /v-w-c/gateway/ve/image/translate
Übersetzen: translateOn: 1, synthesisOn: 1
Text löschen: translateOn: 0, synthesisOn: 1

API Dokumentation lesen Bildübersetzung ausprobieren

Zuerst in Weydub ausprobieren

Wenn Nutzer die Ausgabequalität vor der Implementierung prüfen möchten, leiten Sie sie zum passenden Weydub-Workflow weiter. Die API Dokumentation bleibt hier für Automatisierung, Signierung, Callbacks und das Verhalten in der Produktion.

Untertitel online entfernenUntertitel- und Textbereinigung in der Web-App validieren. Video übersetzenÜberprüfen Sie Untertitel, Synchronisation und die lokalisierte Videoausgabe. Untertitel generierenTesten Sie OCR oder die visuelle Extraktion von Sprachuntertiteln. Bild übersetzenTesten Sie OCR, das Entfernen, die Übersetzung und die Layout-Synthese.

Produktionsregeln

Diese Regeln werden in die API Seiten übernommen, damit Entwickler und Agenten während der Implementierung mit der lokalen Weydub-Dokumentation arbeiten können.

VideolimitsDie aktuellen festen Limits liegen bei 15 Minuten und 1000MB pro Videodatei. Teilen oder komprimieren Sie die Datei vor der Übermittlung.

BildlimitsMaximal 2000*2000 px und 50MB. Unterstützte Formate: png, jpeg, jpg, bmp, webp. URLs dürfen keine chinesischen Zeichen enthalten.

AbrechnungVideo-Workflows werden in 30-Sekunden-Einheiten abgerechnet. Bei kombinierten Diensten können sich die Kosten summieren. Für endgültig fehlgeschlagene Aufgaben werden null Credits abgezogen.

CallbacksÜberprüfen Sie Callback-Sign. Geben Sie nach der dauerhaften Speicherung HTTP 200 sowie einen nicht leeren Body zurück. Fehlgeschlagene Callbacks werden 24 Stunden lang etwa alle 30 Minuten erneut versucht.

Zwei Zielgruppen

Diese Dokumentation richtet sich an Personen, die AI Coding-Tools verwenden, sowie an Automatisierungsagenten, die einen kompakten, zuverlässigen Vertrag benötigen.

Menschliche Entwickler, die AI Coding-Tools verwenden Lesen Sie den Überblick, kopieren Sie Markdown in Ihren IDE Assistenten, führen Sie die Demoszenarien aus und hinterlegen Sie anschließend die Zugangsdaten über Umgebungsvariablen.

Automatisierungsagenten und interne Bots Laden Sie die Agentenreferenz und den Skill, erstellen Sie asynchrone Aufgaben, speichern Sie die Arbeits-IDs, verarbeiten Sie Callbacks idempotent und geben Sie AppSecret niemals preis.

In dieser Reihenfolge lesen

Lesen Sie zuerst die fünf zentralen Tutorials. Verwenden Sie die Agentendateien, wenn ein AI Coding-Tool oder ein interner Bot die Implementierung übernimmt.

SchnellstartMinimaler Python-Ablauf zum Erstellen und Abfragen einer Aufgabe zur Texterfernung. Authentifizierung und SignierungAppKey, AppSign und die Konvention für doppelte MD5 Signaturen. Untertitel entfernenBasic, Advanced Lite/Pro, Masken, CRF und Payloads zur Entfernung. VideoübersetzungUntertitelübersetzung, Synchronisation, Übersetzung von Bildschirmtexten und Sprachmodi. Untertitel-ExtraktionUntertitel-Extraktion per OCR und ASR mit asynchroner Aufgabenverarbeitung. API ReferenzEndpunktübersicht, Anfrageformat, Statusfelder und Fehlerbehebung. LLM ReferenzKurze Orientierungsdatei für Coding-Assistenten und Bots. Weydub API SkillWiederverwendbare Anweisungen für Codex, Cursor, Claude Code und interne Agenten.

Integrationspfad

Verwenden Sie dies als Implementierungscheckliste für Skripte, Backend-Dienste, No-Code-Bridges, Queue-Worker und von AI-generierte Clients.

Kostenloser ZugriffÖffnen Sie den API Zugriff über My Account und bestätigen Sie anschließend die Kontoberechtigungen für den Ziel-Workflow.
Secrets speichernVerwenden Sie WEYDUB_APP_KEY und WEYDUB_APP_SECRET oder einen Secret-Manager.
Exakt signierenKompaktes JSON, Double-MD5 Signatur, anschließend dieselben Body-Bytes senden.
Aufgabe erstellenMedien-URLs übermitteln und die zurückgegebenen Projekt-, Arbeits- und Aufgaben-IDs speichern.
Sicher abwartenVerwenden Sie in der Produktion Callbacks und als Fallback Polling.
Ergebnisse speichernAusgabe-URLs, SRT Links, Bild-Assets, Status und Fehler speichern.
Demos ausführenPrüfen Sie dies anhand offizieller Assets, bevor Sie Kundenmedien anbinden.
Nutzer schützenGestalten Sie Wiederholungsversuche idempotent und geben Sie AppSecret niemals preis.

Minimale Aufrufstruktur

Verwenden Sie Umgebungsvariablen für Zugangsdaten. Speichern Sie AppSecret niemals in Frontend-Code, öffentlichen Repositories, Screenshots, Protokollen oder Prompts, die möglicherweise gespeichert werden.

POST https://api.zhaoli.com/v-w-c/gateway/ve/work/free
Headers:
  Content-Type: application/json
  AppKey: $WEYDUB_APP_KEY
  AppSign: md5(md5(request_body) + $WEYDUB_APP_SECRET)

Body:
{
  "urls": ["https://example.com/demo.mp4"],
  "needChineseOcclude": 1,
  "videoInpaintLang": "all"
}

Demo-Szenarien

Verwenden Sie diese öffentlichen Ressourcen, um eine API Integration zu überprüfen, bevor Sie Kundenmedien verbinden. Sie decken die Workflows ab, die Weydub zufolge von Bots und Programmiertools am häufigsten aufgerufen werden.

Szenario 1

Erweiterte Textentfernung

Senden Sie ein englischsprachiges Video mit fest eingebrannten Untertiteln und dem erweiterten Pro-Vollbildmodell ein.

Szenario 2

Videoübersetzung

Übersetzen Sie das englische Demo-Video mit Untertiteln und AI Dubbing ins Spanische.

Szenario 3

Hochemotionales Klonen

Verwenden Sie das chinesische Video und das zugehörige JSON für die chinesisch-englische Synchronisation von Kurzdramen.

Englisches Video: http://gc9.cdn.izhaoli.cn/ghostcut_demo/TextRemoval_Dubbing_Eng.mp4
Chinesisches Video: http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.mp4
Chinesisches JSON: http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.json

Als Markdown kopieren

Dieser Block entspricht der Übersicht in index.md, sodass ein Mensch ihn in eine AI Coding-Sitzung einfügen und ein Agent ihn als reines Markdown analysieren kann.

Weydub API – Übersicht Markdown, bereit für Coding-Tools und Automatisierungsagenten.

# Weydub API Dokumentation

Weydub API ist der Einstieg für Entwicklerteams, AI Coding-Tools und Automatisierungsagenten, die Medien lokalisieren möchten, ohne eigene Infrastruktur für OCR, ASR, Inpainting, Übersetzung, Synchronisation oder Rendering zu betreiben. Angemeldete Weydub-Nutzer können den API Zugriff kostenlos unter „My Account“ aktivieren.

## Zentrale Workflows

| Workflow | Verwendung | Hauptendpunkt | Wichtige Felder |
| --- | --- | --- | --- |
| Untertitel und eingeblendeten Text entfernen | Entfernen Sie Untertitel, Wasserzeichen, Bauchbinden, Logos, Handlungshinweise, Registrierungsnummern und anderen sichtbaren Text aus Videos. | `POST /v-w-c/gateway/ve/work/free` | `needChineseOcclude`, `videoInpaintLang`, `videoInpaintMasks`, `extraOptions.extra_inpaint_config` |
| Videos übersetzen | Quelluntertitel erstellen, Dialoge übersetzen, optional mit AI Stimme synchronisieren, sichtbaren Text übersetzen und lokalisierte Video-Assets rendern. | `POST /v-w-c/gateway/ve/work/free` | `needWanyin`, `sourceLang`, `lang`, `wyTaskType`, `wyNeedText`, `wyVoiceParam` |
| Untertitel extrahieren | SRT/VTT Dateien aus sichtbaren Untertiteln per OCR oder aus gesprochenem Audio per ASR erstellen. | `POST /v-w-c/gateway/ve/work/free` | OCR: `needChineseOcclude: 14`; ASR: `wyTaskType: "ONLY_ASR"` |
| Bilder übersetzen | Text in Produktbildern, Screenshots, Comics, App-UI Aufnahmen und Marketingmotiven übersetzen oder entfernen. | `POST /v-w-c/gateway/ve/image/translate` | `srcLang`, `tgtLang`, `translateOn`, `synthesisOn`, `downloadInfo` |

## Workflow-Signale

- Videoentfernung: einfacher Vollbildmodus `needChineseOcclude: 1`; einfacher Bereich `needChineseOcclude: 2`; bewegter Text `needChineseOcclude: 3`; Advanced Lite `advanced_lite`; Advanced Pro mit Begrenzungsrahmen `advanced_large_box`; Advanced Pro im Vollbildmodus `advanced_full`; CRF Überschreibung über `extraOptions.write_options.crf`, sofern aktiviert.
- Videoübersetzung: vollständige Synchronisation `needWanyin: 1`, `wyTaskType: "FULL"`, `wyNeedText: 1`; Übersetzung eingeblendeten Texts `needWanyin: 0`, `needChineseOcclude: 11`; Synchronisation mit hoher Emotionalität `/v-w-c/gateway/ve/work/voice/incorporate`.
- OCR Untertitelextraktion: `needChineseOcclude: 14`, `videoInpaintMasks` mit `type: "trans_only_ocr"`, optionale OCR Bereinigung unter `extraOptions.extra_inpaint_config`.
- ASR Untertitelextraktion: `needWanyin: 1`, `wyTaskType: "ONLY_ASR"`, `needWyEdit: 0`, `wyNeedText: 0`, optional `asr_speaker_detect_on`.
- Bildübersetzung: `translateOn: 1`, `synthesisOn: 1`.
- Entfernen von Bildtext: `translateOn: 0`, `synthesisOn: 1`.
- Bild erneut bearbeiten: `POST /v-w-c/gateway/ve/image/translate/redo`; bearbeiten Sie nur Übersetzungs-, Farb- und Schriftgrößenfelder, sofern der Support nichts anderes bestätigt.

## Zuerst in Weydub testen

- Untertitel online entfernen: https://weydub.com/subtitle-removal/
- Ein Video übersetzen: https://weydub.com/video-translator/
- Untertitel erstellen: https://weydub.com/subtitle-generator/
- Ein Bild übersetzen: https://weydub.com/image-translator/

## In dieser Reihenfolge lesen

1. Schnellstart: https://weydub.com/docs/api/quickstart.md
2. Authentifizierung und Signierung: https://weydub.com/docs/api/auth-and-signing.md
3. Untertitel entfernen: https://weydub.com/docs/api/video-subtitle-removal.md
4. Videoübersetzung: https://weydub.com/docs/api/video-translation.md
5. Untertitel extrahieren: https://weydub.com/docs/api/subtitle-extraction.md
6. Weydub API Skill: https://weydub.com/docs/api/weydub-api-skill.md
7. API Referenz: https://weydub.com/docs/api/api-reference.md

## API Grundlagen

- Basis-URL: `https://api.zhaoli.com`
- Auth-Header: `AppKey`, `AppSign`
- Signatur: `AppSign = md5(md5(request_body) + AppSecret)`
- Endpunkt für nicht signierte Enums: `POST /v-w-c/enum/query2`
- Die meisten Medienaufträge werden asynchron verarbeitet.
- Aktivieren Sie den API Zugriff kostenlos unter „My Account“; bestätigen Sie vor dem Produktiveinsatz die Bild-API, die Entfernung mit Advanced Lite/Pro, die Synchronisation mit hoher Emotionalität und die Batch-Limits.
- Verwenden Sie im Produktiveinsatz Callbacks und als Ausweichlösung Polling.
- Überprüfen Sie den Callback-Header `Callback-Sign`.
- Bewahren Sie `AppSecret` ausschließlich serverseitig auf.

## Limits und Aufbewahrung

- Harte Videobegrenzung: 15 Minuten pro Datei.
- Harte Videobegrenzung: 1000MB pro Datei.
- Harte Bildbegrenzungen: `2000*2000 px`, `50MB`.
- Bildformate: `png`, `jpeg`, `jpg`, `bmp`, `webp`.
- Bild-URLs dürfen keine chinesischen Zeichen enthalten.
- Abrechnungseinheit für Videos: 30 Sekunden.
- Für endgültig fehlgeschlagene Aufträge (`processStatus > 1`) werden null Credits abgezogen.
- Standardmäßig werden Quell- und gerenderte Assets der letzten 30 Tage aufbewahrt. Speichern Sie Ergebnis-URLs/-Assets nach dem Callback.

## Betriebsregeln für Agenten

- Raten Sie niemals Zugangsdaten, die Verfügbarkeit von Endpunkten oder Kontoberechtigungen.
- Platzieren Sie `AppSecret` niemals in Frontend-Code, Browser-Erweiterungen, öffentlichen Repositories, Logs, Screenshots oder dauerhaft gespeicherten Prompts.
- Signieren Sie exakt den kompakten JSON Body, der über die Leitung gesendet wird.
- Behalten Sie verschachtelte Optionen wie `extraOptions`, `wyVoiceParam`, `videoInpaintMasks`, `downloadInfo`, `downloadInfos` und `result` bei der erneuten Bearbeitung genau in der Form bei, die auf der jeweiligen Workflow-Seite angegeben ist.
- Speichern Sie Projekt-IDs, Auftrags-IDs, Bildauftrags-IDs, Quell-URLs, Status, Fehlerdetails und Ergebnis-URLs in Ihrer eigenen Auftragstabelle.
- Verwenden Sie öffentliche Demo-Assets, bevor Sie Kundenmedien anbinden.

Für AI Coding-Tools

Geben Sie Ihrem Assistenten den Schnellstart, die Authentifizierungsdokumentation, die Dokumentation zum Entfernen von Untertiteln, zur Videoübersetzung und zur Untertitel-Extraktion sowie den Weydub API Skill. Stellen Sie Zugangsdaten anschließend ausschließlich über Umgebungsvariablen bereit. Dies ist der vorgesehene Weg für Codex, Cursor, Claude Code, interne Bots und Automatisierungsagenten.

Agent Skill lesen API Referenz öffnen llms.txt öffnen Rohes Skill-Markdown Markdown-Übersicht öffnen

Hilfe und Tutorials

Die lokalen API Seiten sind die maßgebliche Quelle für die Implementierung. Für Hilfe zu Produktabläufen nutzen Sie das lokale Weydub-Hilfezentrum.

Weydub-Hilfe Guthaben- und Abrechnungsregeln Batch-Download Leitfaden für Weydub Studio