W API Weydub

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.

  1. 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.
  2. Consulta il riferimentoControlla endpoint, strutture delle richieste, campi di stato e note per la risoluzione dei problemi.
  3. Esegui la guida rapidaCrea un'attività demo con variabili d'ambiente e firma JSON compatta.
  4. 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.

01

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.crf quando è abilitato
02

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
03

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
04

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.

Limiti videoI limiti massimi attuali sono 15 minuti e 1000 MB per file video. Dividi o comprimi il file prima dell'invio.
Limiti immaginiMassimo 2000*2000 px e 50 MB. Formati supportati: png, jpeg, jpg, bmp, WEBP. Gli URL non devono contenere caratteri cinesi.
FatturazioneI flussi video vengono fatturati in unità da 30 secondi. I servizi combinati possono sommare i costi. Le attività definitivamente non riuscite detraggono zero crediti.
CallbackVerifica Callback-Sign. Restituisci HTTP 200 e un corpo non vuoto dopo l'archiviazione persistente. I callback non riusciti vengono ritentati per 24 ore, circa ogni 30 minuti.

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.

Sviluppatori che usano strumenti di programmazione con IA Leggi la panoramica, copia il Markdown nell'assistente del tuo IDE, esegui gli scenari demo, quindi configura le credenziali tramite variabili d'ambiente.
Agent di automazione e bot interni Carica il riferimento per gli agent e la skill, crea attività asincrone, salva gli ID dei lavori, gestisci i callback in modo idempotente e non esporre mai AppSecret.

Percorso di integrazione

Usalo come checklist di implementazione per script, servizi backend, integrazioni no-code, worker per le code e client generati dall'IA.

  1. Accesso gratuitoApri l'accesso all'API da Il mio account, quindi verifica le abilitazioni dell'account per il flusso di lavoro scelto.
  2. Archivia i segretiUsa WEYDUB_APP_KEY e WEYDUB_APP_SECRET oppure un gestore di segreti.
  3. Firma esattamente JSON compatto, firma con doppio MD5, quindi invia gli stessi byte del corpo.
  4. Crea attività Invia gli URL dei contenuti multimediali e salva gli ID restituiti di progetto, lavoro e attività.
  5. Attendi in sicurezza Usa i callback in produzione e il polling come alternativa.
  6. Salva i risultati Salva gli URL di output, i link SRT, gli asset immagine, lo stato e gli errori.
  7. Esegui le demo Verifica con gli asset ufficiali prima di collegare i contenuti multimediali dei clienti.
  8. 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.

  • 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.

Panoramica dell'API Weydub Markdown pronto per gli strumenti di programmazione e gli agent di automazione.

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.