# Wan API Guthaben-Endpunkt (https://wanapi.app/de/docs/balance)



Dieser Endpunkt funktioniert für alle Modelle. Sende deinen Schlüssel als `Authorization: Bearer YOUR_API_KEY` an `https://api.wanapi.app`. Er gibt das Guthaben des Kontos zurück, dem der Schlüssel gehört, und ändert keine Daten.

`GET /v1/balance` gibt das verfügbare Guthaben des Kontos dieses Schlüssels zurück. Der Endpunkt ändert nichts.

```bash
curl https://api.wanapi.app/v1/balance \
  -H "Authorization: Bearer $WAN_API_KEY"
```

```json
{
  "object": "balance",
  "currency": "USD",
  "balance": 12.5,
  "key_remaining": null
}
```

| Feld            | Bedeutung                                                                                                                                                |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `object`        | Immer `balance`.                                                                                                                                         |
| `currency`      | Immer `USD`.                                                                                                                                             |
| `balance`       | Verfügbares Kontoguthaben in USD. Playground und alle API-Schlüssel des Kontos teilen es.                                                                |
| `key_remaining` | Verbleibendes Limit dieses Schlüssels in USD oder `null`, wenn der Schlüssel kein Limit hat. Ein Schlüssel kann keinen der beiden Beträge überschreiten. |

## Fehler [#errors]

| Status | Code                  | Bedeutung                                                           |
| ------ | --------------------- | ------------------------------------------------------------------- |
| 401    | —                     | Der API-Schlüssel fehlt, ist ungültig, deaktiviert oder abgelaufen. |
| 503    | `balance_unavailable` | Versuche es später erneut.                                          |