GET /models

列出当前 Key 可调用的模型,或查询单个模型支持的参数与计费方式。

本页目录
text
GET https://api.apione.ai/v1/models
GET https://api.apione.ai/v1/models/{model}/params

列出模型

返回当前 Key 可以调用的全部模型。结果已经按 Key 的可用模型范围过滤,不需要也不支持查询参数。

bash
curl https://api.apione.ai/v1/models \
  -H "Authorization: Bearer $APIONE_API_KEY"
json
{
  "object": "list",
  "data": [
    { "id": "claude-sonnet-4-6", "object": "model", "created": 0, "owned_by": "maxx" },
    { "id": "gpt-5.6-sol", "object": "model", "created": 0, "owned_by": "maxx" }
  ]
}

id 就是请求里 model 字段要填的值。价格、上下文长度等信息请看模型目录。

查询模型参数

返回单个模型的计费方式和它接受的额外参数,主要用于视频、图片等按次或按秒计费的模型。

bash
curl https://api.apione.ai/v1/models/kling-2-5-turbo/params \
  -H "Authorization: Bearer $APIONE_API_KEY"
json
{
  "model": "kling-2-5-turbo",
  "billingMode": "duration",
  "chargeModes": ["usage", "request", "second", "image"],
  "params": ["resolution", "generation_mode", "quality"],
  "request": {
    "resolution": { "type": "string", "enum": ["720p", "1080p", "2k", "4k"] },
    "generationMode": { "type": "string", "enum": ["text_to_video", "image_to_video", "video_reference"] },
    "mode": { "type": "string", "enum": ["std", "pro", "2k", "4k"] }
  }
}
billingModestring

计费方式:token 按用量、duration 按时长、request 按次、hybrid 混合;空字符串表示由网关自动判断。

chargeModesstring[]

该模型允许的扣费口径,取值 usage / request / second / image。

paramsstring[]

该模型声明支持的参数;没有额外参数时为空数组。

requestobject

请求体里可以填的字段及取值范围;没有约束时为空对象 {}。

模型不存在或当前 Key 无权调用时,返回 404 与 {"error": "model not found"}。

提示

把列出模型做成启动时的一次性拉取,用来校验配置里的模型 ID 是否仍然可用——比线上遇到 400 model_not_supported 早得多。

联系我们

文档没写清楚,或者需要人工协助?按问题类型选一个渠道即可。

邮箱

技术支持support@apione.ai

WhatsApp

Telegram

工单

计费与账户控制台 › 反馈