平台 API
模型管理 API
本 API 文件提供模型管理介面的詳細說明,包括新版本與舊版本介面的功能、請求示例、參數說明及回應格式。
GET
模型管理 API
新版本介面
獲取模型資訊平台
介面地址:GET https://aihubmix.com/api/v1/models
功能描述:獲取所有可用模型的詳細資訊。
模型物件欄位說明
基礎資訊
模型類型,逗號分隔,支援值:
llm(大語言模型)、image_generation(圖片生成模型)、video(影片生成模型)、tts(語音合成模型)、stt(語音轉文字模型)、embedding(嵌入模型)、rerank(排序模型)、ocr(文字辨識模型)、search(搜尋模型)、3d(3D 生成模型)支援的功能特性,逗號分隔,支援值:
thinking(支援思考推理)、tools(支援工具調用)、function_calling(支援函數調用)、web(支援搜尋)、deepsearch(支援深度搜尋)、long_context(長上下文模型)、structured_outputs(結構化輸出)模型可用的介面協議,逗號分隔,支援值:
chat_completions(Chat Completions 介面)、responses(Responses 介面)、claude_api(Claude Messages 介面)、gemini_api(Gemini 介面)。為空表示暫未標註價格資訊
分檔價格陣列,可選欄位。每個元素包含
tier 物件(type 固定為 context,size 為上下文 Token 數閾值)與該檔的 input、output、cache_read、cache_write 價格。請求的上下文長度超過 size 後按該檔價格計費;頂層的 input、output 等欄位為預設檔價格推理與工具能力
思考檔位配置陣列,可選欄位。每項包含
type,支援值:toggle(思考可開關)、effort(按檔位控制,values 列出可選檔位、default 為預設檔位)、budget_tokens(按 Token 預算控制)各介面協議下思考內容的返回載體,可選欄位,省略時表示未收錄。鍵為協議名(
anthropic.messages、openai.chat_completions、openai.responses、google.gemini),值為 true(該協議可返回思考內容)或 {"field": "reasoning_content"}(思考內容透過該欄位返回)。請按實際調用的協議取對應鍵變體與生命週期
變體類型,與
variant_of 成對出現,支援值:pricing-tier(價格檔)、channel-tier(接入檔)、mode-preset(模式預設)、deprecated-alias(已廢棄別名)限時優惠
優惠時間規則類型,支援值:
absolute(絕對時間區間,見 absolute 物件的 start、end)、daily(每日固定時段,見 daily.ranges)、weekly(每週固定時段,見 weekly 陣列的 weekdays 與 ranges,weekdays 按 ISO 8601 編碼,週一為 1、週日為 7)請求示例
請求參數說明(可用於篩選)
模型類型。支援值:
llm(大語言模型)、image_generation(圖片生成模型)、video(影片生成模型)、tts(語音合成模型)、stt(語音轉文字模型)、embedding(嵌入模型)、rerank(排序模型)、ocr(文字辨識模型)、search(搜尋模型)、3d(3D 生成模型)模型功能特性。支援值:
thinking(支援思考推理)、tools(支援工具調用)、function_calling(支援函數調用)、web(支援搜尋)、deepsearch(支援深度搜尋)、long_context(長上下文模型)、structured_outputs(結構化輸出),支援多功能查詢(逗號分隔)回應成功示例
使用場景示例
說明:在使用程式設計模型智能排序時,系統會優先展示包含 coding 標籤的模型,其他模型按預設順序排列。
效能最佳化
快取機制
- 快取策略:HTTP 快取,快取時長 300 秒(5 分鐘)
- 快取控制:
Cache-Control: private, max-age=300, stale-while-revalidate=300 - 內容驗證:支援 ETag 內容雜湊驗證
快取使用示例
如果內容未更新,伺服器返回 304 Not Modified 狀態碼。
錯誤處理
重要說明
- 資料完整性:此介面返回所有符合條件的模型,不進行分頁處理
- 類型相容性:支援新舊類型識別的自動映射
t2t↔llmt2i↔image_generationt2v↔videoreranking↔rerank
- 篩選邏輯:多個篩選條件之間為邏輯與(AND)關係
- 排序規則:未指定排序方式時,按系統預設順序排列
- 生命週期:
retire_stage為deprecated的模型仍可正常調用,建議參考successor_model、retired_at欄位提前規劃遷移;已停止服務的模型不會出現在返回列表中 - 可選欄位:標註為可選的欄位省略時表示該資訊未標註或未收錄,省略不代表模型不具備對應能力
舊版本介面
⚠️ 注意:以下為舊版本介面,建議優先使用新版本介面以獲得更好的效能和功能體驗。
獲取模型列表
端點(Endpoint):GET /v1/models
- 有用戶登入獲取用戶分組下的可用列表,無用戶登入獲取 default 分組下的可用列表。
- header 中有 Authorization 欄位則查詢 key 對應的 token 下配置的模型列表。
返回結果
返回資料結構
狀態碼 200獲取模型資訊
端點(Endpoint):GET /v1/models/:model
請求參數
返回示例:
返回結果
返回資料結構
狀態碼 200最後更新:2026-09-18