Autenticación
Cómo autenticar tus peticiones y seleccionar el workspace
Toda petición a la API necesita una clave de API.
Generando tu clave
Entra en Claves de API en los ajustes de tu cuenta y pulsa Nueva clave. Guarda la clave en un lugar seguro: no se vuelve a mostrar después de creada.
La clave da acceso a los créditos y a las cuentas conectadas del workspace. Mantenla en tu servidor, en una variable de entorno, nunca en el código del navegador ni de la app.
Enviando la clave
Envía la clave en todas las peticiones, de una de las dos formas:
curl https://api.cut.pro/api/v1/workspace \
-H "X-Api-Key: $CUTPRO_API_KEY"curl https://api.cut.pro/api/v1/workspace \
-H "Authorization: Bearer $CUTPRO_API_KEY"El límite de peticiones es por clave, y cada respuesta trae lo que queda de él en las cabeceras X-RateLimit-Remaining y X-RateLimit-Reset. Mira Errores y límites.
Una clave ausente, revocada o inválida vuelve así:
{ "code": "UNAUTHORIZED" }Workspaces
Una clave de API está vinculada a uno o más workspaces (tokens con alcance, al estilo de Cloudflare). Los créditos, los envíos, los clips y los renders siempre pertenecen al workspace que resuelva la petición.
Toda petición opera en ese workspace automáticamente. No hace falta ningún header extra.
Llama a GET /workspace para ver qué workspace resolvió la petición actual, junto con el plan y tu rol en él.
Conexiones sociales
Las cuentas sociales conectadas (TikTok, Instagram, YouTube, etc.) son los IDs que pasas como connection_id al crear una publicación. El ciclo de vida de las conexiones no se expone por la API: para conectar una cuenta nueva, entra en cut.pro y usa el flujo de OAuth dentro de la app.