자체 키 사용(BYOK)

설정의 BYOK 페이지에 조직에서 사용하는 모델 제공업체의 API 키를 저장하세요. 그러면 해당 제공업체 모델에 대한 현지화 요청은 저장한 키를 사용해 제공업체로 직접 전송되고, 제공업체가 조직에 요금을 청구합니다. Enterprise 요금제에서 사용할 수 있습니다.

지원 제공업체: Anthropic, OpenAI, Google, Mistral AI.

자체 키가 사용되는 요청#

자체 키는 로컬라이제이션에만 사용됩니다. 그 외 모든 요청에는 Lingo.dev의 키가 사용됩니다.

요금 청구#

사용자의 키로 요청이 실행되면 제공업체가 해당 토큰 사용량에 대한 요금을 사용자에게 청구합니다.

키를 관리할 수 있는 사용자#

BYOK 페이지에 접근하려면 다음 두 가지 조건을 충족해야 합니다.

1. 이용 자격: 조직에 BYOK 기능이 활성화되어 있어야 합니다(Enterprise 요금제). 이 페이지는 설정에 항상 표시됩니다. 이용 자격이 없으면 "현재 요금제에서는 자체 제공업체 키를 사용할 수 없습니다"라는 메시지가 표시되며, 키를 저장할 수 없습니다.
2. 권한: 키를 추가, 교체, 삭제하거나 켜고 끄려면 구성원의 역할에 설정 관리(org:manage_settings) 권한이 있어야 합니다. RBAC를 사용하지 않으면 모든 구성원이 소유자이므로 이 권한을 갖습니다.

모든 구성원은 어떤 제공업체에 키가 등록되어 있는지, 해당 키가 사용 중인지 확인할 수 있습니다. 조직 API 키로는 키를 변경할 수 없습니다. 개인 사용자로 로그인하세요.

키 추가#

1. 설정 → BYOK를 여세요.
2. 제공업체 옆의 키 추가를 클릭하세요.
3. API 키를 붙여넣고 저장하세요.

저장 시 Lingo.dev가 제공업체를 통해 키의 유효성을 확인합니다. 제공업체가 키를 받아들이지 않으면 저장되지 않습니다. 제공업체 계정에서 키를 확인한 뒤 다시 붙여넣으세요.

제공업체 모델 사용#

엔진이 해당 제공업체의 모델을 호출할 때 자체 키가 사용됩니다. 제공업체 모델을 자체 키로 실행하려면 엔진의 모델 구성에서 해당 모델을 설정하세요.

키가 없거나 꺼져 있어도 로컬라이제이션은 중단되지 않습니다. 다만 제공업체가 응답을 시작한 뒤에 모델 사용을 거부하면 요청이 실패할 수 있습니다. 이를 방지하려면 자체 키에 해당 모델의 접근 권한을 부여하거나 다른 모델을 선택하세요.

자체 키가 거부되는 경우#

다음 오류가 발생하면 요청이 중단됩니다. Lingo.dev의 키로 전환되지 않으며, 엔진의 모델 구성에 있는 다음 모델로도 넘어가지 않습니다. 오류 메시지에는 제공업체와 해결해야 할 사항이 표시됩니다.

이러한 문제는 사용자 계정과 해당 계정의 한도에 관한 것이므로, 요청을 Lingo.dev의 키로 전환하면 사용자가 문제를 알아차릴 수 없게 됩니다.

키 끄기#

키를 삭제하지 않고 사용만 중지하려면 키를 끄세요. 페이지에 꺼짐이 표시되며, 키를 다시 켤 때까지 해당 제공업체의 모델은 Lingo.dev의 키와 사용자의 크레딧으로 실행됩니다.

이용 중인 요금제에서 더 이상 자체 키를 지원하지 않으면 저장된 키에 저장됨, 사용하지 않음이 표시됩니다. 해당 제공업체의 모델은 Lingo.dev의 키와 사용자의 크레딧으로 실행됩니다. 저장된 키는 직접 삭제할 때까지 유지됩니다.

키 삭제#

키 삭제를 클릭하세요. Lingo.dev에서 키가 삭제되며, 해당 제공업체의 모델은 다시 Lingo.dev의 키와 사용자의 크레딧으로 실행됩니다.

다음 단계#