인증 방식
🔑 API Key
요금
1.5 Flash 무료(제한), Pro $3.5/1M tokens~
Base URL
generativelanguage.googleapis.com
태그
AI, Gemini
서비스 소개
Google의 Gemini API는 Gemini 1.5 Pro, 1.5 Flash 모델을 제공합니다. 특히 Gemini 1.5 Flash는 무료 티어(분당 15회, 일 1500회)가 제공되어 개발 시작에 최적입니다. 100만 토큰의 긴 컨텍스트와 이미지·영상·오디오 분석을 지원합니다.
🚀 시작하기
- 1
Google AI Studio 접속
aistudio.google.com → Google 계정으로 로그인
- 2
API 키 발급
Get API key → Create API key → 복사
- 3
SDK 설치
npm install @google/generative-ai 또는 pip install google-generativeai
📋 응답 예시
{
"candidates": [{
"content": {
"parts": [{"text": "안녕하세요! 무엇을 도와드릴까요?"}],
"role": "model"
},
"finishReason": "STOP"
}],
"usageMetadata": { "promptTokenCount": 5, "candidatesTokenCount": 12 }
}💡 코드 예제
JavaScriptNode.js
import { GoogleGenerativeAI } from '@google/generative-ai'
const genAI = new GoogleGenerativeAI(process.env.GEMINI_API_KEY!)
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' })
// 텍스트 생성
const result = await model.generateContent('프랜차이즈 창업 장단점을 알려줘')
console.log(result.response.text())
// 채팅 (대화 이력 유지)
const chat = model.startChat({
history: [
{ role: 'user', parts: [{ text: '안녕' }] },
{ role: 'model', parts: [{ text: '안녕하세요!' }] },
],
})
const msg = await chat.sendMessage('오늘 날씨 어때?')
console.log(msg.response.text())
// 이미지 분석
import fs from 'fs'
const imageData = fs.readFileSync('image.jpg').toString('base64')
const imgResult = await model.generateContent([
{ inlineData: { data: imageData, mimeType: 'image/jpeg' } },
'이 이미지를 설명해줘',
])PythonPython
import google.generativeai as genai
genai.configure(api_key="YOUR_API_KEY")
model = genai.GenerativeModel("gemini-1.5-flash")
# 텍스트 생성
response = model.generate_content("프랜차이즈 창업 비용 알려줘")
print(response.text)
# 스트리밍
for chunk in model.generate_content("긴 글 작성", stream=True):
print(chunk.text, end="")