# Ep.11 — Fast-Ref API（V2 · Markdown · 用 AI 做简单工具）

https://youtu.be/AwROKyruO2I

> **一句话**: 把 Fast-Ref **API V2** 文档下载成 Markdown，丢给 AI，不用打开 Fast-Ref 窗口，用脚本（或小工具）调用功能。

文档：[API Reference — Fast-Ref](https://docs.otakusolutions.com/api/fast-ref)

---

## 1. API 是什么？

| 术语 | 含义 | 在 Fast-Ref 里 |
|------|------|----------------|
| **UI**（User Interface） | 用按钮和窗口操作 | 打开 Fast-Ref 窗口再点 |
| **API**（Application Programming Interface） | 用脚本调用同样的功能 | MAXScript Editor 里把语言设成 **Python** |

绑定师、TA 已经熟悉。动画师和入门者可以记成：**不用窗口，用代码驱动 Fast-Ref。**

在 3ds Max **MAXScript Editor** 把语言改成 **Python** 就能跑 Fast-Ref API。命令列表就是上面的 API 文档。

以前是 V1，这次更新到 **V2**。

---

## 2. 怎么拿文档

1. OtakuSolutions 网站 → **API Reference** → **Fast-Ref**。
2. 每页都有 **Download Markdown**。
3. 列表上方的 **Download All** 可一次下载全部 `.md`。

`.md`（Markdown）是给开发者用的文档格式，作用类似 Word，但 **AI 更好读。**  
可以用 **Typora** 打开，记事本也行。

---

## 3. 丢给 AI 做简介

Gemini / ChatGPT / Claude 都可以。

1. 把解压后的 `*.md` 附上。
2. Gemini 可能限制文件数量。这时只传 **Fast-Ref API 合订一份** 即可。
3. 提示词例如：`请介绍一下这份 API。`（用英文、日文也行）

AI 会整理结构和用法。做下载功能就是为了这个。

---

## 4. 示例 — 不打开 Fast-Ref 窗口加入 Mable

不会 Python 也没关系，让 AI 写。

1. 例如：`做一个不经过 Fast-Ref UI、直接添加 Mable 角色的简单工具。`
2. 同时写上你的 **3ds Max 版本**（片里是 2025）。
3. 第一次可能是没有界面、直接跑的脚本。  
   → `改成点按钮才会出现的 UI。`
4. 在 Max 里运行。报错就把 **报错原文原样复制** 回给 AI。
5. 简单工具也很少一次成功。要 **来回改**。
6. 点按钮，确认没有打开 Fast-Ref 窗口也能载入引用。
7. 在 Fast-Ref 里 **Refresh** / 看槽位。**New File** 之后再用 API 载入也成功，就对了。  
   **不是**因为 Fast-Ref UI 开着才行。

---

## 5. 为什么要用

只靠 Fast-Ref UI，每个工作室的 **口味和管线** 都不一样。  
把 API 嵌进自己的工具，就能用 **自己的按钮、自己的流程** 调用 Fast-Ref。

```
Download All API 文档
    → 把 *.md 交给 AI
    → 要简介 / 要小工具（写明 Max 版本）
    → 报错原文扔回去改
    → 接到自己的管线工具
```