Documentación para desarrolladores
API de Weydub para la localización audiovisual, desarrolladores humanos y agentes de automatización.
Empieza con una solicitud firmada y después pasa a flujos de producción para eliminar subtítulos y texto, traducir vídeos, extraer subtítulos, traducir imágenes, gestionar callbacks y automatizar procesos. Los usuarios de Weydub que hayan iniciado sesión pueden activar gratis el acceso a la API desde Mi cuenta.
Empieza como en una plataforma para desarrolladores
Obtén las credenciales, realiza una llamada firmada, consulta el estado y después elige la página del flujo de trabajo. Así se mantiene ágil el recorrido para las personas y se ofrece a los agentes la estructura necesaria para crear integraciones de forma segura.
- Obtén accesoInicia sesión, activa gratis el acceso a la API desde Mi cuenta y confirma las funciones disponibles para tu cuenta.
- Consulta la referenciaComprueba los endpoints, la estructura de las solicitudes, los campos de estado y las notas de solución de problemas.
- Ejecuta el inicio rápidoCrea una tarea de demostración con variables de entorno y firma con JSON compacto.
- Verifica los resultadosConsulta el estado periódicamente o recibe un callback; después, guarda las URL de salida y los errores.
Flujos de trabajo principales
La página principal de la API se centra en cuatro tareas de producción: eliminar texto de vídeos, traducir vídeos, extraer archivos de subtítulos y traducir imágenes.
Eliminar subtítulos y texto
Limpia subtítulos incrustados, subtítulos descriptivos, marcas de agua, rótulos inferiores, logotipos, pistas de la trama, números de registro y texto visible.
- Endpoint:
/v-w-c/gateway/ve/work/free - Básico:
needChineseOcclude: 1|2|3 - Lite/Pro:
advanced_lite,advanced_large_box,advanced_full - Máscaras:
videoInpaintMasks - CRF:
extraOptions.write_options.crfsi está habilitado
Traducir vídeo
Crea subtítulos traducidos, doblaje con IA opcional y recursos de vídeo localizados y renderizados.
- Endpoint:
/v-w-c/gateway/ve/work/free - Doblaje:
needWanyin: 1,wyTaskType: FULL - Texto en el fotograma:
needChineseOcclude: 11 - Alta emoción:
/voice/incorporate
Extraer subtítulos
Genera archivos SRT/VTT a partir de subtítulos visibles mediante OCR o de diálogos hablados mediante ASR.
- OCR:
needChineseOcclude: 14 - Máscaras de OCR:
type: trans_only_ocr - ASR:
wyTaskType: ONLY_ASR,wyNeedText: 0
Traducir imágenes
Localiza imágenes de productos, capturas de pantalla, viñetas de cómic, capturas de la interfaz de aplicaciones y recursos creativos.
- Endpoint:
/v-w-c/gateway/ve/image/translate - Traducir:
translateOn: 1,synthesisOn: 1 - Borrar texto:
translateOn: 0,synthesisOn: 1
Pruébalo primero en Weydub
Cuando alguien quiera comprobar la calidad del resultado antes de implementar la integración, dirígelo al flujo de trabajo correspondiente de Weydub. La documentación de la API se mantiene aquí para la automatización, la firma, los callbacks y el comportamiento en producción.
Reglas de producción
Estas reglas se incluyen en las páginas de la API para que los desarrolladores y los agentes puedan trabajar con la documentación local de Weydub durante la implementación.
Dos públicos
Esta documentación está escrita para personas que utilizan herramientas de programación con IA y para agentes de automatización que necesitan un contrato compacto y fiable.
Leer en orden
Lee primero los cinco tutoriales principales. Utiliza los archivos para agentes cuando una herramienta de programación con IA o un bot interno se encargue de la implementación.
Ruta de integración
Úsala como lista de comprobación de implementación para scripts, servicios de backend, integraciones sin código, workers de colas y clientes generados con IA.
- Acceso gratuitoActiva el acceso a la API desde Mi cuenta y confirma después las funciones disponibles para el flujo de trabajo de destino.
- Guarda los secretosUsa
WEYDUB_APP_KEYyWEYDUB_APP_SECRETo un gestor de secretos. - Firma exactamenteJSON compacto, firma MD5 doble y, después, envía los mismos bytes del cuerpo.
- Crea la tareaEnvía las URL de los recursos multimedia y guarda los identificadores de proyecto, trabajo y tarea que se devuelvan.
- Espera de forma seguraUsa callbacks en producción y consultas periódicas como alternativa.
- Guarda los resultadosGuarda las URL de salida, los enlaces SRT, los recursos de imagen, el estado y los errores.
- Ejecuta las demosVerifica el funcionamiento con recursos oficiales antes de conectar contenido multimedia de clientes.
- Protege a los usuariosHaz que los reintentos sean idempotentes y no filtres nunca AppSecret.
Estructura mínima de la llamada
Usa variables de entorno para las credenciales. No guardes nunca AppSecret en código de frontend, repositorios públicos, capturas de pantalla, registros ni prompts que puedan conservarse.
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"
}
Escenarios de demostración
Usa estos recursos públicos para verificar una integración de la API antes de conectar contenido multimedia de clientes. Cubren los flujos de trabajo que Weydub espera que los bots y las herramientas de programación invoquen con mayor frecuencia.
Eliminación avanzada de texto
Envía un vídeo en inglés con subtítulos incrustados y utiliza el modelo Advanced Pro de pantalla completa.
Escenario 2Traducción de vídeo
Traduce el vídeo de demostración en inglés al español con subtítulos y doblaje con IA.
Escenario 3Clonación de alta emoción
Usa el vídeo en chino y el JSON asociado para doblar del chino al inglés un drama corto.
- Vídeo en inglés:
http://gc9.cdn.izhaoli.cn/ghostcut_demo/TextRemoval_Dubbing_Eng.mp4 - Vídeo en chino:
http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.mp4 - JSON en chino:
http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.json
Copiar como Markdown
Este bloque reproduce la introducción de index.md, para que una persona pueda pegarlo en una sesión de programación con IA y un agente pueda analizarlo como Markdown sin formato.
Para herramientas de programación con IA
Proporciona a tu asistente el Inicio rápido, Autenticación, Eliminación de subtítulos, Traducción de vídeo, Extracción de subtítulos y Weydub API Skill. Después, proporciona las credenciales únicamente mediante variables de entorno. Esta es la ruta prevista para Codex, Cursor, Claude Code, bots internos y agentes de automatización.
Ayuda y tutoriales
Las páginas locales de la API son la referencia canónica para la implementación. Para obtener ayuda sobre los flujos de producto, utiliza el centro de ayuda local de Weydub.