내 API 키 사용

Markdown으로 보기

내 API 키 사용(BYOK)은 Endue 가 사용자의 제공자 키로 모델을 호출한다는 뜻입니다. 제공자가 사용자에게 직접 청구하고, 그 호출은 Endue 허용량을 쓰지 않습니다. 키마다 어느 에이전트와 어느 모델에 쓸지 정합니다.

언제 쓰는가

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

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

설정하기

모델 제공자 대시보드에서 키를 만듭니다. Anthropic · OpenAI 키는 에이전트마다 정할 수 있고, OpenRouter · xAI 키는 계정 전체에 적용됩니다.
좌측 사이드바에서 리소스 › 모델 을 엽니다. 내 LLM 키 에서 Anthropic 이나 OpenAI 를 펼치고 키 추가 를 누릅니다. 원하면 이름을 붙이고, 키를 붙여넣어 등록합니다. 등록할 때 키가 유효한지 제공자에 한 번 확인합니다.
이 키를 쓰는 곳을 고릅니다. 에이전트 에서 전체 를 두거나 지정 으로 바꿔 프로필을 보고 에이전트를 고릅니다. 모델 도 전체 를 두거나 이 키를 쓸 모델을 고릅니다.
키로 못 돌 때를 고릅니다. 기본은 endue 크레딧으로 이어서 실행 입니다. 멈추고 알리기 로 두면 이 키가 맡은 에이전트와 모델에는 endue 크레딧을 쓰지 않습니다.
동작을 확인합니다. 그 에이전트와 대화를 엽니다. 모델 선택 목록에서 내 키로 도는 모델은 이름 옆에 열쇠 아이콘과 제공자 이름이 붙습니다.

에이전트 하나만 따로 정하기

에이전트의 에이전트 빌더 모델 섹션에 실행 키 가 있습니다. 내 Anthropic · OpenAI 키가 나열되고, 키마다 이 에이전트에만 켜고 끄는 스위치가 있습니다. 같은 선택이 리소스 › 모델 의 키 카드에도 보이고, 어느 쪽에서 바꿔도 다른 쪽에 반영됩니다.

목록 위 한 줄은 에이전트의 기본 모델이 지금 무엇으로 도는지 알려 줍니다. 예를 들면 내 Anthropic 키, 또는 endue 크레딧입니다. 키를 추가하거나 순서를 바꾸거나 삭제하려면 키 관리 를 누릅니다.

등록할 수 있는 키

키	쓰이는 모델	에이전트마다	요청이 가는 곳
Anthropic	Claude 모델	예	Anthropic
OpenAI	GPT 모델	예	OpenAI
OpenRouter	모든 모델	아니요, 계정 전체	OpenRouter
xAI	Grok 모델	아니요, 계정 전체	xAI

Anthropic · OpenAI 키는 여러 개 등록할 수 있습니다. 목록의 위에서부터 차례로 시도하고, 위로 · 아래로 로 순서를 바꿉니다.

모델마다 Endue 는 그 모델 제공자의 키 중 에이전트와 모델에 맞는 첫 키를 씁니다. 맞는 키가 없으면 OpenRouter 키를, 그다음 endue 크레딧을 씁니다.

제공자 키로는 요청할 수 없는 모델이 있습니다. OpenAI 의 Codex · Pro 계열, Grok 4.20, 그리고 Anthropic 이 API 에서 내린 Claude 모델이 그렇습니다. 이 모델들은 OpenRouter 키가 있으면 그 키로, 없으면 endue 크레딧으로 실행됩니다.

화면에서 보이는 것

모델 이름 옆. 모델 선택 목록, 에이전트 카드, 입력창에서 내 키로 도는 모델에 열쇠 아이콘과 제공자 이름이 붙습니다. endue 크레딧으로 도는 모델에는 아무것도 붙지 않습니다.
모델 정보. 실행 줄에 키 이름과 청구되는 계정이 나옵니다.
답 아래. 답이 평소와 다른 키로 돌았다면 그 답 아래에 작은 열쇠 아이콘이 붙습니다. 가리키면 무엇 대신 무엇으로 돌았는지 보입니다.

제공자 키로 실행할 때 달라지는 점

Anthropic. PDF 를 그대로 전달하고, 모델이 일하는 동안 생각 과정이 보입니다. 도구를 많이 쓰는 긴 대화에서 반복되는 부분은 Anthropic 의 캐시 단가로 청구됩니다.
xAI. Grok 모델에 붙인 PDF 는 본문을 텍스트로 뽑아 전달합니다. 그림과 표의 모양은 전달되지 않습니다.
OpenAI. GPT 모델은 답을 만드는 동안 생각 과정이 표시되지 않습니다. 답은 같습니다.
Temperature. 에이전트의 temperature 설정은 Anthropic · OpenAI 에 보내지 않습니다.
음성 · 영상. 음성 · 영상 첨부를 글로 옮기는 일은 OpenRouter 를 거칩니다. OpenRouter 키가 없으면 Anthropic · OpenAI · xAI 키로 도는 모델에 음성 · 영상 첨부가 전달되지 않습니다.

바뀌는 것과 그대로인 것

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

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

키가 동작을 멈추면

제공자가 키를 거부하거나, 결제에 문제가 있거나, 지출 한도에 닿으면 Endue 는 같은 답 안에서 다음으로 넘어갑니다. 맞는 다음 키, 그다음 OpenRouter 키, 그다음 endue 크레딧 순서입니다. 입력창 위에 무슨 일이 있었는지 안내가 뜹니다. 예를 들면 「Anthropic 이 「회사 키」를 거부해 「개인 키」로 이어서 답했어요.」 입니다.

그 모델에 걸린 키 중 하나라도 멈추고 알리기 로 되어 있으면 endue 크레딧으로는 넘어가지 않습니다. OpenRouter 키가 있으면 그 키는 씁니다. 없으면 실행이 멈추고, 안내에 키 관리 버튼이 붙습니다.

키가 거부되면 Endue 가 제공자에 그 키를 한 번 더 확인합니다. 거부가 맞으면 키 카드에 거부됨 으로 표시됩니다.

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

한계

에이전트마다 정하는 키는 Anthropic · OpenAI 만 됩니다. OpenRouter · xAI 키는 계정 전체에 적용됩니다.
에이전트에 걸린 키는 그 에이전트의 모든 실행에 쓰입니다. Live 방문자 대화, 채널, API, 예약도 같습니다. 실행은 언제나 에이전트 주인의 키를 씁니다.
예약의 자율 실행은 Anthropic · OpenAI 키를 쓰지 않습니다. OpenRouter 키나 endue 크레딧으로 실행되고, 그 모델에 멈추고 알리기 키가 걸려 있으면 크레딧으로는 실행하지 않습니다.
답 도중에 endue 크레딧으로 넘어가면 넘어간 뒤의 부분만 허용량에서 빠집니다. 허용량이 모자라면 평소의 허용량 안내와 함께 실행이 멈춥니다.
제공자의 요청 한도는 사용자의 것입니다. 바쁜 예약은 거기 닿을 수 있습니다.
자기 키로 발생한 비용은 Endue 의 사용량 화면이 아니라 제공자 쪽에서 보입니다.