# 내 API 키 사용

> 에이전트의 모델 호출에 Endue 의 허용량 대신 사용자가 가진 모델 제공자 자격증명을 씁니다.

**내 API 키 사용**(BYOK)은 Endue 가 *사용자의* 제공자 자격증명으로 모델을 호출한다는 뜻입니다. 제공자가 사용자에게 직접 청구하고, 그 호출은 Endue 허용량을 쓰지 않습니다.

## 언제 쓰는가

- 이미 제공자 크레딧이나 협상된 단가가 있을 때.
- 청구나 감사 때문에 조직이 모델 트래픽을 자기 계정으로 돌리기를 요구할 때.
- 자기 계정에서만 접근되는 모델을 쓰고 싶을 때.

여기에 해당하지 않는다면 내장 허용량이 더 간단합니다. 설정할 것도, 충전해 둘 것도 없습니다.

## 설정하기

<Steps>

1. **모델 제공자 대시보드에서 키를 만듭니다.**

2. **Endue 의 설정 → 계정 → LLM 키를 열고** 붙여넣습니다.

3. **동작을 확인합니다.** 평범한 대화를 한 번 돌려 실행이 끝나는지 보세요.

</Steps>

<Aside type="caution" title="키는 자격증명입니다">
  그 키로 지출할 수 있는 사람은 누구나 청구서를 키울 수 있습니다. 제공자에서 지출 한도를 걸고,
  유출이 의심되면 키를 교체하세요. 교체는 제공자에서 새 키를 만들고 Endue 에서 갈아 끼우는 것을
  뜻합니다. 옛 키와 새 키는 실행 중에 서로 대체되지 않습니다.
</Aside>

## 바뀌는 것과 그대로인 것

| 바뀌는 것 | 그대로인 것 |
| --- | --- |
| 모델 호출의 비용을 누가 내는가 | 에이전트의 행동에 관한 모든 것 |
| 어떤 모델에 닿을 수 있는가 — 사용자 계정의 접근 권한이 적용됩니다 | [승인](/ko/docs/work/approvals/) · [커넥터](/ko/docs/connect/overview/) · [메모리](/ko/docs/capabilities/memory/) · [아티팩트](/ko/docs/capabilities/artifacts/) |
| 청구서가 어디로 오는가 | 여전히 적용되는 Endue 구독 |

BYOK 는 모델 호출을 다룹니다. Endue 요금제를 바꾸거나 제품을 무료로 만들지는 않습니다.

## 키가 동작을 멈추면

취소됐거나 만료됐거나 크레딧이 없는 키는 모델 단계에서 실행을 실패시킵니다. 증상은 에이전트가 아무 일도 하기 전에 오류로 끝나는 실행입니다.

순서대로 확인하세요. 제공자에서 키가 아직 유효한지, 계정에 크레딧이 있는지, 고른 모델이 그 계정으로 닿을 수 있는 것인지.

## 한계

- 키는 에이전트별이 아니라 계정별로 설정합니다.
- 키가 유효하지 않으면 실행이 실패합니다. Endue 허용량으로 자동 전환되지 않습니다.
- 제공자의 요청 한도는 사용자의 것입니다. 바쁜 [루틴](/ko/docs/automate/routines/)은 거기 닿을 수 있습니다.
- 자기 키로 발생한 비용은 Endue 의 사용량 화면이 아니라 제공자 쪽에서 보입니다.

## 관련 문서

<CardGrid>
  <LinkCard
    title="요금제와 사용량"
    href="/ko/docs/account/plans-and-usage/"
    description="내장 허용량을 소모하는 것들."
  />
  <LinkCard
    title="모델 고르기"
    href="/ko/docs/build/models/"
    description="카탈로그, 그리고 모델별 실행 비용."
  />
  <LinkCard
    title="보안과 권한"
    href="/ko/docs/account/security/"
    description="자격증명이 어떻게 다뤄지는지."
  />
</CardGrid>