Skip to main content
GET
列出网关模型
默认情况下,此端点仅返回当前可路由的模型。设置 availability=all 可同时包含已知但当前不可用的模型。 目录响应会缓存五分钟,并可能在缓存重新验证期间继续提供五分钟。这适用于当前目录的 JSON、RSS 和 Atom 表示;发布动态有自己时长更短的轮询缓存。 GET /models/me 为未来根据当前调用方的护栏筛选模型而保留。目前该接口会返回 501 not implemented,因此现在请使用 GET /models 查询共享的 Gateway 目录。

常用筛选条件

  • endpoints 使用公开名称,例如 chat.completions、responses 和 messages
  • status 按模型生命周期筛选,例如 active、deprecated 或 retired
  • provider 按提供商公开 ID 筛选,例如 openai、anthropic 或 google_vertex
  • provider_status 按提供商发布阶段筛选,例如 active、beta、alpha 或 not_ready
  • provider_routing_status 按提供商级路由状态筛选
  • model_routing_status 按模型级路由状态筛选
  • capability_status 按提供商对所请求端点映射的能力状态筛选
  • provider_availability_status 按提供商可用性筛选,例如 active、coming_soon 或 inactive
  • provider_availability_reason 按提供商可用性原因筛选,例如 preview_only、provider_not_ready、gated、access_limited 或 region_limited
  • organisation 按公开模型 ID 前缀筛选,例如 anthropic/claude-3-haiku 中的 anthropic
  • availability=active 是默认值
  • availability=all 包含状态为 coming_soon、inactive 或尚未公开路由的模型或提供商
  • input_modalities 是 input_types 的别名
  • output_modalities 是 output_types 的别名
  • supported_parameters 是 params 的别名
如需查看某个模型的端点契约,请调用 GET /models/{author}/{slug}/endpoints。响应会按提供商区分路由,并在每一行中列出公开路径、模态、受支持参数详情、可用性、路由状态、提供商模型标识和价格摘要。 提供商条目还可能包括:
  • availability_status
  • availability_reason
  • provider_status
  • provider_routing_status
  • model_routing_status
  • capability_status

响应

availability_reason 是用于说明提供商条目为何处于活动、仅预览或非活动状态的单一字段。

授权

Authorization
string
header
必填

Bearer 令牌身份验证

查询参数

在模型 ID、名称、描述和组织中搜索,不区分大小写。

Maximum string length: 200

搜索提供商或模型组织,不区分大小写。

Maximum string length: 100
input_modality
enum<string>

要求支持指定的输入模态。

可用选项:
text,
image,
audio,
video
minimum_context_tokens
number

要求输入上下文至少支持此数量的 token。

必填范围: x >= 0
maximum_input_price_per_million
number

每百万输入 token 的最高价格(美元)。

必填范围: x >= 0
gateway_available_only
boolean
默认值:false

仅返回至少有一个可路由网关服务的模型。

sort_by
enum<string>
默认值:relevance

用于对模型发现结果排序的字段。

可用选项:
relevance,
input_price,
output_price,
context_length,
provider_count
sort_order
enum<string>

可选的排序方向。价格默认升序,其他数值默认降序。

可用选项:
asc,
desc
endpoints
string[]

按端点筛选

organisation

按组织筛选 组织标识符。

可用选项:
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[]

按提供商 ID 筛选

provider_status
string[]

按提供商推出状态筛选

provider_routing_status
string[]

按提供商路由状态筛选

model_routing_status
string[]

按模型路由状态筛选

capability_status
string[]

按提供商能力状态筛选

provider_availability_status
string[]

按提供商可用状态筛选

provider_availability_reason
string[]

按提供商可用原因筛选

status
string[]

按模型状态筛选

input_types
string[]

按输入类型筛选

input_modalities
string[]

input_types 的公共别名。

output_types
string[]

按输出类型筛选

output_modalities
string[]

output_types 的公共别名。

params
string[]

按参数筛选

supported_parameters
string[]

params 的公共别名。

availability
enum<string>
默认值:active

可用性筛选器。active 仅返回可公开路由的模型;all 还包含不可路由的可用性记录。

可用选项:
active,
all
limit
integer
默认值:50

限制结果数量

必填范围: 1 <= x <= 250
offset
integer
默认值:0

分页偏移量

必填范围: 0 <= x <= 5000
format
enum<string>
默认值:json

响应格式。默认为 json。

可用选项:
json,
rss,
atom
feed
enum<string>

format 的别名。接受 json、rss 或 atom。

可用选项:
json,
rss,
atom

响应

模型列表

ok
boolean
必填
示例:

true

availability_mode
enum<string>
必填
可用选项:
active,
all
示例:

"active"

limit
integer
必填
必填范围: 1 <= x <= 250
示例:

50

offset
integer
必填
必填范围: 0 <= x <= 5000
示例:

0

total
integer
必填
必填范围: x >= 0
示例:

128

models
object[]
必填
最后修改于 2026年10月2日