Saltar al contenido principal
GET
Listar modelos de la pasarela
Llama a GET /v1/models para listar los modelos a los que puedes enrutar ahora mismo. Configura availability=all para incluir los modelos conocidos que no están disponibles en este momento.
Cada modelo incluye una entrada en offers por cada ruta de proveedor (resumido, valores ilustrativos):
Enruta tráfico de producción solo a una oferta cuyo routable sea true. status_reason explica por qué una oferta está solo en vista previa o inactiva. El esquema completo aparece más abajo. GET /models/me devuelve la misma lista con los guardrails de tu clave aplicados: las reglas de privacidad y de proveedores de tu espacio de trabajo, y los guardrails de los departamentos de la clave, de su miembro y de la propia clave. Se omiten los modelos que bloquea una regla de modelos y los que no tienen ningún proveedor permitido, y cada modelo conserva solo las ofertas a las que se pueden enviar sus solicitudes. Acepta los mismos filtros que GET /models. La respuesta también incluye access: si se aplica alguna regla (restricted), los modelos que dejan fuera (hidden_model_count y hidden_models, con ids y nombres) y cuántos modelos listados perdieron algún proveedor (limited_model_count), para que puedas explicar por qué falta un modelo.

Filtra la lista

Los filtros que aceptan varios valores admiten parámetros repetidos o una lista separada por comas. Para consultar las rutas de proveedores, el detalle de parámetros y los precios de un modelo, llama a GET /models/{author}/{slug}/endpoints.

Comprueba los niveles de servicio de cada oferta

Cada entrada de offers incluye service_tiers, los niveles de servicio que acepta esa oferta del proveedor. Es un subconjunto ordenado alfabéticamente de flex, priority, standard y ultrafast, donde priority es el nivel Fast. Un nivel aparece cuando la ruta del proveedor tiene precios activos y vigentes para él, y una ruta que atiende un solo nivel enumera solo ese nivel. Algunos niveles también están disponibles mediante rutas de proveedor específicas de cada nivel que no aparecen en la lista. Los precios de pricing siguen siendo los del nivel estándar.

Obtén la lista en formato OpenAI

Usa GET /v1/models?format=openai para los clientes que esperan la respuesta de lista de modelos de OpenAI. El valor predeterminado format=json devuelve los metadatos de modelo más completos de Phaseo.
El formato OpenAI usa la misma autenticación, disponibilidad regional, modelos privados del espacio de trabajo y filtros que el JSON nativo. Devuelve todos los modelos que coinciden salvo que indiques limit; offset se sigue aplicando. Los IDs se mantienen en la forma canónica de Phaseo para la inferencia. created usa la fecha de lanzamiento del catálogo, o 0 si se desconoce; owned_by usa la organización del catálogo, private para los modelos del espacio de trabajo, o phaseo si se desconoce.

Guarda en caché la lista de modelos

Las respuestas del catálogo se guardan en caché durante cinco minutos y pueden servirse otros cinco minutos mientras la caché se revalida. Esto se aplica a las representaciones JSON, RSS y Atom del catálogo actual; el feed de lanzamientos tiene su propia caché de consulta, más corta. Las respuestas JSON y en formato OpenAI incluyen un encabezado ETag débil (W/"…"). Cambia cuando cambian los modelos de la página, limit, offset, total o el formato. Ignora gateway_region, así que el mismo catálogo servido desde otra región tiene el mismo ETag. Por eso es débil: las respuestas que lo comparten son equivalentes, pero sus bytes pueden diferir. Las respuestas RSS, Atom y de error no lo incluyen. Devuelve el valor guardado sin cambios en If-None-Match. Si el catálogo no ha cambiado, la respuesta es 304 Not Modified sin cuerpo y repite los encabezados ETag, Cache-Control y Vary. Si no, recibes un 200 normal con la nueva lista y un ETag nuevo. If-None-Match también acepta una lista separada por comas y *, y la comparación es débil, así que el valor coincide con o sin su prefijo W/.
Un 304 ahorra transferencia y análisis. El servidor sigue evaluando la solicitud: carga el catálogo y vuelve a calcular el ETag. Basta con consultar aproximadamente cada 15 minutos y descargar la lista de nuevo solo cuando cambia el catálogo. Guarda un ETag por URL de solicitud, porque cada página, conjunto de filtros y formato tiene su propio valor.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Encabezados

If-None-Match
string

ETag de una respuesta anterior en formato JSON u OpenAI para la misma URL. Si todavía coincide, la respuesta es 304 Not Modified sin cuerpo. Acepta una lista separada por comas, validadores débiles (W/) y *.

Parámetros de consulta

Búsqueda sin distinguir mayúsculas en identificadores, nombres y descripciones de modelos y organizaciones.

Maximum string length: 200

Búsqueda de proveedores u organizaciones de modelos sin distinguir mayúsculas.

Maximum string length: 100
input_modality
enum<string>

Exigir una modalidad de entrada compatible.

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

Exigir al menos este número de tokens de contexto de entrada.

Rango requerido: x >= 0
maximum_input_price_per_million
number

Precio máximo en USD de entrada por millón de tokens.

Rango requerido: x >= 0
gateway_available_only
boolean
predeterminado:false

Devolver solo modelos con al menos una oferta enrutable del gateway.

sort_by
enum<string>
predeterminado:relevance

Campo usado para ordenar los resultados del descubrimiento de modelos.

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

Dirección de orden opcional. Los precios se ordenan de forma ascendente por defecto; los demás valores numéricos, de forma descendente.

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

Usa parameter_specs para añadir los parámetros de solicitud de cada oferta con la forma estándar.

Opciones disponibles:
parameter_specs
endpoints
string[]

Filtrar por endpoints

organisation

Filtrar por organización Identificador de la organización.

Opciones 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[]

Filtrar por ID del proveedor

provider_status
string[]

Filtrar por estado de despliegue del proveedor

provider_routing_status
string[]

Filtrar por estado de enrutamiento del proveedor

model_routing_status
string[]

Filtrar por estado de enrutamiento del modelo

capability_status
string[]

Filtrar por estado de capacidades del proveedor

provider_availability_status
string[]

Filtrar por estado de disponibilidad del proveedor

provider_availability_reason
string[]

Filtrar por motivo de disponibilidad del proveedor

status
string[]

Filtrar por estado del modelo

input_types
string[]

Filtrar por tipos de entrada

input_modalities
string[]

Alias público de input_types.

output_types
string[]

Filtrar por tipos de salida

output_modalities
string[]

Alias público de output_types.

params
string[]

Filtrar por parámetros

supported_parameters
string[]

Alias público de params.

availability
enum<string>
predeterminado:active

Filtro de disponibilidad. active devuelve solo los modelos enrutables públicamente; all incluye registros de disponibilidad no enrutables.

Opciones disponibles:
active,
all
limit
integer
predeterminado:50

Limitar el número de resultados

Rango requerido: 1 <= x <= 250
offset
integer
predeterminado:0

Desplazamiento para la paginación

Rango requerido: 0 <= x <= 5000
format
enum<string>
predeterminado:json

Formato de respuesta. Por defecto usa el JSON nativo de Phaseo. El formato OpenAI devuelve toda la lista filtrada salvo que se indique limit.

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

Alias de format. Acepta json, rss o atom.

Opciones disponibles:
json,
rss,
atom

Respuesta

Lista de modelos

ok
boolean
requerido
Ejemplo:

true

availability_mode
enum<string>
requerido
Opciones disponibles:
active,
all
Ejemplo:

"active"

limit
integer
requerido
Rango requerido: 1 <= x <= 250
Ejemplo:

50

offset
integer
requerido
Rango requerido: 0 <= x <= 5000
Ejemplo:

0

total
integer
requerido
Rango requerido: x >= 0
Ejemplo:

128

models
object[]
requerido
access
object

Solo lo devuelve /models/me: lo que los guardrails de quien llama dejaron fuera de la lista, antes de la búsqueda y la paginación.

Última modificación el 16 de noviembre de 2026