Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.clipping.cc/llms.txt

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

A API é paga por uso, debitada do saldo da conta dona da API key. O saldo é medido em coins (1 coin = R$ 1,00).

​
Modelo: taxa fixa + pass-through

Cada chamada à /v1 tem dois componentes de custo:
1

Taxa fixa de plataforma

Um valor pequeno por request, debitado da conta da key.
2

Pass-through (quando houver)

Se a chamada acionar um provedor externo (transcrição, IA, YouTube), o custo real dele também é repassado. As rotas de leitura atuais servem do banco e normalmente não têm pass-through.

​
Taxa fixa por rota

RotaCusto
Maioria das leituras (me, items, collections, reporters, videos, discover)0,001 coin
search0,005 coin
items/{id}/transcript0,005 coin
Preços podem ser ajustados conforme a operação evolui. O custo é sempre debitado após a resposta — uma falha de billing nunca derruba a chamada.

​
Saldo insuficiente

Antes de processar, a API checa o saldo. Se estiver zerado ou negativo, a resposta é: 
// HTTP 402 Payment Required
{ "erro": "saldo insuficiente — adicione coins na conta" }
Adicione coins em clipping.cc/balance.

​
Recarga via Pix

Coins são comprados via Pix (1 coin = R$ 1,00). O fluxo:
1

Criar a cobrança

POST /admin/accounts/me/deposit/pix com { amount_coins, cpf }. Retorna o QR Code (imagem base64) e o copia-e-cola:
{
  "deposit_id": "…",
  "status": "pending",
  "amount_coins": 50,
  "pix": {
    "qr_code_base64": "iVBORw0KGgo…",
    "copia_e_cola": "00020101…",
    "expiration": "2026-05-28T23:59:59Z"
  }
}
2

Pagar

O usuário paga o Pix pelo app do banco (QR ou copia-e-cola). Mínimo de 5 coins por recarga.
3

Crédito automático

Quando o pagamento confirma, o provedor (Asaas) notifica a API e os coins são creditados na conta — você recebe um evento deposit_credited em tempo real.
O crédito acontece só após a confirmação do Pix. A taxa de processamento é absorvida pela plataforma — você credita exatamente amount_coins.

​
Acompanhando consumo

O saldo atual vem em GET /v1/me (ver aba Referência da API). O extrato detalhado de transações fica no painel em clipping.cc/balance.