Skip to main content

Documentation Index

Fetch the complete documentation index at: https://cut.pro/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.
Last modified on June 1, 2026