Gemini API 키 가져오기

Gemini API를 사용하려면 API 키가 필요합니다. Google AI 스튜디오에서 몇 번의 클릭만으로 키를 만들 수 있습니다.

API 키 설정

초기 테스트의 경우 API 키를 하드코딩할 수 있지만 안전하지 않으므로 일시적으로만 하드코딩해야 합니다. 이 섹션의 나머지 부분에서는 다양한 운영체제에서 API 키를 로컬에서 환경 변수로 설정하는 방법을 설명합니다.

Linux/macOS - Bash

Bash는 일반적인 Linux 및 macOS 터미널 구성입니다. 다음 명령어를 실행하여 구성 파일이 있는지 확인할 수 있습니다.

~/.bashrc

응답이 '파일 또는 디렉터리가 없음'인 경우 이 파일을 만들고 다음 명령어를 실행하여 열거나 zsh를 사용해야 합니다.

touch ~/.bashrc
open ~/.bashrc

다음 내보내기 명령어를 추가하여 API 키를 설정해야 합니다.

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

파일을 저장한 후 다음을 실행하여 변경사항을 적용합니다.

source ~/.bashrc

macOS - Zsh

Zsh는 일반적인 Linux 및 macOS 터미널 구성입니다. 다음 명령어를 실행하여 구성 파일이 있는지 확인할 수 있습니다.

~/.zshrc

응답이 '파일 또는 디렉터리가 없음'인 경우 이 파일을 만들고 다음 명령어를 실행하여 열거나 bash를 사용해야 합니다.

touch ~/.zshrc
open ~/.zshrc

다음 내보내기 명령어를 추가하여 API 키를 설정해야 합니다.

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

파일을 저장한 후 다음을 실행하여 변경사항을 적용합니다.

source ~/.zshrc

Windows

시스템 설정에서 '환경 변수'를 검색합니다.
'사용자 변수' (현재 사용자의 경우) 또는 '시스템 변수'(모든 사용자의 경우 - 주의해서 사용)를 수정합니다.
변수를 만들고 export GEMINI_API_KEY=your_key_here를 추가합니다.
변경사항 적용

첫 번째 Gemini API 요청 보내기

curl 명령어를 사용하여 설정을 확인할 수 있습니다.

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

API 키 안전하게 보호하기

Gemini API 키를 안전하게 보호하는 것이 중요합니다. Gemini API 키를 사용할 때 유의해야 할 사항은 다음과 같습니다.

Google AI Gemini API는 승인에 API 키를 사용합니다. 다른 사용자가 내 Gemini API 키에 액세스하면 내 프로젝트의 할당량을 사용하여 호출할 수 있으므로 조정된 모델 및 파일에 액세스하는 것 외에도 할당량이 손실되거나 요금이 청구된 프로젝트에 추가 비용이 청구될 수 있습니다.
API 키 제한사항을 추가하면 각 API 키를 통해 사용할 수 있는 노출 영역을 제한하는 데 도움이 됩니다.
Gemini API 키를 안전하게 유지하는 것은 개발자의 책임입니다.
- Gemini API 키를 소스 제어에 체크인하지 마세요.
- 클라이언트 측 애플리케이션 (Android, Swift, 웹, Dart/Flutter)은 API 키가 노출될 위험이 있습니다. 프로덕션 앱에서 Google AI 클라이언트 SDK를 사용하여 모바일 및 웹 앱에서 Google AI Gemini API를 직접 호출하는 것은 권장하지 않습니다.

일반적인 권장사항은 이 지원 도움말을 참고하세요.