> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询与选择模型

> 查询当前密钥可用模型，确认 ID、能力和参数。

先确认当前 Key 可以调用的模型，再核对模型能力和价格。展示名称、厂商名称与请求使用的模型 ID 不应混用。

![APIONE 模型广场筛选与模型卡片](https://mintcdn.com/apione/pAFvFGkbmcRZirTZ/images/ui/model-catalog.png?fit=max\&auto=format\&n=pAFvFGkbmcRZirTZ\&q=85\&s=b60b5a7f06c1e256c10ccd1d1e19f9f0)

模型广场可以按模态、厂商和上下文长度筛选，并比较价格与可用渠道。

## 查询当前 Key 可用模型

设置 `APIONE_API_KEY` 后查询：

```bash theme={null}
curl --fail-with-body https://api.apione.ai/v1/models \
  -H "Authorization: Bearer $APIONE_API_KEY"
```

从响应的 `data[].id` 复制模型 ID，保留大小写。APIONE 不要求仿照其他平台添加供应商前缀。

平台模型目录列出的模型，不一定全部对当前 Key 开放。示例中出现的模型也不代表永久可用；切换 Key、分组或模型版本后，应重新核对可用范围。

## 查询参数

`GET /v1/models/{model}/params` 返回目标模型的参数与计费信息。把模型 ID 放入路径时需正确 URL 编码。

| 字段 | 类型 | 核对内容 |
| - | - | - |
| `model` | string | 实际查询的模型 ID |
| `params` | string\[] | 模型声明的额外参数名称 |
| `request` | object | 请求字段及取值范围约束 |
| `billingMode` | string | `token`、`duration`、`request`、`hybrid`；空字符串表示由网关判断 |
| `chargeModes` | string\[] | 允许的扣费口径：`usage`、`request`、`second`、`image` |

以接口实际响应为准，不要从某个参数名推断其他能力。模型不存在或无访问权限时，参数查询可能返回 404；先用模型列表确认 ID 和权限。

网页选型可访问[模型目录](https://apione.ai/zh/models)，查看价格、上下文和输入类型。分组如何影响费用，见[分组定价与计费](https://apione.ai/docs/account/usage.md)。

![APIONE 模型广场搜索 Gemini 模型](https://mintcdn.com/apione/pAFvFGkbmcRZirTZ/images/ui/model-search.png?fit=max\&auto=format\&n=pAFvFGkbmcRZirTZ\&q=85\&s=633884d33b4d84dea7581b434b5b5a50)

输入模型名称后，目录会保留筛选条件并展示匹配模型、价格、渠道和近期成功率。

![APIONE 模型详情页](https://mintcdn.com/apione/pAFvFGkbmcRZirTZ/images/ui/model-detail.png?fit=max\&auto=format\&n=pAFvFGkbmcRZirTZ\&q=85\&s=35c168af320d711f179c4acd0bfee9f2)

模型详情页展示上下文、最大输出、能力、价格和服务表现。

## 选型顺序

1. 确认任务、输入输出类型和使用协议。
2. 核对上下文窗口、最大输出、结构化输出或工具调用等必需能力。
3. 用同一组已脱敏的业务样例比较质量、耗时和用量。
4. 将模型 ID 放入配置或环境变量，先小范围验证，再切换正式流量。

## 能力检查

| 容易混淆的能力 | 需要分别确认 |
| - | - |
| 图像输入与图像生成 | 能看图的模型不一定能生成图片 |
| Chat Completions 与 Responses | 同一模型对两个端点的支持可能不同 |
| 结构化输出 | 分别检查 JSON 对象和 JSON Schema 支持 |
| 工具调用 | 模型返回调用请求后，由应用执行函数并回传结果 |

不要把其他中转站的模型后缀或自动路由名称用于 APIONE。平台在模型的候选渠道中选择可用渠道，请求不能指定渠道或区域；见[官方路由说明](https://apione.ai/zh/api-docs/docs/smart-routing)。

继续阅读[对话参数](https://apione.ai/docs/models/chat.md)、[结构化输出与工具调用](https://apione.ai/docs/models/advanced.md)；接口依据见[公开模型说明](https://apione.ai/zh/api-docs/docs/model-list)。

## 参数返回为空时

接口返回 HTTP 200，但 `params` 为 `[]`、`request` 为 `{}` 或 `billingMode` 为空时，仅表示该响应没有声明相应信息，不代表模型不支持、参数可以任意填写或调用免费。`chargeModes` 中的 `usage`、`request`、`second`、`image` 是响应列出的模式名称，不等于该模型同时按四种方式收费。

1. 在 APIONE 模型详情和当前 Key 分组中核对可用协议与价格。
2. 有明确模型参数说明时，以该说明确定尺寸、质量、参考图、蒙版等字段；不要照搬其他模型的枚举。
3. 没有明确参数依据时，先验证本页的最小请求，暂不提交可选字段或批量任务。
4. 携带模型 ID、接口、请求时间和实际请求标识联系支持确认参数，不发送完整 Key。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.