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

한 줄 요약: Fast-Ref API V2 문서를 Markdown으로 받아 AI에 넣고, UI를 거치지 않고 스크립트(또는 작은 툴)로 Fast-Ref 기능을 호출하는 방법을 배웁니다.

문서: API Reference — Fast-Ref

1. API가 뭔가?

리거·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 버전 명시)
    → 에러는 그대로 돌려보내며 수정
    → 자기 파이프라인 툴에 연결