Gemini 系列是什么
Gemini 是 Google 的多模态模型家族，按 Pro 与 Flash 分档：Pro 面向高难度任务，Flash 主打低延迟与低成本，另有更轻的 Lite 档承接高并发。它的原生多模态能力较强，图片、音频、视频可作为输入的一部分；部分版本上下文达到百万 token 量级。接入分两条路：AI Studio 的 Gemini API 适合快速验证，Vertex AI 面向企业级生产。
基本信息
| 厂商 | |
|---|---|
| 档次 | Pro / Flash / Flash-Lite |
| 接入点 | generativelanguage.googleapis.com 或 Vertex AI |
| 鉴权 | x-goog-api-key 请求头，或 Vertex 的 IAM 凭证 |
| 请求结构 | contents / parts 数组，不是 messages |
| 能力 | 文本、图像、音频、视频输入，函数调用与结构化输出 |
请求结构与 OpenAI 的差异
| 维度 | Gemini | OpenAI |
|---|---|---|
| 对话容器 | contents 数组，多轮按 role 交替 | messages 数组 |
| 消息内容 | parts 数组，文本用 text 字段 | content 字符串或块数组 |
| 角色取值 | user / model | user / assistant / system |
| 系统指令 | 独立的 systemInstruction 字段 | system 或 developer 消息 |
| 鉴权 | 请求头 x-goog-api-key 或查询参数 | Authorization: Bearer |
典型使用场景
- 原生多模态理解：直接读图片、音视频，做转写、摘要与标注
- 超长文档处理：把整本手册或整个代码库放进单次请求做问答
- 高并发轻任务：Flash 与 Lite 档承接分类、改写、抽取
- 函数调用：让模型输出结构化调用意图，驱动自有系统
- 企业集成：走 Vertex AI 获得配额、权限与数据合规支持
最小调用（curl）
最小调用（curl）
curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent" -H "x-goog-api-key: $GEMINI_API_KEY" -H "Content-Type: application/json" -d '{"contents":[{"parts":[{"text":"你好"}]}]}' # 最小请求体
# 多轮对话把上一轮模型回答以 role=model 的元素追加进 contents
# systemInstruction 用于放系统级规则，与 contents 分开传
# 不要用 URL 查询参数传 key，容易进代理与访问日志AI Studio 与 Vertex AI 的选择
| 维度 | AI Studio | Vertex AI |
|---|---|---|
| 定位 | 原型与个人开发 | 企业生产环境 |
| 鉴权 | API key | IAM 服务账号 |
| 配额 | 按项目与档位限制 | 可申请企业配额 |
| 数据条款 | 按免费与付费档区分 | 企业级数据处理约定 |
| 迁移成本 | 代码改动不大 | 请求形态有差异，需要适配 |
安全过滤默认开启，部分内容会被拦截并返回被屏蔽的完成原因；业务上要处理这类响应，而不是当成接口故障重试。
把 API key 拼在 URL 里传参很常见但风险高：URL 会进浏览器历史、代理日志与监控系统，应改为请求头传递。