# Credits anzeigen

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

Gibt zurück, wie viele Testläufe Ihr Konto noch ausführen kann – aus demselben Pool, aus dem auch `POST /generate` schöpft.

## Anfrage

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

## Antwort

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

| Feld | Bedeutung |
|---|---|
| `credits_remaining` | Anproben, die Sie sofort durchführen können. Nutzen Sie diese hier |
| `purchased_remaining` | Verbleibende gekaufte Credits (sie verfallen nie) |
| `purchased_total` | Alle jemals gekauften Credits |
| `free_remaining` | Verbleibendes Gratisguthaben (wird nur vor Ihrem ersten Einkauf verwendet) |
| `spends_from` | `purchased`, sobald Sie Credits gekauft haben, andernfalls `free_allowance` |

## Tipps

- Überprüfen Sie den Stand vor einer großen Datenverarbeitung und lassen Sie sich benachrichtigen, sobald `credits_remaining` unter den Verbrauch von einigen Tagen fällt.
- Ratenbegrenzung: 60 Anfragen pro Minute und Schlüssel. Rufen Sie die Funktion nicht vor jedem Test auf; ein `402`-Fehler von `/generate` zeigt Ihnen bereits an, wenn das Limit erreicht ist.
- [Kaufen Sie Guthaben](/pricing#developer-api) auf der Seite „Abrechnung“ im Dashboard.

## Fehler

| HTTP | Code | Bedeutung |
|---|---|---|
| 401 | `NO_KEY`, `INVALID_KEY` | Fehlender oder falscher Schlüssel |
| 429 | `RATE_LIMITED` | Über 60 Anfragen pro Minute |
| 500 | `CREDITS_UNAVAILABLE` | Vorübergehendes Problem, bitte versuchen Sie es erneut |
