API de Clipping con IA

API de Clipping con IA

Envía un vídeo de cualquier duración y recibe todos los clips clasificados por potencial viral. Cada clip incluye timestamps de inicio/fin detectados automáticamente, títulos, descripciones y hashtags generados por IA. Si la exportación está habilitada, la respuesta también incluye enlaces de descarga de vídeos renderizados con reencuadre automático y subtítulos animados opcionales.

Fuentes de Vídeo Compatibles

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

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

Enviar Tarea de Clipping

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

Cuerpo de la Solicitud

Valores de Diseño de Reencuadre

enable_export establecido en true. Clips renderizados con export_link.

Solicitud

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -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", "project_name": "sample project name", "target_duration": "DURATION_30_60", "enable_export": true, "resolution": "HD_720", "enable_caption": true, "enable_ai_reframe": true, "ratio": "RATIO_9_16"}'

Respuesta de Envío

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

enable_export omitido o false. Solo metadatos, sin renderización.

Solicitud

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -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", "project_name": "sample project name", "target_duration": "DURATION_30_60"}'

Respuesta de Envío

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

Ejemplos

Escenarios comunes de AI Clipping. Reemplaza YOUR_API_KEY con una clave del API Dashboard.

Convertir un video de YouTube en clips virales

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

Convertir la grabación de un webinar en shorts verticales 9:16 con subtítulos

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -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",
    "target_duration": "DURATION_30_60",
    "enable_export": true,
    "resolution": "HD_720",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'

Convertir un podcast en los shorts mejor clasificados

Útil para contenido de larga duración cuando solo quieres los clips con mayor puntuación viral.

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -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",
    "limit": 5,
    "target_duration": "DURATION_60_90",
    "enable_export": true,
    "resolution": "HD_720",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'

Obtener Resultados de Clipping

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

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

{
  "data": {"id": "proj_xyz789", "status": "SUCCEEDED", "expire_at": 1741824000000, "cost_usage": 120.0,
           "clips": [{"idx": 0, "title": "sample title", "begin_ms": 15000, "end_ms": 75000,
                      "thumbnail": "https://cdn.example.com/thumb/clip_001.jpg",
                      "tags": ["insight"], "desc": "sample description", "score": 81,
                      "export_link": "https://cdn.example.com/export/clip_001.mp4"}]}
}

{
  "data": {"id": "proj_abc123", "status": "SUCCEEDED", "expire_at": 1741824000000, "cost_usage": 120.0,
           "clips": [{"idx": 0, "title": "sample title", "begin_ms": 15000, "end_ms": 75000,
                      "thumbnail": "https://cdn.example.com/thumb/clip_001.jpg",
                      "tags": ["insight"], "desc": "sample description", "score": 81}]}
}

Campos de la Respuesta

Objeto de Clip

Reexportar Clips Existentes

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

Preguntas frecuentes

¿Cuál es la duración máxima del video?

No hay un límite estricto de duración — la API está diseñada para contenido de varias horas, como podcasts, transmisiones de videojuegos en vivo y webinars. Los límites de tamaño de archivo solo se aplican a las subidas locales; las fuentes basadas en URL no tienen tope.

¿Cómo se clasifican los clips?

Cada clip se puntúa según su potencial viral — integridad narrativa, fuerza del gancho, picos emocionales y señales de engagement. Usa el parámetro limit para conservar solo los N clips con mejor puntuación.

¿Puedo obtener clips sin renderizarlos?

Sí. Omite enable_export (o ponlo en false) para recibir solo timestamps, títulos, descripciones y etiquetas. Renderiza los clips seleccionados más tarde usando la API de Exportación de Clips.

¿Qué proporciones admite AI Reframe?

RATIO_9_16 (TikTok / Reels / Shorts), RATIO_1_1 (feed de Instagram), RATIO_4_5 (retrato de Instagram) y RATIO_16_9 (horizontal). Consulta los los valores de diseño de reencuadre para ver las opciones de diseño por proporción.

¿Desde qué plataformas puedo crear clips?

YouTube, Vimeo, Dailymotion, Kick, Twitch, TikTok, Facebook, Zoom, Rumble y más, además de archivos subidos localmente (mp4, mov, webm, avi).