文章摘要 摘要
加载中...|
此内容根据文章生成,并经过人工审核,仅用于文章内容的解释与总结
主要来源:
核验时间:2026-07-06(Asia/Shanghai) 官方页面更新时间:模型总览 2026-06-30 UTC;生命周期与 Locations 页 2026-07-01 UTC。
本文档只收录 Google 模型和 Google 开放模型相关条目,不收录 Partner models、自部署模型、已在生命周期页明确退役的模型作为“当前可用主表”。如果官方“调用示例页”和“生命周期页”冲突,本文以生命周期页判断是否仍适合作为当前可用模型;以调用示例页判断 REST 方法。
准确性约定:
API Model ID 必须来自官方模型页、生命周期页、Locations 页或调用示例页。- 端点位置只写“已确认可用/官方示例使用”的位置;如果模型支持更多区域,以官方 Locations 页和模型详情页为准。
global 端点不保证数据驻留或区域内 ML 处理。需要数据驻留或 jurisdictional boundary 时,必须按 Google Cloud 数据驻留文档和支持的区域/多区域端点单独确认。- Preview、Experimental、短期可用模型没有长期稳定性承诺,不应用作长期生产依赖,除非业务接受迁移成本。
一、调用方法速查
不同模型家族不能套用同一个 REST 方法。原文档中把所有模型都写成 :generateContent 是严重错误。
| 模型/能力 | REST 方法或路径 | 典型位置 | 说明 |
|---|
| Gemini 文本/多模态生成模型 | .../publishers/google/models/{MODEL_ID}:generateContent | global、区域或多区域;以模型详情页为准 | 适用于 Gemini 文本、多模态理解、Gemini 图像生成/编辑等 generateContent 模型 |
| Gemini Live API | 见 Live API 详情页 | 详情页列出美国和欧洲具体区域 | gemini-live-2.5-flash-native-audio 的区域不要按普通 Gemini 文本模型推断 |
| 文本嵌入 | .../publishers/google/models/{MODEL_ID}:predict | 官方示例使用 us-central1 | 例如 gemini-embedding-001、text-embedding-005 |
| 多模态嵌入 | .../publishers/google/models/{MODEL_ID}:predict | 以嵌入文档/Locations 页为准 | 例如 gemini-embedding-2、multimodalembedding@001 |
| Veo 视频生成 | .../publishers/google/models/{MODEL_ID}:predictLongRunning;查询操作用 :fetchPredictOperation | 官方视频生成示例使用 us-central1 | 不是 generateContent |
| Lyria 3 | /v1beta1/projects/{PROJECT}/locations/global/interactions | global | 请求体中传 model: lyria-3-pro-preview 或 lyria-3-clip-preview |
| Lyria 2 | .../publishers/google/models/lyria-002:predict | 使用文档中的 LOCATION | 不是 Lyria 3 的 interactions 路径 |
| Gemma / Model Garden 开放模型 | 通过 Model Garden / MaaS / 自部署流程调用 | 以具体部署方式为准 | Model Garden 标识不等同于通用 publishers/google/models/{MODEL_ID}:generateContent |
二、精选 Gemini 模型(Featured)
| 模型名称 | API Model ID | 已确认端点 | 简介 |
|---|
| Gemini 3.5 Flash | gemini-3.5-flash | 支持 global;其他区域见详情页/Locations | 接近 Pro 的智能水平,Flash 级成本与速度;支持 100 万 token 上下文 |
| Gemini 3.1 Flash-Lite | gemini-3.1-flash-lite | 支持 global;其他区域见详情页/Locations | 面向高吞吐、低延迟、成本敏感流量 |
| Gemini 3.1 Flash Image | gemini-3.1-flash-image | 支持 global;其他区域见详情页/Locations | Nano Banana 2;图像生成、对话式编辑、多图融合与角色一致性 |
三、Gemini 模型
3.1 GA / 当前稳定模型
Live API 详情页列出的支持区域:
- 美国:
us-central1、us-east1、us-east4、us-east5、us-south1、us-west1、us-west4 - 欧洲:
europe-central2、europe-north1、europe-southwest1、europe-west1、europe-west4、europe-west8
3.2 Preview Gemini 模型
| 模型名称 | API Model ID | 已确认端点 | 简介 |
|---|
| Gemini Omni Flash | gemini-omni-flash-preview | 支持 global;其他区域见详情页/Locations | 根据文本或参考资产生成视频,或编辑现有视频 |
| Gemini 3.1 Flash Image Preview | gemini-3.1-flash-image-preview | 支持 global;其他区域见详情页/Locations | 2026-07-17 退役;迁移到 gemini-3.1-flash-image |
| Gemini 3.1 Pro | gemini-3.1-pro-preview | 支持 global;其他区域见详情页/Locations | 推理优先,面向复杂智能体工作流和编码;100 万 token 上下文 |
| Gemini 3 Flash | gemini-3-flash-preview | 支持 global;其他区域见详情页/Locations | 复杂多模态理解、编码和前沿推理 |
| Gemini 3 Pro Image Preview | gemini-3-pro-image-preview | 支持 global;其他区域见详情页/Locations | 推理增强图像生成与复杂多轮编辑 |
四、Gemma 开放模型(Model Garden)
这些是 Model Garden / 开放模型条目。表中的标识是 Model Garden 标识,不应直接等同于 publishers/google/models/{MODEL_ID}:generateContent。
五、嵌入(Embeddings)模型
嵌入模型使用 :predict,不是 :generateContent。
5.1 文本嵌入
| 模型名称 / API Model ID | 状态 | 输出维度 | 最大序列长度 | 语言 | 预计退役 |
|---|
gemini-embedding-001 | 当前文本嵌入主模型 | 最高 3072 | 2048 tokens | 支持的文本语言 | 不早于 2028-05-20 |
text-embedding-005 | 旧版;英文和代码任务 | 最高 768 | 2048 tokens | English | 2027-04-01 |
text-multilingual-embedding-002 | 旧版;多语言任务 | 最高 768 | 2048 tokens | 支持的文本语言 | 2027-04-01 |
text-embedding-004 | 生命周期页仍列出;当前文本嵌入指南未列入推荐模型表 | 未在当前调用页确认 | 未在当前调用页确认 | 未在当前调用页确认 | 2027-04-01 |
5.2 多模态嵌入
| 模型名称 / API Model ID | 状态 | 默认维度 | 可选维度范围 | 推荐低维度 | 预计退役 |
|---|
gemini-embedding-2 | 当前多模态嵌入模型 | 3072 | 128-3072 | 128、768、1536 | 未公布 |
multimodalembedding@001 | 多模态嵌入旧模型 | 1408 | 128-1408 | 128、256、512 | 2027-04-01 |
多模态嵌入可处理图像、文本、视频数据组合。纯文本检索、聚类、长文档分析等场景优先使用文本嵌入 API。
六、Veo 视频生成模型
Veo 使用长运行预测接口:生成请求为 :predictLongRunning,查询操作为 :fetchPredictOperation。官方视频生成调用示例使用 us-central1。
6.1 当前 GA Veo 模型
| 模型名称 | API Model ID | 官方示例位置 | 预计退役 | 简介 |
|---|
| Veo 3.1 Generate | veo-3.1-generate-001 | us-central1 | 未公布 | 文本/图像到高质量视频 |
| Veo 3.1 Fast | veo-3.1-fast-generate-001 | us-central1 | 未公布 | 高质量、低延迟视频生成 |
6.2 Preview / Experimental Veo 模型
以下 ID 仍出现在官方视频生成调用页;Preview/Experimental 可用性和行为可能变化。
| 模型名称 | API Model ID | 状态 | 官方示例位置 |
|---|
| Veo 3.1 Lite Generate | veo-3.1-lite-generate-001 | Preview | us-central1 |
| Veo 3.1 Generate Preview | veo-3.1-generate-preview | Preview | us-central1 |
| Veo 3.1 Fast Generate Preview | veo-3.1-fast-generate-preview | Preview | us-central1 |
| Veo 3 Generate Preview | veo-3.0-generate-preview | Preview | us-central1 |
| Veo 3 Fast Generate Preview | veo-3.0-fast-generate-preview | Preview | us-central1 |
| Veo 2 Generate Preview | veo-2.0-generate-preview | Preview | us-central1 |
| Veo 2 Generate Experimental | veo-2.0-generate-exp | Experimental | us-central1 |
6.3 不应作为当前可用主表的 Veo ID
生命周期页显示以下 GA Veo ID 已于 2026-06-30 退役;即使其他页面仍可能列出端点覆盖或历史调用信息,也不应作为当前可用模型推荐。
| API Model ID | 生命周期页退役日期 |
|---|
veo-3.0-generate-001 | 2026-06-30 |
veo-3.0-fast-generate-001 | 2026-06-30 |
veo-2.0-generate-001 | 2026-06-30 |
七、Lyria 音乐生成模型
| 模型名称 | API Model ID | 调用方式 | 位置 | 简介 |
|---|
| Lyria 3 Pro | lyria-3-pro-preview | /v1beta1/projects/{PROJECT}/locations/global/interactions | global | 根据文本和图片提示生成完整长度音乐曲目(Preview) |
| Lyria 3 Clip | lyria-3-clip-preview | /v1beta1/projects/{PROJECT}/locations/global/interactions | global | 根据文本和图片提示生成 30 秒音频片段(Preview) |
| Lyria 2 | lyria-002 | .../publishers/google/models/lyria-002:predict | 使用 API 文档中的 LOCATION | 根据文本提示生成音乐(GA) |
八、Speech-to-Text / Text-to-Speech 模型
Locations 页把以下语音模型列在 Google 模型端点覆盖范围内。它们不属于 Gemini 文本生成主表,调用方式需参考对应 Speech 文档。
| 能力 | 官方列出的标识 | 说明 |
|---|
| Chirp 3: Transcription | chirp_3 | 语音转文本 |
| Chirp 3: HD Voices | 未在 Locations 摘要中显示具体 ID | 文本转语音高质量声音 |
| Chirp 3: Instant Custom Voice | 未在 Locations 摘要中显示具体 ID | 即时自定义声音 |
| Chirp 2: Transcription | chirp_2 | 语音转文本 |
| Gemini 2.5 Pro TTS | gemini-2.5-pro-tts | 文本转语音 |
| Gemini 2.5 Flash TTS | gemini-2.5-flash-tts | 文本转语音 |
九、端点位置与 URL 模板
9.1 generateContent 模型
| 端点类型 | 位置标识 | URL 模板 | 注意事项 |
|---|
| Global | global | https://aiplatform.googleapis.com/v1/projects/{PROJECT}/locations/global/publishers/google/models/{MODEL_ID}:generateContent | 可提高可用性和降低 429 风险;不适合有 ML processing 区域控制要求的场景 |
| 区域 | us-central1 等 | https://{REGION}-aiplatform.googleapis.com/v1/projects/{PROJECT}/locations/{REGION}/publishers/google/models/{MODEL_ID}:generateContent | 是否支持取决于具体模型 |
| 多区域 | us、eu | https://aiplatform.{LOCATION}.rep.googleapis.com/v1/projects/{PROJECT}/locations/{LOCATION}/publishers/google/models/{MODEL_ID}:generateContent | 用于美国或欧盟 jurisdictional boundary;只支持部分模型 |
9.2 非 generateContent 模型
| 能力 | URL / 方法模板 |
|---|
| 文本/多模态嵌入 | https://{LOCATION}-aiplatform.googleapis.com/v1/projects/{PROJECT}/locations/{LOCATION}/publishers/google/models/{MODEL_ID}:predict |
| Veo 生成视频 | https://us-central1-aiplatform.googleapis.com/v1/projects/{PROJECT}/locations/us-central1/publishers/google/models/{MODEL_ID}:predictLongRunning |
| Veo 查询操作 | https://us-central1-aiplatform.googleapis.com/v1/projects/{PROJECT}/locations/us-central1/publishers/google/models/{MODEL_ID}:fetchPredictOperation |
| Lyria 3 | https://aiplatform.googleapis.com/v1beta1/projects/{PROJECT}/locations/global/interactions |
| Lyria 2 | https://{LOCATION}-aiplatform.googleapis.com/v1/projects/{PROJECT}/locations/{LOCATION}/publishers/google/models/lyria-002:predict |
十、语言支持概览
- Gemini:官方总览称所有 Gemini 模型可理解并响应 100+ 种语言;具体语言覆盖以各模型详情页为准。
- Gemma:官方总览称 Gemma 和 Gemma 2 仅支持英语;Gemma 3 和 Gemma 3n 支持 140+ 语言。Gemma 4 的语言覆盖以 Model Garden 模型卡为准。
- 文本嵌入:
gemini-embedding-001 和 text-multilingual-embedding-002 支持多语言文本;text-embedding-005 面向英语和代码任务。
十一、维护备注
- 模型是否仍可用:优先检查“模型版本和生命周期”页。
- 模型在哪些位置可用:检查 Locations 页和模型详情页;不要仅凭
global 支持推断区域支持。 - 模型怎么调用:检查对应能力的调用指南。Gemini、Embeddings、Veo、Lyria 的 REST 方法不同。
- 退役模型不要放入当前可用主表;如需记录迁移,请放到“已退役/迁移”小节并标明退役日期。