자체 키 사용(BYOK)
조직의 Anthropic, OpenAI, 구글, Mistral AI 키를 저장하세요. 로컬라이제이션 요청에 조직의 키가 사용되고, 제공업체가 비용을 직접 청구합니다.
로컬라이제이션에 조직의 모델 제공업체 API 키를 사용하세요. 설정의 자체 키 사용 페이지에서 조직의 키를 추가한 다음, 로컬라이제이션에 사용할 모델을 선택하세요. 해당 제공업체의 모델을 요청하면 조직의 키가 사용되고, 제공업체가 토큰 비용을 직접 청구합니다. Enterprise 요금제에서 사용할 수 있습니다.
지원 제공업체: Anthropic, OpenAI, 구글, Mistral AI.
자체 키로 로컬라이제이션하기 #
AI 평가자, 엔진 제안 등 다른 기능은 제공업체 키를 추가하거나 모델을 선택하지 않아도 사용할 수 있습니다.
요금 청구 #
자체 키로 로컬라이제이션을 실행하면 제공업체가 모델의 토큰 비용을 청구하며, Lingo.dev에서는 모델 비용을 청구하지 않습니다. 로컬라이제이션된 콘텐츠에 대한 Lingo.dev 인프라스트럭처 요금은 그대로 적용됩니다. 자체 키를 사용하지 않는 로컬라이제이션의 모델 비용은 Lingo.dev 크레딧으로 결제됩니다.
키를 관리할 수 있는 사용자 #
자체 키 사용 페이지에는 두 가지 이용 조건이 적용됩니다.
- 이용 자격: 조직에서 자체 키 사용 기능이 활성화되어 있어야 합니다(Enterprise 요금제). 페이지는 설정에 항상 표시됩니다. 이용 자격이 없으면 "현재 요금제에서는 자체 제공업체 키를 사용할 수 없습니다"라는 메시지가 표시되며, 키를 저장할 수 없습니다.
- 권한: 키를 추가, 교체, 켜기, 끄기 또는 삭제하려면 구성원의 역할에 설정 관리(
org:manage_settings) 권한이 있어야 합니다. 역할 기반 접근 제어를 사용하지 않으면 모든 구성원이 소유자이며, 이 권한을 갖습니다.
모든 구성원은 어느 제공업체에 키가 등록되어 있는지, 해당 키가 사용 중인지 확인할 수 있습니다. 조직 API 키로는 키를 변경할 수 없습니다. 사용자 계정으로 로그인하세요.
키 추가하기 #
- 설정 → 자체 키 사용을 여세요.
- 제공업체 옆의 키 추가를 클릭하세요.
- API 키를 붙여넣고 저장하세요.
키를 저장할 때 Lingo.dev에서 제공업체를 통해 키의 유효성을 확인합니다. 제공업체가 키를 승인하지 않으면 저장되지 않습니다. 제공업체 계정에서 키를 확인한 다음 다시 붙여넣으세요.
키 표시
저장한 키는 전체 내용이 다시 표시되지 않습니다. 페이지에는 키의 마지막 네 글자와 업데이트 시점만 표시됩니다. 키를 변경하려면 교체를 클릭하고 새 키를 붙여넣으세요.
제공업체의 모델 사용하기 #
로컬라이제이션 요청에서 해당 제공업체의 모델을 호출하면 자체 키가 사용됩니다. 엔진의 로컬라이제이션 단계에서 자체 키를 사용하려면 엔진의 모델 구성에서 해당 제공업체의 모델을 설정하세요.
| 상황 | 처리 방식 |
|---|---|
| 모델 제공업체의 키가 등록되어 켜져 있고, 해당 키로 모델을 사용할 수 있음 | 자체 키로 요청 실행 |
| 해당 제공업체의 키가 없음 | 카탈로그 모델을 사용하는 로컬라이제이션에 Lingo.dev 크레딧 사용 |
| 키가 꺼져 있음 | 카탈로그 모델을 사용하는 로컬라이제이션에 Lingo.dev 크레딧 사용 |
| 모델이 Lingo.dev 모델 카탈로그에 없고, 해당 제공업체의 자체 키가 없거나 꺼져 있음 | Lingo.dev의 키로 해당 모델을 사용할 수 없어 로컬라이제이션 실패 |
| 제공업체가 자체 키를 통한 모델 사용을 거부함 | 카탈로그 모델은 Lingo.dev 크레딧으로 재시도하고, 카탈로그에 없는 모델은 실패 |
자체 키 사용 태그
제공업체가 엔진에 설정된 식별자와 정확히 일치하는 모델을 제공할 때만 자체 키가 사용됩니다. 모델 선택기와 엔진의 모델 구성에서는 자체 키로 사용할 수 있는 모델에 자체 키 사용 태그가 표시됩니다. 저장된 모델에 자체 키 미사용 태그가 표시되면 자체 키로 사용할 수 없는 모델이므로, 해당 모델을 사용하는 로컬라이제이션에는 Lingo.dev 크레딧이 사용됩니다. 저장된 모델에 Mistral AI 키 필요 태그가 표시되면 Lingo.dev 모델 카탈로그에 없어 자체 Mistral AI 키로만 실행할 수 있는데, 해당 키가 없거나 꺼져 있다는 뜻입니다. 키를 추가하거나 켜세요. 또는 다른 모델을 선택하세요.
키가 없거나 꺼져 있어도 카탈로그 모델을 사용하는 로컬라이제이션은 중단되지 않습니다.
카탈로그에 없는 모델 #
모델 선택기에는 mistralai/zai-glm-5-3처럼 자체 Mistral AI 키로 사용할 수 있지만 Lingo.dev 모델 카탈로그에는 없는 채팅 모델도 표시됩니다. 이 모델에는 자체 키 사용 태그가 붙고, Mistral AI에서 부여한 고유 식별자를 기준으로 모델당 한 번씩 provider/model 형식으로 표시됩니다. mistralai/zai-glm-latest 같은 별칭으로 저장한 모델도 자체 키로 실행됩니다.
이 모델은 Lingo.dev의 키로 사용할 수 없으므로 자체 키로만 실행됩니다. 현재는 Mistral AI의 모델 목록에서만 채팅 모델 여부를 확인할 수 있으므로, 다른 제공업체의 키로는 카탈로그에 없는 모델이 추가되지 않습니다.
자체 키가 거부되는 경우 #
다음 오류가 발생하면 로컬라이제이션 요청이 중단됩니다. Lingo.dev 크레딧으로 재시도하거나 엔진의 모델 구성에 있는 다음 모델로 넘어가지 않습니다. 오류 메시지에는 제공업체와 해결해야 할 사항이 표시됩니다.
| 상황 | 해결 방법 |
|---|---|
| 제공업체가 키의 요청 속도를 제한함 | 몇 분 후 다시 시도하거나 제공업체에서 키의 요청 속도 한도를 높이세요 |
| 제공업체 계정의 크레딧 또는 할당량이 소진됨 | 제공업체에서 크레딧을 추가하거나 할당량을 늘린 다음 다시 시도하세요 |
| 키 폐기 등의 이유로 제공업체가 키를 거부함 | 설정 → 자체 키 사용에서 키를 교체한 다음 다시 시도하세요 |
| Lingo.dev에서 저장된 키를 읽을 수 없음 | 설정 → 자체 키 사용에서 키를 다시 저장한 다음 다시 시도하세요 |
이는 사용자의 한도와 계정에 관한 문제이므로, Lingo.dev 크레딧으로 재시도하면 사용자가 문제를 알아차릴 수 없게 됩니다.
키 끄기 #
키를 삭제하지 않고 사용만 중지하려면 키를 끄세요. 페이지에 꺼짐이 표시되며, 키를 다시 켤 때까지 해당 제공업체의 카탈로그 모델을 사용하는 로컬라이제이션에는 Lingo.dev 크레딧이 사용됩니다. 키가 꺼져 있는 동안에는 카탈로그에 없는 모델이 실행되지 않습니다.
이용 중인 요금제에서 더 이상 자체 키를 지원하지 않으면 저장된 키에 저장됨, 사용하지 않음이 표시됩니다. 해당 제공업체의 카탈로그 모델을 사용하는 로컬라이제이션에는 Lingo.dev 크레딧이 사용되며, 카탈로그에 없는 모델은 실행되지 않습니다. 저장된 키는 직접 삭제할 때까지 유지됩니다.
키 삭제하기 #
키 삭제를 클릭하세요. Lingo.dev에서 키가 삭제됩니다. 해당 제공업체의 카탈로그 모델을 사용하는 로컬라이제이션에는 다시 Lingo.dev 크레딧이 사용되며, 카탈로그에 없는 모델은 더 이상 실행되지 않습니다.
제공업체에서 키 폐기하기
Lingo.dev에서 키를 삭제해도 키가 폐기되지는 않습니다. 제공업체에서 직접 폐기할 때까지 해당 키는 유효합니다.