Quickstart: tu primer clip

Esta guía recorre el flujo completo de la API con curl. Antes de empezar, genera una clave de API y guárdala en TU_CLAVE.

Analiza el vídeo (sin coste)
Consulta los metadatos y el coste en créditos antes de gastar nada.
Ventana de terminal
```
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 y current_balance. Guarda el video_id.

¿Quieres clipar un archivo de tu ordenador en vez de una URL? Mira Enviando un vídeo para el flujo de subida.
Envía a clipping
Envía el vídeo. Los créditos se descuentan inmediatamente. El timeframe es opcional: omítelo para procesar el vídeo entero, o limítalo a un tramo (en segundos) para ahorrar créditos.
Ventana de terminal
```
1
curl -X POST https://api.cut.pro/api/v1/clips \
2
  -H "X-Api-Key: TU_CLAVE" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "video_id": "VIDEO_ID",
6
    "strategy_id": "STRATEGY_ID",
7
    "timeframe": { "start": 0, "end": 1800 }
8
  }'
```
La respuesta trae submission_id, status y credits_charged. Guarda el submission_id.

strategy_id, template_id y source_language (auto, en, pt) son opcionales. Lista tus estrategias y plantillas con GET /templates para obtener los IDs.
Sigue hasta que termine
Haz polling sobre el envío. El status pasa por queued → downloading → transcribing → video_analysis → analyzing → finalizing → completed (o failed).
Ventana de terminal
```
1
curl https://api.cut.pro/api/v1/clips/VIDEO_ID/submissions/SUBMISSION_ID \
2
  -H "X-Api-Key: TU_CLAVE"
```
Cuando el status sea completed, clips_count indica cuántos clips se generaron.
Obtén los clips generados
Ventana de terminal
```
1
curl https://api.cut.pro/api/v1/clips/VIDEO_ID/submissions/SUBMISSION_ID/clips \
2
  -H "X-Api-Key: TU_CLAVE"
```
Cada clip trae id, title, rating (la puntuación de la IA), start_time, end_time, play_url y download_url. Ordena por rating para quedarte con los mejores primero.
Renderiza un clip
Genera el MP4 final de un clip. Para aplicar un diseño antes, llama a POST .../apply_template sobre el envío.
Ventana de terminal
```
1
curl -X POST \
2
  https://api.cut.pro/api/v1/clips/VIDEO_ID/submissions/SUBMISSION_ID/clips/CLIP_ID/render \
3
  -H "X-Api-Key: TU_CLAVE"
```
La respuesta trae render_id y status. Si from_cache es true, el download_url ya viene listo.
Sigue el render
Ventana de terminal
```
1
curl https://api.cut.pro/api/v1/renders/RENDER_ID \
2
  -H "X-Api-Key: TU_CLAVE"
```
El status pasa por queued → active → completed y progress va de 0 a 100.
Descarga el MP4
Con el render en completed, obtén la URL de descarga.
Ventana de terminal
```
1
curl https://api.cut.pro/api/v1/renders/RENDER_ID/download \
2
  -H "X-Api-Key: TU_CLAVE"
```
La respuesta trae url (enlace firmado al archivo) y filename.

¿Y ahora?

Publica en las redes

Lleva los clips renderizados a TikTok, Instagram, YouTube y más con POST /posts.

Workspace y créditos

Entiende el consumo de créditos y cómo consultar el saldo del workspace.