Workspace y créditos

Toda llamada a la API ocurre dentro de un workspace, y es su saldo de créditos el que se consume cuando creas envíos.

El workspace de la petición

La clave de API resuelve a un workspace en cada petición (mira Autenticación sobre claves de uno y de varios workspaces). Para inspeccionar qué workspace se resolvió, con plan, rol y número de miembros:

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

{
  "id": "7401220118845503",
  "name": "Estudio de ejemplo",
  "is_personal": false,
  "role": "admin",
  "plan_name": "Pro",
  "plan_is_free": false,
  "credits": 480,
  "credits_unlimited": false,
  "member_count": 4
}

Cómo se consumen los créditos

Los créditos son del workspace, no de la clave. Una clave de varios workspaces consume del workspace elegido por la cabecera X-Workspace-Id.

El cobro ocurre en el envío. Los créditos se descuentan en el momento en que llamas a POST /clips. Analizar con POST /clips/info no cuesta nada y muestra el credits_cost antes de que te comprometas.

1 crédito equivale a 1 minuto procesado. El coste es proporcional al tramo de vídeo que mandas procesar (el timeframe), así que reducir el tramo baja el coste.

Cuando el saldo no cubre el envío, POST /clips responde 402 INSUFFICIENT_CREDITS, y el extra trae credits_needed y current_balance.

Consultando el saldo

Saldo actual del workspace:

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

{
  "balance": 480,
  "unlimited": false,
  "unlimited_until": null
}

Extracto de movimientos (créditos añadidos y consumidos):

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