> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent 接入

> AIHubMix 面向 AI Agent 的全部接入入口：agents.md 接入說明、llms.txt 機器可讀索引、每模型 llms.txt 呼叫指南、Playground Skill、Playground 深層連結。每項一條可複製指令。

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

## 一句話上手

把下面這句話發給你的 AI Agent：

```text theme={null}
Fetch https://aihubmix.com/agents.md and follow it.
```

`agents.md` 是寫給 Agent 直接執行的接入說明：檢查 API Key、從即時目錄選擇模型、按協議呼叫、端到端驗證，並包含故障排除表。

## 入口總覽

| 入口               | 網址                                                          | 用途                               |
| ---------------- | ----------------------------------------------------------- | -------------------------------- |
| Agent 接入說明       | `https://aihubmix.com/agents.md`                            | Agent 自助完成接入與驗證的逐步說明             |
| 網站機器可讀索引         | `https://aihubmix.com/llms.txt`                             | 全站能力與文件的 LLM 可讀索引                |
| 文件機器可讀索引         | `https://docs.aihubmix.com/llms.txt`                        | 文件站全量頁面索引，任意文件頁網址後加 `.md` 可取得純文字 |
| 每模型呼叫指南          | `https://aihubmix.com/model/{model_id}/llms.txt`            | 單一模型的價格、已核實能力、協議端點與可執行範例         |
| Playground Skill | `https://aihubmix.com/skills/playground`                    | 試用、調參、對比模型與生成媒體的 Agent 技能檔案      |
| 即時模型目錄           | `https://aihubmix.com/api/v1/models?type=llm&sort_by=order` | 無需鑑權的 JSON，含價格與中繼資料              |

## 每模型 llms.txt

每個模型都有一份機器可讀的呼叫指南，包含價格、已核實的能力清單、支援的協議端點和可執行範例：

```bash theme={null}
curl -s https://aihubmix.com/model/gemini-3.7-flash/llms.txt
```

模型詳情頁上的 `llms.txt` 標籤可直接開啟對應檔案。尚未完成核實的模型會返回一份指引文件，指向即時目錄與參數 schema，不包含未經核實的能力聲明。

## Playground Skill

把 Playground 的能力（模型試用、參數調校、同題對比、圖像與影片生成、深層連結接力）交給你的 Agent：

```text theme={null}
Run curl -fsSL https://aihubmix.com/skills/playground and follow it.
```

Skill 同時發布在 `/.well-known/skills/aihubmix-playground/SKILL.md`，也可透過 [GitHub 儲存庫](https://github.com/AIhubmix/skills) 以 `npx skills add AIhubmix/skills` 安裝。接入與整合場景請使用 [AIHubMix API Skill](/zh-Hant/skills)。

## 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`](https://www.npmjs.com/package/@aihubmix/codegen) 提供 4 協議、7 語言的程式化程式碼生成，其構造的請求主體與 Playground 實際發出的請求主體一致；[`@aihubmix/model-schema`](https://www.npmjs.com/package/@aihubmix/model-schema) 將參數 schema 轉換為 codegen 輸入。

## 常見問題

### Agent 如何驗證接入成功？

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

### 呼叫需要什麼憑證？

一個 AIHubMix API Key，透過環境變數 `AIHUBMIX_API_KEY` 傳遞，可在 [控制台](https://console.aihubmix.com/token) 建立。請勿把 Key 寫入程式碼、腳本或對話。

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

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

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

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

***

更新時間：2026-08-20