# add_reference()

`.max` 파일을 새 레퍼런스로 추가합니다. 비어 있는 슬롯에 자동으로 배정됩니다.

### 시그니처
```python
api.add_reference(file_path: str) -> dict
```

### 파라미터
| 파라미터 | 타입 | 설명 |
| --- | --- | --- |
| `file_path` | `str` | 추가할 `.max` 파일의 절대 경로 |

### 반환값
```python
{
    "success": True,
    "message": str,
    "slot": int,
}
```

### 예외
| 예외 | 조건 |
| --- | --- |
| `FileNotFoundError` | 파일이 디스크에 존재하지 않을 때 |
| `ValueError` | 슬롯 10개가 모두 사용 중일 때 |

### 예제
```python
from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
result = api.add_reference(r"J:\assets\character_A.max")

if result['success']:
    print(f"Added to slot {result['slot']}")
```
> **v2:** 확인 다이얼로그 없이 자동으로 진행됩니다.

---