查询可用模型

模型权限可能因账户分组、API Key 限制和渠道状态而不同。生产代码应以 /v1/models 返回结果为准，不要只依赖网页上的静态模型名称。

请求

GET https://routerbee.com/v1/models
Authorization: Bearer $ROUTERBEE_API_KEY

curl --silent --show-error 'https://routerbee.com/v1/models' \
  --header "Authorization: Bearer $ROUTERBEE_API_KEY"

该接口没有请求体，也没有查询参数。

响应字段

{
  "object": "list",
  "data": [
    {
      "id": "seedance-2.5",
      "object": "model",
      "created": 1755216000,
      "owned_by": "routerbee"
    }
  ]
}

字段	类型	一定存在	说明
object	string	是	固定为列表类型，通常是 list
data	array	是	当前 API Key 可见的模型列表
data[].id	string	是	请求中的 model 必须原样使用此值
data[].object	string	否	通常为 model
data[].created	integer	否	Unix 秒级时间戳；不能用于判断模型版本
data[].owned_by	string	否	模型归属标签；不代表实际计费方
data[].supported_endpoint_types	array	否	部分模型可能返回支持的接口类别

客户端至少应依赖 data[].id，其他字段都应按可选字段处理。

确认视频模型

当前 RouterBee 视频链路已验证的公开模型为：

seedance-2.5

如果 /v1/models 没有返回该模型，请检查 API Key 的模型限制、分组和额度，或联系管理员。

不要猜测模型名称

seedance-2.0、seedance-2.0-fast、seedance-2.0-mini 等名称只有在它们实际出现在你的 /v1/models 响应中时才可以调用。营销页面出现某项能力，不等于当前 API Key 已经开放对应模型。

常见问题

data 是空数组

通常表示当前密钥没有可用模型。检查 API Key 是否启用了模型限制、选择了错误分组，或模型渠道暂时不可用。

模型广场能看到，但 API 返回中没有

模型广场是公开目录；/v1/models 是当前密钥的实际权限。调用时以后者为准。

是否需要缓存模型列表

可以短时间缓存，但不要永久写死。模型权限和渠道可能发生变化；当收到“模型不可用”错误时，应重新查询。