Workspace e créditos
Como o workspace, o plano e o saldo de créditos funcionam na API
Toda chamada à API acontece dentro de um workspace, e é o saldo de créditos dele que é consumido quando você cria submissões.
O workspace da requisição
A chave de API resolve para um workspace em cada requisição (veja Autenticação sobre chaves single e multi-workspace). Para inspecionar qual workspace foi resolvido, com plano, papel e número de membros:
curl https://api.cut.pro/api/v1/workspace \
-H "X-Api-Key: $CUTPRO_API_KEY"{
"id": "7401220118845503",
"name": "Estúdio Exemplo",
"is_personal": false,
"role": "admin",
"plan_name": "Pro",
"plan_is_free": false,
"credits": 480,
"credits_unlimited": false,
"member_count": 4
}Como os créditos são consumidos
Os créditos pertencem ao workspace, não à chave. Uma chave multi-workspace consome do workspace escolhido pelo header X-Workspace-Id.
A cobrança acontece na submissão. Os créditos são debitados no momento em que você chama POST /clips. Analisar com POST /clips/info não custa nada e mostra o credits_cost antes de você se comprometer.
1 crédito equivale a 1 minuto processado. O custo é proporcional ao trecho do vídeo que você manda processar (o timeframe), então restringir o trecho reduz o custo.
Quando o saldo não cobre a submissão, POST /clips responde 402 INSUFFICIENT_CREDITS, e o extra traz credits_needed e current_balance.
Consultando o saldo
Saldo atual do workspace:
curl https://api.cut.pro/api/v1/balance \
-H "X-Api-Key: $CUTPRO_API_KEY"{
"balance": 480,
"unlimited": false,
"unlimited_until": null
}Extrato de movimentações (créditos adicionados e consumidos):
curl https://api.cut.pro/api/v1/balance/history \
-H "X-Api-Key: $CUTPRO_API_KEY"Quer prever o custo antes de submeter? Chame POST /clips/info com a URL do vídeo: a resposta traz credits_cost, discount_percent e current_balance.