# Ver créditos

`GET https://www.tryoncloud.com/api/v1/credits`

Devuelve el número de pruebas que aún puede realizar tu cuenta, procedentes del mismo conjunto del que se nutre la solicitud `POST /generate`.

## Solicitud

```bash
curl https://www.tryoncloud.com/api/v1/credits -H "X-API-KEY: $TRYONCLOUD_API_KEY"
```

## Respuesta

```json
{
  "credits_remaining": 4870,
  "purchased_remaining": 4870,
  "purchased_total": 5000,
  "free_remaining": 0,
  "spends_from": "purchased"
}
```

| Campo | Significado |
|---|---|
| `credits_remaining` | Pruebas que puedes hacer ahora mismo. Usa esta. |
| `purchased_remaining` | Créditos adquiridos restantes (no caducan nunca) |
| `purchased_total` | Todos los créditos comprados hasta la fecha |
| `free_remaining` | Saldo de bonificación restante (solo se utiliza antes de tu primera compra) |
| `spends_from` | `purchased` una vez que hayas comprado créditos; de lo contrario, `free_allowance` |

## Consejos

- Compruébalo antes de procesar un lote grande y avísate cuando `credits_remaining` baje por debajo de unos pocos días de uso.
- Límite de solicitudes: 60 solicitudes por minuto por clave. No lo solicites antes de cada prueba; un código de error `402` de `/generate` ya te indica cuándo has agotado el límite.
- [Compra créditos](/pricing#developer-api) en la página «Facturación» del panel de control.

## Errores

| HTTP | código | Significado |
|---|---|---|
| 401 | `NO_KEY`, `INVALID_KEY` | Clave ausente o incorrecta |
| 429 | `RATE_LIMITED` | Más de 60 solicitudes por minuto |
| 500 | `CREDITS_UNAVAILABLE` | Problema temporal, vuelve a intentarlo |
