Workspace y créditos
Cómo funcionan el workspace, el plan y el saldo de créditos en la API
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"¿Quieres prever el coste antes de enviar? Llama a POST /clips/info con la URL del vídeo: la respuesta trae credits_cost, discount_percent y current_balance.