查询模型详情 · OpenGptApi

接口说明

同一逻辑模型可能有多条渠道行，能力闭集必须逐行读取。只有已公开且可路由的精确组合才可以提交，未出现的 1K、2K、4K 或比例不能靠推测扩展。

认证：无需认证

请求

路径参数

名称	类型	说明
`model_id`必填	string	公开逻辑模型 ID。

响应

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

HTTP	含义
`200`	请求成功
`404`	资源不存在，或签名无效
`422`	请求结构校验失败
`500`	服务内部错误

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

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

重要边界

最终售价只读取公开 price_matrix，不使用供应商采购价。
三款 Nano Banana 会明确返回 custom_aspect_ratio_supported=false 与 custom_pixel_size_supported=false；只能提交渠道逐项列出的离散 tier/ratio 组合。
任意 WIDTHxHEIGHT 只有在当前可路由渠道的 parameters.size 明确返回 custom_size_constraints 时才可尝试；没有该字段就不支持自定义像素尺寸。

查看机器可读 OpenAPI