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.

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

Enviar Tarea de Búsqueda de Momentos

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

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.
`query`	string	Sí	`""`	Consulta en lenguaje natural (ej.: `"reacciones graciosas"`, `"demostraciones de producto"`)
`project_name`	string	No	`""`	Nombre personalizado para esta tarea
`source_lang`	string	No	`null`	Idioma de origen. Cuando `null`, se detecta automáticamente.
`target_lang`	string	No	`null`	Idioma de destino para títulos, descripciones y subtítulos.
`limit`	number	No	`null`	Número máximo de clips a devolver.
`enable_export`	boolean	No	`false`	`false`: solo metadatos; `true`: renderiza inmediatamente.
`resolution`	string	No	`SD_480`	Resolución: `SD_480`, `HD_720`, `FHD_1080`, `QHD_2K`, `UHD_4K`.
`enable_caption`	boolean	No	`false`	Añadir subtítulos animados.
`caption_display`	string	No	`original`	Modo de subtítulos: `both`, `original`, `translation`.
`cc_style_tpl`	string	No	`temp-7`	ID de plantilla de estilo de subtítulos.
`enable_ai_hook`	boolean	No	`false`	Añadir texto de gancho generado por IA.
`ai_hook_script_style`	string	No	`serious`	Estilo del gancho: `serious`, `casual`, `informative`, `conversational`, `humorous`, `parody`, `inspirational`, `dramatic`, `empathetic`, `persuasive`, `neutral`, `excited`, `calm`.
`ai_hook_position`	string	No	`beginning`	Posición: `beginning`, `end`.
`enable_ai_reframe`	boolean	No	`false`	Activar Reencuadre con IA.
`ratio`	string	Obligatorio cuando `enable_ai_reframe` es `true`	—	Proporción: `RATIO_9_16`, `RATIO_1_1`, `RATIO_4_5`, `RATIO_16_9`.
`reframe_layout`	string	No	`Auto`	Diseño del Reencuadre con IA.

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

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.