查询模型列表 · OpenGptApi

接口说明

模型目录是能力、比例、尺寸档位、公开价格与渠道可路由状态的入口。不要在客户端写死模型能力；提交前应以当前目录为准。

认证：无需认证

请求

查询参数

名称	类型	说明
`model_company`	string	按公开模型公司过滤。
`modality`	string	按模态过滤，例如 image。
`page`	integer	页码，从 1 开始。
`page_size`	integer	每页 1–100 条，默认 20。

响应

JSON 接口使用统一响应信封。HTTP 状态表达请求结果，业务错误不会伪装成 HTTP 200。

HTTP	含义
`200`	请求成功
`400`	业务参数或过滤条件无效
`422`	请求结构校验失败
`500`	服务内部错误

完整成功响应示例（可选字段可能因状态不同而变化）

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "model_id": "gpt-image-2",
        "company": "OpenAI",
        "modality": "image",
        "lifecycle_status": "active",
        "availability_status": "available",
        "capabilities": [],
        "verified_capabilities": []
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20
  },
  "request_id": "8f25b42f-2ed1-4ad7-99de-61d7f779bc7b",
  "timestamp": "2026-08-10T00:00:00Z"
}

重要边界

公开只读。价格与能力以返回的当前快照为准。

查看机器可读 OpenAPI