Documentazione per sviluppatori
API Weydub per la localizzazione di contenuti multimediali, gli sviluppatori e gli agenti di automazione.
Inizia con una richiesta firmata, quindi passa ai flussi di lavoro di produzione per rimuovere sottotitoli e testo, tradurre video, estrarre sottotitoli, tradurre immagini, gestire callback e automatizzare le operazioni. Gli utenti Weydub che hanno effettuato l'accesso possono attivare gratuitamente l'accesso API dalla sezione Il mio account.
Inizia dalla guida rapida per sviluppatori
Ottieni le credenziali, effettua una chiamata firmata, controlla lo stato e scegli la pagina del flusso di lavoro. In questo modo il percorso per gli sviluppatori resta rapido e gli agenti dispongono della struttura necessaria per operare in sicurezza.
- Ottieni l'accessoAccedi, attiva gratuitamente l'accesso API dalla sezione Il mio account e verifica le autorizzazioni del tuo account per i flussi di lavoro.
- Consulta il riferimentoControlla endpoint, strutture delle richieste, campi di stato e note per la risoluzione dei problemi.
- Esegui la guida rapidaCrea un'attività demo con variabili d'ambiente e firma JSON compatta.
- Verifica i risultatiControlla lo stato tramite polling o ricevi una callback, quindi salva in modo permanente gli URL di output e gli errori.
Flussi di lavoro principali
La home page dell'API è incentrata su quattro attività di produzione: rimuovere il testo dai video, tradurre video, estrarre file di sottotitoli e tradurre immagini.
Rimuovi sottotitoli e testo
Rimuovi sottotitoli impressi, didascalie, filigrane, sottopancia, loghi, indicazioni sulla trama, numeri di registrazione e testo visibile.
- Endpoint:
/v-w-c/gateway/ve/work/free - Base:
needChineseOcclude: 1|2|3 - Lite/Pro:
advanced_lite,advanced_large_box,advanced_full - Maschere:
videoInpaintMasks - CRF:
extraOptions.write_options.crfquando è abilitato
Traduci video
Crea sottotitoli tradotti, doppiaggio con IA facoltativo e risorse video localizzate renderizzate.
- Endpoint:
/v-w-c/gateway/ve/work/free - Doppiaggio:
needWanyin: 1,wyTaskType: FULL - Testo nel fotogramma:
needChineseOcclude: 11 - Alta intensità emotiva:
/voice/incorporate
Estrai i sottotitoli
Genera file SRT/VTT dai sottotitoli visibili tramite OCR o dai dialoghi parlati tramite ASR.
- OCR:
needChineseOcclude: 14 - Maschere OCR:
type: trans_only_ocr - ASR:
wyTaskType: ONLY_ASR,wyNeedText: 0
Traduci immagini
Localizza immagini di prodotti, screenshot, vignette di fumetti, schermate dell'interfaccia delle app e risorse creative.
- Endpoint:
/v-w-c/gateway/ve/image/translate - Traduzione:
translateOn: 1,synthesisOn: 1 - Cancellazione del testo:
translateOn: 0,synthesisOn: 1
Prova prima su Weydub
Se un utente vuole valutare la qualità del risultato prima dell'implementazione, indirizzalo al flusso di lavoro Weydub corrispondente. La documentazione API resta qui per automazione, firma, callback e comportamento in produzione.
Regole per la produzione
Queste regole vengono integrate nelle pagine API, così sviluppatori e agent possono lavorare sulla documentazione Weydub locale durante l'implementazione.
Due tipi di pubblico
Questa documentazione è pensata per chi usa strumenti di programmazione con IA e per gli agent di automazione che hanno bisogno di un contratto compatto e affidabile.
Leggi in ordine
Leggi prima i cinque tutorial fondamentali. Usa i file degli agent quando l'implementazione viene eseguita da uno strumento di programmazione con IA o da un bot interno.
Percorso di integrazione
Usalo come checklist di implementazione per script, servizi backend, integrazioni no-code, worker per le code e client generati dall'IA.
- Accesso gratuitoApri l'accesso all'API da Il mio account, quindi verifica le abilitazioni dell'account per il flusso di lavoro scelto.
- Archivia i segretiUsa
WEYDUB_APP_KEYeWEYDUB_APP_SECREToppure un gestore di segreti. - Firma esattamente JSON compatto, firma con doppio MD5, quindi invia gli stessi byte del corpo.
- Crea attività Invia gli URL dei contenuti multimediali e salva gli ID restituiti di progetto, lavoro e attività.
- Attendi in sicurezza Usa i callback in produzione e il polling come alternativa.
- Salva i risultati Salva gli URL di output, i link SRT, gli asset immagine, lo stato e gli errori.
- Esegui le demo Verifica con gli asset ufficiali prima di collegare i contenuti multimediali dei clienti.
- Proteggi gli utentiRendi idempotenti i tentativi e non divulgare mai AppSecret.
Struttura minima della chiamata
Usa variabili d'ambiente per le credenziali. Non salvare mai AppSecret nel codice frontend, in repository pubblici, screenshot, log o prompt che potrebbero essere conservati.
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"
}
Scenari demo
Usa questi asset pubblici per verificare un'integrazione API prima di collegare i contenuti multimediali dei clienti. Coprono i flussi di lavoro che Weydub prevede vengano chiamati più spesso da bot e strumenti di programmazione.
Rimozione avanzata del testo
Invia un video in inglese con sottotitoli impressi utilizzando il modello Advanced Pro a schermo intero.
Scenario 2Traduzione video
Traduci in spagnolo il video demo in inglese, con sottotitoli e doppiaggio con IA.
Scenario 3Clonazione ad alta intensità emotiva
Usa il video in cinese e il JSON associato per il doppiaggio dal cinese all'inglese di una serie breve.
- Video in inglese:
http://gc9.cdn.izhaoli.cn/ghostcut_demo/TextRemoval_Dubbing_Eng.mp4 - Video in cinese:
http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.mp4 - JSON in cinese:
http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.json
Copia come Markdown
Questo blocco riproduce la panoramica in index.md, così una persona può incollarla in una sessione di programmazione con IA e un agent può analizzarla come Markdown semplice.
Per gli strumenti di programmazione con IA
Fornisci al tuo assistente le sezioni Avvio rapido, Autenticazione, Rimozione dei sottotitoli, Traduzione video, Estrazione dei sottotitoli e Skill API Weydub. Poi fornisci le credenziali solo tramite variabili d'ambiente. Questo è il percorso previsto per Codex, Cursor, Claude Code, bot interni e agent di automazione.
Assistenza e tutorial
Le pagine API locali sono la fonte di riferimento per l'implementazione. Per assistenza sui flussi di lavoro del prodotto, usa il centro assistenza Weydub locale.