Workspace e créditos

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"