# 내 API 키 사용

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

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

## 언제 쓰는가

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

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

## 설정하기

<Steps>

1. **모델 제공자 대시보드에서 키를 만듭니다.** OpenRouter, xAI, OpenAI 키를 등록할 수 있습니다.

2. **Endue 의 설정 → 계정 → LLM 키를 열고** 그 제공자 줄에서 등록을 눌러 붙여넣습니다. 등록할 때 키가 유효한지 제공자에 한 번 확인합니다.

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

</Steps>

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

## 등록할 수 있는 키

| 키 | 쓰이는 모델 | 요청이 가는 곳 |
| --- | --- | --- |
| OpenRouter | 모든 모델 | OpenRouter |
| xAI | Grok 모델 | xAI |
| OpenAI | GPT 모델 | OpenAI |

키를 여러 개 등록하면 모델의 제공자 키가 먼저 쓰입니다. Grok 모델은 xAI 키로, GPT 모델은 OpenAI 키로 가고, 나머지 모델은 OpenRouter 키로 갑니다. 맞는 키가 없는 모델은 endue 크레딧으로 실행됩니다.

xAI·OpenAI 키로는 요청할 수 없는 모델이 있습니다. OpenAI 의 Codex·Pro 계열과 Grok 4.20 이 그렇습니다. 이 모델들은 OpenRouter 키가 있으면 그 키로, 없으면 endue 크레딧으로 실행됩니다.

xAI·OpenAI 키로 실행할 때 달라지는 점이 세 가지 있습니다.

- Grok 모델에 붙인 PDF 는 본문을 텍스트로 뽑아 전달합니다. 그림과 표의 모양은 전달되지 않습니다.
- GPT 모델은 답을 만드는 동안 생각 과정이 표시되지 않습니다. 답은 같습니다.
- 음성·영상 첨부를 글로 옮기는 일은 OpenRouter 를 거칩니다. OpenRouter 키 없이 xAI·OpenAI 키만 등록했다면 음성·영상 첨부는 모델에 전달되지 않습니다. OpenRouter 키를 함께 등록하면 전달됩니다.

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

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

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

## 키가 동작을 멈추면

실행 도중 제공자가 키를 거부하거나 제공자 계정에 크레딧이 없으면 그 실행은 모델 단계에서 실패합니다. 입력창 위에 어느 제공자의 키인지와 함께 안내가 뜨고, 안내의 **LLM 키 설정** 이 설정으로 데려갑니다.

키가 거부되면 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>