Source: https://ailoot.ai/docs/de/how-it-works/
Canonical: https://ailoot.ai/docs/de/how-it-works/
Language: de

[Start](https://ailoot.ai/docs/de/) 

# KI-API: So funktioniert eine Anfrage in Ailoot

[Markdown](https://ailoot.ai/docs/de/how-it-works/index.md)

So funktioniert es

Was mit einer Anfrage zwischen Ihrer Anwendung und dem Modell geschieht.

Sie senden eine Anfrage an Ailoot API genauso wie direkt an OpenAI, Anthropic oder Google. Ailoot prüft Schlüssel und Guthaben, übermittelt die Anfrage an das Modell, liefert die Antwort im selben Format und bucht nach dem tatsächlichen Verbrauch ab.

<em>01</em><strong>Anfrage</strong>Ihr Client sendet eine Anfrage an api.ailoot.ai mit dem Schlüssel sk-…

<em>02</em><strong>Prüfung und Reservierung</strong>Schlüssel, Limits, Guthaben. Für die Antwort wird ein Betrag reserviert.

<em>03</em><strong>Modell</strong>Das Modell antwortet, und die Antwort wird in Ihrem Format zurückgegeben.

<em>04</em><strong>Abbuchung</strong>Eine Abbuchung nach den tatsächlichen Tokens; der Rest der Reservierung wird freigegeben.

## [](https://ailoot.ai/docs/de/how-it-works/#formats)Ein Schlüssel — drei Formate

Das Format wird vom Anfragepfad bestimmt, nicht vom Modell. Dasselbe Claude-Modell kann über OpenAI Chat, OpenAI Responses oder Anthropic Messages aufgerufen werden. Die Antwort entspricht dem Format des aufgerufenen Pfads.

| Format | Pfad | Welche Clients es verwenden |
| --- | --- | --- |
| OpenAI Chat Completions | `/v1/chat/completions` | OpenAI SDK, die meisten Chats und Editoren, n8n, LangChain |
| OpenAI Responses | `/v1/responses` | Codex CLI, OpenAI Agents SDK, neuere SDK-Versionen |
| Anthropic Messages | `/v1/messages` | Claude Code, Anthropic SDK, Zed, Cline |
| Gemini | `/v1beta/models/{model}:generateContent` | Gemini CLI, Google GenAI SDK |

## [](https://ailoot.ai/docs/de/how-it-works/#money)Abrechnung: Reservierung und eine Abbuchung

- Vor dem Versand einer neuen Textanfrage reserviert Ailoot einen anhand der Eingabe und einer typischen Antwort geschätzten Betrag unter Berücksichtigung des Limits (`max_tokens`) und der Bedingungen des konkreten Modells. Passt die Reservierung nicht in das freie Guthaben oder das Schlüssellimit, darf das übermittelte Limit nur bei einem Modell und einer Methode gesenkt werden, die es tatsächlich einhalten, und dabei weder unter 256 Tokens noch unter das festgelegte Mindestvolumen der Antwort. Für Bilder, Video und Audio als Ausgabe bleibt die vollständige Reservierung der Ergebniskosten bestehen.
- Nach der Antwort erfolgt eine Abbuchung nach dem tatsächlichen Verbrauch. Nicht genutztes reserviertes Guthaben wird sofort freigegeben.
- Übersteigen die Antwortkosten die Reservierung, wird die Differenz aus dem freien Guthaben genommen. Das Guthaben fällt nie ins Minus.
- Reicht das Guthaben nicht einmal für die minimale Reservierung, wird die Anfrage nicht gesendet. Sie erhalten einen verständlichen Fehler 402; es wird nichts abgebucht.
- Ein Fehler ohne Ergebnis wird nicht berechnet.

Einzelheiten und ein Rechenbeispiel stehen auf der Seite [Guthabenreservierung und Abbuchung](https://ailoot.ai/docs/de/billing/reserve/).

## [](https://ailoot.ai/docs/de/how-it-works/#errors)Fehler mit Request ID

Jede Antwort erhält eine Anfragekennung: im Header `X-Request-ID` und im Fehlertext. Fehler erscheinen als JSON im Format der aufgerufenen API und werden deshalb von den SDKs korrekt erkannt. Falls etwas schiefgeht, senden Sie die Request ID an den [Support](https://ailoot.ai/docs/de/support/) — so finden wir die Anfrage innerhalb einer Minute.

401 Unauthorized

```json
{
  "code": "API_KEY_REQUIRED",
  "error": {
    "code": "invalid_api_key",
    "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer <key>\". Request ID: 3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6.",
    "param": null,
    "reason": "invalid_api_key",
    "request_id": "3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6",
    "type": "invalid_request_error"
  },
  "message": "No API key was sent with the request. Nothing was charged. …"
}
```

## [](https://ailoot.ai/docs/de/how-it-works/#streaming)Streaming und Timeouts

Streaming-Antworten (`stream: true`) werden als Server-Sent Events geliefert. Kostenpflichtige Textantworten liefert Ailoot nach der Kostenberechnung. Deshalb bleibt mit `stream: true` das Format ein Stream (SSE), während der Text nach Abschluss durch das Modell als ein Block geliefert wird, nicht Wort für Wort. Dauert die Antwortvorbereitung länger als ungefähr 15 Sekunden, senden die Streams von Chat Completions, Responses und Messages zunächst technische Begleitzeilen `: ping` (ungefähr alle 10 Sekunden), danach die Zeile `: ailoot-charged-usd …` mit dem Abbuchungsbetrag und die eigentlichen Daten. Die SDKs überspringen solche Zeilen.

Im Gemini-Format gibt es keine technischen Begleitzeilen. Die Antwort über `:streamGenerateContent` wird nach der Berechnung vollständig geliefert. Planen Sie bei Reasoning-Modellen ausreichend Spielraum für den Client-Timeout ein; einige Minuten sind normal.

## [](https://ailoot.ai/docs/de/how-it-works/#headers)Antwortheader

`X-Request-ID` ist in jeder Antwort enthalten. Die übrigen Header fügt Ailoot kostenpflichtigen Textantworten hinzu:

| Header | Inhalt |
| --- | --- |
| `X-Request-ID` | Anfragekennung, die der Support benötigt |
| `X-Ailoot-Charged-USD` | Abgebuchter Betrag für diese Anfrage, in Dollar |
| `X-Ailoot-Output-Tokens` | Anzahl der bezahlten Antworttokens |
| `X-Ailoot-Max-Tokens-Capped` | Das gesenkte Antwortlimit, wenn das Guthaben für die vollständige Reservierung nicht ausreichte |
| `X-Ailoot-Notice-Code`, `X-Ailoot-Notice` | Erläuterung, wenn die Antwort am Längenlimit endete |

Hat der Stream bereits mit technischen Begleitzeilen begonnen, werden diese Informationen als Kommentarzeile vor den Daten geliefert, nicht als Header.

## [](https://ailoot.ai/docs/de/how-it-works/#cache)Prompt-Cache

Unterstützt das Modell Caching, kann ein erneut gesendeter langer Präfix, etwa Systemanweisung oder Dokumente, günstiger sein. Preise für Lesen und Schreiben stehen in der Modellkarte im [Katalog](https://ailoot.ai/models/de/). Ob der Cache getroffen wird, entscheidet der Modellentwickler; Ailoot garantiert dies nicht.

Noch Fragen? Senden Sie uns die Request ID und eine Beschreibung, damit wir Ihnen weiterhelfen können.[Support kontaktieren](mailto:support@ailoot.ai)

## Fragen zur Funktionsweise einer KI-API

### Was macht Ailoot bei einer KI-API-Anfrage?

Sie senden eine Anfrage an Ailoot API genauso wie direkt an OpenAI, Anthropic oder Google. Ailoot prüft Schlüssel und Guthaben, übermittelt die Anfrage an das Modell, liefert die Antwort im selben Format und bucht nach dem tatsächlichen Verbrauch ab.

## Ailoot · Das Unternehmen und sein Projektportfolio





Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle.





Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.





Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.