Discourse AI에 Gemini API 키 설정하기
소개
이 주제는 기존 Google Cloud 계정 프로젝트에 Google Gemini API 키를 설정하는 방법을 다룹니다. Gemini는 무료 서비스가 아니므로, Google Cloud 관리에서 결제가 설정되어 있는지 확인해야 합니다.
Gemini Developer studio 키 생성 페이지에는 이 주제와 관련하여 링크가 포함된 중요한 정보가 있습니다:
자, 시작해 보겠습니다!
참고: Google Cloud 및 Discourse 포럼에 대한 관리자 수준의 접근 권한이 필요합니다.
단계 1: Google Cloud 프로젝트 설정
Gemini API 키를 적절히 설정하려면 Google Cloud 계정에 대한 관리자 접근 권한이 필요하며, Gemini API 키 사용에 사용할 수 있는 결제 프로젝트를在那里 생성해야 합니다.
Gemini Studio에서 키를 생성하고 Google Cloud에 연결할 수 있지만, 오가는 번거로움을 피하기 위해 Google Cloud 콘솔에서 모든 작업을 수행하는 것이 다소 더 쉽습니다.
조직의 Google Cloud API 관리자로 이동하여 상위 조직에 있는지 확인하세요(Google Cloud 로고 옆 상단 필드에서 확인할 수 있습니다).
이미 사용하려는 프로젝트가 없다면 Gemini 키를 위해 프로젝트를 생성해야 합니다(프로젝트를 선택하거나 새 프로젝트를 생성하는 링크는 페이지 왼쪽 상단에 있음).
새 프로젝트의 경우, 새 프로젝트 생성 페이지를 완료하세요(적절한 드롭다운 필드에서 조직이 선택되어 있는지 확인하세요).
프로젝트의 결제를 관리하려면, 조직에 결제가 설정되어 있다고 가정하고 Google Cloud 결제에서 프로젝트에 대한 결제 계정을 설정해야 합니다. (또는 결제 계정 관리자)는 키가 생성된 후 나중에 이 작업을 수행할 수 있습니다. 조직의 Google Cloud 계정에 따라 프로젝트와 결제 프로젝트에 할당량이 있음을 유의하세요. 프로젝트에서 결제를 활성화하려면 Google Cloud 탐색 메뉴의 결제 탭으로 이동하여 결제 계정을 연결하고(“결제 계정 관리” 링크 참조) 결제 프로젝트 페이지에서 프로젝트의 결제를 활성화하세요.
단계 2: Gemini API 키 생성
중요! API 키를 안전하게 사용하세요. 진행하기 전에 API 키 안전하게 보관하기 및 API 키를 안전하게 사용하는 모범 사례를 주의 깊게 읽어 주세요.
이제 프로젝트에서 API 키를 생성할 준비가 되었습니다. 해당 프로젝트의 자격 증명(Credentials)로 이동하여 상단의 “+ 자격 증명 생성” 링크를 클릭하고 드롭다운 옵션에서 “API 키”를 선택하세요.
새 API 키가 생성됩니다. 이를 복사하여 비밀번호 금고 애플리케이션과 같은 안전한 곳에 보관하세요. 키를 공유하지 마세요. 이 키는 Discourse AI 설정에 입력해야 할 키입니다.
이제 키가 API 키 목록에 표시되어야 합니다. 편집하려면 키를 클릭하세요.
키에 적절한 이름을 부여한 다음, API 제한 섹션으로 내려가 “키 제한”을 선택하고 “Generative Language API”를 선택하세요.
업데이트된 키를 저장하세요. 새 키의 “키 표시” 링크를 클릭하고 복사하세요.
단계 3: Discourse AI 설정에서 Gemini 구성
Discourse AI는 이제 API 키 관리를 위해 중앙 집중식 자격 증명(Credentials) 시스템을 사용합니다. 각 LLM 구성에 키를 직접 붙여넣는 대신, 먼저 자격 증명을 생성한 다음 Gemini 모델을 구성할 때 해당 자격 증명을 선택합니다.
단계 3a: 자격 증명 생성
관리자 > 플러그인 > AI > 자격 증명으로 이동하여 새 자격 증명을 클릭하세요. 기술적인 이름(예: “Gemini API Key”)을 부여하고 Google Cloud에서 복사한 API 키를 붙여넣으세요. 자격 증명을 저장하세요.
팁: 인라인으로 자격 증명을 생성할 수도 있습니다. 다음 단계에서 새 LLM을 추가할 때 자격 증명 선택기 옆의 + 버튼을 클릭하여 즉시 생성할 수 있습니다.
단계 3b: Gemini LLM 추가
이제 관리자 > 플러그인 > AI > LLMs로 이동하세요. 추가를 클릭하고 사전 구성된 Gemini 모델 중 하나(예: Gemini 3 Flash 또는 Gemini 3 Pro)를 선택하세요. 모델 이름, 엔드포인트 URL 및 기타 설정은 자동으로 입력됩니다. 자격 증명 드롭다운에서 이전 단계에서 생성한 자격 증명을 선택한 다음 저장하세요.
참고: 동일한 자격 증명은 여러 LLM 구성에서 재사용할 수 있으므로 Gemini API 키를 한 번만 입력하면 됩니다.
단계 4: Gemini API 키 사용량 추적
Google Cloud 대시보드의 결제 부분 “결제 계정 관리”에서 Gemini API 키 사용량을 추적할 수 있습니다.
그런 다음 결제 프로젝트 목록에서 특정 프로젝트를 선택하면, API 키 프로젝트를 추적하려는 프로젝트 및 기타 세부 사항을 지정할 수 있는 결제 보고서가 표시됩니다(예: Google Custom Search API 및 Programmable Search Engine이 구성된 경우, Google Cloud 계정에 연결된 다른 Google API 키도 여기서 추적할 수 있습니다).
