Endpoints

Saldo e información de la clave

Consulta con GET /credits o GET /key tu saldo en USD, el gasto total y el límite de peticiones de la clave de API que realiza la llamada.

Consulta el saldo en USD de tu cuenta, el gasto total y el límite de peticiones de la clave que hace la llamada. Dos rutas devuelven el mismo cuerpo: /credits y /key, un alias más corto.

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

Todos los importes están en dólares estadounidenses.

Petición

Sin parámetros. Autentícate con tu clave de API:

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

Respuesta

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

Campo	Descripción
`total_credits`	Total de USD añadidos a la cuenta: recargas, uso incluido en la suscripción, bonos y códigos promocionales.
`total_usage`	Total de USD gastados en peticiones.
`balance_usd`	Saldo disponible actual en USD.
`key_id`	El id de la clave de API usada en esta petición.
`rate_limit.requests`	El límite propio de peticiones por minuto de la clave, o `null` si la clave usa el límite de tu plan.
`rate_limit.interval`	Siempre `1m`.

total_credits - total_usage puede diferir ligeramente de balance_usd por reembolsos y ajustes manuales; balance_usd es el valor de referencia.

Ejemplo: parar antes de quedarte sin 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'

Cuando el saldo llega a $0

Las peticiones de pago devuelven 402 insufficient_balance hasta que añadas fondos, salvo que la recarga automática esté activada en Facturación. Consultar /credits, /key y /models sigue funcionando. Consulta Precios y facturación.

Errores

Estado	Código	Cuándo
401	`invalid_api_key`	Clave ausente o no válida.

Consulta Errores.