Gemini API 速查表 2026 — 免费层限制、模型和端点一站式
发布: (2026年5月3日 GMT+8 22:18)
3 分钟阅读
原文: Dev.to
Source: Dev.to
模型概览
| Model | Context | Best for |
|---|---|---|
| gemini-2.5-flash-preview | 1 M tokens | 通用使用、思考、快速响应 |
| gemini-2.5-pro-preview | 1 M tokens | 复杂推理、最高质量 |
| gemini-1.5-flash | 1 M tokens | 稳定、可投入生产 |
| gemini-1.5-pro | 2 M tokens | 最长上下文 |
| gemini-2.0-flash-lite | 1 M tokens | 最低延迟、最高吞吐量 |
推荐模型
大多数使用场景：gemini-2.5-flash-preview
速率限制
| Model | 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 = 每分钟 token 数，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)
}错误代码
| Code | Meaning | Fix |
|---|---|---|
| 400 | 请求错误 / token 超限 | 缩短提示词 |
| 403 | API key 无效 | 检查密钥 |
| 429 | 达到速率限制 | 等待后重试 |
| 500 | 内部错误 | 重试 |
| 503 | 服务器过载 | 等待 2 秒后重试一次 |
Token 估算
- 1 token ≈ 英文 4 个字符
- 1 token ≈ 日文 2–3 个字符
- 100 行 Logcat ≈ 3 000–5 000 tokens
- 1 页 PDF 文本 ≈ 500–800 tokens
获取 API Key
- 前往 aistudio.google.com。
- 使用 Google 登录。
- 点击 “Get API Key.”
- 不需要信用卡。
相关链接
- Hiyoko PDF Vault → (by @hiyoyok)