Endpoints

Saldo e informações da chave

Consulte o saldo em USD, o gasto total e o limite de requisições da chave de API com GET /credits ou GET /key, com exemplos em curl e Python.

Leia o saldo em USD da sua conta, o gasto total e o limite de requisições da chave usada na chamada. Dois caminhos retornam o mesmo corpo: /credits e /key, um alias mais curto.

GET https://api14.com/api/v1/credits
GET https://api14.com/api/v1/key

Todos os valores estão em dólares americanos.

Requisição

Sem parâmetros. Autentique-se com a sua chave de API:

curl https://api14.com/api/v1/credits \
  -H "Authorization: Bearer sk-api14-..."

Resposta

{
  "data": {
    "total_credits": 145.0,
    "total_usage": 102.82,
    "balance_usd": 42.18,
    "key_id": "ckey_01JABCDEF",
    "rate_limit": { "requests": 120, "interval": "1m" }
  }
}

Campo	Descrição
`total_credits`	Total em USD já adicionado à conta: recargas, uso incluído na assinatura, bônus e códigos promocionais.
`total_usage`	Total em USD gasto em requisições.
`balance_usd`	Saldo atual disponível para uso, em USD.
`key_id`	O id da chave de API usada nesta requisição.
`rate_limit.requests`	O limite de requisições por minuto da própria chave, ou `null` se a chave usar o limite do seu plano.
`rate_limit.interval`	Sempre `1m`.

total_credits - total_usage pode diferir um pouco de balance_usd por causa de reembolsos e ajustes manuais; balance_usd é o valor oficial.

Exemplo: pare antes de ficar sem saldo

import os, requests

r = requests.get(
    "https://api14.com/api/v1/credits",
    headers={"Authorization": f"Bearer {os.environ['API14_API_KEY']}"},
)
balance = r.json()["data"]["balance_usd"]
if balance < 1:
    raise SystemExit(f"Balance low: ${balance:.2f}. Add funds at /dashboard/billing")

curl -s https://api14.com/api/v1/key \
  -H "Authorization: Bearer $API14_API_KEY" | jq '.data.balance_usd'

Quando o saldo chega a $0

As requisições pagas retornam 402 insufficient_balance até você adicionar fundos, a menos que a recarga automática esteja ativada em Billing. A leitura de /credits, /key e /models continua funcionando. Veja Preços e cobrança.

Erros

Status	Código	Quando
401	`invalid_api_key`	Chave ausente ou inválida.

Veja Erros.