Konten und Zugriff
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Admin | Eine Workspace-Rolle, die Einstellungen nur für Admins verwaltet, etwa Budgets, Ausgabenregeln, Guardrails und Vertrauensrichtlinien, und das Auditprotokoll liest. | API, Dashboard, CLI, MCP |
| Inhaber | Eine Workspace-Rolle, die dieselben Einstellungen wie ein Admin verwaltet und Inhaber-E-Mails erhält, etwa Warnungen zu Modellabkündigungen. | API, Dashboard, CLI, MCP |
| Mitglied | Eine Workspace-Rolle, die den Workspace nutzt und seine Ausgabenregeln sehen, aber keine Einstellungen ändern kann, die Inhabern und Admins vorbehalten sind. | API, Dashboard, CLI, MCP |
| Workspace | Ein Container, der seine eigenen API-Schlüssel, Routing-Einstellungen, Voreinstellungen, Guardrails und seinen Admin-Zugang von anderen Workspaces getrennt hält. | API, Dashboard, CLI |
Schlüssel und Authentifizierung
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| API-Schlüssel | Ein Geheimnis, das mit phaseo_v1_sk_ beginnt und als Bearer-Token gesendet wird, um Modell- und Generierungsanfragen zu authentifizieren. | API, Dashboard, CLI, SDK, MCP |
| BYOK | Bring your own key: Phaseo routet Anfragen mit dem API-Schlüssel deines Anbieters, und der Anbieter rechnet die Modellnutzung ab. | API, Dashboard |
| BYOK-Fallback | Eine Workspace-Einstellung, die festlegt, ob eine fehlgeschlagene BYOK-Anfrage mit Phaseo-Credits wiederholt werden darf. | API, Dashboard |
| Funktion (Capability) | Eine Berechtigung auf einem Management-Schlüssel oder einer OAuth-Anmeldung, etwa keys:write, die festlegt, welche Verwaltungs-APIs aufgerufen werden dürfen. | API, Dashboard, CLI, MCP |
| Management-Schlüssel | Ein Geheimnis, das mit phaseo_v1_mk_ beginnt, für Verwaltungs-APIs wie Schlüssel, Voreinstellungen und Guardrails; damit lassen sich keine Inferenzanfragen senden. | API, Dashboard |
| OAuth-App | Eine App, die Personen mit Phaseo OAuth anmeldet und im Rahmen der Scopes und des Workspace, die sie freigeben, in ihrem Namen handelt. | API, Dashboard, CLI, MCP |
| Vertrauenswürdiger Workload | Ein Deployment oder CI-Job, der statt eines API-Schlüssels das kurzlebige OIDC-Token seiner Plattform sendet und über eine Vertrauensrichtlinie zugeordnet wird. | API, Dashboard |
Modelle und Anbieter
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Abgekündigt (Modell) | Das Labor oder der Anbieter hat die Einstellung des Modells angekündigt, und seine Anfragen werden weiterhin normal bedient. | API, Dashboard |
| Anbieter | Ein Unternehmen, das ein Modell hostet und dessen Verfügbarkeit, unterstützte Parameter, Preise und Leistung festlegt. | API, Dashboard, SDK, MCP |
| Anbieter-Statussymbol | Der Status, den Phaseo für eine Anbieterroute von Hand setzt: Active, Lower priority (nur als Reserve) oder Disabled. | Dashboard |
| Anbieterqualifizierte Modell-ID | Eine Modell-ID mit Anbieterpräfix, etwa baseten:thinking-machines/inkling-small, die ohne Fallback bei diesem Anbieter läuft. | API, SDK |
| Eingestellt (Modell) | Das Einstellungsdatum ist vorbei; Anfragen funktionieren, solange ein Anbieter das Modell bedient, und schlagen danach mit 410 model_retired fehl. | API, Dashboard |
| Kontextlänge | Die Kontextgröße, die eine Anbieterroute für ein Modell unterstützt, auf der Modellseite für jeden Anbieter angezeigt. | API, Dashboard |
| Modell-ID | Die ID, die du als model sendest, etwa openai/gpt-6-astra, angezeigt im Schnellstart auf jeder Modellseite. | API, Dashboard, CLI, SDK, MCP |
| Privates Modell | Ein dediziertes oder selbst gehostetes OpenAI-kompatibles Deployment in deinem Workspace, das nur dein Workspace sehen oder aufrufen kann. | API, Dashboard |
| Quantisierung | Das Speichern der Gewichte eines Modells in einem kleineren Zahlentyp, etwa FP8 oder INT4, was schnellere Antworten auf Kosten etwas Qualität bringt. | API, Dashboard, SDK |
| Routbares Modell | Ein Modell mit mindestens einer Anbieterroute, die gerade am Gateway aktiv ist; GET /v1/models listet standardmäßig nur diese Modelle. | API, Dashboard, MCP |
Anfragen und Antworten
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Gateway | Die Phaseo API unter https://api.phaseo.app/v1, die jede Anfrage an einen Anbieter routet, der das Modell hostet. | API, SDK |
| Gecachte Tokens | Eingabetokens, die der Anbieter aus seinem Prompt-Cache gelesen hat, zum Cache-Lesepreis abgerechnet und als cached_tokens gemeldet. | API, SDK |
| Generierungs-ID | Die Anfrage-ID mit dem Präfix G-, die in x-request-id und in Fehlerantworten zurückkommt; nutze sie für Logs, Abfragen und den Support. | API, Dashboard, SDK |
| Prompt-Caching | Den Anfang eines Prompts gleich halten, damit der Anbieter ihn aus dem Cache liest und zum Cache-Lesepreis abrechnet. | API, SDK |
| Reasoning-Aufwand | Wie viel ein Reasoning-Modell vor der Antwort nachdenkt, festgelegt mit reasoning.effort oder reasoning_effort, von none bis max. | API, SDK |
| Reasoning-Tokens | Tokens, die ein Reasoning-Modell vor seiner Antwort verbraucht; sie zählen als Ausgabe und nutzen einen Teil des Ausgabelimits. | API, SDK |
| Service-Stufe | Eine Geschwindigkeits- und Preisstufe für eine Textanfrage (standard, fast, ultrafast oder flex), die nur Anbieter bedienen, die sie anbieten. | API, SDK |
| Session-ID | Eine session_id, die du sendest, um die Anfragen einer Unterhaltung bei einem Anbieter zu halten, für bis zu 24 Stunden Aktivität. | API, Dashboard, SDK |
| Streaming | stream: true setzen, damit das Gateway die Ausgabe als Server-Sent Events sendet, während das Modell sie schreibt. | API, SDK |
| Tokens | Die Einheiten, die ein Modell als Eingabe liest und als Ausgabe schreibt; jedes Token erhöht Latenz und Kosten. | API, Dashboard, SDK |
| Usage-Objekt | Das Feld usage in einer Antwort, das die Anzahl der Eingabe-, Ausgabe- und Cache-Tokens der Anfrage meldet. | API, SDK |
Routing
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Alpha- und Beta-Anbieterkanäle | Schalter in den Routing-Einstellungen, damit Vorschau-Anbieter nur dann Traffic bekommen, wenn du dich dafür entscheidest; provider.include_alpha erlaubt Alpha-Anbieter pro Anfrage. | API, Dashboard |
| Anbieter-Fallback | Wenn der gewählte Anbieter fehlschlägt, versucht das Gateway den nächsten geeigneten Anbieter für dasselbe Modell. | API, SDK |
| Anbietersortierung | Wie Anbieter gereiht werden: balanced (Standard, Kosten pro erfolgreicher Antwort), price, latency oder throughput. | API, Dashboard, CLI, SDK |
| Auto Routing | Sende phaseo/auto, und Phaseo wählt für jede Anfrage ein Modell anhand der Arbeitslast, deines Ziels und deiner Preisgrenzen. | API, Dashboard, CLI, SDK, Slack |
| Dynamische Route | Ein versionierter Ablauf von Regeln, der an API-Schlüssel angehängt ist und verzweigen, Traffic aufteilen, die Nutzung begrenzen und Modelle wechseln kann. | API, Dashboard |
| Kostenloser Router | Sende phaseo/free, und Phaseo führt die Anfrage auf einem verfügbaren kostenlosen Modell aus, ganz ohne Credits. | API, SDK |
| Modell-Fallbacks | In models aufgeführte Modelle, die der Reihe nach versucht werden, wenn das vorherige Modell mit 429, 500, 502, 503 oder 504 endet. | API, SDK |
| Prompt-Vorlage | Nachrichten einer Voreinstellung mit {{variables}}, sodass jede Anfrage nur den Verweis auf die Voreinstellung und die Variablenwerte sendet. | API, Dashboard, SDK |
| Regionales Routing | Textanfragen an eu.api.phaseo.app oder us.api.phaseo.app senden, um nur Routen zu nutzen, die dort laufen. | API, SDK |
| Routing für eingestellte Modelle | Eine optionale Workspace-Einstellung, die Anfragen für ein Modell, das kein Anbieter mehr bedient, an einen freigegebenen oder gewählten Ersatz sendet. | API, Dashboard |
| Versionslabel einer Voreinstellung | Ein Name wie production, der auf eine veröffentlichte Version einer Voreinstellung zeigt; wenn du ihn verschiebst, wechseln Anfragen auf eine neuere oder ältere Version. | API, Dashboard, SDK |
| Voreinstellung | Ein gespeichertes Modell mit Systemprompt, Parametern und Anbieterregeln, das Aufrufer über seinen Namen nutzen, etwa @support-triage. | API, Dashboard, SDK |
Guardrails und Datenschutz
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Guardrail | Eine Richtlinie für API-Schlüssel oder Mitglieder, die Anbieter, Modelle und Datenverarbeitung einschränkt und Prompts prüft; Ausgaben begrenzt sie nicht. | API, Dashboard |
| Guardrail-Aktion | Was eine Inhaltsprüfung eines Guardrails bei einem Treffer tut: Markieren, Schwärzen oder Blockieren. | API, Dashboard |
| I/O-Protokollierung | Eine Datenschutzeinstellung, die Prompt und Antwort jeder Anfrage speichert, damit du sie ansehen, erneut ausführen oder im Chat öffnen kannst. | API, Dashboard, Chat |
| Prompt-Injection-Prüfung | Eine Guardrail-Prüfung, die von Nutzern gelieferte Inhalte auf gängige Prompt-Injection-Muster untersucht. | API, Dashboard |
| Prüfung auf sensible Daten | Eine Guardrail-Prüfung, die Daten wie E-Mail-Adressen, Telefonnummern und Kartennummern findet, bevor die Anfrage Phaseo verlässt. | API, Dashboard |
| ZDR | Zero Data Retention: Der Anbieter speichert keine Prompts oder Ausgaben; du kannst es pro Anfrage, pro Guardrail oder pro Workspace verlangen. | API, Dashboard, CLI, SDK, MCP |
Tools und Ausgaben
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Decisions-API | POST /v1/decisions, das typisierte Fragen (predicate, choice, score) mit Wahrscheinlichkeiten in der gestellten Reihenfolge beantwortet. | API, SDK |
| Response Healing | Ein Plugin, das fast gültiges JSON repariert, etwa JSON in einem Markdown-Codeblock, bevor es deinen Parser erreicht. | API, SDK |
| Server-Tool | Ein phaseo:-Tool, das Phaseo ausführt, wenn das Modell es aufruft, etwa phaseo:web_search, phaseo:web_fetch, phaseo:datetime oder phaseo:advisor. | API, SDK, Chat |
| Strukturierte Ausgaben | Ein JSON Schema senden, damit das Modell JSON in dieser Form statt freiem Text zurückgibt. | API, SDK |
| Tool-Aufrufe | Deine Funktionen in tools beschreiben, damit das Modell einen Aufruf zurückgibt, den deine App ausführt, und dann mit dem Ergebnis antwortet. | API, SDK |
Kosten, Limits und Abrechnung
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Abteilungsbudget | Eine tägliche, wöchentliche oder monatliche Ausgabenobergrenze für die Schlüssel und OAuth-Anfragen, die einer Abteilung zugerechnet werden. | API, Dashboard |
| Ausgabenregel | Eine Regel, die warnt, wenn die Ausgaben eines Bereichs einen Schwellenwert überschreiten, und weitere Anfragen mit 429 spend_rule_blocked blockieren kann. | API, Dashboard |
| Ausgabenwarnung | Die Benachrichtigung, die eine Ausgabenregel sendet, wenn Ausgaben, eine Prognose, ein Ausreißer oder das Guthaben ihren Schwellenwert überschreiten. | API, Dashboard |
| Budget | Eine Ausgabenobergrenze für den Workspace (täglich, wöchentlich, monatlich oder insgesamt); Anfragen darüber hinaus erhalten 429 key_limit_exceeded. | API, Dashboard |
| Credits | Vorausbezahltes Workspace-Guthaben, das kostenpflichtige Anfragen zu Katalogpreisen verbrauchen; auf Käufe fällt eine Gebühr von 5 % an (mindestens $1), und :free-Modelle brauchen keine Credits. | API, Dashboard, CLI, MCP |
| Ratenlimit | Die erlaubten Anfragen pro Minute für jeden Nutzer in jedem Workspace; sie steigen, je etablierter der Workspace ist. | API, CLI |
| Schlüssellimit | Eine tägliche, wöchentliche oder monatliche Obergrenze für Anfragen oder Ausgaben eines API-Schlüssels, die bei jeder Anfrage geprüft wird. | API, Dashboard, CLI |
Observability
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Anfrage-Klassifikator | Eine Taxonomie und ein Modell, die jede abgeschlossene Anfrage kennzeichnen; die Kennzeichnungen werden als Anfragekennzeichnungen gespeichert, nach denen du filtern kannst. | API, Dashboard |
| Anfragekennzeichnung | Ein Schlüssel-Wert-Paar wie team=support, das im Header X-Phaseo-Metadata gesendet wird, um Ausgaben und Logs zu filtern. | API, SDK |
| Anfrageprotokolle | Ein Eintrag pro Anfrage mit Nutzung, Latenz, Kosten, Fehlern und dem Anbieter, der sie bedient hat. | API, Dashboard, CLI, MCP |
| App-Zuordnung | Header wie X-App-Id, X-Title und HTTP-Referer, die die Nutzung einer Anfrage unter einer App gruppieren. | API, SDK |
| Auditprotokoll | Die Aufzeichnung, wer Schlüssel, Mitglieder und andere Admin-Einstellungen geändert hat; nur Inhaber und Admins können sie lesen. | API, Dashboard, CLI |
| Broadcast | Sendet einen Trace jeder Gateway-Anfrage an ein Observability-Tool, einen Webhook, einen Speicher-Bucket oder ein Data Warehouse, ohne Codeänderungen. | API, Dashboard |
| Im Chat öffnen | Setzt eine gespeicherte Anfrage oder einen Sitzungsschritt als Unterhaltung im Chat fort, mit demselben oder einem anderen Modell. | Dashboard, Chat |
Asynchrone Aufträge
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Asynchroner Auftrag | Eine Video- oder Batch-Anfrage, die sofort einen Auftrag zurückgibt; du fragst ihn ab oder wartest auf einen Webhook, bis er fertig ist. | API, SDK |
| Batch | Ein Auftrag der Batch-API für große, zeitversetzte Workloads, bei dem jede Zeile ein Modell anspricht. | API, SDK |
| Videoauftrag | Eine Anfrage an die Video-API, die einen Auftrag zurückgibt; lade das Video herunter, sobald sein Status completed ist. | API, SDK |
| Webhook-Endpunkt | Eine Workspace-URL, die signierte Statusereignisse für Video- und Batch-Aufträge empfängt. | API, Dashboard |
Enterprise
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Abteilung | Eine Gruppe von Workspace-Mitgliedern, von Hand verwaltet oder aus deinem Verzeichnis synchronisiert, auf die Budgets, Ratenlimits und Ausgabenregeln zielen können. | API, Dashboard |
| Identity-Add-on | Das Workspace-Add-on, das du brauchst, um SSO oder SCIM einzuschalten, Provisioning-Tokens zu erstellen und das Verzeichnis zu verwalten. | API, Dashboard |
| SCIM | Bereitstellung von Workspace-Mitgliedern und Abteilungen aus deinem Identitätsanbieter mit einem SCIM-Provisioning-Token. | API, Dashboard |
| Self Serve Enterprise | Ein monatliches Workspace-Abonnement für SSO, SCIM, Verzeichnisverwaltung, Abteilungen und bevorzugten E-Mail-Support. | Dashboard |
| SSO | Single Sign-On für Workspace-Mitglieder über SAML oder einen eigenen OIDC-Anbieter. | API, Dashboard |
| Verzeichnis | Die Enterprise-Abteilungen des Workspace und die effektiven Berechtigungen jedes Mitglieds, verwaltet von Inhabern und Admins. | API, Dashboard |
CLI, MCP, SDKs und Apps
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Agent Skills | Öffentliche Phaseo-Anleitungen für Coding-Agenten zu Gateway, SDKs, Voreinstellungen, Routing und Migrationen. | API, CLI, SDK |
| Client-SDK | Ein Phaseo-Paket für deine Sprache mit einer Methode pro Gateway-Endpunkt, etwa @phaseo/sdk oder phaseo. | SDK |
| Docs MCP | Ein schreibgeschützter MCP-Server unter https://phaseo.app/docs/mcp, mit dem Coding-Assistenten diese Dokumentation durchsuchen und lesen können. | MCP |
| Phaseo CLI | Der Befehl phaseo zum Erstellen von Schlüsseln, Ändern von Einstellungen und Automatisieren von Admin-Aufgaben aus einer Shell oder aus CI. | CLI |
| Phaseo MCP | Ein MCP-Server, der KI-Clients aktuelle Daten zu Modellen, Preisen, Nutzung und Workspace liefert und optional dein Konto verwalten kann. | MCP |
| Slack-Agent | Der Phaseo-Agent in Slack, der auf Erwähnungen und Direktnachrichten mit dem Modell antwortet, das dein Workspace gewählt hat. | Dashboard, Slack |
Funktionsphasen
| Begriff | Bedeutung | Gilt für |
|---|---|---|
| Abgekündigt (Funktion) | Eine Funktion, die noch funktioniert, aber entfernt wird; ihre Seite nennt das Entfernungsdatum, sobald eines feststeht. | API, Dashboard, CLI, SDK, MCP, Chat, Slack |
| Allgemein verfügbar | Eine stabile Funktion, die ohne Phasen-Badge angezeigt wird. | API, Dashboard, CLI, SDK, MCP, Chat, Slack |
| Alpha | Eine frühe Funktion, die sich stark ändern oder entfernt werden kann. | API, Dashboard, CLI, SDK, MCP, Chat, Slack |
| Auf Anfrage | Eine Funktion, die pro Workspace freigeschaltet wird; bis dahin ist ihre Einstellungsseite ausgeblendet und ihre API gibt einen Fehler zurück. | API, Dashboard |
| Beta | Eine Funktion, die für ihren Hauptzweck funktioniert, deren Einzelheiten sich aber ändern können; Änderungen werden im Changelog angekündigt. | API, Dashboard, CLI, SDK, MCP, Chat, Slack |
| Funktionsvorschau | Die Einstellungsseite, die zeigt, ob die Video-API und die Batch-API für deinen Workspace freigeschaltet sind. | Dashboard |