Enviando un vídeo para clipping

Antes de generar clips necesitas un video_id. Hay dos formas de conseguirlo, y ambas convergen en el mismo paso siguiente: llamar a POST /clips con ese video_id (mira el Quickstart).

Opción A: por URL pública

La forma más simple. Envía la URL de un vídeo público (YouTube, TikTok, Twitch, Kick, Vimeo, etc.) para analizarlo. Analizar no cuesta créditos.

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

La respuesta trae video_id, credits_cost (lo que se cobrará al enviar), current_balance y el título y la duración del vídeo. Guarda el video_id y sigue a POST /clips.

Opción B: subiendo tu propio archivo

Para vídeos de tu ordenador, la subida se hace en tres pasos con una URL prefirmada (presigned), enviando los bytes directamente al almacenamiento.

Inicia la subida

Declara el nombre del archivo y el tipo de contenido. La respuesta trae el video_id, la upload_url (a dónde enviar los bytes) y expires_in (segundos hasta caducar).

1
curl -X POST https://api.cut.pro/api/v1/videos/upload \
2
  -H "X-Api-Key: TU_CLAVE" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "file_name": "mi-directo.mp4",
6
    "content_type": "video/mp4"
7
  }'

Envía los bytes a la upload_url
Haz un PUT del archivo directamente a la upload_url. No envíes aquí tu clave de API (la URL ya está firmada), y usa el mismo Content-Type que declaraste en el paso anterior.
Ventana de terminal
```
1
curl -X PUT "UPLOAD_URL" \
2
  -H "Content-Type: video/mp4" \
3
  --data-binary @mi-directo.mp4
```
El PUT debe devolver 200 antes de seguir.
Finaliza la subida
Registra la subida indicando las dimensiones y la duración del archivo (medidas por tu lado). La respuesta trae los metadatos del vídeo y el credits_cost, igual que el análisis por URL.
Ventana de terminal
```
1
curl -X POST https://api.cut.pro/api/v1/videos/upload/complete \
2
  -H "X-Api-Key: TU_CLAVE" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "video_id": "VIDEO_ID",
6
    "file_name": "mi-directo.mp4",
7
    "duration": 5400,
8
    "width": 1920,
9
    "height": 1080
10
  }'
```
Llama a este paso solo después de que el PUT devuelva 200. Si el archivo no está en el almacenamiento, la respuesta es 404 FILE_NOT_FOUND. Si la duración está fuera de los límites, devuelve 400 VIDEO_TOO_SHORT o VIDEO_TOO_LONG (con max_duration).

Siguiente paso

Con el video_id en la mano (venga de donde venga), envíalo a clipping:

Continúa en el Quickstart desde el paso “Envía a clipping” (POST /clips).