查询可用模型

模型权限可能因账户分组、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": "your-model-id",
      "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，其他字段都应按可选字段处理。

确认视频模型

上面的 your-model-id 只是响应结构占位符。先在模型广场查看视频模型及其详情，再确认该模型的完整 ID 出现在本接口的 data[].id 中。只有同时满足这两个条件，才应把它用于视频创建请求。

如果所选模型没有出现在响应中，请检查 API Key 的模型限制、分组和额度，或联系管理员。不要根据文档中的示例猜测模型名称。

常见问题

data 是空数组

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

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

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

是否需要缓存模型列表

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