模型管理 API

AcceleAI 提供模型管理接口，方便你查询平台支持的模型列表、模型属性和定价信息。支持新版 API（推荐）和 OpenAI 兼容的旧版 API 两种方式。

新版 API

请求接口


GET https://api.acceleai.cn/api/v1/models

模型对象字段

字段	类型	说明
`model_id`	string	模型唯一标识
`desc`	string	模型描述
`types`	string	模型类别：`llm`、`image_generation`、`video`、`tts`、`stt`、`embedding`、`rerank`
`features`	string	模型能力：`thinking`、`tools`、`function_calling`、`web`、`deepsearch`、`long_context`、`structured_outputs`
`input_modalities`	string	支持的输入类型：`text`、`image`、`audio`、`video`、`pdf`
`max_output`	string	最大输出 token 数
`context_length`	string	最大上下文长度
`pricing`	object	定价信息
`pricing.input`	number	输入价格（USD / 1K tokens）
`pricing.output`	number	输出价格（USD / 1K tokens）
`pricing.cache_read`	number	缓存读取价格（可选）
`pricing.cache_write`	number	缓存写入价格（可选）

查询参数

参数	说明	示例
`type`	按模型类别筛选	`type=llm`
`modalities`	按输入类型筛选（逗号分隔）	`modalities=text,image`
`model`	按模型名称模糊搜索	`model=claude`
`features`	按能力筛选（逗号分隔）	`features=thinking,tools`
`sort_by`	排序字段：`model_ratio`、`context_length`、`coding`、`order`	`sort_by=context_length`
`sort_order`	排序方向：`asc` 或 `desc`	`sort_order=desc`

请求示例

查询所有支持思维链的 LLM 模型，按上下文长度降序：


curl "https://api.acceleai.cn/api/v1/models?type=llm&features=thinking&sort_by=context_length&sort_order=desc" \
  -H "Authorization: Bearer <ACCELE_AI_API_KEY>"

查询支持图片输入的模型：


curl "https://api.acceleai.cn/api/v1/models?modalities=image" \
  -H "Authorization: Bearer <ACCELE_AI_API_KEY>"

缓存策略

新版 API 支持 HTTP 缓存机制：

缓存有效期为 300 秒
支持 ETag 验证，可通过 If-None-Match 头发送条件请求
缓存命中时返回 304 Not Modified，节省带宽


# 首次请求，获取 ETag
curl -i "https://api.acceleai.cn/api/v1/models"
 
# 后续请求，携带 ETag 进行条件验证
curl "https://api.acceleai.cn/api/v1/models" \
  -H "If-None-Match: \"之前获取的ETag值\""

旧版 API（OpenAI 兼容）

获取所有模型


GET https://api.acceleai.cn/v1/models


curl https://api.acceleai.cn/v1/models \
  -H "Authorization: Bearer <ACCELE_AI_API_KEY>"

获取指定模型


GET https://api.acceleai.cn/v1/models/{model_id}


curl https://api.acceleai.cn/v1/models/gpt-4o-mini \
  -H "Authorization: Bearer <ACCELE_AI_API_KEY>"

响应格式


{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "created": 1686935002,
      "owned_by": "openai",
      "permission": [],
      "root": "gpt-4o-mini",
      "parent": null
    }
  ]
}

建议： 新版 API 提供更丰富的模型元数据（能力标签、定价、输入模态等），推荐优先使用。