API Referenz

Diese Referenz bietet Entwicklern und Automatisierungsagenten eine zentrale, kompakte Anlaufstelle für die Endpunkte der Weydub API, Zugriffsprüfungen, Anfragestruktur, asynchrones Verhalten, Abrechnungs- und Aufbewahrungsregeln sowie Hinweise zur Fehlerbehebung.

Grundlagen zu Anfragen

Einige Bezeichnungen aus der Legacy-Infrastruktur können weiterhin in öffentlichen Demo-Assets oder älteren Kontopfaden erscheinen. Betrachten Sie diese Dokumentation zu Weydub API als die aktuell maßgebliche produktseitige Vertragsgrundlage.

Vor dem Aufruf

Authentifizierung

Für die meisten Anfragen werden folgende Header verwendet:

Content-Type: application/json
AppKey: $WEYDUB_APP_KEY
AppSign: md5(md5(request_body) + $WEYDUB_APP_SECRET)

Signieren Sie exakt den kompakten JSON-Body, der gesendet wird. Lesen Sie Authentifizierung und Signierung, bevor Sie Signaturfehler untersuchen.

Ausnahme ohne Signatur:

POST /v-w-c/enum/query2

Der Enum-Abfrageendpunkt wird für dynamische Sprach- und Statuslisten verwendet und erfordert keine Signatur.

Endpunktübersicht

Videoaufgabe erstellen

POST /v-w-c/gateway/ve/work/free

Häufige Workflows mit diesem Endpunkt:

Minimalanfrage:

{
  "urls": ["https://example.com/demo.mp4"],
  "needChineseOcclude": 1,
  "videoInpaintLang": "all",
  "callback": "https://your-domain.example/webhooks/weydub"
}

Typische Felder der Erstellungsantwort:

Videostatus abfragen

POST /v-w-c/gateway/ve/work/status

{
  "idWorks": [488026661]
}

Statuswerte:

Erfolgreiche Videoaufgaben können videoUrl, coverUrl, srcSrtUrl, tgtSrtUrl, sourceVideoUrl, ttsMetaResult, wyVoiceParam und Aufgabenmetadaten enthalten.

Bildaufgaben

Aktueller öffentlicher Endpunkt zum Erstellen:

POST /v-w-c/gateway/ve/image/translate

Endpunkt für die erneute Verarbeitung:

POST /v-w-c/gateway/ve/image/translate/redo

Anfrage zur Bildübersetzung:

{
  "srcLang": "en",
  "tgtLang": "es",
  "translateOn": 1,
  "synthesisOn": 1,
  "commodityFilterOn": 0,
  "downloadInfo": "{\"url\":\"https://example.com/product.png\",\"fileName\":\"product.png\",\"id\":12345,\"materialName\":\"product.png\"}",
  "app": "WD"
}

Anfrage zur Entfernung von Bildtext:

{
  "srcLang": "en",
  "tgtLang": "en",
  "translateOn": 0,
  "synthesisOn": 1,
  "commodityFilterOn": 0,
  "downloadInfo": "{\"url\":\"https://example.com/banner.png\",\"fileName\":\"banner.png\",\"id\":12346,\"materialName\":\"banner.png\"}",
  "app": "WD"
}

Lesen Sie Bildübersetzung, bevor Sie Bildaufgaben implementieren, da downloadInfo, downloadInfos und bei erneuter Verarbeitung result ihr jeweils dokumentiertes Zeichenfolgenformat beibehalten müssen.

Enum-Abfrage

POST /v-w-c/enum/query2

Für diesen Endpunkt ist AppSign nicht erforderlich.

{
  "text": "Lang"
}

Gängige Enum-Namen:

Abrechnung, Grenzwerte und Aufbewahrung

Callback-Zusammenfassung

Übergeben Sie bei unterstützten Erstellungsanfragen eine callback-URL. Weydub sendet das abgeschlossene Arbeitselement direkt an Ihren Server, ohne den äußeren code- / msg- / body-Wrapper, der bei Polling-Antworten verwendet wird.

Regeln für die Callback-Verarbeitung:

• Verifizieren Sie Callback-Sign mithilfe des unveränderten Bodys der Callback-Anfrage und Ihres AppSecret.
• Geben Sie HTTP 200 zusammen mit einem beliebigen nicht leeren Body erst zurück, nachdem die dauerhafte Speicherung erfolgreich war.
• Stellen Sie anhand der Work-/Task-ID sicher, dass Handler idempotent sind.
• Bei fehlgeschlagenen Callbacks für Aufgaben, die innerhalb der letzten 24 Stunden erstellt wurden, erfolgt etwa alle 30 Minuten ein erneuter Zustellversuch.
• Wenn eine erneute Ausführung Video- oder Bildinhalte ändert, kann sich die Ausgabe-URL ändern; speichern Sie die neueste Ergebnis-URL.

Weitere Einzelheiten zu Callbacks finden Sie unter Asynchrones Aufgabenmodell.

Fehlerbehebung

Agentenvertrag

Automatisierungsagenten sollten:

• Laden Sie llms.txt und Weydub API Skill.
• Verwenden Sie Demoszenarien vor Kundenmedien.
• Bewahren Sie Zugangsdaten in Umgebungsvariablen oder einem Secret-Manager auf.
• Speichern Sie IDs dauerhaft, bevor Sie den Benutzern den Erfolg melden.
• Modellieren Sie Jobs als submitted -> processing -> succeeded | failed | timed_out.
• Legen Sie AppSecret niemals offen und erfinden Sie keine freigeschalteten Endpunkte.