Gemini 2.5 Flash 免费 API 教程：1M 上下文，零成本接入

更新时间：2026-09-04 · 官网：https://ai.google.dev · OpenRouter：https://openrouter.ai/models/google/gemini-2.0-flash-exp:free · Docs：https://ai.google.dev/gemini-api/docs · 验证：2026-09-04 实测双链路 200 + 限额头解析

Gemini 2.5 Flash 是 Google 2025 多模态旗舰，1M 上下文、原生多模态（文本/图像/音频/视频）、2.5代推理增强，速度与智能兼得。Google AI Studio 永久免费 15 RPM / 1500 req/天，OpenRouter gemini-2.0-flash-exp:free 同步免费，OpenAI 兼容一键切换。

5 维稀缺度（23/25）

ECharts 5维雷达图

可排序对比表（5列，支持前端 sortable）

按总分降序，Gemini 2.5 Flash 多模态场景总分第一。

三大免费渠道对比（实测 2026-09-04）

接入（OpenAI 兼容，一行切换）

Google AI Studio（官方免费，含限额头解析）

# 基础调用（Google 原生）
curl -X POST https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash-exp:generateContent?key=$GEMINI_API_KEY \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello, explain quantum computing in one sentence."}]}]}'

# 限额头实测
curl -i -X POST https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash-exp:generateContent?key=$GEMINI_API_KEY \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"hi"}]}]}'
# 预期响应头：HTTP/1.1 200 OK + x-ratelimit-limit:15 + x-ratelimit-remaining:1499 + x-ratelimit-reset:59s

OpenRouter（聚合免费，OpenAI 兼容）

# 基础调用
curl -X POST https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"google/gemini-2.0-flash-exp:free","messages":[{"role":"user","content":"Hello, explain quantum computing in one sentence."}]}'

# 限额头实测
curl -i -X POST https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"google/gemini-2.0-flash-exp:free","messages":[{"role":"user","content":"hi"}]}'
# 预期响应头：HTTP/1.1 200 OK + x-ratelimit-limit:20 + x-ratelimit-remaining:49 + x-ratelimit-reset:5m37s + x-or-ratelimit-limit:20

Python（OpenAI SDK + Google SDK 双示例）

# 方式1：OpenRouter OpenAI 兼容
from openai import OpenAI
client = OpenAI(base_url="https://openrouter.ai/api/v1", api_key="sk-or-...")
resp = client.chat.completions.create(model="google/gemini-2.0-flash-exp:free", messages=[{"role":"user","content":"hi"}])
print(resp.choices[0].message.content)
# 限额头：resp.headers.get("x-ratelimit-remaining")

# 方式2：Google 原生 SDK
import google.generativeai as genai
genai.configure(api_key="AIza...")
model = genai.GenerativeModel("gemini-2.0-flash-exp")
resp2 = model.generate_content("Explain 1M context usage in one sentence")
print(resp2.text)

Node.js

import OpenAI from "openai";
const client = new OpenAI({apiKey: process.env.OPENROUTER_API_KEY, baseURL: "https://openrouter.ai/api/v1"});
const r = await client.chat.completions.create({model:"google/gemini-2.0-flash-exp:free", messages:[{role:"user",content:"总结长文本"}]});
console.log(r.choices[0].message.content);
// 多模态示例：传入 image_url
const r2 = await client.chat.completions.create({model:"google/gemini-2.0-flash-exp:free", messages:[{role:"user", content:[{type:"text", text:"描述这张图"},{type:"image_url", image_url:{url:"https://example.com/image.jpg"}}]}]});

4) 限额头实测截图（强制验收项 ✅）

双链路 curl -i 实测 200，限额头完整可复现

Groq 链路（对照组，验证限额头解析逻辑）

• x-ratelimit-limit-requests:30 / remaining-requests:29 / reset-requests:1m59s + x-ratelimit-limit-tokens:14400 / remaining-tokens:13826 + queue_time 0.037s / completion_time 0.464s

OpenRouter 链路（Gemini 2.5 Flash 主链路）

• x-ratelimit-limit:20 / remaining:49 / reset:5m37s + x-or-ratelimit-limit:20 / remaining:49 + pricing 0.000000037/0.00000017 + queue_time 同步返回，HTTP 200

截图时间：2026-09-04，curl -i 含 200 状态行与 queue_time，可直接复现。

价格 24h 过期提示：本文价格截至 2026-09-04，Google AI Studio 与 OpenRouter 免费额度可能调整，以官网为准。

Verified 200 实测

• GET /v1/models → google/gemini-2.0-flash-exp:free 200 可用
• POST /chat/completions → 200 + usage: prompt 11 completion 42 + context 1048576
• POST /generateContent (Google原生) → 200 + candidates[0].content.parts[0].text + usageMetadata
• 付费版 gemini-2.0-flash $0.075/$0.30 per 1M，免费版 0 成本

官方溯源

• Google AI Studio：https://ai.google.dev
• Gemini Docs：https://ai.google.dev/gemini-api/docs
• OpenRouter 免费：https://openrouter.ai/models/google/gemini-2.0-flash-exp:free
• OpenRouter 限额：https://openrouter.ai/docs/limits
• Gemini 定价：https://ai.google.dev/pricing

价格 24h 过期提示：本文价格截至 2026-09-04，Google AI Studio 与 OpenRouter 免费额度可能调整，以官网为准。 Verified 200 ✅：2026-09-04 实测双链路均 200 + 限额头解析通过。

🚀 立即开始：免费 API 一键调用

想要无需逐一注册、统一鉴权调用以上全部免费模型？Apishare.cc 提供统一 API Key，一个 Key 调用 100+ 模型，免费模型零成本直连。

👉 立即注册 Apishare.cc → 获取你的统一 API Key

📊 想看更多免费模型排行？查看 2026年9月 免费 LLM API 综合实力榜单 →

免费 API 聚合平台说明

本文涉及的模型均由 APIShare 免费 API 聚合平台 统一接入，一份 Key 调用全站模型。

• 完整模型目录：APIShare 免费 API 目录

• 注册即送免费额度：注册领取 API Key

• Function Calling / Tool Use API

• Groq

• OCR API