Passer au contenu principal
GET
Lister les modèles de la passerelle
Appelez GET /v1/models pour lister les modèles vers lesquels vous pouvez router dès maintenant. Définissez availability=all pour inclure les modèles connus mais pas disponibles actuellement.
Chaque modèle liste une entrée dans offers par route de fournisseur (extrait, valeurs données à titre indicatif) :
N’envoyez du trafic de production que vers une offre dont routable vaut true. status_reason indique pourquoi une offre est en aperçu uniquement ou inactive. Le schéma complet figure ci-dessous. GET /models/me renvoie la même liste en appliquant les garde-fous de votre clé : les règles de confidentialité et de fournisseurs de votre espace de travail, ainsi que les garde-fous des départements de la clé, de son membre et de la clé elle-même. Les modèles bloqués par une règle de modèles et ceux sans fournisseur autorisé sont exclus, et chaque modèle ne garde que les offres vers lesquelles ses requêtes peuvent être acheminées. Il accepte les mêmes filtres que GET /models. La réponse contient aussi access : si une règle s’applique (restricted), les modèles exclus (hidden_model_count et hidden_models, avec identifiants et noms) et le nombre de modèles listés ayant perdu des fournisseurs (limited_model_count), pour expliquer pourquoi un modèle manque.

Filtrer la liste

Les filtres qui acceptent plusieurs valeurs prennent des paramètres répétés ou une liste séparée par des virgules. Pour examiner les routes de fournisseurs, le détail des paramètres et les tarifs d’un modèle, appelez GET /models/{author}/{slug}/endpoints.

Vérifier les niveaux de service par offre

Chaque entrée de offers contient service_tiers, les niveaux de service acceptés par cette offre du fournisseur. C’est un sous-ensemble trié par ordre alphabétique de flex, priority, standard et ultrafast, où priority correspond au niveau Fast. Un niveau est listé lorsque la route du fournisseur a pour lui une tarification active et en vigueur, et une route qui ne sert qu’un niveau ne liste que celui-ci. Certains niveaux sont aussi disponibles via des routes de fournisseur propres à un niveau, qui ne sont pas listées. Les prix sous pricing restent ceux du niveau standard.

Obtenir la liste au format OpenAI

Utilisez GET /v1/models?format=openai pour les clients qui attendent la réponse de liste de modèles d’OpenAI. Le format=json par défaut renvoie les métadonnées de modèles plus riches de Phaseo.
Le format OpenAI utilise la même authentification, la même disponibilité régionale, les mêmes modèles privés de l’espace de travail et les mêmes filtres que le JSON natif. Il renvoie tous les modèles correspondants, sauf si vous fournissez limit ; offset s’applique toujours. Les ID restent sous la forme canonique de Phaseo pour l’inférence. created reprend la date de sortie du catalogue, ou 0 si elle est inconnue ; owned_by reprend l’organisation du catalogue, private pour les modèles de l’espace de travail, ou phaseo si elle est inconnue.

Mettre en cache la liste des modèles

Les réponses du catalogue sont mises en cache pendant cinq minutes et peuvent être servies pendant cinq minutes de plus pendant la revalidation du cache. Cela s’applique aux représentations JSON, RSS et Atom du catalogue actuel ; le flux des sorties a son propre cache d’interrogation, plus court. Les réponses JSON et au format OpenAI contiennent un en-tête ETag faible (W/"…"). Il change lorsque les modèles de la page, limit, offset, total ou le format changent. Il ignore gateway_region : le même catalogue servi depuis une autre région a donc le même ETag. C’est pourquoi il est faible : les réponses qui le partagent sont équivalentes, mais leurs octets peuvent différer. Les réponses RSS, Atom et d’erreur n’en contiennent pas. Renvoyez la valeur enregistrée telle quelle dans If-None-Match. Si le catalogue n’a pas changé, la réponse est 304 Not Modified, sans corps, et reprend les en-têtes ETag, Cache-Control et Vary. Sinon, vous recevez un 200 normal avec la nouvelle liste et un nouvel ETag. If-None-Match accepte aussi une liste séparée par des virgules et *, et la comparaison est faible : la valeur correspond donc avec ou sans son préfixe W/.
Un 304 économise le transfert et l’analyse. Le serveur évalue quand même la requête : il charge le catalogue et recalcule l’ETag. Une interrogation toutes les 15 minutes environ suffit, en ne téléchargeant de nouveau la liste que lorsque le catalogue change. Conservez un ETag par URL de requête, car chaque page, ensemble de filtres et format a sa propre valeur.

Autorisations

Authorization
string
header
requis

Authentification par jeton Bearer

En-têtes

If-None-Match
string

ETag d’une réponse précédente au format JSON ou OpenAI pour la même URL. S’il correspond toujours, la réponse est 304 Not Modified, sans corps. Accepte une liste séparée par des virgules, des validateurs faibles (W/) et *.

Paramètres de requête

Recherche insensible à la casse dans les identifiants, noms et descriptions des modèles et les organisations.

Maximum string length: 200

Recherche insensible à la casse de fournisseurs ou d’organisations de modèles.

Maximum string length: 100
input_modality
enum<string>

Exiger une modalité d’entrée prise en charge.

Options disponibles:
text,
image,
audio,
video
minimum_context_tokens
number

Exiger au moins ce nombre de tokens de contexte d’entrée.

Plage requise: x >= 0
maximum_input_price_per_million
number

Prix maximal en USD par million de tokens d’entrée.

Plage requise: x >= 0
gateway_available_only
boolean
défaut:false

Renvoyer uniquement les modèles ayant au moins une offre routable du gateway.

sort_by
enum<string>
défaut:relevance

Champ utilisé pour trier les résultats de découverte des modèles.

Options disponibles:
relevance,
input_price,
output_price,
context_length,
provider_count
sort_order
enum<string>

Sens de tri facultatif. Les prix sont triés par ordre croissant par défaut ; les autres valeurs numériques par ordre décroissant.

Options disponibles:
asc,
desc
include
enum<string>[]

Indiquez parameter_specs pour ajouter les paramètres de requête de chaque offre dans la forme standard.

Options disponibles:
parameter_specs
endpoints
string[]

Filtrer par points de terminaison

organisation

Filtrer par organisation Identifiant de l’organisation.

Options disponibles:
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[]

Filtrer par ID du fournisseur

provider_status
string[]

Filtrer par état de déploiement du fournisseur

provider_routing_status
string[]

Filtrer par état de routage du fournisseur

model_routing_status
string[]

Filtrer par état de routage du modèle

capability_status
string[]

Filtrer par état des capacités du fournisseur

provider_availability_status
string[]

Filtrer par état de disponibilité du fournisseur

provider_availability_reason
string[]

Filtrer par motif de disponibilité du fournisseur

status
string[]

Filtrer par état du modèle

input_types
string[]

Filtrer par types d’entrée

input_modalities
string[]

Alias public de input_types.

output_types
string[]

Filtrer par types de sortie

output_modalities
string[]

Alias public de output_types.

params
string[]

Filtrer par paramètres

supported_parameters
string[]

Alias public de params.

availability
enum<string>
défaut:active

Filtre de disponibilité. active renvoie uniquement les modèles routables publiquement ; all inclut les états de disponibilité non routables.

Options disponibles:
active,
all
limit
integer
défaut:50

Limiter le nombre de résultats

Plage requise: 1 <= x <= 250
offset
integer
défaut:0

Décalage pour la pagination

Plage requise: 0 <= x <= 5000
format
enum<string>
défaut:json

Format de réponse. Le JSON natif de Phaseo est utilisé par défaut. Le format OpenAI renvoie toute la liste filtrée sauf si limit est fourni.

Options disponibles:
json,
openai,
rss,
atom
feed
enum<string>

Alias de format. Accepte json, rss ou atom.

Options disponibles:
json,
rss,
atom

Réponse

Liste des modèles

ok
boolean
requis
Exemple:

true

availability_mode
enum<string>
requis
Options disponibles:
active,
all
Exemple:

"active"

limit
integer
requis
Plage requise: 1 <= x <= 250
Exemple:

50

offset
integer
requis
Plage requise: 0 <= x <= 5000
Exemple:

0

total
integer
requis
Plage requise: x >= 0
Exemple:

128

models
object[]
requis
access
object

Renvoyé uniquement par /models/me : ce que les garde-fous de l’appelant ont exclu de la liste, avant la recherche et la pagination.

Dernière modification le 16 novembre 2026