Skip to content

模型查询

模型查询用于确认当前 API Key 可用的模型。接入前建议先调用模型列表接口,避免在请求体中使用不可用模型名。

查询模型列表

http
GET /v1/models
bash
curl https://moonapix.com/v1/models \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

查询单个模型

http
GET /v1/models/{modelid}
bash
curl https://moonapix.com/v1/models/moonapix-chat \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

响应示例

json
{
  "object": "list",
  "data": [
    {
      "id": "moonapix-chat",
      "object": "model",
      "owned_by": "moonapix"
    }
  ]
}

响应中的 id 字段就是请求接口时使用的 model 值。

使用建议

  • 在接入配置中保存模型名,而不是硬编码到多个业务模块。
  • 当模型不可用时,先查询模型列表和 API Key 权限。
  • 视频、图像、音乐等能力还需要查看对应模型矩阵,确认输入方式、比例、时长和任务查询方式。

相关页面