Riferimento API

Questo riferimento offre a sviluppatori e agenti di automazione un unico punto di consultazione compatto in cui trovare gli endpoint API di Weydub, i controlli di accesso, la struttura delle richieste, il comportamento asincrono, le regole di fatturazione e conservazione e gli indicatori per la risoluzione dei problemi.

Nozioni di base sulle richieste

Alcuni nomi dell'infrastruttura legacy potrebbero ancora comparire nelle risorse demo pubbliche o nei percorsi degli account meno recenti. Considerare questa documentazione API di Weydub come il contratto attualmente valido per il prodotto.

Prima di effettuare una chiamata

Autenticazione

La maggior parte delle richieste usa le seguenti intestazioni:

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

Firma il corpo JSON compatto esattamente come verrà inviato. Leggi Autenticazione e firma prima di eseguire il debug degli errori di firma.

Eccezione senza firma:

POST /v-w-c/enum/query2

L'endpoint di interrogazione delle enumerazioni viene utilizzato per gli elenchi dinamici di lingue e stati e non richiede la firma.

Indice degli endpoint

Creare un'attività video

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

Flussi di lavoro comuni che utilizzano questo endpoint:

Richiesta minima:

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

Campi tipici della risposta alla creazione:

Interrogazione dello stato del video

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

{
  "idWorks": [488026661]
}

Valori di stato:

Le attività video completate correttamente possono includere videoUrl, coverUrl, srcSrtUrl, tgtSrtUrl, sourceVideoUrl, ttsMetaResult, wyVoiceParam e i metadati dell'attività.

Attività relative alle immagini

Endpoint pubblico attuale per la creazione:

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

Endpoint di riesecuzione:

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

Richiesta di traduzione dell'immagine:

{
  "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"
}

Richiesta di rimozione del testo dall'immagine:

{
  "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"
}

Leggere Traduzione delle immagini prima di implementare le attività relative alle immagini, poiché downloadInfo, downloadInfos e result per la riesecuzione devono mantenere il formato stringa documentato.

Interrogazione degli enum

POST /v-w-c/enum/query2

Questo endpoint non richiede AppSign.

{
  "text": "Lang"
}

Nomi comuni degli enum:

Fatturazione, limiti e conservazione

Riepilogo dei callback

Specificare un URL di callback nelle richieste di creazione, quando supportato. Weydub invia l'elemento di lavoro completato direttamente al server, senza la struttura esterna code / msg / body utilizzata dalle risposte di polling.

Regole per la gestione dei callback:

• Verificare Callback-Sign utilizzando il corpo non elaborato della richiesta di callback e il proprio AppSecret.
• Restituire HTTP 200 insieme a un qualsiasi corpo non vuoto solo dopo che l'archiviazione persistente è stata completata correttamente.
• Rendere i gestori idempotenti in base all'ID del lavoro o dell'attività.
• I callback non riusciti relativi ad attività create nelle ultime 24 ore vengono ritentati all'incirca ogni 30 minuti.
• Se una riesecuzione modifica il contenuto del video o dell'immagine, l'URL di output può cambiare; archiviare l'URL più recente del risultato.

Consultare Modello delle attività asincrone per i dettagli sui callback.

Risoluzione dei problemi

Contratto per gli agenti

Gli agenti di automazione dovrebbero:

• Caricare llms.txt e Skill API di Weydub.
• Utilizzare Scenari demo prima di usare contenuti multimediali dei clienti.
• Conservare le credenziali nelle variabili di ambiente o in un gestore di segreti.
• Salvare in modo persistente gli ID prima di comunicare agli utenti l'esito positivo.
• Modellare le attività come submitted -> processing -> succeeded | failed | timed_out.
• Non esporre mai AppSecret né inventare endpoint abilitati.