Genera clips de un video

El clipping tiene tres recursos: el video (la fuente), el envío (un procesamiento de ese video) y los clips (los cortes que generó el envío). Un video puede tener varios envíos, por ejemplo con tramos o plantillas distintos.

POST /clips/info  →  POST /clips  →  GET .../submissions/{id}  →  GET .../clips
    análisis            envío           hasta completed             los cortes

Analiza el enlaceCopy Anchor Link

curl -X POST https://api.cut.pro/api/v1/clips/info \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }'

La respuesta trae título, autor, plataforma, duración en segundos, miniatura y el costo en créditos. Analizar no cobra, pero tiene un límite propio de 10 por minuto. Si el archivo lo tienes tú, usa la subida en lugar de este paso.

Cuando el enlace no sirve, el code dice por qué:

Crea el envíoCopy Anchor Link

curl -X POST https://api.cut.pro/api/v1/clips \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "7412908365112823",
    "source_language": "pt",
    "timeframe": { "start": 600, "end": 1800 },
    "template_id": "7398110254410021"
  }'

Errores comunes al crear: 402 INSUFFICIENT_CREDITS, 409 VIDEO_ALREADY_PROCESSING (el mismo video ya se está procesando), 429 TOO_MANY_PENDING_CLIPS (cola del workspace llena), 400 TIMEFRAME_OUT_OF_BOUNDS y 400 TIMEFRAME_TOO_SHORT.

Sigue el envíoCopy Anchor Link

curl https://api.cut.pro/api/v1/clips/7412908365112823/submissions/7412908371004912 \
  -H "X-Api-Key: $CUTPRO_API_KEY"

Consulta cada 5 a 10 segundos. Los estados siguen este orden:

Fuente que aún no está en el aireCopy Anchor Link

Un envío puede quedar detenido en downloading porque la fuente todavía no existe completa: un estreno programado, una transmisión en vivo aún al aire o una grabación que la plataforma todavía procesa. En ese caso waiting_reason viene completo:

No es un error y no se trabó: el envío continúa solo cuando la fuente queda disponible. Muéstraselo a la persona y ofrece cancelar, porque el DELETE en este estado devuelve los créditos.

Cuando fallaCopy Anchor Link

error_code dice el motivo. Los que empiezan con DOWNLOAD_ son de la fuente (DOWNLOAD_PRIVATE_VIDEO, DOWNLOAD_MEMBERS_ONLY, DOWNLOAD_GEO_RESTRICTED, DOWNLOAD_REMOVED_BY_UPLOADER): cambiar de video es el camino. EMPTY_TRANSCRIPT y DOWNLOAD_NO_AUDIO indican que no hay voz de la que generar clips. Los demás son fallas del procesamiento y valen un nuevo intento:

curl -X POST https://api.cut.pro/api/v1/clips/7412908365112823/submissions/7412908371004912/retry \
  -H "X-Api-Key: $CUTPRO_API_KEY"

El reintento crea un envío nuevo con la misma configuración y cobra como POST /clips. El que falló sigue en el historial. Solo vale para un envío en failed: en los demás, la respuesta es 409 SUBMISSION_NOT_FAILED.

Lista los clipsCopy Anchor Link

curl "https://api.cut.pro/api/v1/clips/7412908365112823/submissions/7412908371004912/clips?min_rating=7&sort=rating&order=desc" \
  -H "X-Api-Key: $CUTPRO_API_KEY"

{
  "clips": [
    {
      "id": "7412908412887301",
      "title": "El estribillo que todo el mundo conoce",
      "description": "El momento de mayor energía del video, con el público cantando a coro.",
      "rating": 9.2,
      "start_time": 42.5,
      "end_time": 71.0,
      "language": "en",
      "created_at": "2026-10-29T18:04:50.000Z",
      "thumbnail_url": "https://...",
      "download_url": "https://...",
      "play_url": "https://...",
      "has_template_applied": false,
      "edit_id": null
    }
  ],
  "pagination": { "current_page": 1, "total_pages": 1, "total_count": 6, "has_next_page": false, "has_previous_page": false, "limit": 20 }
}

• rating va de 0 a 10. Filtra con min_rating y max_rating.
• Ordena por rating, duration, title o start_time.
• download_url es el corte crudo, sin edición. Para el MP4 con plantilla y subtítulos, renderiza.
• Los enlaces están firmados y duran poco. Pide la lista de nuevo cuando vayas a usarlos.

Subtítulos del clipCopy Anchor Link

curl "https://api.cut.pro/api/v1/clips/7412908365112823/submissions/7412908371004912/clips/7412908412887301/subtitles?format=srt" \
  -H "X-Api-Key: $CUTPRO_API_KEY"

Devuelve SRT o texto plano (format=txt), con el tiempo empezando en 00:00 y alineado al clip. Si el clip tiene edición, los subtítulos son los de la edición, con correcciones y traducción.

RetenciónCopy Anchor Link

Los clips de un envío no quedan para siempre. Pasada la retención, el envío aparece con expired: true y las rutas de clips responden 410 SUBMISSION_EXPIRED. Es permanente: no repitas, envía el video de nuevo. Lo que ya renderizaste sigue recuperable por el edit_id.

Organiza la bibliotecaCopy Anchor Link

Eliminar no tiene vuelta atrás.