# Ep.11 — Fast-Ref API (V2 · Markdown · AI로 간단한 툴 만들기)

https://youtu.be/PyDUUvGnKQo

> **한 줄 요약**: Fast-Ref **API V2** 문서를 Markdown으로 받아 AI에 넣고, UI를 거치지 않고 스크립트(또는 작은 툴)로 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**(Open Editor) → 언어를 **Python**으로 바꾸면 Fast-Ref API를 실행할 수 있습니다. 명령 목록이 바로 위 API 문서입니다.

원래 V1이 있었고, 이번 업데이트에서 **V2**로 올라갔습니다.

---

## 2. 문서 받는 법

1. OtakuSolutions 사이트 → **API Reference** → **Fast-Ref**.
2. 페이지마다 **Download Markdown**.
3. 목록 위의 **Download All**로 전체 `.md`를 한 번에 받습니다.

`.md`(Markdown)는 개발용 문서 포맷입니다. 한글·워드와 같은 역할이고, **AI가 읽기 쉽습니다.**  
열어볼 때는 **Typora**를 쓰거나, 그냥 메모장으로도 됩니다.

---

## 3. AI에 넣고 브리핑 받기

Gemini / ChatGPT / Claude 모두 됩니다.

1. 받은 폴더에서 `*.md`를 첨부합니다.
2. Gemini는 파일 개수 제한이 있을 수 있습니다. 그러면 **Fast-Ref API 전체 합본** 하나만 넣어도 됩니다.
3. 프롬프트 예: `이 API 관해서 브리핑 해봐.` (영어·일본어로 그대로 써도 됩니다.)

AI가 구성과 쓰는 법을 정리해 줍니다. 다운로드 기능을 만든 이유가 이것입니다.

---

## 4. 예제 — Fast-Ref 창 없이 Mable 넣기

파이썬을 몰라도 됩니다. AI에게 시킵니다.

1. 예: `Fast-Ref UI를 거치지 않고 Mable 캐릭터를 추가하는 간단한 툴을 만들어줘.`
2. 쓰는 **3ds Max 버전**을 같이 적습니다. (영상 예: 2025)
3. 처음엔 UI 없이 바로 실행되는 스크립트가 나올 수 있습니다.  
   → `버튼 클릭하면 나오게 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 기능을 **우리 버튼·우리 흐름**으로 쓸 수 있습니다.

```
API 문서 Download All
    → *.md 를 AI에 첨부
    → 브리핑 / 간단한 툴 요청 (Max 버전 명시)
    → 에러는 그대로 돌려보내며 수정
    → 자기 파이프라인 툴에 연결
```