# 模型与标识

https://modelportal.ai/docs/models?lang=zh

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

## 模型 ID

[模型目录](/models)里每个模型的「模型 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`。状态说明见[模型能力](/docs/capabilities)。

## 供应商标识与报价标识

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

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

## 用程序查询

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

字段说明见[模型列表接口](/docs/api-models)。