Autenticación

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.

Precaución

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:

Header X-Api-Key

curl https://api.cut.pro/api/v1/workspace \
  -H "X-Api-Key: $CUTPRO_API_KEY"

Authorization Bearer

curl https://api.cut.pro/api/v1/workspace \
  -H "Authorization: Bearer $CUTPRO_API_KEY"

Una clave ausente, revocada o inválida vuelve así:

Respuesta 401

{ "code": "UNAUTHORIZED", "message": "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.

Clave de un workspace

Toda petición opera en ese workspace automáticamente. No hace falta ningún header extra.

Clave multi-workspace

Envía el header X-Workspace-Id en cada petición para elegir a qué workspace llega la llamada:

curl https://api.cut.pro/api/v1/balance \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "X-Workspace-Id: 7401220118845503"

Sin el header, la respuesta es 400 MISSING_WORKSPACE_ID, con la lista de workspaces permitidos.

Consejo

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 connectionId 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.