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 預填輸入框但不送出
  • 規格與價格並排對比：主站對比頁 https://aihubmix.com/compare/{model_a}/{model_b}，任意兩個模型的規格、價格與能力並排展示，Agent 可直接產生連結
連結為一次性參數：頁面載入後網址列參數即被清除，不攜帶任何金鑰。

​
程式碼生成

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

​
常見問題

​
Agent 如何驗證接入成功？

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

​
這些入口需要憑證嗎？

讀取本頁全部機器可讀入口（agents.md、llms.txt、每模型 llms.txt、Skill 檔案、模型目錄）不需要任何憑證，直接存取即可。只有發起真實模型呼叫時才需要 AIHubMix API Key：透過環境變數 AIHUBMIX_API_KEY 傳遞，可在 控制台 建立。請勿把 Key 寫入程式碼、腳本或對話。

​
每模型 llms.txt 涵蓋哪些模型？

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

​
目前對 MCP 的支援情況如何？

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