Créditos

Consulta o saldo de créditos restante da tua conta. Uma chamada apenas de leitura que nunca deduz créditos.

Devolve o saldo de créditos da conta associada à tua chave API. É uma consulta apenas de leitura — nunca deduz créditos. Usa-a para mostrar a quota restante no teu painel ou para controlar as chamadas antes de gastar créditos.

Endpoint

Passa a tua apiKey no corpo JSON como em qualquer outro endpoint ou — por ser uma consulta apenas de leitura — como parâmetro de query num pedido GET: GET /api/credits?apiKey=YOUR_API_KEY.

curl -X POST https://app.pedra.ai/api/credits \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY"
  }'

# Or, since it's read-only, a simple GET:
curl "https://app.pedra.ai/api/credits?apiKey=YOUR_API_KEY"

Resposta

Devolve 200 com o saldo atual:

{
  "plan": "pro",
  "creditsRemaining": 87
}

Campos da resposta

• plan — o plano da tua conta: free ou pro.
• creditsRemaining — créditos ainda disponíveis para gerações. Corresponde ao saldo mostrado no editor da Pedra.

Como os créditos são gastos

Cada operação deduz um número fixo de créditos — as chamadas de imagem custam 1–2 e os frames de vídeo animados 5 cada (os frames estáticos são gratuitos). Vê Preços para o detalhe completo e Erros e limites para o que acontece quando se esgotam.