KI-API: So funktioniert eine Anfrage in Ailoot

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.

• 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.

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 — so finden wir die Anfrage innerhalb einer Minute.

{
  "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. …"
}

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.

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

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

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. Ob der Cache getroffen wird, entscheidet der Modellentwickler; Ailoot garantiert dies nicht.