> ## 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.

# 查询模型参数

> 使用参数接口确认模型能力、请求字段和计费维度。

模型名称相同不代表所有线路都支持相同参数。接入前用当前 API Key 查询目标模型参数，避免依赖过期示例。

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

模型详情页用于确认上下文、最大输出、模型能力、价格和近期服务表现。

## 运行示例前准备

安装 Python 3，并在运行脚本的同一个 Python 环境安装依赖：

```bash theme={null}
python -m pip install requests
```

如果你的系统使用 `python3`，安装和运行时都使用 `python3`。Windows 也可以对应使用 `py -m pip install requests` 与 `py example.py`。使用虚拟环境时，先激活环境。

在 [API 密钥页](https://apione.ai/zh/app/api-keys)创建密钥，从[当前 Key 可用的模型列表](https://apione.ai/docs/models/catalog.md)复制当前 Key 的模型列表中的准确模型 ID，然后在运行脚本的终端设置变量。下面的大写值是占位符，需要替换。

> [tab] macOS / Linux
>
> ```bash theme={null}
> export APIONE_API_KEY="YOUR_APIONE_API_KEY"
> export APIONE_MODEL="YOUR_MODEL_ID"
> ```

> [tab] Windows PowerShell
>
> ```powershell theme={null}
> $env:APIONE_API_KEY = "YOUR_APIONE_API_KEY"
> $env:APIONE_MODEL = "YOUR_MODEL_ID"
> ```

变量只对当前终端及其启动的子进程生效。在同一终端运行后面的示例；IDE、容器或新终端需要另行配置。不要把真实密钥提交到代码仓库。

## 请求

```http theme={null}
GET https://api.apione.ai/v1/models/{model}/params
Authorization: Bearer YOUR_APIONE_API_KEY
```

```bash theme={null}
curl -sS "https://api.apione.ai/v1/models/YOUR_MODEL_ID/params" \
  -H "Authorization: Bearer YOUR_APIONE_API_KEY"
```

`{model}` 使用 `/v1/models` 返回的准确 ID，并进行 URL 编码。模型不属于当前 Key、ID 拼写错误或没有访问权限时，可能返回 404 或模型不可用错误。

## Python 示例

```python theme={null}
import os
import urllib.parse
import requests

model = urllib.parse.quote(os.environ["APIONE_MODEL"], safe="")
response = requests.get(
    f"https://api.apione.ai/v1/models/{model}/params",
    headers={"Authorization": f"Bearer {os.environ['APIONE_API_KEY']}"},
    timeout=30,
)
print(response.status_code, {name: response.headers[name] for name in ("X-Request-ID", "X-Maxx-Trace-Id", "X-Maxx-Request-ID") if name in response.headers})
print(response.text)
response.raise_for_status()
```

## 重点读取什么

| 信息 | 用途 |
| - | - |
| 请求字段 | 判断 `temperature`、工具、图片、尺寸等是否可用 |
| 字段类型与枚举 | 构造正确请求并生成表单校验 |
| 默认值与范围 | 避免越界参数和无效组合 |
| `billingMode` | 了解按 Token、请求、图片、时长或其他模式计费 |
| `chargeModes` | 读取响应列出的计费模式名称；实际计费以模型及当前分组为准 |

响应结构可能随模型类型变化。第一次接入时保存一份脱敏响应作为项目测试夹具，但不要把它当成永久静态事实。

## 参数不存在怎么办

1. 确认模型 ID 来自同一个 Key 的 `/v1/models`。
2. 检查是否选错协议或模型类型。
3. 使用最小请求去掉全部可选参数。
4. 最小请求成功后逐个添加字段。
5. 仍不确定时携带请求 ID 联系支持。

## 缓存与更新

应用可以短期缓存参数响应，减少重复查询，但应设置更新时间。模型升级、线路切换或分组调整后，重新读取参数。上线前和出现 `unsupported_parameter` 时主动刷新。

## 参数返回为空时

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

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

下一步：[选择模型](https://apione.ai/docs/models/selection.md)、[模型目录](https://apione.ai/docs/models/catalog.md)、[图像与视频参数](https://apione.ai/docs/api/media-parameters.md)。


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