# 在 AI 工具中使用本文档

来源: https://platform.lyrouter.com/ai_gateway/docs/ai-tools
更新日期: 2026-10-19

本文档的每一页都有给 AI 读的 Markdown 版本，另有整站目录、全文合集、OpenAPI 规格和一个 MCP 服务。让 DeepSeek、ChatGPT、Claude、Cursor、Claude Code 等工具按 LYRouter 的接口写代码时，把下面任一份交给它，比让它凭记忆猜更准确。

下文的地址都在控制台域名 `https://platform.lyrouter.com` 上，不是网关地址 `https://api.lyrouter.com`。

## 选择哪一种

| 用途 | 交给 AI 的内容 |
| --- | --- |
| 就某一页提问 | 页面顶部的「复制为 AI 阅读友好的格式」 |
| 让 AI 自己找相关的页 | [llms.txt](https://platform.lyrouter.com/llms.txt) |
| 一次把全部文档交给 AI | [llms-full.txt](https://platform.lyrouter.com/llms-full.txt) |
| 生成客户端代码、校验请求 | [OpenAPI 规格](#openapi-规格) |
| 在编辑器或命令行里随时查文档 | [MCP 服务](#mcp-服务) |

## 页面上的按钮

每页标题下方有 **复制为 AI 阅读友好的格式** 按钮：复制本页的 Markdown，粘贴到任意 AI 对话中即可提问。复制内容开头写有本页地址；站内链接已改成完整地址，截图换成文字说明，代码块原样保留。

## 每页的 Markdown 地址

在页面地址后加 `.md`，就是这一页的 Markdown 版本，内容与「复制为 AI 阅读友好的格式」相同：

| 页面 | Markdown 地址 |
| --- | --- |
| `https://platform.lyrouter.com/ai_gateway/docs/errors` | `https://platform.lyrouter.com/ai_gateway/docs/errors.md` |
| `https://platform.lyrouter.com/ai_gateway/docs/errors/en` | `https://platform.lyrouter.com/ai_gateway/docs/errors/en.md` |

英文版的地址带 `/en`；只有中文的文章没有 `en.md`。

## llms.txt 与 llms-full.txt

按 [llms.txt 约定](https://llmstxt.org) 提供两个文件：

| 文件 | 内容 |
| --- | --- |
| [`/llms.txt`](https://platform.lyrouter.com/llms.txt) | 文档目录：每页的标题、Markdown 地址和一句摘要，中文在前、英文在后，末尾列出 OpenAPI 规格和 MCP 服务的地址 |
| [`/llms-full.txt`](https://platform.lyrouter.com/llms-full.txt) | 全部中文文章的 Markdown 合集，每篇以 `---` 分隔、开头写有原文地址 |

`llms-full.txt` 较长，适合上下文窗口大的模型，或作为知识库文件上传。只需要部分内容时，先给 `llms.txt`，让 AI 按目录抓取所需的页。

## OpenAPI 规格

| 文件 | 范围 |
| --- | --- |
| [lyrouter-openapi.yaml](https://platform.lyrouter.com/ai_gateway/api-spec/lyrouter-openapi.yaml) | 对话（Chat Completions、Responses、Anthropic Messages）、向量、重排、列出模型 |
| [multimodal-openapi.yaml](https://platform.lyrouter.com/ai_gateway/api-spec/multimodal-openapi.yaml) | 图像生成与编辑、视频任务等多模态接口 |

两份都是 OpenAPI 3.1，可以直接交给 AI 作为接口依据，也可以用代码生成器得到客户端：

```bash
npx openapi-typescript https://platform.lyrouter.com/ai_gateway/api-spec/lyrouter-openapi.yaml \
  -o ./src/lyrouter-api.d.ts
```

规格描述的是网关对外的接口；某个模型实际接受哪些参数，以各接口页和[协议兼容性与限制](https://platform.lyrouter.com/ai_gateway/docs/compatibility)为准。

## MCP 服务

文档提供一个 MCP 服务，地址为：

```text
https://platform.lyrouter.com/api/v1/docs/mcp
```

传输方式为 Streamable HTTP，不需要 API Key。服务提供两个工具：

| 工具 | 作用 |
| --- | --- |
| `search_docs` | 按关键词或问题搜索文档（中英文均可），返回匹配页的标题、页面地址、Markdown 地址和摘要 |
| `get_doc` | 按页面标识（如 `errors`）或页面地址读取一页的完整 Markdown，可选中文或英文 |

在 Claude Code 中添加：

```bash
claude mcp add --transport http lyrouter-docs https://platform.lyrouter.com/api/v1/docs/mcp
```

在 Cursor 中，把下面的配置写入 `~/.cursor/mcp.json`（只对当前项目生效时写入项目的 `.cursor/mcp.json`）：

```json
{
  "mcpServers": {
    "lyrouter-docs": {
      "url": "https://platform.lyrouter.com/api/v1/docs/mcp"
    }
  }
}
```

其他支持远程 MCP 的工具，按其说明添加同一地址即可。添加后，向 AI 提问时说明「查 LYRouter 文档」，它会调用上面的工具取得最新内容。

## 常见问题

### AI 说打不开文档地址，怎么办？

**答：** 部分 AI 产品在对话中不能联网，或不能访问任意地址。改用「复制为 AI 阅读友好的格式」，把内容直接粘贴进对话。

### AI 给出的参数和本文档不一致，以哪个为准？

**答：** 以本文档为准。AI 可能混用了 OpenAI、Anthropic 官方文档或旧版本的内容，可以把相关页的 Markdown 交给它重新回答。