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

# 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](/api-reference/autenticacao) sobre chaves single e multi-workspace). Para inspecionar qual workspace foi resolvido, com plano, papel e número de membros:

```bash theme={null}
curl https://api.cut.pro/api/v1/workspace \
  -H "X-Api-Key: SUA_CHAVE"
```

## Como os créditos são consumidos

<Steps>
  <Step title="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`.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Consultando o saldo

Saldo atual do workspace:

```bash theme={null}
curl https://api.cut.pro/api/v1/balance \
  -H "X-Api-Key: SUA_CHAVE"
```

Extrato de movimentações (créditos adicionados e consumidos):

```bash theme={null}
curl https://api.cut.pro/api/v1/balance/history \
  -H "X-Api-Key: SUA_CHAVE"
```

<Tip>
  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](/billing/how-credits-work).
</Tip>