AibubuDevelopers
开发者文档

模型列表

查询当前对外可用的 OpenAI 兼容模型列表,适合作为接入前的模型探测接口。

这是开发者接入时最常调用的只读接口之一。

GET /v1/models

接口概览

项说明
路由GET /v1/models
鉴权Authorization: Bearer sk_aibubu_xxx
请求体无
返回200 OK + 模型列表

适用场景

  • 初始化时拉取当前可用模型
  • 检查某个环境是否已开放目标模型
  • 给你自己的后台或配置页做模型下拉列表

Authorizations

Authorization: Bearer sk_aibubu_your_api_key

Response

成功时通常返回模型列表对象。

{
  "object": "list",
  "data": [
    {
      "id": "gpt-image-2",
      "name": "gpt-image-2",
      "region": "all",
      "family": "image",
      "description": "通用图片生成",
      "capabilities": ["image_generation"],
      "pricing": {"unit": "image", "display": "按图片计费", "credits_text": "以 /v1/quote 为准"},
      "schema": {"fields": [{"name": "resolution", "type": "string", "required": false, "default": "1K", "options": ["1K", "2K", "4K"]}]},
      "ui_hints": [],
      "enabled": true
    }
  ]
}

响应字段说明

字段类型说明
objectstring列表对象类型,通常为 list
dataarray当前可用模型列表
data[].idstring模型 ID,后续调用时直接传给 model
data[].familystring模型类型:text、image 或 video
data[].schema.fieldsarray动态参数定义,包含字段名、类型、是否必填、默认值、枚举 options 和限制
data[].pricingobject计费展示信息;准确积分以 /v1/quote 为准
data[].enabledboolean当前是否启用

接入建议

  • 模型是否支持图片或视频参数,不要只靠名字硬编码判断,优先读取 family 和 schema.fields
  • 当前没有公开的 /v1/models/{model}/schema,模型参数直接从列表项的 schema.fields 读取
  • 图片和视频模型的参数差异,统一看 支持模型与参数
  • 文字模型同样使用 schema.fields 判断可用参数,不要默认传入 reasoning、temperature 等字段
  • 如果你的前端要动态显示模型列表,建议定期刷新而不是写死

当前国内公开模型

当前公开文字模型包括 GPT/GLM、Claude、Gemini、Grok 和 DeepSeek 系列;视频模型包括 Seedance、Kling 和 Gemini Omni 系列。列表会随线上路由、区域和 API Key 权限变化,以上接口返回值为准。

本页目录