Skip to main content
AIHubMix 為 AI Agent(Claude Code、Codex、Cursor、Cline 等編程助手)提供一組機器可讀的接入入口。Agent 可以自行完成發現模型、生成呼叫、驗證連通,直至把配置好的 Playground 連結交回給你。本頁彙總全部入口,每項一條可複製指令。

一句話上手

把下面這句話發給你的 AI Agent:
agents.md 是寫給 Agent 直接執行的接入說明:檢查 API Key、從即時目錄選擇模型、按協議呼叫、端到端驗證,並包含故障排除表。

入口總覽

每模型 llms.txt

每個模型都有一份機器可讀的呼叫指南,包含價格、已核實的能力清單、支援的協議端點和可執行範例:
模型詳情頁上的 llms.txt 標籤可直接開啟對應檔案。尚未完成核實的模型會返回一份指引文件,指向即時目錄與參數 schema,不包含未經核實的能力聲明。

Playground Skill

把 Playground 的能力(模型試用、參數調校、同題對比、圖像與影片生成、深層連結接力)交給你的 Agent:
Skill 同時發布在 /.well-known/skills/aihubmix-playground/SKILL.md,也可透過 GitHub 儲存庫npx skills add AIhubmix/skills 安裝。接入與整合場景請使用 AIHubMix API Skill

Playground 深層連結

Agent 可以生成直達連結,讓你在瀏覽器中接手一個已配置好的 Playground 工作階段:
  • 多模型對比:https://playground.aihubmix.com/?models=gemini-3.7-flash,claude-opus-4-1(最多 6 個)
  • 配置直達:https://playground.aihubmix.com/?config=<base64url 編碼的 JSON>,JSON 形如 {"model": "...", "proto": "chat", "params": {...}, "system": "...", "draft": "..."}draft 預填輸入框但不送出
連結為一次性參數:頁面載入後網址列參數即被清除,不攜帶任何金鑰。

程式碼生成

npm 套件 @aihubmix/codegen 提供 4 協議、7 語言的程式化程式碼生成,其構造的請求主體與 Playground 實際發出的請求主體一致;@aihubmix/model-schema 將參數 schema 轉換為 codegen 輸入。

常見問題

Agent 如何驗證接入成功?

agents.md 內含端到端驗證步驟:發送一條要求精確回覆的最小請求,檢查回應本文與模型回顯。HTTP 200 不等於成功,需要檢查回應內容。

呼叫需要什麼憑證?

一個 AIHubMix API Key,透過環境變數 AIHUBMIX_API_KEY 傳遞,可在 控制台 建立。請勿把 Key 寫入程式碼、腳本或對話。

每模型 llms.txt 涵蓋哪些模型?

已核實模型返回完整文件(能力清單來自官方核實資料),其餘模型返回指引文件。涵蓋範圍隨核實進度擴大。

目前對 MCP 的支援情況如何?

MCP 端點目前提供圖像生成服務,能力擴展進行中。現階段建議優先使用 Skill 與 agents.md 接入。
更新時間:2026-08-20