模型管理API

GET

api

models

模型管理API

curl --request GET \
  --url https://aihubmix.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {}
  ],
  "model_id": "<string>",
  "model_name": "<string>",
  "developer_id": 123,
  "desc": "<string>",
  "vendor": "<string>",
  "types": "<string>",
  "features": "<string>",
  "input_modalities": "<string>",
  "output_modalities": "<string>",
  "endpoints": "<string>",
  "max_output": 123,
  "context_length": 123,
  "release_date": "<string>",
  "last_updated": "<string>",
  "open_weights": true,
  "schema_checked": true,
  "pricing": {},
  "pricing.input": 123,
  "pricing.output": 123,
  "pricing.cache_read": 123,
  "pricing.cache_write": 123,
  "pricing.tiers": [
    {}
  ],
  "reasoning": true,
  "tool_call": true,
  "reasoning_options": [
    {}
  ],
  "interleaved": {},
  "variant_of": "<string>",
  "variant_kind": "<string>",
  "retire_stage": "<string>",
  "deprecated_at": "<string>",
  "retired_at": "<string>",
  "successor_model": "<string>",
  "promotion": {},
  "promotion.name": "<string>",
  "promotion.off_percent": 123,
  "promotion.time_type": "<string>"
}

新版本接口

获取模型信息平台

接口地址：GET https://aihubmix.com/api/v1/models 功能描述：获取所有可用模型的详细信息。

模型对象字段说明

基础信息

array

模型信息列表数组

string

模型唯一标识符，即调用接口时使用的 model 参数值

string

模型显示名称

integer

模型开发者在平台内的编号，可配合请求参数 developer_id 筛选

string

模型功能描述（英文）

string

模型厂商标识（如 openai、anthropic、zhipu）。与 developer_id 是两套独立编号，可选字段，缺省表示未收录

string

模型类型，逗号分隔，支持值：llm（大语言模型）、image_generation（图片生成模型）、video（视频生成模型）、tts（语音合成模型）、stt（语音转文本模型）、embedding（嵌入模型）、rerank（排序模型）、ocr（文字识别模型）、search（搜索模型）、3d（3D 生成模型）

string

支持的功能特性，逗号分隔，支持值：thinking（支持思考推理）、tools（支持工具调用）、function_calling（支持函数调用）、web（支持搜索）、deepsearch（支持深度搜索）、long_context（长上下文模型）、structured_outputs（结构化输出）

string

支持的输入模态，逗号分隔，支持值：text（文本）、image（图像）、audio（音频）、video（视频）、pdf

string

支持的输出模态，逗号分隔，支持值：text（文本）、image（图像）、audio（音频）、video（视频）。可选字段，缺省表示未标注

string

模型可用的接口协议，逗号分隔，支持值：chat_completions（Chat Completions 接口）、responses（Responses 接口）、claude_api（Claude Messages 接口）、gemini_api（Gemini 接口）。为空表示暂未标注

integer

最大输出 Token 数量

integer

上下文窗口大小（最大输入 Token 数量）

string

模型发布日期，格式 YYYY-MM-DD 或 YYYY-MM。可选字段，缺省表示未收录

string

模型最近一次更新日期，无原地升级记录时与 release_date 相同。可选字段

boolean

模型权重是否开放下载、可自行部署。false 表示官方明确不发布权重；可选字段，缺省表示未收录

boolean

平台是否已完成该模型请求参数结构的核对

价格信息

object

价格信息对象，所有价格单位为美元每 100 万（1M）Token

number

输入 Token 价格（美元 / 1M Token）

number

输出 Token 价格（美元 / 1M Token）

number

缓存读取价格（美元 / 1M Token，可选字段）

number

缓存写入价格（美元 / 1M Token，可选字段）

array

分档价格数组，可选字段。每个元素包含 tier 对象（type 固定为 context，size 为上下文 Token 数阈值）与该档的 input、output、cache_read、cache_write 价格。请求的上下文长度超过 size 后按该档价格计费；顶层的 input、output 等字段为默认档价格

推理与工具能力

boolean

是否具备思考推理能力，由 features 归一得到的布尔值。可选字段，缺省表示未标注，缺省时不代表不支持

boolean

是否支持工具调用，由 features 归一得到的布尔值。可选字段，缺省表示未标注，缺省时不代表不支持

array

思考档位配置数组，可选字段。每项包含 type，支持值：toggle（思考可开关）、effort（按档位控制，values 列出可选档位、default 为默认档位）、budget_tokens（按 Token 预算控制）

object

各接口协议下思考内容的返回载体，可选字段，缺省表示未收录。键为协议名（anthropic.messages、openai.chat_completions、openai.responses、google.gemini），值为 true（该协议可返回思考内容）或 {"field": "reasoning_content"}（思考内容通过该字段返回）。请按实际调用的协议取对应键

变体与生命周期

string

母模型 ID，可选字段。存在时表示当前 model_id 与母模型为同一个模型，仅平台内档位或预设不同

string

变体类型，与 variant_of 成对出现，支持值：pricing-tier（价格档）、channel-tier（接入档）、mode-preset（模式预设）、deprecated-alias（已废弃别名）

string

模型生命周期阶段，恒定返回，支持值：active（正常提供服务）、deprecated（已公告下线，仍可调用）。已停止服务的模型不会出现在本接口返回中

string

下线公告时间（ISO 8601 格式）。仅 deprecated 阶段返回

string

计划停止服务时间（ISO 8601 格式）。可选字段，仅 deprecated 阶段可能返回

string

建议迁移的替代模型 ID。可选字段，仅 deprecated 阶段可能返回

限时优惠

object

限时优惠信息，可选字段，无优惠时缺省

string

优惠活动名称

integer

折扣百分比，如 10 表示优惠 10%

string

优惠时间规则类型，支持值：absolute（绝对时间区间，见 absolute 对象的 start、end）、daily（每日固定时段，见 daily.ranges）、weekly（每周固定时段，见 weekly 数组的 weekdays 与 ranges，weekdays 按 ISO 8601 编码，周一为 1、周日为 7）

请求示例

import requests

# 接口地址
url = "https://aihubmix.com/api/v1/models"

response = requests.get(url)
print(response.json())

params = {
    "type": "llm",                   
	"modalities": "text",
	"model": "gpt-5",
	"features": "thinking",
    "sort_by": "context_length",
    "sort_order": "desc"    
}
response = requests.get(url, params=params)
print(response.json())

fetch('https://aihubmix.com/api/v1/models')
  .then(response => response.json())
  .then(data => console.log(data));

const params = new URLSearchParams({
  type: 'llm',
  modalities: 'text',
  model: 'gpt-5',
  features: 'thinking',
  sort_by: 'context_length',
  sort_order: 'desc' 
});

fetch(`https://aihubmix.com/api/v1/models?${params}`)
  .then(response => response.json())
  .then(data => console.log(data));

curl -X GET "https://aihubmix.com/api/v1/models"

curl -X GET "https://aihubmix.com/api/v1/models?type=llm&modalities=text&model=gpt-5&features=thinking&sort_by=context_length&sort_order=desc"

请求参数说明（可用于筛选）

string

模型类型。支持值：llm（大语言模型）、image_generation（图片生成模型）、video（视频生成模型）、tts（语音合成模型）、stt（语音转文本模型）、embedding（嵌入模型）、rerank（排序模型）、ocr（文字识别模型）、search（搜索模型）、3d（3D 生成模型）

string

输入模态。支持值：text（文本）、image（图像）、audio（音频）、video（视频）、pdf，支持多模态查询（逗号分隔）

string

模型名称模糊搜索（支持部分匹配）

string

模型功能特性。支持值：thinking（支持思考推理）、tools（支持工具调用）、function_calling（支持函数调用）、web（支持搜索）、deepsearch（支持深度搜索）、long_context（长上下文模型）、structured_outputs（结构化输出），支持多功能查询（逗号分隔）

string

接口协议筛选。支持值：chat_completions、responses、claude_api、gemini_api，支持多值查询（逗号分隔）

integer

按模型开发者编号筛选，编号见响应字段 developer_id

string

按模型标签筛选，如 coding（编程类模型）

boolean

传 true 时仅返回平台已完成请求参数结构核对的模型（即响应字段 schema_checked 为 true 的模型）

string

排序字段。支持值：
• model_ratio：按性价比排序
• context_length：按上下文长度排序
• coding：编程模型优先排序
• order：按默认顺序排序

string

排序方向。支持值：
• asc（升序）
• desc（降序）

响应成功示例

{
    "data": [
        {
            "model_id": "gpt-6-astra",
            "model_name": "GPT 6 Astra",
            "developer_id": 12,
            "desc": "GPT-6 Astra is OpenAI's newest and most intelligent model, with industry-leading performance in computer operations, web browsing, software engineering, scientific research, and professional work.",
            "pricing": {
                "cache_read": 1,
                "cache_write": 12.5,
                "input": 10,
                "output": 50,
                "tiers": [
                    {
                        "cache_read": 2,
                        "cache_write": 25,
                        "input": 20,
                        "output": 75,
                        "tier": {
                            "size": 272000,
                            "type": "context"
                        }
                    }
                ]
            },
            "types": "llm",
            "features": "tools,thinking,structured_outputs",
            "input_modalities": "text,image",
            "endpoints": "chat_completions,responses",
            "max_output": 128000,
            "context_length": 1050000,
            "release_date": "2026-09-05",
            "last_updated": "2026-09-05",
            "output_modalities": "text",
            "reasoning": true,
            "tool_call": true,
            "reasoning_options": [
                {
                    "type": "effort",
                    "values": ["low", "medium", "high", "xhigh", "max"],
                    "default": "medium"
                }
            ],
            "interleaved": {
                "openai.responses": true
            },
            "vendor": "openai",
            "open_weights": false,
            "schema_checked": false,
            "retire_stage": "active"
        },
        {
            "model_id": "glm-5.3",
            "model_name": "GLM 5.3",
            "developer_id": 5,
            "desc": "GLM-5.3 is Z.AI's coding and agentic reasoning model, built for complex software engineering, long-running agent tasks, vulnerability analysis, and other demanding workloads.",
            "pricing": {
                "cache_read": 0.2817,
                "input": 1.1268,
                "output": 3.9438
            },
            "types": "llm",
            "features": "thinking,tools,function_calling,structured_outputs",
            "input_modalities": "text",
            "endpoints": "",
            "max_output": 131072,
            "context_length": 1048576,
            "release_date": "2026-08-14",
            "last_updated": "2026-08-14",
            "output_modalities": "text",
            "reasoning": true,
            "tool_call": true,
            "reasoning_options": [
                {
                    "type": "toggle"
                },
                {
                    "type": "effort",
                    "values": ["low", "high", "max"],
                    "default": "max"
                }
            ],
            "interleaved": {
                "anthropic.messages": true,
                "openai.chat_completions": {
                    "field": "reasoning_content"
                }
            },
            "vendor": "zhipu",
            "open_weights": true,
            "schema_checked": false,
            "promotion": {
                "name": "GLM-5.3 limited-time special offer",
                "off_percent": 10,
                "time_type": "daily",
                "daily": {
                    "ranges": ["00:00-23:59"]
                }
            },
            "retire_stage": "active"
        }
    ],
    "message": "",
    "success": true
}

使用场景示例

GET https://aihubmix.com/api/v1/models?type=llm

GET https://aihubmix.com/api/v1/models?tag=coding&sort_by=context_length&sort_order=desc

GET https://aihubmix.com/api/v1/models?model=gpt-5

GET https://aihubmix.com/api/v1/models?type=llm&modalities=text,image&features=function_calling&sort_by=model_ratio&sort_order=asc

GET https://aihubmix.com/api/v1/models?sort_by=coding

GET https://aihubmix.com/api/v1/models?endpoints=claude_api

GET https://aihubmix.com/api/v1/models?schema_checked=true

说明：在使用编程模型智能排序时，系统会优先展示包含 coding 标签的模型，其他模型按默认顺序排列。

性能优化

缓存机制

缓存策略：HTTP 缓存，缓存时长 300 秒（5 分钟）
缓存控制：Cache-Control: private, max-age=300, stale-while-revalidate=300
内容验证：支持 ETag 内容哈希验证

缓存使用示例

# 使用ETag进行条件请求
curl -H "If-None-Match: \"abc123...\"" \
     https://aihubmix.com/api/v1/models

如果内容未更新，服务器返回 304 Not Modified 状态码。

错误处理

{
  "success": false,
  "message": "请求参数格式错误"
}

{
  "success": false,
  "message": "服务器内部错误，请稍后重试"
}

重要说明

数据完整性：此接口返回所有符合条件的模型，不进行分页处理
类型兼容性：支持新旧类型标识的自动映射
- t2t ↔ llm
- t2i ↔ image_generation
- t2v ↔ video
- reranking ↔ rerank
筛选逻辑：多个筛选条件之间为逻辑与（AND）关系
排序规则：未指定排序方式时，默认按系统预设顺序排列
生命周期：retire_stage 为 deprecated 的模型仍可正常调用，建议参考 successor_model、retired_at 字段提前规划迁移；已停止服务的模型不会出现在返回列表中
可选字段：标注为可选的字段缺省时表示该信息未标注或未收录，缺省不代表模型不具备对应能力

旧版本接口

⚠️ 注意：以下为旧版本接口，建议优先使用新版本接口以获得更好的性能和功能体验。

获取模型列表

端点（Endpoint）： GET /v1/models

有用户登录获取用户分组下的可用列表，无用户登录获取 default 分组下的可用列表。
header 中有 Authorization 字段则查询 key 对应的 token 下配置的模型列表。

返回示例：

{
  "data": [
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "created": 1626777600,
      "owned_by": "OpenAI",
      "permission": [
        {
          "id": "modelperm-LwHkVFn8AcMItP432fKKDIKJ",
          "object": "model_permission",
          "created": 1626777600,
          "allow_create_engine": true,
          "allow_sampling": true,
          "allow_logprobs": true,
          "allow_search_indices": false,
          "allow_view": true,
          "allow_fine_tuning": false,
          "organization": "*",
          "group": null,
          "is_blocking": false
        }
      ],
      "root": "gpt-4o-mini",
      "parent": null
    }
  ]
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» data	[object]	true	none		none
»» id	string	true	none	模型 ID	none
»» object	string	true	none	model	none
»» created	integer	true	none	创建时间	none
»» owned_by	string	true	none	开发者	none
»» permission	[object]¦null	true	none		none
»»» id	string	true	none		none
»»» object	string	true	none		none
»»» created	integer	true	none		none
»»» allow_create_engine	boolean	true	none		none
»»» allow_sampling	boolean	true	none		none
»»» allow_logprobs	boolean	true	none		none
»»» allow_search_indices	boolean	true	none		none
»»» allow_view	boolean	true	none		none
»»» allow_fine_tuning	boolean	true	none		none
»»» organization	string	true	none		none
»»» group	null	true	none		none
»»» is_blocking	boolean	true	none		none
»» root	string	true	none	模型名称	none
»» parent	null	true	none	父节点	none

获取模型信息

端点（Endpoint）：GET /v1/models/:model

请求参数

名称	位置	类型	必选	说明
model	path	string	是	模型 ID

返回示例：

200 Response

{
  "id": "string",
  "object": "string",
  "created": 0,
  "owned_by": "string",
  "permission": [
    {
      "id": "string",
      "object": "string",
      "created": 0,
      "allow_create_engine": true,
      "allow_sampling": true,
      "allow_logprobs": true,
      "allow_search_indices": true,
      "allow_view": true,
      "allow_fine_tuning": true,
      "organization": "string",
      "group": null,
      "is_blocking": true
    }
  ],
  "root": "string",
  "parent": null
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
id	string	true	none	模型 ID	none
object	string	true	none	model	none
created	integer	true	none	创建时间	none
owned_by	string	true	none	开发者	none
permission	[object]	true	none		none
» id	string	false	none		none
» object	string	false	none		none
» created	integer	false	none		none
» allow_create_engine	boolean	false	none		none
» allow_sampling	boolean	false	none		none
» allow_logprobs	boolean	false	none		none
» allow_search_indices	boolean	false	none		none
» allow_view	boolean	false	none		none
» allow_fine_tuning	boolean	false	none		none
» organization	string	false	none		none
» group	null	false	none		none
» is_blocking	boolean	false	none		none
root	string	true	none	模型名称	none
parent	null	true	none	父节点	none

更新时间：2026-09-18

模型管理API

curl --request GET \
  --url https://aihubmix.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {}
  ],
  "model_id": "<string>",
  "model_name": "<string>",
  "developer_id": 123,
  "desc": "<string>",
  "vendor": "<string>",
  "types": "<string>",
  "features": "<string>",
  "input_modalities": "<string>",
  "output_modalities": "<string>",
  "endpoints": "<string>",
  "max_output": 123,
  "context_length": 123,
  "release_date": "<string>",
  "last_updated": "<string>",
  "open_weights": true,
  "schema_checked": true,
  "pricing": {},
  "pricing.input": 123,
  "pricing.output": 123,
  "pricing.cache_read": 123,
  "pricing.cache_write": 123,
  "pricing.tiers": [
    {}
  ],
  "reasoning": true,
  "tool_call": true,
  "reasoning_options": [
    {}
  ],
  "interleaved": {},
  "variant_of": "<string>",
  "variant_kind": "<string>",
  "retire_stage": "<string>",
  "deprecated_at": "<string>",
  "retired_at": "<string>",
  "successor_model": "<string>",
  "promotion": {},
  "promotion.name": "<string>",
  "promotion.off_percent": 123,
  "promotion.time_type": "<string>"
}

模型端点

平台 API

新版本接口

获取模型信息平台

模型对象字段说明

基础信息

价格信息

推理与工具能力

变体与生命周期

限时优惠

请求示例

请求参数说明（可用于筛选）

响应成功示例

使用场景示例

性能优化

缓存机制

缓存使用示例

错误处理

重要说明

旧版本接口

获取模型列表

返回结果

返回数据结构

获取模型信息

请求参数

返回结果

返回数据结构

​新版本接口

​获取模型信息平台

​模型对象字段说明

​基础信息

​价格信息

​推理与工具能力

​变体与生命周期

​限时优惠

​请求示例

​请求参数说明（可用于筛选）

​响应成功示例

​使用场景示例

​性能优化

​缓存机制

​缓存使用示例

​错误处理

​重要说明

​旧版本接口

​获取模型列表

​返回结果

​返回数据结构

​获取模型信息

​请求参数

​返回结果

​返回数据结构

新版本接口

获取模型信息平台

模型对象字段说明

基础信息

价格信息

推理与工具能力

变体与生命周期

限时优惠

请求示例

请求参数说明（可用于筛选）

响应成功示例

使用场景示例

性能优化

缓存机制

缓存使用示例

错误处理

重要说明

旧版本接口

获取模型列表

返回结果

返回数据结构

获取模型信息

请求参数

返回结果

返回数据结构