Transparentes Routing und Aufschlüsselung der Ausführung

GetVibe ist ein transparenter Router: Sie wählen entweder explizit eine öffentliche Variante über das Suffix :alias aus oder lassen den Modellnamen ohne Suffix – dann wählt das Gateway die Route gemäß Ihrer Konto-/Schlüsselstrategie und wechselt bei Fehlern zu einer anderen verfügbaren Variante. In Antworten und im Verlauf werden ausschließlich öffentliche Routenbezeichner verwendet.

"model": "claude-opus-4.8"          // auto — key strategy
"model": "claude-opus-4.8:yellow"   // pin — :yellow only, no switching to other channels
"model": "claude-opus-4.8:2"        // pin — catalog variant #2 (legacy :N syntax)

Jedes Modell wird über mehrere Kanäle zu unterschiedlichen Preisen bereitgestellt, also über eine Preisstaffel. Diese beiden Request-Body-Parameter bestimmen, welche Stufen dieser Staffel Sie bedienen dürfen. Beide werden in USD pro 1M Tokens angegeben, also in derselben Einheit und mit denselben Zahlen, die auf der Seite Models angezeigt werden. Sie werden mit unserem Preis verglichen, also mit dem Betrag, der Ihnen berechnet wird, niemals mit einem für Sie nicht sichtbaren Großhandelspreis.

{
  "model": "deepseek-v4-flash-0731",
  "messages": [{"role": "user", "content": "hi"}],
  "max_price": 0.02,
  "min_price": {"input": 0.001}
}

Beide Seiten müssen passen, Eingabe und Ausgabe – niemals ein Durchschnitt aus beiden. Ein Kanal, der bei der Eingabe günstig und bei der Ausgabe teuer ist, erfüllt keine einheitliche Begrenzung mit einer einzigen Zahl.

Eine dauerhaft geltende Obergrenze, die einmal im Cabinet festgelegt wird

Ein Preislimit muss nicht bei jedem Aufruf erneut angegeben werden. Das Dashboard speichert ein Limit pro API-Schlüssel und pro Modell sowie einen Standardwert, der für jedes Modell gilt, für das Sie kein eigenes Limit festgelegt haben, und die API liest dieses Limit bei jeder Anfrage. Eine Anfrage mit max_price verwendet stattdessen diesen Wert für genau diesen Aufruf; eine Anfrage ohne diesen Parameter verwendet Ihr gespeichertes Limit. Priorität, vom spezifischsten zum allgemeinsten:

Wo Sie die Preise lesen, die Sie begrenzen

GET /api/catalog veröffentlicht für jedes Modell ein channels-Array: einen Eintrag pro Kanal, auf dem eine Anfrage landen kann, nach dem Preis aufsteigend sortiert, jeweils mit der Adresse, über die Sie ihn fest angeben können, seinem inputUsd-/outputUsd-Preis pro 1M Tokens und der Angabe, ob er der Standard ist. Das sind genau die Zahlen, mit denen max_price und min_price verglichen werden, und genau die Zahlen, die Ihnen berechnet werden — eine Liste, nicht drei.

curl -s https://getvibeapi.com/api/catalog   | jq '.[] | select(.apiModel=="z-ai/glm-5.3") | .channels'

Was Ihnen in Rechnung gestellt wird

Ihnen wird der Kanal berechnet, der die Anfrage tatsächlich verarbeitet hat, zuzüglich unseres festen Aufschlags — nicht die von Ihnen festgelegte Obergrenze und niemals mehr als diese. Wenn Sie einen Preis begrenzen und die Anfrage auf einer günstigeren Stufe verarbeitet wird, zahlen Sie den günstigeren Preis. Die Staffelung auf der Modellseite zeigt eine Spanne, und der „ab“-Wert ist die günstigste vorhandene Stufe — es handelt sich um einen tatsächlichen Preis, der Ihnen berechnet werden könnte, nicht um ein Versprechen, dass diese Anfrage dort landet. Setzen Sie max_price, wenn Sie eine garantierte Obergrenze benötigen.

Wenn nichts passt

Die Anfrage wird abgelehnt: HTTP 422 mit "type": "price_bound_no_lane", wobei die günstigsten und teuersten Kanalpreise für dieses Modell und die vollständige Liste channels angegeben werden, damit Sie anhand der Zahlen eine Grenze auswählen können, statt eine zu schätzen. lowest_passing_usd_per_million ist die kleinste Grenze, die derzeit einen Kanal zulässt — das eigene Preispaar eines Kanals, sodass die Übermittlung erfolgreich ist (die beiden cheapest-Segmente können aus unterschiedlichen Kanälen stammen). Dasselbe Feld erscheint, wenn der Austausch selbst Ihre Grenze abgelehnt hat: Dann handelt es sich um die nächste Preisstufe, die noch verfügbare Kapazität hat, und sie ist niemals niedriger als die von Ihnen gesendete Grenze. Wenn Ihre Grenze nicht das Limit war — die eigene Einkaufsobergrenze für den Kanal war es, und die Angebote darunter waren ausgelastet oder erschöpft — lautet die Antwort stattdessen HTTP 503 "type": "no_seller_available" mit Retry-After und ohne Preisvorschlag: Eine Erhöhung von max_price würde nicht helfen, ein erneuter Versuch in Kürze könnte jedoch erfolgreich sein. Die günstigste Stufe enthält oft ein einzelnes ausgelastetes Angebot. Für zuverlässige Zuweisungen sollten Sie die Grenze daher auf oder über dem priceTypical des Modells festlegen, wo sich der Großteil des Angebots befindet. Wir bedienen niemals unbemerkt einen teureren Kanal und ersetzen niemals ein anderes Modell. Ein fehlerhafter Wert — eine Zeichenfolge, null, eine negative Zahl oder ein unbekanntes Feld — ist 400 invalid_request_error und wird niemals stillschweigend ignoriert.

{
  "error": {
    "message": "No channel of model "deepseek-v4-flash-0731" is priced within your max_price $0.0001 in / $0.0001 out...",
    "type": "price_bound_no_lane",
    "code": 422,
    "param": "max_price",
    "cheapest_usd_per_million": {"input": 0.0065, "output": 0.013},
    "dearest_usd_per_million": {"input": 0.0528, "output": 0.1584},
    "lowest_passing_usd_per_million": {"input": 0.0205, "output": 0.0613},
    "channels": [
      {"address": "deepseek/deepseek-v4-flash-0731:codebuddy-cn", "label": "codebuddy-cn", "inputUsd": 0.0205, "outputUsd": 0.0613, "isDefault": true},
      {"address": "deepseek/deepseek-v4-flash-0731:qwencloud", "label": "qwencloud", "inputUsd": 0.0378, "outputUsd": 0.1132, "isDefault": false}
    ]
  }
}

Kanäle, die aus einem Anbieter-Abonnementpool bereitgestellt werden, sind über ihren Namen adressierbar. Schreiben Sie den Namen nach einem Doppelpunkt, genau wie jeden anderen Alias:

"model": "gpt-6.1-sol:codex"         // pin a subscription pool
"model": "claude-opus-5.5:claude-code"  // pin the Claude Code pool

Das Suffix nach dem Doppelpunkt ist eine öffentliche Routenkennung, kein Upstream-Name. Die vollständige Liste für ein bestimmtes Modell finden Sie im Katalog (Models, Spalte «In API»). Wichtige Aliase:

Für auto-Anfragen (Modellname ohne Suffix) werden die folgenden Einstellungen für jeden API-Schlüssel festgelegt (Dashboard → API-Schlüssel):

Fügen Sie nach einem Doppelpunkt einen Anbieter-Alias hinzu — er wird unabhängig von der Routing-Strategie berücksichtigt. Die vollständige Liste der Aliase und Beispiele finden Sie im Abschnitt Models → Providers.

"model": "claude-opus-4.8"        // auto — key strategy
"model": "claude-opus-4.8:yellow"     // explicitly pin the :yellow channel
"model": "claude-opus-4.8:kiro-pool"  // explicitly pin the :kiro-pool channel

Für jeden API-Schlüssel können Sie im Dashboard Folgendes festlegen:

Bei einem reinen Modellnamen kann das Gateway zu einer anderen öffentlichen Variante desselben Modells wechseln, wenn die aktuelle Variante 429, 5xx oder ein leeres 200 ohne Inhalt zurückgegeben hat. Einschränkungen:

• Anfragen mit Bildern/PDF werden nicht zu einem anderen Anbieter umgeschaltet (Kompatibilität mit Vision).
• Das Failover wechselt nicht zu einer deutlich teureren Variante (außer strategy=price).
• Die Anzahl der Versuche pro Clientanfrage ist nach oben begrenzt.
• Mit pin (:alias) ist der anbieterübergreifende Failover-Mechanismus deaktiviert — Sie erhalten den Fehler der ausgewählten Route.

Das erneute Senden mit exponentiellem Backoff bei 429 wird unter Fehler und Limits beschrieben.

Bei vertrauenswürdigen Clients für die Aufdeckung/Fehlerdiagnose sind nach Abschluss der Anfrage (einschließlich auto) Header verfügbar, die zeigen, welche öffentliche Variante tatsächlich ausgeführt wurde. Normalen Clients werden diese Daten nicht bereitgestellt.

Antwort-Header für vertrauenswürdige Reveal-/Debug-Clients (chat / messages / responses)

curl -sD - https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"ping"}],"max_tokens":8}' \
  -o /dev/null | grep -i getvibe

# x-getvibe-route: yellow
# x-getvibe-model: gpt-6.1-sol:yellow

Nutzungsverlauf

In GET /v1/generations, GET /v1/usage und im Dashboard enthält jeder Datensatz die Felder:

GetVibe stellt keine «rohe» Auflistung der Weiterleitungsstrecke bereit, in der Upstream-Anbieter im Request Body aufgeführt werden. Die Steuerung erfolgt über den öffentlichen :alias, die Schlüsselstrategie und das automatische Failover innerhalb des Modellkatalogs. Es gibt keine separate API zum «Ignorieren von Anbietern» und keine Routing-ZDR-Flags.