AIHub 在 https://ai.yunxinapi.com/hub/v1 下支持模型查询入口。查询后返回当前访问令牌可见、可路由的逻辑模型列表，是调用方确认模型可用性的首选接口。

模型目录中的模型不一定对当前访问令牌可见。返回结果会受到模型授权、访问组、渠道模型映射、路由绑定和运行时健康影响。单模型查询不可见时返回 404。

请求 URL

• 查询当前可见的模型列表：GET https://ai.yunxinapi.com/hub/v1/models
• 查询单个指定的可见模型：GET https://ai.yunxinapi.com/hub/v1/models/{model}

请求头

以下鉴权方式至少提供一种。同时存在时， Authorization 优先。

Header	必填	说明
Authorization	否	AIHub 访问令牌，格式为 Bearer <AIHUB_TOKEN>
X-Api-Key	否	未传 Authorization 时可作为访问令牌；同时传入 Anthropic-Version 时，模型列表按 Anthropic 形状返回
Anthropic-Version	否	用于识别 Anthropic SDK 的模型列表响应形状

请求参数

字段	位置	必填	说明
model	path	否	单模型查询时填写 AIHub 逻辑模型名。

GET https://ai.yunxinapi.com/hub/v1/models 当前不需要 query 参数。Anthropic SDK 可能传入 limit、after_id 等分页参数，AIHub 会按当前可见模型集合返回结果。

列表模型

bashcurl "https://ai.yunxinapi.com/hub/v1/models" \
  -H "Authorization: Bearer $AIHUB_TOKEN"

查询单个模型

bashcurl "https://ai.yunxinapi.com/hub/v1/models/$AIHUB_MODEL" \
  -H "Authorization: Bearer $AIHUB_TOKEN"

AIHUB_MODEL 为 AIHub 逻辑模型名。可先调用列表接口，使用响应中的 data[].id 作为请求体 model 字段或单模型查询路径。

OpenAI-compatible 响应

默认返回 OpenAI-compatible 模型列表形状。

列表响应

字段	类型	说明
object	string	列表对象类型，固定为 list。
data	object[]	模型列表。
data[].id	string	AIHub 逻辑模型名。
data[].object	string	模型对象类型，固定为 model。
data[].created	int	创建时间；当前固定为 0。
data[].owned_by	string	所属方；当前为 aihub。

单模型查询响应

字段	类型	说明
id	string	AIHub 逻辑模型名。
object	string	模型对象类型，固定为 model。
created	int	创建时间；当前固定为 0。
owned_by	string	所属方；当前为 aihub。

Anthropic 响应

当请求使用 X-Api-Key 且包含 Anthropic-Version，AIHub 会按 Anthropic 模型列表形状返回。

字段	类型	说明
data	object[]	模型列表。
data[].id	string	AIHub 逻辑模型名。
data[].type	string	固定为 model。
data[].display_name	string	展示名，当前与逻辑模型名一致。
data[].created_at	string	创建时间；当前固定为 1970-01-01T00:00:00Z。
first_id	string/null	当前页首个模型 ID。
last_id	string/null	当前页最后一个模型 ID。
has_more	bool	当前固定为 false。