API de Resumen de Vídeo

Envía un vídeo de cualquier duración y recibe una descripción general estructurada generada por IA, hashtags y momentos destacados de la línea de tiempo. La API admite desde vídeos cortos hasta vídeos de horas en plataformas populares y archivos subidos localmente.

Fuentes de Vídeo Compatibles

YouTube, Vimeo, Dailymotion, Kick, Twitch, TikTok, Facebook, Zoom, Rumble y otras.

La subida local requiere un plan Standard o superior. Consulta la API de Subida.

Enviar Tarea de Resumen

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

Cuerpo de la Solicitud

Parámetro	Tipo	Requerido	Predeterminado	Descripción
`video_url`	string	Sí	—	URL del vídeo de origen o identificador del archivo subido
`source_lang`	string	No	`null`	Idioma de origen. Cuando `null`, se detecta automáticamente.
`target_lang`	string	No	`null`	Idioma de destino para el contenido de salida. Cuando `null`, corresponde al `source_lang`.

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"video_url": "https://www.youtube.com/watch?v=example", "target_lang": "en"}'

Respuesta

{"data": {"id": "sum_proj_001", "name": "sample project name", "status": "CREATED"}}

Obtener Resultados del Resumen

GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/{id}

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/sum_proj_001 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

Respuesta

{
  "data": {
    "status": "SUCCEEDED",
    "title": "sample title",
    "video_thumbnail": "https://cdn.example.com/thumb/video_001.jpg",
    "summary": "sample summary text",
    "tags": ["#topic1", "#topic2"],
    "highlights": [{"start": 0, "end": 196000, "desc": "sample section title",
                    "events": [{"timestamp": 160, "desc": "sample event"}]}],
    "cost_usage": 54.0
  }
}

Campos de la Respuesta

Campo	Tipo	Descripción
`status`	string	`CREATED`, `QUEUED`, `ONGOING`, `SUCCEEDED`, `FAILED`
`error_message`	string	Motivo del error (solo cuando `FAILED`)
`title`	string	Título generado por IA
`video_thumbnail`	string	URL de la miniatura del vídeo
`summary`	string	Descripción general completa en texto
`tags`	string[]	Hashtags generados por IA
`highlights`	array	Segmentos destacados de la línea de tiempo
`cost_usage`	number	API Units consumidas

Objeto de Destaque

Campo	Tipo	Descripción
`start`	number	Tiempo de inicio en milisegundos
`end`	number	Tiempo de fin en milisegundos
`desc`	string	Título/descripción del segmento
`events`	array	Eventos clave dentro del segmento

Objeto de Evento

Campo	Tipo	Descripción
`timestamp`	number	Tiempo del evento en milisegundos
`desc`	string	Descripción del evento