Pular para o conteúdo principal
GET
Listar modelos do gateway
Chame GET /v1/models para listar os modelos para os quais você pode rotear agora. Defina availability=all para incluir modelos conhecidos, mas que não estão disponíveis no momento.
Cada modelo lista uma entrada em offers por rota de provedor (resumido, valores ilustrativos):
Só envie tráfego de produção para uma oferta em que routable seja true. status_reason explica por que uma oferta está apenas em prévia ou inativa. O esquema completo está abaixo. GET /models/me retorna a mesma lista com as proteções da sua chave aplicadas: as regras de privacidade e de provedores do seu workspace e as proteções dos departamentos da chave, do membro dela e da própria chave. Ficam de fora os modelos bloqueados por uma regra de modelos e os modelos sem nenhum provedor permitido, e cada modelo mantém apenas as ofertas para as quais as solicitações podem ser roteadas. Aceita os mesmos filtros que GET /models. A resposta também traz access: se alguma regra se aplica (restricted), os modelos que ficam de fora (hidden_model_count e hidden_models, com ids e nomes) e quantos modelos listados perderam algum provedor (limited_model_count), para você explicar por que um modelo não aparece.

Filtrar a lista

Os filtros que aceitam vários valores aceitam parâmetros repetidos ou uma lista separada por vírgulas. Para inspecionar as rotas de provedor, os detalhes de parâmetros e os preços de um modelo, chame GET /models/{author}/{slug}/endpoints.

Verificar os níveis de serviço de cada oferta

Cada entrada em offers inclui service_tiers, os níveis de serviço que aquela oferta do provedor aceita. É um subconjunto, em ordem alfabética, de flex, priority, standard e ultrafast, em que priority é o nível Fast. Um nível aparece quando a rota do provedor tem preços ativos e vigentes para ele, e uma rota que atende um único nível lista apenas esse nível. Alguns níveis também estão disponíveis por rotas de provedor separadas, específicas do nível, que não são listadas. Os preços em pricing continuam sendo os do nível padrão.

Obter a lista no formato da OpenAI

Use GET /v1/models?format=openai para clientes que esperam a resposta de lista de modelos da OpenAI. O padrão format=json retorna os metadados de modelo mais completos do Phaseo.
O formato da OpenAI usa a mesma autenticação, disponibilidade regional, modelos privados do espaço de trabalho e filtros que o JSON nativo. Ele retorna todos os modelos correspondentes, a menos que você informe limit; offset continua valendo. Os IDs permanecem no formato canônico do Phaseo para inferência. created usa a data de lançamento do catálogo, ou 0 quando ela é desconhecida; owned_by usa a organização do catálogo, private para modelos do espaço de trabalho, ou phaseo quando é desconhecida.

Armazenar a lista de modelos em cache

As respostas do catálogo ficam em cache por cinco minutos e podem ser servidas por mais cinco minutos enquanto o cache é revalidado. Isso vale para as representações JSON, RSS e Atom do catálogo atual; o feed de lançamentos tem seu próprio cache de consulta, mais curto. As respostas em JSON e no formato da OpenAI incluem um cabeçalho ETag fraco (W/"…"). Ele muda quando os modelos da página, limit, offset, total ou o formato mudam. Ele ignora gateway_region, então o mesmo catálogo servido de outra região tem o mesmo ETag. Por isso ele é fraco: respostas que o compartilham são equivalentes, mas seus bytes podem ser diferentes. Respostas RSS, Atom e de erro não incluem esse cabeçalho. Envie o valor salvo de volta, sem alterações, em If-None-Match. Se o catálogo não mudou, a resposta é 304 Not Modified, sem corpo, e repete os cabeçalhos ETag, Cache-Control e Vary. Caso contrário, você recebe um 200 normal com a nova lista e um novo ETag. If-None-Match também aceita uma lista separada por vírgulas e *, e a comparação é fraca, então o valor corresponde com ou sem o prefixo W/.
Um 304 economiza transferência e análise. O servidor ainda avalia a solicitação: ele carrega o catálogo e recalcula o ETag. Consultar mais ou menos a cada 15 minutos basta, baixando a lista de novo só quando o catálogo muda. Mantenha um ETag por URL de solicitação, porque cada página, conjunto de filtros e formato tem seu próprio valor.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Cabeçalhos

If-None-Match
string

ETag de uma resposta anterior em formato JSON ou OpenAI para a mesma URL. Se ainda corresponder, a resposta será 304 Not Modified, sem corpo. Aceita uma lista separada por vírgulas, validadores fracos (W/) e *.

Parâmetros de consulta

Pesquisa sem diferenciar maiúsculas e minúsculas em identificadores, nomes e descrições de modelos e organizações.

Maximum string length: 200

Pesquisa de provedores ou organizações de modelos sem diferenciar maiúsculas e minúsculas.

Maximum string length: 100
input_modality
enum<string>

Exigir uma modalidade de entrada suportada.

Opções disponíveis:
text,
image,
audio,
video
minimum_context_tokens
number

Exigir pelo menos esta quantidade de tokens de contexto de entrada.

Intervalo obrigatório: x >= 0
maximum_input_price_per_million
number

Preço máximo em USD de entrada por milhão de tokens.

Intervalo obrigatório: x >= 0
gateway_available_only
boolean
padrão:false

Retornar apenas modelos com pelo menos uma oferta roteável do gateway.

sort_by
enum<string>
padrão:relevance

Campo usado para ordenar os resultados da descoberta de modelos.

Opções disponíveis:
relevance,
input_price,
output_price,
context_length,
provider_count
sort_order
enum<string>

Direção de ordenação opcional. Preços são ordenados de forma crescente por padrão; outros valores numéricos, de forma decrescente.

Opções disponíveis:
asc,
desc
include
enum<string>[]

Defina como parameter_specs para incluir os parâmetros de requisição de cada oferta no formato padrão.

Opções disponíveis:
parameter_specs
endpoints
string[]

Filtrar por endpoints

organisation

Filtrar por organização Identificador da organização.

Opções disponíveis:
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 do provedor

provider_status
string[]

Filtrar pelo status de lançamento do provedor

provider_routing_status
string[]

Filtrar pelo status de roteamento do provedor

model_routing_status
string[]

Filtrar pelo status de roteamento do modelo

capability_status
string[]

Filtrar pelo status de recursos do provedor

provider_availability_status
string[]

Filtrar pelo status de disponibilidade do provedor

provider_availability_reason
string[]

Filtrar pelo motivo de disponibilidade do provedor

status
string[]

Filtrar pelo status do 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 saída

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>
padrão:active

Filtro de disponibilidade. active retorna somente modelos roteáveis publicamente; all inclui registros de disponibilidade não roteáveis.

Opções disponíveis:
active,
all
limit
integer
padrão:50

Limitar o número de resultados

Intervalo obrigatório: 1 <= x <= 250
offset
integer
padrão:0

Deslocamento da paginação

Intervalo obrigatório: 0 <= x <= 5000
format
enum<string>
padrão:json

Formato de resposta. O padrão é o JSON nativo da Phaseo. O formato OpenAI retorna toda a lista filtrada, a menos que limit seja informado.

Opções disponíveis:
json,
openai,
rss,
atom
feed
enum<string>

Alias de format. Aceita json, rss ou atom.

Opções disponíveis:
json,
rss,
atom

Resposta

Lista de modelos

ok
boolean
obrigatório
Exemplo:

true

availability_mode
enum<string>
obrigatório
Opções disponíveis:
active,
all
Exemplo:

"active"

limit
integer
obrigatório
Intervalo obrigatório: 1 <= x <= 250
Exemplo:

50

offset
integer
obrigatório
Intervalo obrigatório: 0 <= x <= 5000
Exemplo:

0

total
integer
obrigatório
Intervalo obrigatório: x >= 0
Exemplo:

128

models
object[]
obrigatório
access
object

Retornado apenas por /models/me: o que as proteções de quem chama deixaram de fora da lista, antes da busca e da paginação.

Última modificação em 16 de novembro de 2026