Zum Hauptinhalt springen
GET
Gateway-Modelle auflisten
Rufe GET /v1/models auf, um die Modelle aufzulisten, an die du gerade routen kannst. Setze availability=all, um auch Modelle einzubeziehen, die bekannt, aber derzeit nicht verfügbar sind.
Jedes Modell führt in offers einen Eintrag pro Anbieter-Route (gekürzt, Werte zur Veranschaulichung):
Route Produktions-Traffic nur an ein Angebot, dessen routable gleich true ist. status_reason erklärt, warum ein Angebot nur Vorschau oder inaktiv ist. Das vollständige Schema steht unten. GET /models/me gibt dieselbe Liste mit den Guardrails deines Schlüssels zurück: den Datenschutz- und Anbieterregeln deines Workspace sowie den Guardrails der Abteilungen des Schlüssels, seines Mitglieds und des Schlüssels selbst. Modelle, die eine Modellregel sperrt, und Modelle ohne erlaubten Anbieter fehlen, und jedes Modell behält nur die Angebote, an die seine Anfragen geleitet werden dürfen. Es nimmt dieselben Filter wie GET /models an. Die Antwort enthält außerdem access: ob eine Regel greift (restricted), welche Modelle die Regeln ausschließen (hidden_model_count und hidden_models, mit IDs und Namen) und wie viele gelistete Modelle Anbieter verloren haben (limited_model_count), damit du erklären kannst, warum ein Modell fehlt.

Die Liste filtern

Filter, die mehrere Werte annehmen, akzeptieren wiederholte Parameter oder eine kommagetrennte Liste. Um die Anbieter-Routen, Parameterdetails und Preise eines einzelnen Modells zu prüfen, rufe GET /models/{author}/{slug}/endpoints auf.

Service-Tiers pro Angebot prüfen

Jeder Eintrag in offers enthält service_tiers, die Service-Tiers, die dieses Anbieterangebot akzeptiert. Es ist eine alphabetisch sortierte Teilmenge von flex, priority, standard und ultrafast, wobei priority die Fast-Stufe ist. Eine Stufe wird aufgeführt, wenn die Anbieter-Route aktive, derzeit gültige Preise für sie hat, und eine Route, die nur eine Stufe bedient, führt nur diese Stufe auf. Einige Stufen sind auch über separate, stufenspezifische Anbieter-Routen verfügbar, die nicht aufgeführt werden. Die Preise unter pricing bleiben Preise der Standardstufe.

Die Liste im OpenAI-Format abrufen

Verwende GET /v1/models?format=openai für Clients, die die Modelllisten-Antwort von OpenAI erwarten. Der Standard format=json gibt die umfangreicheren Modellmetadaten von Phaseo zurück.
Das OpenAI-Format verwendet dieselbe Authentifizierung, regionale Verfügbarkeit, privaten Workspace-Modelle und Filter wie natives JSON. Es gibt alle passenden Modelle zurück, sofern du kein limit angibst; offset gilt weiterhin. IDs bleiben für die Inferenz in der kanonischen Form von Phaseo. created verwendet das Veröffentlichungsdatum aus dem Katalog oder 0, wenn es unbekannt ist; owned_by verwendet die Organisation aus dem Katalog, private für Workspace-Modelle oder phaseo, wenn sie unbekannt ist.

Die Modellliste zwischenspeichern

Katalogantworten werden fünf Minuten lang zwischengespeichert und können weitere fünf Minuten ausgeliefert werden, während der Cache neu validiert wird. Das gilt für die JSON-, RSS- und Atom-Darstellungen des aktuellen Katalogs; der Release-Feed hat einen eigenen, kürzeren Polling-Cache. JSON-Antworten und Antworten im OpenAI-Format enthalten einen schwachen ETag-Header (W/"…"). Er ändert sich, wenn sich die Modelle auf der Seite, limit, offset, total oder das Format ändern. Er ignoriert gateway_region, sodass derselbe Katalog aus einer anderen Region denselben ETag hat. Deshalb ist er schwach: Antworten mit demselben Wert sind gleichwertig, ihre Bytes können sich aber unterscheiden. RSS-, Atom- und Fehlerantworten enthalten keinen. Sende den gespeicherten Wert unverändert in If-None-Match zurück. Hat sich der Katalog nicht geändert, lautet die Antwort 304 Not Modified ohne Body und wiederholt die Header ETag, Cache-Control und Vary. Andernfalls erhältst du ein normales 200 mit der neuen Liste und einem neuen ETag. If-None-Match akzeptiert auch eine kommagetrennte Liste und *, und der Vergleich ist schwach, sodass der Wert mit oder ohne sein Präfix W/ passt.
Ein 304 spart Übertragung und Parsing. Der Server wertet die Anfrage trotzdem aus: Er lädt den Katalog und berechnet den ETag neu. Ein Abruf etwa alle 15 Minuten reicht; die Liste wird nur dann erneut heruntergeladen, wenn sich der Katalog ändert. Speichere einen ETag pro Anfrage-URL, weil jede Seite, jede Filterkombination und jedes Format einen eigenen Wert hat.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Header

If-None-Match
string

ETag aus einer früheren Antwort im JSON- oder OpenAI-Format für dieselbe URL. Stimmt er noch überein, lautet die Antwort 304 Not Modified ohne Antworttext. Akzeptiert eine durch Kommas getrennte Liste, schwache Validatoren (W/) und *.

Abfrageparameter

Suche ohne Beachtung der Groß-/Kleinschreibung in Modell-IDs, Namen, Beschreibungen und Organisationen.

Maximum string length: 200

Suche nach Anbietern oder Modellorganisationen ohne Beachtung der Groß-/Kleinschreibung.

Maximum string length: 100
input_modality
enum<string>

Eine unterstützte Eingabemodalität voraussetzen.

Verfügbare Optionen:
text,
image,
audio,
video
minimum_context_tokens
number

Mindestens diese Anzahl an Eingabe-Kontexttokens voraussetzen.

Erforderlicher Bereich: x >= 0
maximum_input_price_per_million
number

Maximaler Eingabetokenpreis in USD pro Million Tokens.

Erforderlicher Bereich: x >= 0
gateway_available_only
boolean
Standard:false

Nur Modelle mit mindestens einem routbaren Gateway-Angebot zurückgeben.

sort_by
enum<string>
Standard:relevance

Feld zum Sortieren der Ergebnisse der Modellerkennung.

Verfügbare Optionen:
relevance,
input_price,
output_price,
context_length,
provider_count
sort_order
enum<string>

Optionale Sortierrichtung. Preise werden standardmäßig aufsteigend sortiert, andere Zahlenwerte absteigend.

Verfügbare Optionen:
asc,
desc
include
enum<string>[]

Auf parameter_specs setzen, um die Anfrageparameter jedes Angebots in der einheitlichen Form hinzuzufügen.

Verfügbare Optionen:
parameter_specs
endpoints
string[]

Nach Endpunkten filtern

organisation

Nach Organisation filtern Organisationskennung.

Verfügbare Optionen:
01-ai,
adept,
ai21,
aion-labs,
aisingapore,
alibaba,
allenai,
amazon,
anthracite-org,
anthropic,
arcee-ai,
baai,
baichuan,
baidu,
bigcode,
black-forest-labs,
bytedance,
bytedance-seed,
cogito,
cognitivecomputations,
cohere,
crofai,
cursor,
cyfragovpl,
databricks,
dealignai,
decart,
deepseek,
dots-studio,
early-access,
eleven-labs,
essential-ai,
fastino,
fish-audio,
github,
google,
gryphe,
hexgrad,
ibm,
ibm-granite,
inception,
inclusionai,
inference-net,
inflection,
intfloat,
jetbrains,
kblab,
kling,
kuaishou,
kwaipilot,
kwaivgi,
lg,
lightricks,
liquid-ai,
mancer,
medaibase,
meituan,
meta,
microsoft,
mindai,
minimax,
mistral,
mistralai,
moonshotai,
morph,
naver-hyperclova,
near-ai,
nex-agi,
nous,
nousresearch,
novasearch,
nvidia,
openai,
openbmb,
opencompass,
opengvlab,
orcarouter,
ornith,
perceptron,
perplexity,
phala,
pixverse,
poe,
poolside,
prime-intellect,
prism-ml,
qwen,
reka,
relace,
runway,
sakana,
sao10k,
sapiens-ai,
sentence-transformers,
sference,
shanghai-ai-laboratory,
shengshu-ai,
snowflake,
sourceful,
spacex-ai,
speakleash,
stability-ai,
stealth,
stepfun,
suno,
tencent,
thedrummer,
thinking-machines,
undi95,
upstage,
venice,
vercel,
villanova-ai,
voyage,
windsurf,
writer,
xai,
xgenerationlab,
xiaomi,
z-ai,
zyphra
provider
string[]

Nach Anbieter-ID filtern

provider_status
string[]

Nach Anbieter-Rolloutstatus filtern

provider_routing_status
string[]

Nach Anbieter-Routingstatus filtern

model_routing_status
string[]

Nach Modell-Routingstatus filtern

capability_status
string[]

Nach Anbieter-Fähigkeitsstatus filtern

provider_availability_status
string[]

Nach Anbieter-Verfügbarkeitsstatus filtern

provider_availability_reason
string[]

Nach Anbieter-Verfügbarkeitsgrund filtern

status
string[]

Nach Modellstatus filtern

input_types
string[]

Nach Eingabetypen filtern

input_modalities
string[]

Öffentlicher Alias für input_types.

output_types
string[]

Nach Ausgabetypen filtern

output_modalities
string[]

Öffentlicher Alias für output_types.

params
string[]

Nach Parametern filtern

supported_parameters
string[]

Öffentlicher Alias für params.

availability
enum<string>
Standard:active

Verfügbarkeitsfilter. active gibt nur öffentlich routbare Modelle zurück; all umfasst auch nicht routbare Verfügbarkeitsdatensätze.

Verfügbare Optionen:
active,
all
limit
integer
Standard:50

Anzahl der Ergebnisse begrenzen

Erforderlicher Bereich: 1 <= x <= 250
offset
integer
Standard:0

Offset für die Paginierung

Erforderlicher Bereich: 0 <= x <= 5000
format
enum<string>
Standard:json

Antwortformat. Standard ist das native JSON von Phaseo. Das OpenAI-Format gibt die gesamte gefilterte Liste zurück, sofern limit nicht angegeben ist.

Verfügbare Optionen:
json,
openai,
rss,
atom
feed
enum<string>

Alias für format. Akzeptiert json, rss oder atom.

Verfügbare Optionen:
json,
rss,
atom

Antwort

Modellliste

ok
boolean
erforderlich
Beispiel:

true

availability_mode
enum<string>
erforderlich
Verfügbare Optionen:
active,
all
Beispiel:

"active"

limit
integer
erforderlich
Erforderlicher Bereich: 1 <= x <= 250
Beispiel:

50

offset
integer
erforderlich
Erforderlicher Bereich: 0 <= x <= 5000
Beispiel:

0

total
integer
erforderlich
Erforderlicher Bereich: x >= 0
Beispiel:

128

models
object[]
erforderlich
access
object

Nur von /models/me geliefert: was die Guardrails des Aufrufers aus der Liste ausgeschlossen haben, vor Suche und Paginierung.

Zuletzt geändert am 16. November 2026