> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LLM 모델 관리

> 자체 API 키(BYOK)로 LLM 모델을 등록하고 관리합니다.

LLM 모델 관리는 **BYOK(Bring Your Own Key)** 방식으로, 고객사가 직접 보유한 제공자 API 키로 LLM 모델을 등록하는 화면입니다.
등록한 모델은 [분석·시책](/insight/analytics) 채팅 등에서 사용됩니다.
제공자별로 **기본 모델을 1개**씩 지정할 수 있습니다.

<Info>
  이 화면은 접근 권한 **관리자(manage)** 전용입니다. 최고 관리자(Owner)와 관리자(Manager)가 이용할 수 있으며, 일반 사용자(Member)에게는 노출되지 않습니다.
</Info>

## 지원 제공자

| 제공자           | 모델        | API 키 접두사        |
| ------------- | --------- | ---------------- |
| Claude        | Anthropic | `sk-ant-api03-…` |
| OpenAI        | GPT       | `sk-…`           |
| Google Gemini | Gemini    | `AIza…`          |

## 모델 목록

* 검색 · 제공자 필터를 제공하며, 페이지네이션은 20개 단위입니다.
* 각 모델의 상태 배지로 **연결됨 / 키 무효**를 확인합니다.
* 제공자당 1개씩 **기본 모델 라디오**로 기본 모델을 지정합니다.

## 모델 추가

<Steps>
  <Step title="제공자 선택">
    Claude / OpenAI / Google Gemini 중에서 선택합니다.
  </Step>

  <Step title="API 키 붙여넣기">
    선택한 제공자의 API 키를 붙여넣습니다.
  </Step>

  <Step title="키 검증">
    키를 검증하면 사용 가능한 모델 목록이 반환됩니다.
  </Step>

  <Step title="사용 모델 선택">
    반환된 목록에서 사용할 모델을 선택합니다.
  </Step>

  <Step title="표시명 · 기본 모델 설정 (선택)">
    표시명을 지정하고, 필요하면 "기본 모델로 설정"을 선택합니다.
  </Step>

  <Step title="저장">
    저장하면 모델이 목록에 등록됩니다.
  </Step>
</Steps>

## 모델 관리

관리 모달에서 다음을 수행할 수 있습니다.

<CardGroup cols={2}>
  <Card title="API 키 교체" icon="rotate">
    새 API 키로 교체하면 재검증이 진행됩니다.
  </Card>

  <Card title="모델 삭제" icon="trash">
    2단계 확인을 거쳐 모델을 삭제합니다.
  </Card>
</CardGroup>

<Note>
  API 키는 전체가 저장되지 않고 \*\*힌트(일부)\*\*만 저장됩니다.
</Note>