Referencia de la API

Esta referencia ofrece a desarrolladores y agentes de automatización un único lugar conciso donde consultar los endpoints de la API de Weydub, las comprobaciones de acceso, la estructura de las solicitudes, el comportamiento asíncrono, las reglas de facturación y retención y las señales para solucionar problemas.

Fundamentos de las solicitudes

Es posible que algunos nombres de infraestructura heredada sigan apareciendo en recursos públicos de demostración o en rutas antiguas de cuentas. Considera esta documentación de la API de Weydub como el contrato vigente de cara al producto.

Antes de realizar una llamada

Autenticación

La mayoría de las solicitudes usan estos encabezados:

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

Firma el cuerpo JSON compacto exacto que se enviará. Lee Autenticación y firma antes de depurar errores de firma.

Excepción sin firma:

POST /v-w-c/enum/query2

El endpoint de consulta de enumeraciones se utiliza para obtener listas dinámicas de idiomas y estados y no requiere firma.

Índice de endpoints

Crear una tarea de vídeo

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

Flujos habituales que usan este endpoint:

Solicitud mínima:

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

Campos habituales de la respuesta de creación:

Consultar el estado de un vídeo

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

{
  "idWorks": [488026661]
}

Valores de estado:

Las tareas de vídeo completadas pueden incluir videoUrl, coverUrl, srcSrtUrl, tgtSrtUrl, sourceVideoUrl, ttsMetaResult, wyVoiceParam y metadatos de la tarea.

Tareas de imagen

Endpoint público actual de creación:

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

Endpoint para repetir:

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

Solicitud de traducción de imagen:

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

Solicitud de eliminación de texto de imagen:

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

Lee Traducción de imágenes antes de implementar tareas de imagen, porque downloadInfo, downloadInfos y el result de una repetición deben mantener la estructura de cadena documentada.

Consulta de enumeraciones

POST /v-w-c/enum/query2

Este endpoint no requiere AppSign.

{
  "text": "Lang"
}

Nombres habituales de enumeraciones:

Facturación, límites y retención

Resumen de callbacks

Incluye una URL callback en las solicitudes de creación cuando sea compatible. Weydub envía directamente el elemento de trabajo completado a tu servidor, sin el envoltorio externo code / msg / body usado por las respuestas de consulta periódica.

Reglas para gestionar callbacks:

• Verifica Callback-Sign con el cuerpo sin procesar de la solicitud de callback y tu AppSecret.
• Devuelve HTTP 200 y cualquier cuerpo no vacío solo después de completar correctamente el almacenamiento duradero.
• Haz que los controladores sean idempotentes mediante el ID de trabajo/tarea.
• Los callbacks fallidos de tareas creadas en las últimas 24 horas se reintentan aproximadamente cada 30 minutos.
• Si una repetición cambia el contenido de vídeo o imagen, la URL de salida puede cambiar; almacena la URL del resultado más reciente.

Lee Modelo de tarea asíncrona para obtener información detallada sobre los callbacks.

Solución de problemas

Contrato para agentes

Los agentes de automatización deben:

• Cargar llms.txt y Weydub API Skill.
• Usar Escenarios de demostración antes de procesar contenido multimedia de clientes.
• Mantener las credenciales en variables de entorno o en un gestor de secretos.
• Guardar los ID antes de informar del éxito a los usuarios.
• Modelar las tareas como submitted -> processing -> succeeded | failed | timed_out.
• No exponer nunca AppSecret ni inventar endpoints habilitados.