模型管理 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

新版本介面

獲取模型資訊平台

模型物件欄位說明

基礎資訊

價格資訊

推理與工具能力

變體與生命週期

限時優惠

請求示例

請求參數說明（可用於篩選）

回應成功示例

使用場景示例

效能最佳化

快取機制

快取使用示例

錯誤處理

重要說明

舊版本介面

獲取模型列表

返回結果

返回資料結構

獲取模型資訊

請求參數

返回結果

返回資料結構

​新版本介面

​獲取模型資訊平台

​模型物件欄位說明

​基礎資訊

​價格資訊

​推理與工具能力

​變體與生命週期

​限時優惠

​請求示例

​請求參數說明（可用於篩選）

​回應成功示例

​使用場景示例

​效能最佳化

​快取機制

​快取使用示例

​錯誤處理

​重要說明

​舊版本介面

​獲取模型列表

​返回結果

​返回資料結構

​獲取模型資訊

​請求參數

​返回結果

​返回資料結構

新版本介面

獲取模型資訊平台

模型物件欄位說明

基礎資訊

價格資訊

推理與工具能力

變體與生命週期

限時優惠

請求示例

請求參數說明（可用於篩選）

回應成功示例

使用場景示例

效能最佳化

快取機制

快取使用示例

錯誤處理

重要說明

舊版本介面

獲取模型列表

返回結果

返回資料結構

獲取模型資訊

請求參數

返回結果

返回資料結構