> ## 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](/cn/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