跳转到主要内容
GET
列出网关模型
调用 GET /v1/models 列出你当前可以路由到的模型。设置 availability=all 可包含已知但当前不可用的模型。
每个模型在 offers 中为每条提供商路由列出一个条目(已节选,数值仅作示意):
只能将生产流量路由到 routable 为 true 的 offer。status_reason 说明 offer 为何仅为预览或处于非活动状态。完整的架构见下文。 GET /models/me 返回同一列表,但会应用你的密钥的护栏规则:工作区的隐私和提供商规则,以及密钥所属部门、其成员和密钥本身的护栏。被模型规则屏蔽的模型,以及没有任何允许的提供商的模型都不会列出,每个模型只保留其请求可以路由到的服务。它接受与 GET /models 相同的筛选参数。 响应中还包含 access:是否有规则生效(restricted)、被规则排除的模型(hidden_model_count 和 hidden_models,含 ID 和名称),以及有多少列出的模型失去了部分提供商(limited_model_count),方便你说明某个模型为何不见了。

筛选列表

接受多个值的筛选条件可以使用重复的参数或逗号分隔的列表。 如需查看某个模型的提供商路由、参数详情和价格,请调用 GET /models/{author}/{slug}/endpoints。

查看每个 offer 的服务层级

offers 中的每个条目都包含 service_tiers,即该提供商 offer 接受的服务层级。它是 flex、priority、standard 和 ultrafast 的一个按字母排序的子集,其中 priority 就是 Fast 层级。当提供商路由对某个层级有已启用且当前生效的定价时,才会列出该层级;只服务一个层级的路由只列出该层级。有些层级还可以通过未列出的、针对特定层级的单独提供商路由使用。pricing 下的价格仍是标准层级的价格。

以 OpenAI 格式获取列表

对于需要 OpenAI 模型列表响应格式的客户端,请使用 GET /v1/models?format=openai。默认的 format=json 返回 Phaseo 更丰富的模型元数据。
OpenAI 格式与原生 JSON 使用相同的身份验证、区域可用性、工作区私有模型和筛选条件。除非你提供 limit,否则它会返回所有匹配的模型;offset 仍然有效。ID 保持 Phaseo 用于推理的规范形式。created 使用目录中的发布日期,未知时为 0;owned_by 使用目录中的组织,工作区模型为 private,未知时为 phaseo。

缓存模型列表

目录响应会缓存五分钟,在缓存重新验证期间还可能再提供五分钟。这适用于当前目录的 JSON、RSS 和 Atom 表示形式;发布动态有自己更短的轮询缓存。 JSON 和 OpenAI 格式的响应包含一个弱 ETag 标头(W/"…")。当页面上的模型、limit、offset、total 或格式发生变化时,它会改变。它忽略 gateway_region,因此从其他区域提供的同一目录具有相同的 ETag。这就是它是弱 ETag 的原因:共享同一个值的响应是等价的,但字节可能不同。RSS、Atom 和错误响应不包含它。 在 If-None-Match 中原样发回保存的值。如果目录没有变化,响应为 304 Not Modified,没有正文,并重复 ETag、Cache-Control 和 Vary 标头。否则你会收到一个正常的 200,其中包含新列表和新的 ETag。If-None-Match 也接受逗号分隔的列表和 *,并且使用弱比较,因此无论值是否带有 W/ 前缀都能匹配。
304 可以节省传输和解析开销。服务器仍会处理该请求:它会加载目录并重新计算 ETag。大约每 15 分钟轮询一次就足够了,只有在目录发生变化时才会重新下载列表。为每个请求 URL 保留一个 ETag,因为每个页面、筛选条件组合和格式都有各自的值。

授权

Authorization
string
header
必填

Bearer 令牌身份验证

请求头

If-None-Match
string

同一 URL 先前 JSON 或 OpenAI 格式响应中的 ETag。如果仍然匹配,则返回不含正文的 304 Not Modified。支持逗号分隔的列表、弱校验器(W/)和 *。

查询参数

在模型 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
include
enum<string>[]

设置为 parameter_specs 可按标准格式附加每个报价的请求参数。

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

按提供商 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

响应格式。默认为 Phaseo 原生 JSON。除非指定 limit,否则 OpenAI 格式返回完整的筛选列表。

可用选项:
json,
openai,
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[]
必填
access
object

仅由 /models/me 返回:在搜索和分页之前,调用方的护栏规则从列表中排除的内容。

最后修改于 2026年11月16日