Gemini API Cheatsheet 2026 — 무료 티어 한도, 모델 및 엔드포인트를 한 곳에
발행: (2026년 5월 3일 PM 11:18 GMT+9)
3 분 소요
원문: Dev.to
Source: Dev.to
모델 개요
| 모델 | 컨텍스트 | 추천 용도 |
|---|---|---|
| gemini-2.5-flash-preview | 1 M 토큰 | 일반 사용, 사고, 빠른 응답 |
| gemini-2.5-pro-preview | 1 M 토큰 | 복잡한 추론, 최고 품질 |
| gemini-1.5-flash | 1 M 토큰 | 안정적, 프로덕션 준비 |
| gemini-1.5-pro | 2 M 토큰 | 가장 긴 컨텍스트 |
| gemini-2.0-flash-lite | 1 M 토큰 | 가장 낮은 지연시간, 높은 처리량 |
권장 모델
대부분의 사용 사례에: gemini-2.5-flash-preview
속도 제한
| 모델 | RPM | TPM | RPD |
|---|---|---|---|
| Gemini 2.5 Flash Preview | 10 | 250 000 | 500 |
| Gemini 1.5 Flash | 15 | 1 000 000 | 1 500 |
| Gemini 1.5 Pro | 2 | 32 000 | 50 |
| Gemini 2.0 Flash Lite | 30 | 1 000 000 | 1 500 |
RPM = 분당 요청 수, TPM = 분당 토큰 수, RPD = 일일 요청 수.
API 예시
콘텐츠 생성 (cURL)
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-preview:generateContent \
-H "Content-Type: application/json" \
-H "x-goog-api-key: YOUR_API_KEY" \
-d '{
"contents": [{"parts": [{"text": "Your prompt here"}]}]
}'스트리밍 콘텐츠 생성 (cURL)
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-preview:streamGenerateContent \
-H "Content-Type: application/json" \
-H "x-goog-api-key: YOUR_API_KEY" \
-d '{"contents": [{"parts": [{"text": "Tell me a story"}]}]}'Rust 예시 (reqwest)
use reqwest::Client;
use serde_json::json;
pub async fn call_gemini(prompt: &str, api_key: &str) -> Result {
let client = Client::new();
let url = format!(
"https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-preview:generateContent?key={}",
api_key
);
let body = json!({
"contents": [{ "parts": [{ "text": prompt }] }]
});
let res = client.post(&url).json(&body).send().await?;
let data: serde_json::Value = res.json().await?;
let text = data["candidates"][0]["content"]["parts"][0]["text"]
.as_str()
.unwrap_or("")
.to_string();
Ok(text)
}오류 코드
| 코드 | 의미 | 해결 방법 |
|---|---|---|
| 400 | 잘못된 요청 / 토큰 제한 | 프롬프트를 짧게 |
| 403 | 잘못된 API 키 | 키 확인하기 |
| 429 | 속도 제한 초과 | 기다렸다가 재시도 |
| 500 | 내부 오류 | 재시도 |
| 503 | 과부하 | 2초 기다린 뒤 한 번 재시도 |
토큰 추정
- 1 토큰 ≈ 영어 4자
- 1 토큰 ≈ 일본어 2–3자
- Logcat 100줄 ≈ 3 000–5 000 토큰
- PDF 텍스트 1페이지 ≈ 500–800 토큰
API 키 발급 방법
- aistudio.google.com에 접속합니다.
- Google 계정으로 로그인합니다.
- “Get API Key.” 버튼을 클릭합니다.
- 신용카드 입력은 필요하지 않습니다.
관련 링크
- Hiyoko PDF Vault → (by @hiyoyok)