Introducción

March 10, 2026

Introducción

La API WayinVideo permite a cualquier persona integrar el procesamiento de video con IA en sus flujos de automatización. Está diseñada para procesar videos de cualquier duración de forma rápida, confiable y eficiente — incluyendo videos de varias horas — siendo ideal para pipelines de contenido de podcasts, transmisiones en vivo de videojuegos, webinars, tutoriales, cursos en línea, entrevistas, reuniones, vlogs, videos de e-commerce, demostraciones de productos y mucho más. Envía una URL de video o un archivo subido y recibe clips generados por IA, resúmenes, transcripciones y más.

Capacidades Principales

  • Clipping con IA: Envía un video de cualquier duración y recibe todos los clips clasificados por potencial viral, con timestamps de inicio/fin detectados automáticamente, títulos, descripciones y hashtags generados por IA. Opcionalmente exporta los videos de los clips renderizados.
  • Buscar Momentos: Describe los momentos que deseas en lenguaje natural — como "momentos divertidos" o "goles emocionantes" — y la API encuentra y extrae clips con timestamps, títulos y descripciones de videos de cualquier duración. Opcionalmente exporta los videos renderizados.
  • Resumen de Video: Genera una descripción general estructurada, hashtags y momentos destacados de la línea de tiempo de videos de cualquier duración, con procesamiento rápido y estable.
  • Transcripción de Video: Extrae transcripciones con identificación de locutor de contenido de video o audio.

Fuentes de Video Compatibles

La API acepta URLs de las siguientes plataformas:

  • YouTube
  • Vimeo
  • Dailymotion
  • Kick
  • Rumble
  • Zoom
  • Twitch
  • TikTok
  • Facebook

Próximamente se añadirán más plataformas.

También puedes usar archivos subidos localmente. Consulta la API de Subida para más detalles.

URL Base

Todas las solicitudes de la API se realizan a:

https://wayinvideo-api.wayin.ai/api/v2

Formato de las Solicitudes

La API es RESTful y aceita cuerpos de solicitud en formato JSON. Todas las solicitudes deben incluir los siguientes headers:

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
x-wayinvideo-api-version: v2

Formato de las Respuestas

Éxito (HTTP 200)

Cuando la solicitud tiene éxito, la API devuelve el estado HTTP 200 y un cuerpo JSON que contiene solo el payload en data:

{
  "data": {
    "project_id": "prj06928fdjqqaza",
    "name": "Sample project name",
    "status": "SUCCEEDED"
  }
}

La estructura de data varía según el endpoint; consulta la documentación de cada API para más detalles. Para respuestas de error y otros códigos de estado HTTP, consulta Códigos de Estado.

Ciclo de Vida del Estado

Muchos endpoints devuelven un estado de procesamiento asíncrono. El ciclo de vida es:

CREATED → QUEUED → ONGOING → SUCCEEDED / FAILED

Usa polling para verificar el estado hasta que llegue a SUCCEEDED o FAILED. Cuando una tarea falla, el campo error_message en data describe el motivo.