구글 AI 스튜디오 API 키는 어디서 발급하나요? AI 스튜디오 사이트에 로그인해서 몇 번 클릭하면 바로 받을 수 있어요. 그럼 어디서부터 하면 되는지 보겠습니다.
시작하기 전에 준비할 것
구글 계정만 있으면 별도 결제 정보 없이 바로 진행할 수 있어요. 브라우저에서 AI 스튜디오에 로그인하고, 환경 변수 설정을 위해 터미널을 열어두면 편리합니다.
파이썬을 사용할 예정이라면 pip가 최신인지 확인하고, google-genai 패키지를 설치할 준비만 하면 됩니다.
API 키 발급 단계
- AI 스튜디오 메인 화면 좌측 메뉴에서 Get API key를 클릭합니다.
- 팝업이 뜨면 API 키 만들기 버튼을 누릅니다.
- 이미 만든 구글 클라우드 프로젝트를 선택하거나 새 프로젝트를 생성합니다.
- 선택이 완료되면 화면에 키 문자열이 바로 표시됩니다. 복사 아이콘을 눌러 바로 복사해두세요.
- 필요하면 같은 화면에서 키를 다시 확인하거나 삭제할 수 있습니다.
이 과정을 마치면 구글 AI 스튜디오 API 발급법이 완료된 것이고, 별도 결제 절차는 없습니다.
발급 확인 및 간단 테스트
키를 환경 변수 GEMINI_API_KEY에 저장하고, 아래 코드를 실행해 보세요. 정상적으로 응답이 나오면 설정이 올바른 겁니다.
# pip install google-genai
import os
from google import genai
client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
response = client.models.generate_content(
model="gemini-flash-latest",
contents="한국의 수도는 어디인가요?",
)
print(response.text)
출력에 “서울”이라는 답이 나오면 API 호출이 성공한 것이니, 이제 원하는 프로젝트에 적용하면 됩니다.
자주 마주치는 오류와 해결법
- 키를 복사했는데 공백이 포함된 경우: 환경 변수에 붙여넣을 때 앞뒤 공백을 제거하세요.
- 404 오류가 뜨는 경우: AI 스튜디오에서 최신 모델 이름을 확인하고
model파라미터를 업데이트합니다. - 키가 인식되지 않을 때: 터미널을 재시작하거나
echo $GEMINI_API_KEY로 값이 제대로 설정됐는지 확인합니다.
FAQ
API 키 발급에 비용이 들어가나요?
무료 등급으로 바로 사용할 수 있으며, 사용량이 늘면 결제 정보를 추가해 유료 등급으로 전환하면 됩니다.
키를 잃어버렸을 때는 어떻게 하나요?
AI 스튜디오 좌측 메뉴의 같은 화면에서 키를 다시 복사하거나, 필요하면 새 키를 생성해 교체하면 됩니다.
다른 프로젝트에서도 같은 키를 쓸 수 있나요?
키는 프로젝트와 무관하게 동작하므로, 여러 프로젝트에서 동일 키를 재사용해도 문제 없습니다.