Tovanix
Tovanix

KI-API-Gateway

Ein Token für Claude, GPT, Gemini und Qwen, vollständig kompatibel mit den offiziellen SDKs aller Anbieter. Die Migration erfordert gewöhnlich nur zwei Änderungen: base_url und api_key.

  • Protokollkompatibilität: native OpenAI-, Anthropic- und Gemini-Protokolle direkt aufrufen, ohne Umstrukturierung
  • Streaming: vollständiges SSE-Streaming mit vergleichbarer Ersttoken-Latenz wie beim direkten Anbieterzugang
  • Modellkatalog: verfügbare Modelle mit Kontextfenstern und Fähigkeiten (Bildverarbeitung / Werkzeuge / Denken)
  • Nutzung und Abrechnung: Token-Abrechnung mit Aufschlüsselung je Schlüssel

Ein einheitliches Gateway für mehrere Anbieter mit 3 offiziellen Protokollzugängen: Anthropic / OpenAI / Gemini. Über jedes der drei Formate lassen sich alle Modelle des Gateways aufrufen. Abrechnung nach Tokenverbrauch × offiziellem Preis × dem Faktor der Preisgruppe, die Ihr Schlüssel nutzt, ohne feste Monatsgebühr.

Grundinformationen

  • Authorization: Bearer sk-nc-... (Gemini unterstützt auch x-goog-api-key / ?key=)
  • Nach der Anmeldung auf der Seite „KI-Dienste → API-Schlüssel“ erstellen
  • Offizieller Preis in USD/MTok × Faktor der Preisgruppe; hat die Gruppe Nebenzeiten, werden Anfragen in diesen Zeiten zusätzlich mit dem Nebenzeitfaktor multipliziert. Vorab vom Guthaben abgezogen; Streaming-Aufrufe werden nach Abschluss asynchron abgerechnet
  • GPT mit dem Anthropic-SDK oder Claude mit dem OpenAI-SDK aufrufen — beides wird unterstützt; das Gateway übersetzt die Protokolle automatisch

3 Aufrufformate

Anthropic /v1/messages

Verwendet das messages-Protokoll von Claude; das verbreitetste SDK (@anthropic-ai/sdk / anthropic für Python)

OpenAI /v1/chat/completions

OpenAI-Chat-Completions-Protokoll; unterstützt tools, Streaming und multimodale Inhalte

Gemini /v1beta/models/...

Natives Google-Gemini-Protokoll; das Modell im Pfad bestimmt das Routing

Dienst- und Geschwindigkeitsklassen

Das Gateway leitet Anfragen immer in der Standardklasse weiter und berechnet den Standardpreis; ermäßigte oder schnellere Klassen gibt es nicht:

  • service_tier (flex / fast / priority usw.) wird aus dem Anfragekörper im OpenAI-Format entfernt
  • speed (schneller Modus) wird aus dem Anfragekörper im Anthropic-Format entfernt
  • Der Header X-Service-Tier hat keine Wirkung; Anfragen mit diesem Header werden in der Standardklasse verarbeitet

Fehlercodes

  • 401 — API-Schlüssel ungültig oder deaktiviert
  • 402 insufficient_balance — Guthaben unzureichend: verfügbares Guthaben (nach nicht abgerechneten Kosten) ≤ 0 oder nicht genug für den für diese Anfrage reservierten Betrag (geschätzt aus Kontext- und Ausgabelimit des Modells, bei serverseitiger Websuche zuzüglich „max. Suchen × Stückpreis“); die Fehlermeldung nennt benötigte Reservierung und verfügbares Guthaben. Aufladen und erneut versuchen. Fällt das verfügbare Guthaben unter $5, tragen Antworten X-Tovanix-Balance-Low: 1 und X-Tovanix-Balance-Available (USD), damit Sie frühzeitig warnen können
  • 402 quota_exceeded — Das monatliche Ausgabenlimit des Schlüssels wurde erreicht; es wird nächsten Monat zurückgesetzt. Sie können es auch auf der Seite „API-Schlüssel“ in der Konsole über „Limit ändern“ anpassen (Identitätsbestätigung erforderlich)
  • 403 group_unavailable — Die Preisgruppe, die dieser Schlüssel für den Anbieter des Modells nutzt, wurde deaktiviert. Wechseln Sie die Gruppe des Schlüssels auf der Seite API-Schlüssel; das Gateway wechselt nie von selbst in eine andere Gruppe
  • 503 no_upstream_available — Für das Modell gibt es in der Preisgruppe Ihres Schlüssels derzeit keine verfügbare Route (Routen deaktiviert oder vorübergehend pausiert). Versuchen Sie es später erneut oder wechseln Sie die Gruppe des Schlüssels auf der Seite API-Schlüssel, falls der Anbieter mehrere Gruppen hat
  • 502 — Der Modelldienst ist vorübergehend nicht verfügbar oder hat eine nicht auswertbare Antwort geliefert; versuchen Sie es später erneut

Weitere Endpunkte

Neben Chats bietet das Gateway auch:

GET /v1/models

Aktuell routbare Modelle auflisten (OpenAI-kompatibel; unterstützt SDK models.list())

POST /v1/embeddings

Texteinbettungen (OpenAI-kompatibel; input senden, Vektoren erhalten; Abrechnung je Token)

Beispiele für Python / Node.js

Für Playground, Preise und Aufrufprotokolle öffnen Sie Benutzerzentrum → KI-Dienste.

Häufig gestellte Fragen

Wie viel Code muss beim Wechsel von einer Anbieter-API geändert werden?

Gewöhnlich nur base_url und api_key. Das Gateway ist direkt mit offiziellen SDKs und Protokollen kompatibel. Aufrufinhalte, Antwortstrukturen und Streamingformate bleiben gleich.

Wird Streaming unterstützt?

Ja. SSE-Streaming wird vollständig unterstützt. stream=true funktioniert direkt aus den offiziellen SDKs, und die Ersttoken-Latenz entspricht dem direkten Anbieterzugang.

Verwandte Seiten: KI-Dienste · API-Dokumentation · Lösung für globale KI

Wird geladen…