Pular para o conteúdo principal
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: SUA_CHAVE"

​
Como os créditos são consumidos

1

Os créditos pertencem ao workspace

O saldo é do workspace que a requisição resolve, não da chave em si. Uma chave multi-workspace consome do workspace escolhido pelo header X-Workspace-Id.
2

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

1 crédito = 1 minuto processado

O custo é proporcional ao trecho do vídeo que você manda processar (o timeframe). Restringir o trecho reduz o custo.

​
Consultando o saldo

Saldo atual do workspace: 
curl https://api.cut.pro/api/v1/balance \
  -H "X-Api-Key: SUA_CHAVE"
Extrato de movimentações (créditos adicionados e consumidos): 
curl https://api.cut.pro/api/v1/balance/history \
  -H "X-Api-Key: SUA_CHAVE"
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. Detalhes do modelo de créditos em Como os créditos funcionam.
Última modificação em 1 de junho de 2026