了解支持的型号

对于移动应用和 Web 应用，Firebase AI Logic SDK 可让您直接从应用中与受支持的 Gemini 模型进行交互。

Gemini 模型被视为多模态模型，因为它们能够处理甚至生成多种模态，包括文本、代码、PDF、图片、视频和音频。

此外，请查看我们的常见问题解答，了解 Firebase AI Logic 支持和不支持的所有模型。

旗舰前沿

gemini-4-argon

高级推理和丰富的多模态理解能力，可处理复杂的应用场景和智能应用内工作流。 （需要结算）


快速、智能

gemini-3.8-flash

以极低的成本提供媲美大型模型的前沿性能。 （不需要结算）

超快

gemini-3.5-flash-lite

大体量、成本敏感型主力模型，具有 Gemini 3 系列的性能和质量。 （不需要结算）

图片生成

gemini-3.1-flash-image

一款功能强大、高效的图片生成和编辑模型，专为速度和高容量应用场景而优化。 （需要结算）

通用模型

前往包含模型详情的表格

gemini-4-argon

高级推理和丰富的多模态理解能力，可处理复杂的应用场景和智能应用内工作流。 （需要结算）

gemini-3.8-flash

以极低的成本提供媲美大型模型的前沿性能。 （不需要结算）

gemini-3.5-flash-lite

大体量、成本敏感型主力模型，具有 Gemini 3 系列的性能和质量。 （不需要结算）

图片生成模型

前往包含模型详情的表格

gemini-3-pro-image

先进的图片生成和编辑模型，可用于创建高度符合上下文的原生图片。 （需要结算）

gemini-3.1-flash-image

功能强大、高效的图片生成和编辑模型，针对速度和高容量用例进行了优化。 （需要结算）

gemini-3.1-flash-lite-image

超低延迟且经济实惠的图片生成和编辑模型，专为高用量交互式应用场景而设计。 （需要结算）

音频生成模型

文字转语音 (TTS) 模型

您可以使用 Gemini TTS 模型根据文本输入生成语音。

前往包含模型详情的表格

gemini-3.1-flash-tts-preview

根据文本输入生成语音，功能强大且延迟时间短。 （不需要结算）

Live API 个模型

您可以使用支持 Gemini Live API 的模型生成双向流式音频。

前往包含模型详情的表格

Gemini Developer API：
gemini-3.1-flash-live-preview

Agent Platform Gemini API：
不受支持

支持与 Gemini 模型进行低延迟、实时的双向语音和视频交互。（不需要结算）

Gemini Developer API：
gemini-2.5-flash-native-audio-preview-12-2025

Agent Platform Gemini API：
gemini-live-2.5-flash-native-audio

支持与 Gemini 模型进行低延迟、实时的双向语音和视频交互。（不需要结算）


本页面的其余部分详细介绍了 Firebase AI Logic 支持的模型。

在本页面底部，您可以查看有关上一代模型的详细信息。


对比模型

每个模型都具有不同的功能，可支持各种应用场景。请注意，本部分中的每个表格都介绍了每个模型与 Firebase AI Logic 搭配使用时的情况。每个模型可能都具有使用我们的 SDK 时无法使用的其他功能。

如果您在以下子部分中找不到所需信息，可以在所选 API 提供商文档中找到更多信息：Gemini Developer API 或 Agent Platform Gemini API (formerly Vertex AI)。

支持的输入和输出

下表列出了将每个模型与 Firebase AI Logic 搭配使用时支持的输入和输出类型。

如需了解支持的文件类型，请参阅支持的输入文件和要求。

Gemini 4
Argon 		Gemini 3.x
Flash, Flash‑Lite 		Gemini 3.x
Pro
Image 		Gemini 3.x
Flash
Image 		Gemini 3.x
Flash‑Lite
Image 		Gemini 3.x
Flash
TTS 		Gemini
Live
输入类型
文字
代码
文档
（PDF 或纯文本）
图片
视频
音频
输出类型
文字
文本（流式传输）
代码
结构化输出
（例如 JSON）
图片
视频
音频

支持的功能和特性

下表列出了将每个模型与 Firebase AI Logic 搭配使用时支持的功能和特性。

Gemini 4
Argon 		Gemini 3.x
Flash, Flash‑Lite 		Gemini 3.x
Pro
Image 		Gemini 3.x
Flash
Image 		Gemini 3.x
Flash‑Lite
Image 		Gemini 3.x
Flash
TTS 		Gemini
Live
思考型
根据纯文本或多模态输入生成文本 交错或作为图片的一部分 交错或作为图片的一部分 交错或作为图片的一部分 音频转写
生成图片
修改图片
生成音频 speech 流式传输的音频
生成结构化输出
（例如 JSON）
分析文档
（PDF 或纯文本）
（文本输出 | 图片输出）
分析图片
（文本输出 | 图片输出）
分析视频
(text-output | image-output) 		流式视频
分析音频 流式传输的音频
多轮对话
双向多模态流式传输
支持的工具
函数调用
代码执行
网址上下文
依托 Google Search 进行接地
依托 Google Maps 进行接地

规范和限制

下表列出了将每个模型与 Firebase AI Logic 搭配使用时的规范和限制。

属性 Gemini 4
Argon 		Gemini 3.x
Flash, Flash‑Lite 		Gemini 3.x
Pro
Image 		Gemini 3.x
Flash
Image 		Gemini 3.x
Flash‑Lite
Image 		Gemini 3.x
Flash
TTS 		Gemini
Live
输入 token 限制 * 1,048,576 个 token 1,048,576 个 token 65,536 个 token 131,072 个词元 65,536 个 token 8,192 个 token 查看文档
输出 token 限制 * 32,768 个词元（非流式）
65,536 个词元（流式）**		 65,536 个 token 32,768 个词元 32,768 个词元 4,096 个词元 16,384 个 token
PDF（每个请求）
输入 PDF 文件数量上限
***		 900 个文件 900 个文件 14 个文件 14 个文件 14 个文件 --- 查看文档
每个输入 PDF 文件的
页数
上限***		 900 页 900 页 14 页 14 页 14 页 ---
每个输入 PDF 文件的最大大小为
50 MB 50 MB 50 MB 50 MB 50 MB ---
Google 图片（每个请求）
输入图片数量
上限		 1000 张图片 1000 张图片 14 张图片 14 张图片 14 张图片 --- 查看文档
每个输入的 base64 编码图片的大小上限
 7 MB 7 MB 7 MB 7 MB 7 MB ---
输出图片
数量上限		 --- --- 最高为输出 token 限制 最高为输出 token 限制 最高为输出 token 限制 ---
视频（按请求）
输入视频文件
数量上限		 10 个文件 10 个文件 --- 最高为输入 token 限制 最高为输入 token 限制 --- 查看文档
所有输入视频
的最大长度
（仅限帧数）		 约 60 分钟 约 60 分钟 --- 约 25 分钟 约 12 分钟 ---
所有输入视频
（画面 + 音频）
的时长上限		 约 45 分钟 约 45 分钟 --- --- --- ---
音频（按请求）
输入音频文件
数量上限		 1 个文件 1 个文件 --- --- --- --- 查看文档
所有输入音频的
时长上限		 约 8.4 小时 约 8.4 小时 --- --- --- ---

* 对于所有 Gemini 模型，一个 token 相当于大约 4 个字符，因此 100 个 token 大约相当于 60-80 个英文单词。对于 Gemini 模型，您可以使用 countTokens 确定请求中的词元总数。

** 对于 gemini-4-argon，Firebase AI Logic 尚不支持长解码，但该功能敬请期待！

*** PDF 文件被视为图片，因此 PDF 文件的单页被视为一张图片。请求中允许的页数取决于模型可以支持的图片数量。

查找更多详细信息


模型版本控制和命名模式

模型有稳定、预览和实验版本。为方便起见，系统支持 -latest 别名，但由于它们指向的模型版本不一致，因此不建议使用。

请务必查看使用模型版本的最佳实践。

如需查找要在代码中使用的特定模型名称，请参阅本页面后面的“可用模型名称”部分。

版本类型 /
发布阶段		 说明 模型名称格式
稳定 稳定版本自发布日期起即可用于生产环境并受支持。
  • 稳定版模型通常会随附弃用日期，该日期表示该模型可用的最后一天。在此日期之后，Google 将不再提供该模型，也不再为其提供支持。
  • 大多数稳定版模型在发布日期后的 12 个月内可用（即使发布了替换模型）。
  • 对于 Agent Platform Gemini API (formerly Vertex AI)，某些稳定版模型仅具有短期可用性，这意味着它们可能会在替换模型发布后 45 天内关停（停用）。

稳定版本的模型名称没有后缀

示例：
gemini-4-argon
gemini-3.8-flash

预览 预览版本具有新功能，被视为不稳定。
  • 不建议将这些模型用于生产环境，它们具有更严格的速率限制，并且可能有结算要求。
  • 这些模型会在其关联的稳定版本发布后的几周或几个月内关停（停用）。
  • 对于 Agent Platform Gemini API (formerly Vertex AI)，预览版模型仅在 global 位置提供。

预览版模型的名称会附加 -preview

示例：
gemini-3-pro-preview

实验性 实验性版本具有新功能，被视为不稳定。
  • 不建议将这些模型用于生产环境，并且这些模型具有更严格的速率限制。实验性模型旨在收集反馈，并让用户能够试用我们的最新功能。
  • 这些模型会在其关联的稳定版本发布后的几周或几个月内关停（停用）。
  • 对于 Agent Platform Gemini API (formerly Vertex AI)，实验性模型仅在 global 位置提供。

实验性版本的模型名称会附加 -exp 以及模型的发布日期 (-MM-DD)

示例：
gemini-2.5-pro-exp-03-25
（发布日期：2025 年 3 月 25 日）

关闭（已停用） 关停（弃用）版本已过关停（弃用）日期，并已永久停用。
  • Google 不再提供或支持已关停（已停用）的模型，使用已停用模型名称的请求会返回 404 错误。

---

使用模型版本的最佳实践

  • 在正式版应用中，请使用最新稳定版本的显式模型名称。

    对于 Agent Platform Gemini API (formerly Vertex AI)，如果您选择在正式版应用中使用短期可用性模型，则更需要使用 Firebase Remote Config 或服务器提示模板来控制 AI 功能所使用的模型名称。

  • 仅在原型设计期间使用预览版和实验性版本。我们建议您在开始针对生产用例进行开发和测试时使用稳定版。

  • 我们不建议使用 -latest 别名（即使在开发期间也是如此）。此别名指向特定模型变体的最新版本（可能是稳定版、预览版或实验版）。每次发布特定模型变体的新版本时，此别名都会热交换，并且只有在发生破坏性更改时，系统才会提前 2 周发送电子邮件通知。这种不确定性可能会导致 AI 功能出现意外的行为变化。


可用模型名称

模型名称是您在初始化模型期间在代码中添加的显式值。

如需查看适用于您平台的初始化示例，请参阅入门指南。

如需详细了解发布阶段（尤其是应用场景、结算和关停），请参阅模型版本控制和命名模式。

以程序化方式列出所有可用模型

您可以使用 REST API 列出所有可用的模型名称：

请注意，此返回列表将包含 API 提供商支持的所有模型，但 Firebase AI Logic 仅支持本页面上介绍的 Gemini 模型。

通用模型

Gemini 4 Argon 个模型名称

无论您使用哪家 Gemini API 提供商，都需要采用随用随付 Blaze 定价方案。

模型名称 说明 发布阶段 发布日期 停用日期
gemini-4-argon 最新的稳定版 Gemini 4 Argon 稳定 2026-10-13 待定

Gemini 3.x Flash 个模型名称

如果您 使用的是 Gemini Developer API，则不需要采用随用随付 Blaze 定价方案。

模型名称 说明 发布阶段 发布日期 停用日期
gemini-3.8-flash Gemini 3.x Flash
的最新稳定版本 这是一个短期可用模型（请参阅模型版本控制和命名模式）。 		稳定 2026-09-02 待定
gemini-3.7-flash Gemini 3.x Flash
的稳定版本 这是一个短期可用模型（请参阅模型版本控制和命名模式）。 		稳定 2026-08-13 待定
gemini-3.6-flash Gemini 3.x Flash
的稳定版本 这是一个短期可用模型（请参阅模型版本控制和命名模式）。 		稳定 2026-07-21 待定
gemini-3.5-flash Gemini 3.x Flash 的稳定版本 稳定 2026-05-19 不早于
2027-05-19
gemini-3-flash-preview “Gemini 3.x Flash”预览版 预览 2025-12-17 待定

Gemini 3.x Flash‑Lite 个模型名称

如果您 使用的是 Gemini Developer API，则不需要采用随用随付 Blaze 定价方案。

模型名称 说明 发布阶段 发布日期 停用日期
gemini-3.5-flash-lite 最新的稳定版 Gemini 3.x Flash‑Lite 稳定 2026-07-21 不早于
2027-07-21
gemini-3.1-flash-lite Gemini 3.x Flash‑Lite 的稳定版本 稳定 2026-05-07 不早于
2027 年 5 月 7 日

图片生成模型

Gemini 3.x Pro Image 模型名称（又称“Nano Banana Pro”）

无论您使用哪家 Gemini API 提供商，都需要采用随用随付 Blaze 定价方案。

模型名称 说明 发布阶段 发布日期 停用日期
gemini-3-pro-image Gemini 3.x Pro Image
（又称“Nano Banana Pro”）的稳定版本		 稳定 2026-05-28 不早于
2027-05-28
gemini-3-pro-image-preview Gemini 3.x Pro Image
（又称“Nano Banana Pro”）预览版		 预览 2025-11-20 最早
2026 年 6 月 25 日

Gemini 3.x Flash Image 模型名称（又称“Nano Banana 2”）

无论您使用哪家 Gemini API 提供商，都需要采用随用随付 Blaze 定价方案。

模型名称 说明 发布阶段 发布日期 停用日期
gemini-3.1-flash-image Gemini 3.x Flash Image
（又称“Nano Banana 2”）的稳定版		 稳定 2026-05-28 不早于
2027-05-28
gemini-3.1-flash-image-preview Gemini 3.x Flash Image
（又称“Nano Banana 2”）预览版		 预览 2026-02-26 最早
2026 年 6 月 25 日

Gemini 3.x Flash‑Lite Image 模型名称（又称“Nano Banana 2 Lite”）

无论您使用哪家 Gemini API 提供商，都需要采用随用随付 Blaze 定价方案。

模型名称 说明 发布阶段 发布日期 停用日期
gemini-3.1-flash-lite-image Gemini 3.x Flash‑Lite Image
（又称“Nano Banana 2 Lite”）
的稳定版本。这是一个短期可用模型（请参阅模型版本控制和命名模式）。 		稳定 2026-06-30 待定

音频 - 文字转语音 (TTS) 模型

Gemini 3.x Flash TTS 个模型名称

如果您 使用的是 Gemini Developer API，则不需要采用随用随付 Blaze 定价方案。

模型名称 说明 发布阶段 发布日期 停用日期
gemini-3.1-flash-tts-preview “Gemini 3.x Flash TTS”预览版 预览 2026-06-17 待定

音频 - Live API 个模型

Gemini 3.x Flash Live 个模型名称

Gemini Developer API
模型名称		 说明 发布阶段 发布日期 停用日期
gemini-3.1-flash-live-preview 1 Gemini Developer API上Live API的预览版 预览 2026-03-26 待定
Agent Platform Gemini API (formerly Vertex AI)
模型名称		 说明 发布阶段 发布日期 停用日期
Agent Platform Gemini API (formerly Vertex AI) 不支持任何 Gemini Live 3.x 模型。

1 仅受 Gemini Developer API 支持。 此外，虽然这是一个预览版模型，但它在 Gemini Developer API 的“免费层级”中提供。

Gemini 2.5 Flash Live 个模型名称

如果您使用的是 Gemini Developer API，则不需要随用随付 Blaze 定价方案（通常预览版模型需要付费方案）。

尽管以下模型根据 Gemini API 提供商而具有不同的模型名称，但模型的功能是相同的。

Gemini Developer API
模型名称		 说明 发布阶段 发布日期 停用日期
gemini-2.5-flash-native-audio-preview-12-2025 1 Gemini Developer API上Live API的预览版 预览 2025-12-12 待定
gemini-2.5-flash-native-audio-preview-09-2025 1 Gemini Developer API上 Live API 的初始预览版 预览 2025-09-18 待定
Agent Platform Gemini API (formerly Vertex AI)
模型名称		 说明 发布阶段 发布日期 停用日期
gemini-live-2.5-flash-native-audio 2 Agent Platform Gemini API (formerly Vertex AI)上 Live API 的稳定版 稳定 2025-12-12 不早于
2026 年 12 月 12 日
gemini-live-2.5-flash-preview-native-audio-09-2025 2 Agent Platform Gemini API (formerly Vertex AI)上Live API的预览版 预览 2025-09-18 待定

1 仅受 Gemini Developer API 支持。 此外，虽然这些是预览版模型，但它们可在 Gemini Developer API 的“免费层级”中使用。
2 仅受 Agent Platform Gemini API (formerly Vertex AI) 支持。 此外，这些模型在 global 位置不可用。


支持的语言

通用模型

所有 Gemini 通用模型（例如 Gemini 4 Argon、Gemini 3.8 Flash、Gemini 3.5 Flash-Lite 和更早的 3.x 模型）都可以理解并以 100 多种语言提供回答：

南非荷兰语 (af)、阿尔巴尼亚语 (sq)、阿姆哈拉语 (am)、阿拉伯语 (ar)、亚美尼亚语 (hy)、阿萨姆语 (as)、阿塞拜疆语 (az)、巴斯克语 (eu)、白俄罗斯语 (be)、孟加拉语 (bn)、波斯尼亚语 (bs)、保加利亚语 (bg)、加泰罗尼亚语 (ca)、宿务语 (ceb)、中文（简体和繁体）(zh)、科西嘉语 (co)、克罗地亚语 (hr)、捷克语 (cs)、丹麦语 (da)、迪维希语 (dv)、荷兰语 (nl)、英语 (en)、世界语 (eo)、爱沙尼亚语 (et)、菲律宾语（他加禄语）(fil)、芬兰语 (fi)、法语 (fr)、弗里西亚语 (fy)、加利西亚语 (gl)、格鲁吉亚语 (ka)、德语 (de)、希腊语 (el)、古吉拉特语 (gu)、海地克里奥尔语 (ht)、豪萨语 (ha)、夏威夷语 (haw)、希伯来语 (iw)、印地语 (hi)、苗语 (hmn)、匈牙利语 (hu)、冰岛语 (is)、伊博语 (ig)、印度尼西亚语 (id)、爱尔兰语 (ga)、意大利语 (it)、日语 (ja)、爪哇语 (jv)、卡纳达语 (kn)、哈萨克语 (kk)、高棉语 (km)、韩语 (ko)、克里奥尔语 (kri)、库尔德语 (ku)、吉尔吉斯语 (ky)、老挝语 (lo)、拉丁语 (la)、拉脱维亚语 (lv)、立陶宛语 (lt)、卢森堡语 (lb)、马其顿语 (mk)、马达加斯加语 (mg)、马来语 (ms)、马拉雅拉姆语 (ml)、马耳他语 (mt)、毛利语 (mi)、马拉地语 (mr)、曼尼普尔语 (mni-Mtei)、蒙古语 (mn)、缅甸语 (my)、尼泊尔语 (ne)、挪威语 (no)、尼扬贾语（齐切瓦语）(ny)、奥里亚语 (or)、普什图语 (ps)、波斯语 (fa)、波兰语 (pl)、葡萄牙语 (pt)、旁遮普语 (pa)、罗马尼亚语 (ro)、俄语 (ru)、萨摩亚语 (sm)、苏格兰盖尔语 (gd)、塞尔维亚语 (sr)、塞索托语 (st)、修纳语 (sn)、信德语 (sd)、僧伽罗语 (si)、斯洛伐克语 (sk)、斯洛文尼亚语 (sl)、索马里语 (so)、西班牙语 (es)、巽他语 (su)、斯瓦希里语 (sw)、瑞典语 (sv)、塔吉克语 (tg)、泰米尔语 (ta)、泰卢固语 (te)、泰语 (1)、土耳其语 (tr)、乌克兰语 (uk)、乌尔都语 (ur)、维吾尔语 (ug)、乌兹别克语 (uz)、越南语 (vi)、威尔士语 (cy)、科萨语 (xh)、意第绪语 (yi)、约鲁巴语 (yo) 和祖鲁语 (zu)。th

图片生成模型

Gemini 3.x Image 模型可以接受多种语言的文本提示。不过，它们已针对以下语言和语言区域进行了优化，以实现最佳性能（包括文本提示和在生成的图片中呈现文本）：

阿拉伯语 (ar-EG)、德语 (de-DE)、英语 (EN)、西班牙语 (es-MX)、法语 (fr-FR)、印地语 (hi-IN)、印度尼西亚语 (id-ID)、意大利语 (it-IT)、日语 (ja-JP)、韩语 (ko-KR)、葡萄牙语 (pt-BR)、俄语 (ru-RU)、乌克兰语 (uk-UA)、越南语 (vi-VN) 和简体中文 (zh-CN)。

如需详细了解提示词最佳实践和在图片生成器中生成文本，请参阅图片生成支持的语言。

音频生成模型（TTS 和 Live API）

音频生成模型支持针对语音合成和（对于 Live API）实时双向对话进行优化的专用语言集：

  • 文字转语音 (TTS) 模型：Gemini 3.x TTS 模型可以自动检测和生成近 80 种语言和方言的语音。

    如需查看支持的语言和可用 BCP-47 语言区域代码的完整列表，请参阅语音生成支持的语言。

  • Live API 模型：Live API 模型支持近 80 种语言和方言的实时双向语音互动。

    如需查看支持的语言的完整列表并了解如何影响语音回答语言，请参阅Live API 支持的语言。


有关旧款模型的信息

以下是有效但属于上一代的模型。我们强烈建议您尽可能迁移应用以使用较新的模型。 如需详细了解这些旧模型的弃用和关停（以及推荐的替换模型），请参阅此常见问题解答。

如果您在以下子部分中找不到所需信息，可以在所选 API 提供商文档中找到更多信息： Gemini Developer API 或 Agent Platform Gemini API (formerly Vertex AI)

较旧的 Gemini 型号

  • gemini-3.1-pro-preview
  • gemini-2.5-pro
  • gemini-2.5-flash
  • gemini-2.5-flash-lite
  • gemini-2.5-flash-image（也称为“Nano Banana”）
  • gemini-2.0-flash-001（及其自动更新的别名 gemini-2.0-flash）
  • gemini-2.0-flash-lite-001（及其自动更新的别名 gemini-2.0-flash-lite）

如需了解旧版 Gemini Live API 模型，请参阅 Gemini API 提供商文档：

较旧的 Imagen 型号

  • imagen-4.0-ultra-generate-001
  • imagen-4.0-generate-001
  • imagen-4.0-fast-generate-001
  • imagen-3.0-capability-001
  • imagen-3.0-generate-002
  • imagen-3.0-generate-001
  • imagen-3.0-fast-generate-001

查看关于旧款型号的详细信息


后续步骤

试用 Gemini API 的功能