模型列表
模型名是裸名,不带供应商前缀,例如 deepseek-chat、glm-4.5、qwen-plus。一个模型名只对应一个模型;同一模型背后可能接有多条渠道,选路由网关完成,调用方无需关心。
GET /v1/models
用 GET /v1/models 获取当前 Key 可调用的模型列表,与模型库页面一致;owned_by 就是响应里 provider 会出现的供应商名。GET /v1/models/{model} 查单个。
GET /v1/models
响应(节选)
列表按用户组过滤:模型对你的用户组不可见时不出现在这里,调用它返回 503。Key 的模型限制不影响这个列表,只在调用时生效。
能力与 supported_parameters
/v1/models 只有名字。要拿到每个模型经过验证的能力,用公开的模型库接口 GET /api/available_model:不需要登录,带控制台 cookie 时按你的用户组返回。响应是以模型名为键的对象。
GET /api/available_model
响应(节选)
| 字段 | 含义 |
|---|---|
groups | 能调用该模型的用户组 |
owned_by | 供应商名,与 /v1/models 的 owned_by 相同 |
price | type 为 tokens(按 token)或 times(按次);数值是内部倍率,人民币单价以模型库与定价页为准 |
supported_parameters | 运营在测试矩阵里验证过的能力,取值如 tools、response_format、reasoning、vision;未验证时为空数组,不代表不支持 |
模型的上下文长度、最大输出与输入输出模态在模型库页面按模型展示;tools、response_format 等参数传给不支持的模型时,以上游的返回为准。
模型名规则
| 规则 | 说明 |
|---|---|
| 裸名 | 不带供应商前缀:gpt-4o,而不是 openai/gpt-4o。 |
| 唯一 | 一个名字只对应一个模型,同名模型背后的多条渠道由网关选路,价格与渠道无关。 |
| 大小写 | 按模型库里的写法原样传,不做大小写归一。 |
| 不存在的名字 | 单个 model 写错返回 503「无可用渠道」;models 列表里有不存在的名字返回 400 invalid_models。 |