API de Búsqueda de Momentos

API de Búsqueda de Momentos

La API de Búsqueda de Momentos te permite describir los momentos que deseas en lenguaje natural — como "reacciones graciosas" o "demostraciones de producto" — y la API encuentra y extrae clips con timestamps, títulos, descripciones y hashtags de vídeos de cualquier duración.

Fuentes de Vídeo Compatibles

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

También puedes buscar en archivos de video locales que subas — la subida local requiere un plan Standard o superior.

Enviar Tarea de Búsqueda de Momentos

POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments

Cuerpo de la Solicitud

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -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", "query": "sample query", "enable_export": true, "resolution": "FHD_1080", "enable_ai_reframe": true, "ratio": "RATIO_9_16"}'

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

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -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", "query": "sample query"}'

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

Ejemplos

Escenarios comunes de Find Moments. Reemplaza YOUR_API_KEY con una clave del API Dashboard.

Encontrar momentos divertidos en un video de YouTube

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=EXAMPLE",
    "query": "funny reactions"
  }'

Extraer segmentos de demostración de producto de un video de marketing largo

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=EXAMPLE",
    "query": "product demos and feature walkthroughs",
    "limit": 10
  }'

Encontrar momentos destacados deportivos y exportarlos como clips verticales con subtítulos

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=EXAMPLE",
    "query": "goal moments and key plays",
    "enable_export": true,
    "resolution": "FHD_1080",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'

Obtener Resultados de Búsqueda de Momentos

GET https://wayinvideo-api.wayin.ai/api/v2/clips/find-moments/results/{id}

Resultados incrementales: Cuando status es ONGOING, cada llamada devuelve los clips generados hasta el momento.

{"data": {"id": "proj_moment_789", "status": "SUCCEEDED", "expire_at": 1775831883112, "cost_usage": 120.0,
          "clips": [{"idx": 0, "title": "sample title", "begin_ms": 120000, "end_ms": 185000,
                     "tags": ["product"], "desc": "sample description", "score": 81,
                     "export_link": "https://cdn.example.com/export/moment_001.mp4"}]}}

{"data": {"id": "proj_moment_456", "status": "SUCCEEDED", "expire_at": 1775831883112, "cost_usage": 120.0,
          "clips": [{"idx": 0, "title": "sample title", "begin_ms": 120000, "end_ms": 185000,
                     "tags": ["product"], "desc": "sample description", "score": 81}]}}

Campos de la Respuesta y Objeto de Clip

Misma estructura que API de Clipping con IA — incluyendo idx, title, begin_ms, end_ms, thumbnail, tags, desc, score y opcionalmente export_link.

Reexportar Clips Existentes

Usa la API de Exportación de Clips para renderizar clips posteriormente con diferentes configuraciones.

Preguntas frecuentes

¿En qué se diferencia Find Moments de AI Clipping?

AI Clipping devuelve clips clasificados por potencial viral de forma automática — sin necesidad de consulta. Find Moments te permite describir lo que quieres en lenguaje natural (ej. "funny reactions", "product demos", "goal moments") y devuelve solo los clips coincidentes.

¿Puedo limitar el número de momentos devueltos?

Sí. Pasa limit: N para devolver solo las N coincidencias principales clasificadas por relevancia. Útil cuando el video de origen es largo y solo quieres las coincidencias más fuertes.

¿Find Moments admite resultados parciales?

Sí — al consultar, los segmentos con status: ONGOING ya contienen los clips generados hasta el momento, por lo que puedes comenzar el procesamiento posterior sin esperar a que termine toda la tarea.