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