Skip to main content
GET
Listar modelos de la pasarela
De forma predeterminada, este endpoint solo devuelve los modelos que se pueden enrutar actualmente. Define availability=all para incluir modelos conocidos que todavía no están disponibles. Las respuestas del catálogo se almacenan en caché durante cinco minutos y pueden servirse otros cinco minutos mientras se revalida la caché. Esto se aplica a las representaciones JSON, RSS y Atom del catálogo actual; el feed de lanzamientos tiene su propia caché de consulta, de menor duración. GET /models/me está reservado para filtrar en el futuro los modelos según los guardrails del usuario actual. Ahora devuelve 501 not implemented, así que por el momento usa GET /models para consultar el catálogo compartido de Gateway.

Filtros útiles

  • endpoints usa nombres públicos como chat.completions, responses y messages
  • status filtra por ciclo de vida del modelo, por ejemplo active, deprecated o retired
  • provider filtra por ID público del proveedor, por ejemplo openai, anthropic o google_vertex
  • provider_status filtra por nivel de despliegue del proveedor, por ejemplo active, beta, alpha o not_ready
  • provider_routing_status filtra por estado de enrutamiento del proveedor
  • model_routing_status filtra por estado de enrutamiento del modelo
  • capability_status filtra por estado de capacidad del proveedor para la asignación de endpoint solicitada
  • provider_availability_status filtra por disponibilidad del proveedor, por ejemplo active, coming_soon o inactive
  • provider_availability_reason filtra por motivo de disponibilidad del proveedor, por ejemplo preview_only, provider_not_ready, gated, access_limited o region_limited
  • organisation filtra por el prefijo del ID público del modelo; por ejemplo, anthropic en anthropic/claude-3-haiku
  • availability=active es el valor predeterminado
  • availability=all incluye modelos o proveedores que están coming_soon, inactive o aún no se pueden enrutar públicamente
  • input_modalities es un alias de input_types
  • output_modalities es un alias de output_types
  • supported_parameters es un alias de params
Para consultar el contrato de endpoint de un modelo, llama a GET /models/{author}/{slug}/endpoints. La respuesta separa las rutas por proveedor e incluye, en cada fila, la ruta pública, las modalidades, los detalles de los parámetros compatibles, la disponibilidad, el estado de enrutamiento, el slug del modelo del proveedor y un resumen de precios. Las entradas de proveedores también pueden incluir:
  • availability_status
  • availability_reason
  • provider_status
  • provider_routing_status
  • model_routing_status
  • capability_status

Respuesta

availability_reason es el campo que explica por qué una entrada de proveedor está activa, disponible solo en vista previa o inactiva.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

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
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,
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. De forma predeterminada, es json.

Opciones disponibles:
json,
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
Última modificación el 2 de octubre de 2026