W API de Weydub

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.

  1. Obtén accesoInicia sesión, activa gratis el acceso a la API desde Mi cuenta y confirma las funciones disponibles para tu cuenta.
  2. Consulta la referenciaComprueba los endpoints, la estructura de las solicitudes, los campos de estado y las notas de solución de problemas.
  3. Ejecuta el inicio rápidoCrea una tarea de demostración con variables de entorno y firma con JSON compacto.
  4. 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.

01

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.crf si está habilitado
02

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
03

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
04

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.

Límites de vídeoLos límites máximos actuales son 15 minutos y 1000 MB por archivo de vídeo. Divide o comprime el archivo antes de enviarlo.
Límites de imagenMáximo de 2000 × 2000 px y 50 MB. Formatos compatibles: png, jpeg, jpg, bmp y webp. Las URL no deben contener caracteres chinos.
FacturaciónLos flujos de vídeo se facturan en unidades de 30 segundos. Los servicios combinados pueden acumular costes. Las tareas que terminan con error no descuentan créditos.
CallbacksVerifica Callback-Sign. Devuelve HTTP 200 y un cuerpo no vacío después de almacenar los datos de forma persistente. Los callbacks fallidos se reintentan durante 24 horas, aproximadamente cada 30 minutos.

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.

Desarrolladores que usan herramientas de programación con IA Lee la introducción, copia el Markdown en el asistente de tu IDE, ejecuta los escenarios de demostración y configura después las credenciales mediante variables de entorno.
Agentes de automatización y bots internos Carga la referencia y el Skill para agentes, crea tareas asíncronas, guarda los identificadores de trabajo, gestiona los callbacks de forma idempotente y no expongas nunca AppSecret.

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.

  1. Acceso gratuitoActiva el acceso a la API desde Mi cuenta y confirma después las funciones disponibles para el flujo de trabajo de destino.
  2. Guarda los secretosUsa WEYDUB_APP_KEY y WEYDUB_APP_SECRET o un gestor de secretos.
  3. Firma exactamenteJSON compacto, firma MD5 doble y, después, envía los mismos bytes del cuerpo.
  4. Crea la tareaEnvía las URL de los recursos multimedia y guarda los identificadores de proyecto, trabajo y tarea que se devuelvan.
  5. Espera de forma seguraUsa callbacks en producción y consultas periódicas como alternativa.
  6. Guarda los resultadosGuarda las URL de salida, los enlaces SRT, los recursos de imagen, el estado y los errores.
  7. Ejecuta las demosVerifica el funcionamiento con recursos oficiales antes de conectar contenido multimedia de clientes.
  8. 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.

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

Introducción a la API de Weydub Markdown listo para herramientas de programación y agentes de automatización.

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.