查询模型参数

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

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

运行示例前准备

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

python -m pip install requests

如果你的系统使用 python3，安装和运行时都使用 python3。Windows 也可以对应使用 py -m pip install requests 与 py example.py。使用虚拟环境时，先激活环境。在 API 密钥页创建密钥，从当前 Key 可用的模型列表复制当前 Key 的模型列表中的准确模型 ID，然后在运行脚本的终端设置变量。下面的大写值是占位符，需要替换。

macOS / Linux
Windows PowerShell

export APIONE_API_KEY="YOUR_APIONE_API_KEY"
export APIONE_MODEL="YOUR_MODEL_ID"

$env:APIONE_API_KEY = "YOUR_APIONE_API_KEY"
$env:APIONE_MODEL = "YOUR_MODEL_ID"

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

请求

GET https://api.apione.ai/v1/models/{model}/params
Authorization: Bearer YOUR_APIONE_API_KEY

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 示例

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`	读取响应列出的计费模式名称；实际计费以模型及当前分组为准

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

参数不存在怎么办

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

缓存与更新

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

参数返回为空时

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

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

下一步：选择模型、模型目录、图像与视频参数。

地址与鉴权

模型接口

输出与进阶用法

图像 API

视频 API