Referenz

Auf dieser Seite

Vollständige Tabellen für Model Router. Konzepte und Anleitungen finden Sie ausgehend von der Übersicht.

Modul

ElementWert
Ort im MenüHauptmenü → Model Router, in der Gruppe AI Modules & Agents
Wer darauf zugreifen kannNur Organisation Administrator (Einrichtungen mit Technology Stack).
GeltungsbereichPro Einrichtung (wählen Sie die Einrichtung in der Hauptsymbolleiste aus)
WährungUSD

Aufladungen

EinstellungWert
Mindestbetrag für Aufladungen$10
Höchstbetrag einer einzelnen Aufladung$5,000
Vorgabebeträge$25, $50, $100, $250, $500, $1000
ZahlungsmethodeDie gespeicherte Zahlungskarte der Einrichtung
Zeitpunkt der GutschriftSofort
BelegBelegnummer + herunterladbares PDF pro Aufladung; wird außerdem per E-Mail an die Abrechnungskontakte der Einrichtung gesendet

Automatische Aufladung

EinstellungWert
AuslöserDas Guthaben fällt unter Ihren Schwellenwert When balance is below
AufladebetragIhr Betrag Top up by (mindestens $10)
PrüfintervallEtwa alle 15 Minuten
FehlerbehandlungBanner wird angezeigt bei: keine Karte hinterlegt, Karte erfordert Authentifizierung, Karte abgelehnt

Nutzung und Abgleich

ElementWert
Abgleich der NutzungAlle 15 Minuten mit dem Prepaid-Guthaben; angezeigt in Monthly usage, gruppiert nach Kalendermonat (UTC)
Available balanceLive: gutgeschriebener Gesamtbetrag abzüglich der laufenden Ausgaben (nicht nur das abgeglichene Konto)
Estimated runwayDurchschnittliche tägliche Ausgaben dieses Monats, hochgerechnet auf das Guthaben; angezeigt als 0 days, 1 day, N days, 365+ days oder Not enough data

Kontoweite Ausgabenlimits

LimitZurücksetzenVorgabebeträge
TageslimitJeden Tag um Mitternacht, Ortszeit der Einrichtung$25, $50, $100, $250
MonatslimitAm 1. jedes Monats, Ortszeit der Einrichtung$50, $100, $250, $500, $1000
Total (hard cap)Nur manuelles Zurücksetzen (Reset hard cap – Zähler auf $0, Limit unverändert, abgeschlossener Zeitraum wird im Verlauf der Zurücksetzungen gespeichert)—

Beliebige Kombinationen können aktiv sein. Die Limits gelten für alle API-Schlüssel und verbundenen Dienste zusammen; das Prepaid-Guthaben gilt zusätzlich. Bei Überschreitung werden Anfragen mit einem 402-Fehler budget_exceeded blockiert, bis das Zeitfenster zurückgesetzt wird.

Einstellungen pro Schlüssel / pro Dienst

EinstellungStandardHinweise
BezeichnungleerOptional; dient der Zuordnung der Nutzung in Activity und Logs
Verbindungstyp (nur API-Schlüssel)API keyAPI key bleibt in der Liste der API-Schlüssel; External agent erscheint unter Connected Services
Tägliches AusgabenlimitausWird zu Beginn jedes Tages zurückgesetzt, Zeitzone der Einrichtung
Monatliches AusgabenlimitausWird am 1. jedes Monats zurückgesetzt, Zeitzone der Einrichtung
GesamtlimitausGesamtausgaben über die Lebensdauer des Schlüssels oder Dienstes; wird nie zurückgesetzt
Requests / minUnbegrenztBei Überschreitung wird HTTP 429 zurückgegeben
Tokens / minUnbegrenztBei Überschreitung wird HTTP 429 zurückgegeben
Modelle beschränkenaus (alle für die Einrichtung aktivierten Modelle)Nur die ausgewählten Modelle sind mit diesem Schlüssel oder Dienst nutzbar
Guardrails der Einrichtung überschreibenaus (übernimmt die Einrichtung)Wenn aktiviert, gilt die eigene Auswahl des Schlüssels oder Dienstes – einschließlich „keine“

Status und Aktionen von API-Schlüsseln

StatusBedeutung
ActiveDer Schlüssel funktioniert.
Provisioning…Wird kurz angezeigt, während ein neuer Schlüssel eingerichtet wird.
DisabledDer Schlüssel ist widerrufen (die Zeile ist abgeblendet); er kann reaktiviert werden.
AktionUmkehrbar?Wirkung
Edit—Bezeichnung, Limits, Modelle und Guardrails ändern.
RotateNeinNeuer Geheimschlüssel wird ausgestellt (einmalig angezeigt); der alte funktioniert sofort nicht mehr.
RevokeJa (Re-activate)Schlüssel wird sofort deaktiviert.
DeleteNeinSchlüssel wird dauerhaft entfernt.

Modelle

ElementWert
StandardAlle Katalogmodelle aktiviert
Automatically enable new modelsWenn aktiviert, werden neu in den Katalog aufgenommene Modelle automatisch für die Einrichtung eingeschaltet
Einschränkung"At least one model must stay enabled."
SchnellvorgabenAll models, Frontier, Western providers, Open weights, Budget (Eingabepreis ≤ $1.00 / 1M Tokens)
FilterStatus (Any/Enabled/Disabled), Region (United States/Europe/China), Capability (Vision, Audio, PDF input, Reasoning)
SortierungRecommended, Name, Price, Context size – aufsteigend/absteigend
Angaben pro ModellKontextfenster, Eingabe- und Ausgabepreis pro 1M Tokens, Symbole für Fähigkeiten (Text, Bild, Audio, PDF), Reasoning-Einstellung

Auto Router

StufeBeschreibung
SimpleKurze, einfache Prompts
MediumAlltägliche Aufgaben
ComplexSchwierige, mehrstufige Aufgaben
ReasoningTiefgehendes Reasoning und Analysen
  • Modell-ID: auto; Usage-priced – abgerechnet wird der Tarif des Modells, das der Router pro Anfrage auswählt.
  • Routing pro Einrichtung über Edit routing bearbeitbar (nur aktivierte Modelle auswählbar; jede Stufe muss ein Modell haben); Reset to default stellt die Standardzuordnung wieder her.
  • Logs/Activity zeigen das ermittelte Modell; der Anfragebereich zeigt auto als Requested model.

Sicherheitsvorkehrungen

GuardrailAktion bei Treffer
PII maskingMaskiert personenbezogene Daten im Prompt; die Anfrage wird fortgesetzt
Secret redactionEntfernt Schlüssel/Tokens/Geheimnisse aus dem Prompt; die Anfrage wird fortgesetzt
Prompt-injection shieldBlockiert die Anfrage (403 content_policy_violation)
VorlageAktiviert
NoneNichts (Standard)
PII protectionPII masking
Secret redactionSecret redaction
Injection shieldPrompt-injection shield
StrictAlle drei

Inhaltsfilter

ElementWert
Maximale Anzahl Filter pro Einrichtung25
Maximale Länge eines Musters300 Zeichen
AktionenRedact (Treffer durch [REDACTED] ersetzen) oder Block (mit 403 ablehnen)
Sicherheit der MusterUnsichere reguläre Ausdrücke (z. B. Muster, die zu katastrophalem Backtracking neigen) und Muster mit mehr als 300 Zeichen werden verworfen und nicht angewendet
VererbungEinrichtungsweit; Schlüssel und Dienste mit überschriebenen Guardrails verwenden ihre eigene Liste

Transaktionsverlauf

Der Transaktionsverlauf listet nur Aufladungen und Guthabenanpassungen auf. Die Nutzung wird in Monthly usage zusammengefasst.

TypBedeutung
Top-upKartenbelastung, die dem Guthaben gutgeschrieben wird
RefundErstattete Belastung
AdjustmentManuelle Guthabenkorrektur
ElementWert
SpaltenDate, Type, Amount, Balance after, Receipt
Mehrere BelegeZeilen markieren, dann Download receipts (n)

Monatliche Nutzung

ElementWert
GruppierungKalendermonat (UTC); der aktuelle Monat ist mit Month to date gekennzeichnet
AbgleichAlle 15 Minuten mit dem Prepaid-Guthaben
SpaltenMonth, Usage, Deductions, Downloads
AbbuchungstypUsage charge (abgeglichene Inferenzausgaben), aufgeführt, wenn Sie einen Monat aufklappen
Downloads pro MonatDownload usage statement (PDF) und Download usage detail (CSV)
StatusNutzungsaufstellungen, keine Rechnungen; nur Kartenaufladungen haben Belege

Aktivität und Protokolle

ElementWert
Activity-AnsichtenOverview, Trends, Performance, Explore
ZeitraumvorgabenLast 24 hours, Last 7 days, Last 30 days, Last 90 days, Year, All time, Custom range
Zeitraumvorgaben in LogsLast 15 minutes, Last hour, Last 24 hours (Standard), Last 7 days, Last 30 days, benutzerdefiniert; Live-Aktualisierung Off / 10s / 30s (Standard) / 60s
Group-by-Optionen in ExploreModel, API key / agent, Source, Provider, Status
Obergrenze für CSV-Rohexporte25,000 Zeilen
ExporttypenRaw requests; Summary by model / by key & agent / by source / by period (Zusammenfassungen umfassen ganze Tage)
Gespeicherte InhalteNur Metadaten – nie Prompt- oder Antwortinhalte

API-Fehlerantworten

Basis-URL: wird unter Einstellungen → Service Access & API Keys → Connecting to the API angezeigt (z. B. https://app.performancehub.co/ai/v1). Fehler verwenden das OpenAI-Format { "error": { "message", "type", "code" } }.

HTTPtypecodeBedeutung
401invalid_request_errorinvalid_api_keyFehlender API-Schlüssel oder ungültige Anmeldedaten eines verbundenen Dienstes
401invalid_request_error—Unbekannter oder widerrufener API-Schlüssel ("Invalid API key")
402insufficient_quotainsufficient_creditsPrepaid-Guthaben aufgebraucht (oder bei verbundenen Diensten: die Einrichtung ist nicht aktiviert)
402insufficient_quotabudget_exceededEin Ausgabenlimit wurde erreicht (Einrichtung, Schlüssel oder verbundener Dienst); der Body enthält window, resetsAt, timezone, docsUrl
403invalid_request_error—"Model Router is not enabled for this facility" (API-Schlüssel) oder "Facility has no provisioned inference key" (zum Schlüssel gibt es keinen zugrunde liegenden Inferenzschlüssel)
403invalid_request_errorcontent_policy_violationDurch einen Inhaltsfilter oder den Prompt-Injection-Schutz blockiert
429——Ratenlimit für Anfragen/Min. oder Tokens/Min. überschritten
502server_error—Vorgelagerter Inferenzdienst nicht verfügbar (erneut versuchen)

Ein unerwarteter Fehler bei der Prüfung des API-Schlüssels gibt HTTP 500 "Something went wrong" zurück; versuchen Sie die Anfrage erneut.

GET /v1/models bleibt auch bei einem Guthaben von null verfügbar.