---
title: "Was ist ein Idempotenzschlüssel? Sichere API-Retries"
description: "Ein Idempotenzschlüssel ist eine eindeutige ID des Clients, damit ein Retry seine Wirkung nicht wiederholt, etwa eine zweite Abbuchung. Funktionsweise, IETF-Header."
url: https://broadrouter.com/de/glossary/idempotency-key/
lang: de
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Mit KI-Unterstützung aus dem Englischen übersetzt. [Englisches Original lesen](https://broadrouter.com/glossary/idempotency-key/) (aktualisiert am 2026-11-14).

# Idempotenzschlüssel (Idempotency Key)

Aktualisiert 2026-11-14

Ein Idempotenzschlüssel ist ein eindeutiger Wert, meist eine zufällige ID wie eine UUID, den ein Client an eine zustandsändernde Anfrage wie eine Zahlung oder einen Kauf anhängt. Kommt dieselbe Anfrage mit demselben Schlüssel erneut, liefert der Server das ursprüngliche Ergebnis, statt die Aktion zweimal auszuführen.

Auch genannt: Idempotenzschlüssel, Idempotenz-Key, idempotente Anfrage, idempotenter Retry, Idempotency-Key-Header, idempotency key, Idempotency-Key header, idempotency token, idempotent request, idempotent retry

Netzwerke fallen an der ungünstigsten Stelle aus: nachdem der Server gehandelt hat, aber bevor Sie die Antwort erhalten. Ein Idempotenzschlüssel macht den Retry sicher.

## So funktioniert es

Der Client erzeugt für eine beabsichtigte Aktion einen eindeutigen Schlüssel und sendet ihn mit der Anfrage. Der Server speichert den Schlüssel zusammen mit dem Ergebnis. Kommt derselbe Schlüssel erneut an, spielt der Server das gespeicherte Ergebnis zurück, statt erneut zu handeln.

Die IETF-Arbeitsgruppe HTTPAPI standardisiert das als Request-Header `Idempotency-Key` (Entwurf 08, Oktober 2026, noch kein RFC). Sie beschreibt den Schlüssel als „a unique value generated by the client which the resource uses to recognize subsequent retries of the same request“ (Übersetzung: „einen eindeutigen, vom Client erzeugten Wert, an dem die Ressource spätere Wiederholungen derselben Anfrage erkennt“) und empfiehlt eine UUID oder eine ähnliche zufällige ID. Die Fehlerfälle des Entwurfs:

| Situation | Status |
| --- | --- |
| Schlüssel fehlt, obwohl erforderlich | 400 Bad Request |
| Ursprüngliche Anfrage läuft noch | 409 Conflict |
| Schlüssel mit anderem Body wiederverwendet | 422 Unprocessable Content |

Die Builders’ Library von AWS sagt dasselbe aus Client-Sicht: „APIs with side effects aren’t safe to retry unless they provide idempotency.“ (Übersetzung: „APIs mit Nebenwirkungen lassen sich nur dann sicher wiederholen, wenn sie Idempotenz bieten.“)

## Warum es wichtig ist

Retries mit [exponentiellem Backoff](https://broadrouter.com/de/glossary/exponential-backoff/) sind gängige Praxis, und viele SDKs wiederholen Anfragen automatisch. Ohne Idempotenz kann ein Retry nach einem Timeout zwei Bestellungen oder zwei Abbuchungen erzeugen. Mit einem Schlüssel ist der Retry sicher, egal was der erste Versuch bewirkt hat. Damit ist er ein zentrales Werkzeug für Agents und Skripte, die ohne menschliche Aufsicht etwas kaufen, buchen oder anlegen.

## Bei BroadNet Inference

BroadNet nutzt dieses Muster beim Kauf von [Stundenschlüsseln](https://broadrouter.com/de/blog/hourly-llm-api-key-explained/). `POST /portal/keys/hourly` nimmt eine `request_id` im JSON-Body entgegen, und die Dokumentation stellt klar: „Idempotency is required for money safety“ (Übersetzung: „Idempotenz ist für die Sicherheit bei Zahlungen erforderlich“):

```bash
curl -X POST https://inference.broadnet.ai/portal/keys/hourly \
  -H "Authorization: Bearer <portal-credential>" \
  -H "Content-Type: application/json" \
  -d '{"request_id":"order-20260920-001","label":"kiosk-1"}'
```

Eine wiederverwendete `request_id` erzeugt keinen weiteren Schlüssel und bucht nichts erneut ab. Wiederholen Sie die Anfrage nach einem Timeout, einem Verbindungsabbruch, einem 409 `mint_in_progress` oder einem 5xx mit derselben `request_id`. Eine Wiederholung liefert `already_issued: true` und den Alias des Schlüssels; nur die erste erfolgreiche Antwort enthält den eigentlichen Schlüssel. In der Dokumentation heißt es: „Never generate a replacement id until the original result is known.“ (Übersetzung: „Erzeugen Sie niemals eine Ersatz-ID, bevor das ursprüngliche Ergebnis bekannt ist.“)

Für `/v1/chat/completions` oder Transkriptionen dokumentiert BroadNet keinen Idempotenzschlüssel. Was Sie dort wiederholen sollten, steht unter [Fehlercodes und Retries](https://broadrouter.com/de/guides/errors-and-retries/); warum blinde Retries einen 429 verschlimmern können, erklären die [Rate Limits](https://broadrouter.com/de/glossary/rate-limit/).

## Häufige Fragen

### Wann sollte ich einen neuen Idempotenzschlüssel erzeugen?

Nur für eine neue beabsichtigte Aktion. Verwenden Sie für jeden Retry derselben Aktion denselben Schlüssel, und erzeugen Sie erst dann einen neuen, wenn Sie das Ergebnis des ersten Versuchs kennen.

### Brauchen Chat-Completion-Anfragen an ein LLM einen Idempotenzschlüssel?

Textgenerierung hat keine bleibende Nebenwirkung, eine wiederholte Chat-Anfrage kostet meist nur erneut Tokens. Wichtig ist der Schlüssel bei Aufrufen, die Geld abbuchen oder Ressourcen anlegen. BroadNet dokumentiert ihn nur für den Kauf von Stundenschlüsseln, nicht für Chat Completions.

### Was passiert, wenn ich einen Schlüssel mit einem anderen Request-Body wiederverwende?

Laut dem IETF-Entwurf soll der Server die Anfrage mit 422 Unprocessable Content ablehnen, weil der Schlüssel bereits an eine andere Anfrage gebunden ist.

## Siehe auch

-   [Exponentieller Backoff (Exponential Backoff)](https://broadrouter.com/de/glossary/exponential-backoff/) (Begriff)
-   [Rate Limit (Ratenbegrenzung)](https://broadrouter.com/de/glossary/rate-limit/) (Begriff)
-   [API-Schlüssel (API Key)](https://broadrouter.com/de/glossary/api-key/) (Begriff)
-   [Concurrency (Parallelität)](https://broadrouter.com/de/glossary/concurrency/) (Begriff)
-   [Fehlercodes von BroadNet Inference: Wann ist ein Retry sinnvoll?](https://broadrouter.com/de/guides/errors-and-retries/) (Anleitung)
-   [API-Schlüssel per IP-Allowlist an Ihre Server binden](https://broadrouter.com/de/guides/api-keys-ip-allow-lists/) (Anleitung)
-   [Lang laufende Agenten: Timeouts, Retries und Checkpoints, die halten](https://broadrouter.com/de/blog/long-running-agents-timeouts-retries/) (Artikel)
-   [LLM-API-Schlüssel pro Stunde: der Stunden-Festpreis erklärt](https://broadrouter.com/de/blog/hourly-llm-api-key-explained/) (Artikel)

Testen Sie es mit Ihrem echten Workload. Neue Konten starten mit USD 5 Guthaben für Gemma und Transkription. DeepSeek, GLM und Qwen3.8 erfordern eine Aufladung.

[Loslegen](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-glossary-idempotency-key&utm_content=page-cta) ·

**Quellen**

-   [IETF HTTPAPI, The Idempotency-Key HTTP Header Field (Internet-Draft)](https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/)
-   [AWS Builders' Library, Timeouts, Retries und Backoff mit Jitter (Idempotenz-Tokens)](https://builder.aws.com/content/3EumjoZascWd1oZiEgL8ORlv3qE/timeouts-retries-and-backoff-with-jitter)
-   [API-Referenz von BroadNet Inference, Stundenschlüssel (Idempotenz per request\_id) (auf Englisch)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-glossary-idempotency-key&utm_content=sources#hourly-keys)
