了解支持的型号

对于移动应用和 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 支持的模型。

  • 比较模型：

    • 支持的输入和输出
    • 支持的功能的简要比较
    • 规范和限制，例如输入 token 数上限或输入视频时长上限

  • 模型版本控制方式的说明，特别是其稳定、预览和实验版本

  • 在初始化期间包含在代码中的可用模型名称列表

  • 模型支持的语言列表

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


对比模型

每个模型都具有不同的功能，可支持各种应用场景。请注意，本部分中的每个表格都介绍了每个模型与 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 或纯文本）
（文本输出 | 图片输出）
分析图片
(文本输出 | 图片输出)
分析视频
(文本输出 | 图片输出) 		流式视频
分析音频 流式传输的音频
多轮对话
双向多模态流式传输
支持的工具
函数调用
代码执行
网址上下文
依托 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 个 token 65,536 个词元 8,192 个 token 查看文档
输出 token 限制* 32,768 个词元（非流式）
65,536 个词元（流式）**		 65,536 个 token 32,768 个 token 32,768 个词元 4,096 个 token 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 的功能