# AI 集成指南

> 让 ChatGPT、Claude 等 AI 助手直接读取本文档站：llms.txt 索引、每页 Markdown 版本与推荐提示词

本文档站为 AI 助手（ChatGPT、Claude、Cursor 等）做了专门适配。你可以把文档直接「喂」给 AI，让它替你完成接入、写代码、跑测试。

## AI 友好入口

| 入口 | 地址 | 说明 |
| --- | --- | --- |
| 文档索引 | [`/llms.txt`](https://docs.looprouter.com/llms.txt) | 全站页面清单，AI 从这里发现所有子页面 |
| 全量文档 | [`/llms-full.txt`](https://docs.looprouter.com/llms-full.txt) | 所有页面正文合并为单个纯文本文件 |
| 单页 Markdown | 任意页面 URL 后加 `.md` | 例：[`/api-capabilities/seedance2/overview.md`](https://docs.looprouter.com/api-capabilities/seedance2/overview.md) |
| OpenAPI 规范 | [`/openapi.yaml`](https://docs.looprouter.com/openapi.yaml) | 视频任务接口的完整请求 / 响应定义 |

<Tip>
每个文档页面右上角都有「复制页面」按钮：一键把当前页以 Markdown 格式复制进剪贴板，或直接在 ChatGPT / Claude 中打开提问。
</Tip>

## 推荐提示词

把下面的提示词连同你的需求一起发给 AI 助手：

```text 给 AI 的提示词
请阅读 https://docs.looprouter.com/llms.txt 获取 LoopRouter 文档站的全部页面清单。
每个页面的 URL 后加 .md 即可获得该页的 Markdown 原文（例如
https://docs.looprouter.com/getting-started.md）；完整 API 定义见
https://docs.looprouter.com/openapi.yaml。

LoopRouter 是与火山引擎方舟（Ark）完全兼容的 Doubao Seedance 视频生成 API 网关：
- API 接入点：https://api.looprouter.com
- 鉴权方式：请求头 Authorization: Bearer <API Key>（sk- 开头）
- 创建任务：POST /api/v3/contents/generations/tasks
- 查询任务：GET /api/v3/contents/generations/tasks/{id}

请先通读文档，再按照文档中的参数说明和示例完成我的需求。
```

常见用法示例：

<CardGroup cols={2}>
  <Card title="按文档接入" icon="code">
    "按照这个文档站的说明，用 Python 写一个提交文生视频任务并轮询结果的脚本。"
  </Card>
  <Card title="按文档测试" icon="vial">
    "按照这个文档站测试视频生成 API：覆盖文生视频、首尾帧、参考图三种模式，输出测试报告。"
  </Card>
  <Card title="排查报错" icon="bug">
    "我的请求返回了这个错误（贴上报错），对照文档告诉我参数哪里不对。"
  </Card>
  <Card title="迁移代码" icon="arrows-turn-right">
    "我现在直接调用火山引擎方舟，对照文档把 base URL 和鉴权改成 LoopRouter。"
  </Card>
</CardGroup>

<Note>
AI 给出的代码和结论请以文档原文为准；涉及计费的操作（如批量提交任务）建议先用最小分辨率、最短时长验证。
</Note>
