模型与标识

最后更新

请求里会用到三种标识：模型 ID 决定调用哪个模型，供应商标识和报价标识决定由谁来承接。

模型 ID

模型目录里每个模型的「模型 ID」就是请求里 model 字段的值，一般写成 发布方/模型名，例如 deepseek/deepseek-v3.2。

  • 也可以写模型的别名，响应里的 model 一律回写成规范的模型 ID。
  • Gemini 接口的模型 ID 写在路径里：/v1beta/models/deepseek/deepseek-v3.2:generateContent，斜杠也可以写成 %2F。
  • 模型维护中或不存在返回 404 model_not_found；已下架返回 410 model_retired。状态说明见模型能力。

供应商标识与报价标识

同一个模型可以有多家供应商的报价，每个报价是「某供应商以某个价格、某种配置提供这个模型」。

标识 示例 用途
供应商标识 模型详情页报价列表里的供应商标识 在 provider 的 order、only、ignore 里点名一家供应商的全部报价
报价标识 以 route_ 开头 在 only 里锁定唯一一个报价，见供应商选择

用程序查询

接口 鉴权 返回
GET https://modelportal.ai/v1/models 需要密钥 OpenAI 格式，只含这把密钥能调用、且有可用报价的模型
GET https://modelportal.ai/api/v1/models 不需要 平台扩展格式的模型列表：能力、状态、价格摘要、供应商数，以及每个报价的配置、价格与限额
GET https://modelportal.ai/api/v1/models/<模型 ID> 不需要 单个模型的详情，含每个报价的报价标识、供应商、价格、数据政策和支持的参数；模型 ID 里的 / 写成 %2F

字段说明见模型列表接口。