내 API 키 사용

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

언제 쓰는가

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

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

설정하기

모델 제공자 대시보드에서 키를 만듭니다. OpenRouter, xAI, OpenAI 키를 등록할 수 있습니다.
Endue 의 설정 → 계정 → LLM 키를 열고 그 제공자 줄에서 등록을 눌러 붙여넣습니다. 등록할 때 키가 유효한지 제공자에 한 번 확인합니다.
동작을 확인합니다. 평범한 대화를 한 번 돌려 실행이 끝나는지 보세요.

등록할 수 있는 키

키	쓰이는 모델	요청이 가는 곳
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 키를 함께 등록하면 전달됩니다.

바뀌는 것과 그대로인 것

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

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

키가 동작을 멈추면

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

키가 거부되면 endue 가 제공자에 그 키를 한 번 더 확인합니다. 거부가 맞으면 설정에 거부됨 으로 표시되고, 그 뒤의 실행은 다른 키나 endue 크레딧으로 이어집니다. 어느 쪽으로 실행됐는지도 입력창 위에 보입니다. 새 키로 다시 등록하거나 그 키를 삭제하면 안내가 사라집니다.

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

한계

키는 에이전트별이 아니라 계정별로 설정합니다.
실행 도중에 키가 거부되면 그 실행은 실패합니다. 실행 중간에 다른 키나 크레딧으로 바뀌지 않습니다.
내 키로 시작한 실행은 끝까지 내 키로만 모델을 부릅니다. 에이전트에 설정한 폴백 모델을 내 키로 부를 수 없으면 그 실행에서는 폴백이 쓰이지 않습니다.
제공자의 요청 한도는 사용자의 것입니다. 바쁜 루틴은 거기 닿을 수 있습니다.
자기 키로 발생한 비용은 Endue 의 사용량 화면이 아니라 제공자 쪽에서 보입니다.