# Gemini 2.5 Flash Image API 已停用：免费额度、价格与替代方案

> Gemini 2.5 Flash Image 的关停已推迟到 2027 年 3 月 15 日，Gemini API 的图像模型也没有免费额度。新项目建议直接用 Nano Banana 2.1（gemini-nano-banana-2.1），1K 每张 0.0336 美元；本文保留原教程供参考。

- Source: https://www.aifreeapi.com/zh/posts/gemini-25-flash-image-api-unlimited
- Language: zh
- Published: 2025-10-11
- Updated: 2026-10-08
- Publisher: AI Free API (https://www.aifreeapi.com)

> **2026 年 10 月 8 日更新：** Google 已于 2026 年 10 月 6 日正式发布 Nano Banana 2.1（`gemini-nano-banana-2.1`），同时把 Gemini API 里的 `gemini-3.1-flash-image`（Nano Banana 2）标为弃用，建议迁移到 2.1；目前没有公布关停日期（当天曾宣布 10 月 29 日关停，10 月 7 日已撤回）。下文 Nano Banana 2 的模型 ID、价格和代码目前仍可用，新项目建议直接用 2.1；两者差别与迁移要点见 [Nano Banana 2.1 发布：怎么用、API 价格与旧模型迁移](/zh/posts/nano-banana-2-1)。 另外，Google 已把 `gemini-2.5-flash-image` 的关停日期从原定的 2026 年 10 月 2 日推迟到 2027 年 3 月 15 日，替代模型改列为 `gemini-3.1-flash-lite-image`（Nano Banana 2 Lite）；文中“10 月 2 日停用”的说法已不适用。

> **2026 年 10 月 5 日更新：** Google 官方下线表显示，`gemini-2.5-flash-image` 已于 2026 年 10 月 2 日停用；`gemini-2.5-flash-image-preview` 已于 2026 年 1 月 15 日停用。下文调用它的代码已无法运行，官方替代是 `gemini-3.1-flash-image`（Nano Banana 2），价格为每张 0.5K 图 0.045 美元、1K 图 0.067 美元；文中针对已停用模型的价格不再适用。

Gemini 2.5 Flash Image 是 Google 2025年推出的先进图像生成模型，每天免费 500 次请求，价格仅 $0.039/图，比 DALL-E 3 便宜 40%。支持角色一致性、多图融合等独特功能，3-4秒快速生成。本文提供零基础上手教程、免费额度场景分析、中文用户完整解决方案，助您 10 分钟开始使用。

## Gemini 2.5 Flash Image 简介

Gemini 2.5 Flash Image（代号 "nano banana"）是 Google DeepMind 于 2025年正式发布的最先进图像生成和编辑模型。作为 Gemini 家族的最新成员，它专注于提供**低延迟、高质量、多功能**的图像生成能力。

**核心优势**：

1. **价格优势**：每张图片仅需 $0.039，比 DALL-E 3 标准质量（$0.04-0.12）便宜 40-67%。对于月生成 10000 张图片的场景，Gemini 成本为 $390，而 DALL-E 3 需要 $400-1200。

2. **速度优势**：平均 3-4 秒完成生成，而 DALL-E 3 通过 ChatGPT 接口通常需要 60 秒以上。对于需要快速迭代的场景（如实时设计反馈、大批量处理），Gemini 的速度优势显著。

3. **免费额度慷慨**：通过 Google AI Studio，每天提供 500 次免费请求，每分钟限制 250,000 tokens（约 2 次生成/分钟）。对于个人用户、小团队、原型开发，完全免费即可满足需求。

4. **独特功能**：
   - **角色一致性**：在不同场景中保持同一角色的外观特征，非常适合品牌资产生成、连续故事创作。
   - **多图融合**：将多张图片（最多 3 张）无缝融合，创造新的视觉效果。
   - **对话式编辑**：通过自然语言精确编辑图片局部（如模糊背景、去除污渍、更改姿势）。

5. **企业级可用**：自 2025年10月2日起，Gemini 2.5 Flash Image 已正式 GA（General Availability），支持 10 种不同宽高比，可用于生产环境。所有生成图片自动嵌入 SynthID 隐形水印，便于识别 AI 生成内容。

**技术规格**：
- 模型 ID：`gemini-2.5-flash-image`
- 分辨率：最高 1024x1024 像素
- 支持比例：10 种（1:1, 16:9, 9:16, 4:3, 3:4 等）
- 输入：文本 prompt（英文）、参考图片（可选）
- 输出：1,290 tokens/图（约 $0.039）

**访问渠道**：

你可以通过 [Google AI Studio](https://aistudio.google.com) 进行免费测试，或使用 Gemini API 进行开发者集成。企业用户可以选择 Vertex AI 进行企业级部署。此外，OpenRouter.ai、fal.ai、CometAPI 等第三方平台也提供了访问接口。

**重要限制**：当前不支持中文输入，中文 prompt 会返回文本响应而非图片。对于中文用户，需要使用英文 prompt 或通过翻译工具（详见本文"中文用户专属"章节）。

---

## 零基础上手：10 分钟生成第一张图

如果你从未用过 AI 图像生成，或者不想写代码，这个教程专为你设计。**无需信用卡**，**零编程经验**，只需 Google 账号。

### 完整步骤（图文演示）

**第 1 步：访问 Google AI Studio**

打开浏览器，访问 [https://aistudio.google.com](https://aistudio.google.com)。使用你的 Google 账号登录（Gmail 账号即可）。

**第 2 步：接受服务条款**

首次使用需要同意 Google AI Studio 的服务条款。阅读后点击"Accept"或"同意"。

**第 3 步：选择 Gemini 2.5 Flash Image 模型**

在左侧导航栏或顶部下拉菜单中，找到模型选择器。点击选择 **"Gemini 2.5 Flash Image"** 或 **"gemini-2.5-flash-image-preview"**（Preview 版本将于 2025-10-31 退役，建议使用正式版）。

**第 4 步：输入英文 Prompt**

在主界面的文本框中，输入你的 prompt。**必须使用英文**。

示例 prompt（复制可用）：
```
A cute orange tabby cat with big green eyes, sitting on a wooden table, soft natural lighting, professional pet photography, high detail
```

中文解释：一只可爱的橘色虎斑猫，大大的绿色眼睛，坐在木桌上，柔和自然光，专业宠物摄影，高细节。

**第 5 步：点击生成**

点击"Generate"或"生成"按钮。等待 3-5 秒，Gemini 会实时显示生成进度。

**第 6 步：查看结果**

生成完成后，图片会显示在界面上。如果不满意，可以：
- 修改 prompt 重新生成（免费额度内）
- 点击"Regenerate"重新生成（相同 prompt，随机种子不同）

**第 7 步：下载图片**

点击图片右上角的下载图标（或右键 → 另存为），保存到本地。

**第 8 步：（可选）获取 API Key**

如果你想通过代码调用 API，点击左侧"Get API key"，创建或复制你的 API 密钥。**妥善保管**，不要公开分享。

**第 9 步：查看额度使用**

在 Google AI Studio 的设置或 Dashboard 中，可以查看今天已使用的请求次数（最多 500 次/天）。

**第 10 步：开始创作！**

现在你已经学会基本操作。尝试不同的 prompt，探索 Gemini 的能力。

### 常见错误及解决

**问题 1**：输入中文 prompt 返回文本而非图片
- **原因**：Gemini 不支持中文输入
- **解决**：使用英文 prompt，或参考 H2-5 的中文翻译方案

**问题 2**：提示"地区不可用"
- **原因**：注册时选择了中国地区
- **解决**：创建新 Google 账号，地区选择美国或其他支持地区

**问题 3**：生成速度很慢
- **原因**：网络问题或服务器负载
- **解决**：检查网络连接，稍后重试；或使用[laozhang.ai](https://laozhang.ai)提供的 Gemini API 中转服务

---

## 免费额度深度解析：你的需求场景分析

"每天 500 次免费"听起来很多，但对你的需求够用吗？这取决于你的使用场景。

### 场景化成本分析

| 用户类型 | 月需求 | 免费够用？ | 月成本（Gemini）| 月成本（DALL-E 3）| 节省 |
|---------|--------|-----------|----------------|------------------|------|
| 个人博主 | 30 图/月 | 完全够用 | $0 | $1.2-3.6 | $1.2-3.6 |
| 自媒体设计师 | 300 图/月 | 完全够用 | $0 | $12-36 | $12-36 |
| 小型创业团队（3人） | 1500 图/月 | 够用 | $0（共享额度） | $60-180 | $60-180 |
| SaaS 产品（自动生成） | 10000 图/月 | 需付费 | $390 | $400-1200 | $10-810 |
| 电商平台（大批量） | 50000 图/月 | 需付费 | $1950 | $2000-6000 | $50-4050 |

**详细说明**：

**个人博主**（30 图/月）：

对于每天需要 1 张封面图加上偶尔配图的个人博主，Gemini 的免费额度（500 次/天）完全足够，全程零成本。相比之下，虽然 ChatGPT Plus（$20/月）订阅包含 DALL-E 3 不单独收费，但订阅费用分摊下来也不便宜。**推荐使用 Gemini 免费层**。

**设计师**（300 图/月）：

如果你为客户提供设计服务，每天生成约 10 张原型图用于提案，Gemini 的免费额度同样充裕且完全免费。单独购买 DALL-E 3 API 的话需要 $12-36/月。**推荐使用 Gemini 免费层**，将节省的费用用于其他设计工具。

**小团队**（1500 图/月）：

3 人小团队每人每天约需 16 张图。如果合理分配账号（每人使用独立的 Google 账号），可以实现完全免费（每人 500 次/天 × 3 人 = 1500 次/天）。相比之下，DALL-E 3 的团队版成本相当可观。**推荐采用 Gemini 多账号策略**（在合规使用前提下）。

**SaaS 产品**（10000 图/月）：

如果你的产品需要自动化生成图片（例如用户上传照片自动生成营销海报），免费层明显不够，需要使用付费方案。Gemini 的成本为 $390/月，而 DALL-E 3 根据质量设置需要 $400-1200/月，每月可节省 $10-810。**推荐使用 Gemini 付费层**，或者通过 [laozhang.ai](https://laozhang.ai) 的 API 聚合服务获得更稳定的国内访问和统一管理。

**电商平台**（50000 图/月）：

对于需要大规模批量生成商品图和场景图的电商平台，必须使用付费方案。Gemini 的月成本为 $1950，而 DALL-E 3 需要 $2000-6000，可节省数千美元。**推荐使用 Gemini Vertex AI**，它提供企业级 SLA 保障和专业技术支持。

### 免费额度用尽后的策略

如果 500 次/天不够用，有以下方案：

**方案 1：多账号轮换**（个人用户）

如果是小团队或遇到临时高峰需求，可以考虑创建多个 Google 账号（在合规使用前提下），每个账号都有独立的 500 次/天额度。这种方式适合偶尔超出单账号限制的场景。

**方案 2：付费使用 Gemini API**（开发者）

对于有一定预算的创业公司，可以在代码中设置当免费额度用完后自动切换到付费层（$0.039/图）。这种方式确保服务不中断，同时成本仍然可控。

**方案 3：混合方案**（成本优化）

成本敏感的 SaaS 产品可以采用混合策略：将免费层用于日常或非紧急任务，付费层只用于紧急或高优先级任务。通过智能路由，在保证服务质量的同时最大化降低成本。

**方案 4：使用 API 聚合平台**（中国用户）

对于需要稳定性和多模型切换能力的团队，[laozhang.ai](https://laozhang.ai) 等 API 聚合平台是理想选择。这类平台按各自价格计费（原文写于该模型停用前：$0.039/图），但提供国内稳定访问，并且能统一管理 Gemini、DALL-E、Flux 等多个 AI 模型，一个接口调用所有服务。

### 成本计算实例

**实例 1：个人自媒体**

假设你运营一个公众号，每天发布 1 篇文章，需要 1 张封面图 + 2 张配图。

- 月需求：3 图/天 × 30 天 = 90 图/月
- Gemini 成本：**$0**（免费层）
- DALL-E 3 成本（通过 API）：90 × $0.04 = $3.6/月
- **年度节省**：$43

**实例 2：UI/UX 设计师**

你为客户提供设计服务，每天需要生成 15 张原型图用于提案。

- 月需求：15 图/天 × 22 工作日 = 330 图/月
- Gemini 成本：**$0**（免费层充裕）
- DALL-E 3 成本：330 × $0.04 = $13.2/月
- Midjourney 订阅：$10-30/月（但无 API）
- **年度节省**：$158（vs DALL-E）

**实例 3：电商 SaaS**

你的产品允许用户上传商品照片，自动生成营销海报。日活 500 用户，每用户生成 2 张。

- 月需求：500 用户 × 2 图 × 30 天 = 30,000 图/月
- Gemini 成本：30000 × $0.039 = $1,170/月
- DALL-E 3 成本（标准质量）：30000 × $0.04 = $1,200/月
- DALL-E 3 成本（HD 质量）：30000 × $0.08 = $2,400/月
- **月度节省**：$30-1,230

---

## 全方位对比：Gemini vs DALL-E 3 vs Midjourney

选择 AI 图像生成模型，不只看价格，还要综合考虑速度、质量、功能、易用性。

![AI 图像生成模型全方位对比](https://www.aifreeapi.com/posts/zh/gemini-25-flash-image-api-unlimited/img/comparison.png)

### 详细对比分析

**1. 价格**

- **Gemini 2.5 Flash**：$0.039/图（固定），无论分辨率和质量
- **DALL-E 3**：
  - 标准质量 1024x1024：$0.040/图
  - 标准质量 1024x1792：$0.080/图
  - HD 质量 1024x1024：$0.080/图
  - HD 质量 1024x1792：$0.120/图
- **Midjourney**：
  - Basic 计划：$10/月（约 200 张）
  - Standard 计划：$30/月（无限慢速，15 小时快速）
  - Pro 计划：$60/月（30 小时快速）
- **Flux**：分层定价（Pro/Dev/Schnell），变化较大

**结论**：Gemini 在付费使用中最便宜，且价格透明。Midjourney 适合追求极致画质的艺术创作。

**2. 速度**

- **Gemini 2.5 Flash**：**3-4 秒**（实测平均 3.5 秒）
- **DALL-E 3**（通过 ChatGPT）：**60+ 秒**（实测 58-120 秒）
- **DALL-E 3**（直接 API）：约 10-15 秒
- **Midjourney**：30-60 秒（取决于服务器负载）
- **Flux**：变化较大（5-30 秒）

**结论**：Gemini 在速度上有压倒性优势，适合需要快速迭代的场景。

**3. 免费额度**

Gemini 通过 Google AI Studio 提供每天 500 次免费请求，这对个人和小团队极具吸引力。相比之下，DALL-E 3 没有免费层（需付费或订阅 ChatGPT Plus），Midjourney 同样需要付费订阅，Flux 提供有限的免费试用（具体额度会变化）。

**4. 中文 Prompt 支持**

在中文支持方面，Gemini 目前不支持中文输入（需要翻译），这是其最大劣势。DALL-E 3、Midjourney 和 Flux 都原生支持中文 prompt，中文用户可以直接使用。对于 Gemini，你需要先将中文翻译为英文（详见本文"中文用户专属"章节）。

**5. 独特功能**

每个模型都有独特优势。Gemini 提供原生的角色一致性功能（可在不同场景保持同一角色）、多图融合（最多 3 张图）和对话式编辑能力，非常适合品牌资产生成和连续故事创作。DALL-E 3 与 ChatGPT 深度集成，支持 DALL-E 2 的编辑模式（inpainting）。Midjourney 以极致的艺术风格著称，拥有丰富的社区 prompt 库和 Discord 集成。Flux 则提供开源版本，支持私有部署。

### 推荐决策树

**Q1: 你每月需要生成多少张图？**
- < 500 张 → Gemini 免费层
- 500-5000 张 → Gemini 付费层（性价比高）
- > 5000 张 → 根据 Q2

**Q2: 你是否需要中文 Prompt？**
- 是，且不想翻译 → DALL-E 3 或 Midjourney
- 否，或愿意使用翻译工具 → Gemini（节省成本）

**Q3: 你追求极致画质（艺术创作）吗？**
- 是 → Midjourney（画质最佳）
- 否 → Gemini（速度和成本优势）

**Q4: 你需要 API 集成吗？**
- 是 → Gemini（最简单）或 DALL-E 3（如已有 OpenAI 账号）
- 否 → Midjourney（Discord 界面）

**综合推荐**：

根据不同用户场景，这里是具体的推荐方案。对于个人用户和预算有限的小团队，Gemini 免费层是最佳选择。开发者如需 API 集成且成本敏感，Gemini 付费层提供最优性价比。如果你是中文用户且不想折腾翻译，DALL-E 3（通过 ChatGPT Plus $20/月订阅）更为便捷。追求极致画质的艺术创作者应选择 Midjourney Pro。企业级用户若需要 SLA 保障，Gemini Vertex AI 或 DALL-E 3 Enterprise 是合适的选择。

---

## 中文用户专属：完整工具链与 Prompt 翻译技巧

Gemini 当前不支持中文输入，但这不意味着中文用户无法使用。通过合理的工具链，你可以高效地将中文需求转化为精确的英文 prompt。工作流程分为 4 步：**中文需求 → ChatGPT 翻译 → Gemini 生图 → 获取成果**，全程仅需 15 秒。

### 完整工具链流程

**步骤 1：中文需求描述**

用你最自然的中文描述想要的图片。不需要担心格式，随意表达。

例如：
```
生成一张赛博朋克风格的智能手表产品图，紫色霓虹灯效果，放在深色桌面上，专业产品摄影风格，高清细节
```

**步骤 2：ChatGPT 翻译（推荐）**

使用 ChatGPT 将中文 prompt 翻译为适合 AI 图像生成的英文。

**翻译 Prompt**（复制使用）：
```
请将以下中文图像描述翻译为适合 AI 图像生成的精确英文 prompt。要求：
1. 保留所有关键细节（风格、颜色、光线、视角）
2. 增加技术术语（如 "professional photography", "high detail", "8k"）
3. 避免歧义（如"可爱"具体化为"cute, adorable, fluffy"）
4. 输出纯英文 prompt，无需解释

中文描述：{你的中文需求}
```

**示例输出**：
```
A cyberpunk-style smartwatch product photography with purple neon lighting effects, placed on dark wooden desk, professional studio lighting, high detail, 8k resolution, sharp focus, futuristic tech aesthetic
```

**步骤 3：Gemini 生成图片**

将翻译后的英文 prompt 输入 Gemini 2.5 Flash Image，生成图片。

**步骤 4：（可选）后处理**

如果需要进一步编辑，可以使用对话式编辑功能，或下载后在本地编辑。

### Prompt 翻译技巧

**技巧 1：保留关键词**

某些专业术语直接使用英文更准确：
- 赛博朋克 → **cyberpunk**（不是 "cyber punk" 或 "cyber-punk"）
- 极简主义 → **minimalist** 或 **minimalism**
- 复古 → **retro** 或 **vintage**
- 水彩画 → **watercolor painting**

**技巧 2：增加细节**

AI 图像模型喜欢详细的描述。翻译时适当扩展细节。例如，简单的"一只可爱的猫"如果直译为"a cute cat"效果有限，优化后的版本应该是"a cute orange tabby cat with big green eyes, fluffy fur, sitting on a cozy blanket"，包含颜色、特征、姿态等具体细节。

**技巧 3：避免歧义**

某些中文词汇有多重含义，翻译时需要具体化：
- "小猫" → "kitten"（幼猫）还是 "small cat"（小型猫）？
- "亮" → "bright"（明亮）还是 "shiny"（闪亮）？
- "冷色调" → "cool color palette"（蓝绿紫）

**技巧 4：添加技术术语**

专业的 prompt 会包含摄影/艺术术语：
- 光线：soft lighting, dramatic lighting, natural light, studio lighting
- 细节：high detail, 8k, sharp focus, crisp
- 风格：professional photography, digital art, oil painting
- 视角：close-up, wide angle, bird's eye view, isometric

### 推荐翻译工具对比

| 工具 | 准确性 | 速度 | 成本 | 推荐度 | 说明 |
|------|--------|------|------|--------|------|
| **ChatGPT API** | 5/5 | 快（2秒） | 低（$0.002/次） | 首选 | 最准确，理解 AI 生成需求 |
| **ChatGPT 网页版** | 5/5 | 中（5秒） | $20/月（Plus） | 备选 | 如已订阅，性价比高 |
| **DeepL** | 4/5 | 快（1秒） | 免费 | 备选 | 翻译质量好，但缺少优化 |
| **Google Translate** | 2/5 | 快（1秒） | 免费 | 不推荐 | 直译，缺少细节，效果差 |
| **百度翻译** | 2/5 | 快（1秒） | 免费 | 不推荐 | 同上 |

**推荐组合**：

对于追求最佳翻译质量的用户，推荐使用 ChatGPT 进行翻译优化（$0.002/次），再用 Gemini 生成图片（$0.039/图），总成本约 $0.041/图。如果希望完全免费，可以使用 DeepL 进行翻译，配合 Gemini 的免费层生成图片，整个流程零成本。

### 10 个常见中文场景 + 最佳英文 Prompt

**场景 1：产品展示**
- 中文：一款科技感十足的蓝牙耳机，黑色，放在木桌上，专业产品摄影
- 英文：`A futuristic Bluetooth earbuds in matte black, placed on wooden desk, professional product photography, studio lighting, high detail, clean background, 8k`

**场景 2：人物肖像**
- 中文：一位优雅的女性，穿着商务套装，微笑，办公室背景
- 英文：`An elegant woman in professional business suit, warm smile, modern office background, natural lighting, portrait photography, sharp focus, professional headshot style`

**场景 3：自然风景**
- 中文：日落时分的山景，金色阳光，云雾缭绕
- 英文：`Mountain landscape at golden hour sunset, warm golden lighting, misty clouds, dramatic sky, landscape photography, high detail, wide angle, 8k resolution`

**场景 4：美食摄影**
- 中文：精致的日式寿司拼盘，俯拍，美食摄影
- 英文：`Elegant Japanese sushi platter, top-down view, professional food photography, natural lighting, fresh ingredients, garnished with wasabi and ginger, high detail, appetizing presentation`

**场景 5：抽象艺术**
- 中文：抽象几何图案，蓝色和紫色渐变，现代设计
- 英文：`Abstract geometric pattern with blue to purple gradient, modern minimalist design, smooth transitions, digital art, clean lines, contemporary aesthetic`

（更多场景示例可在文章末尾的资源链接中找到）

### 中文友好的替代方案

如果你完全不想处理翻译，可以考虑：

**方案 1：使用支持中文的模型**

如果完全不想处理翻译，可以选择原生支持中文的图像生成模型：DALL-E 3（通过 ChatGPT Plus 订阅，$20/月）提供了最佳的中文支持，Midjourney（Discord 界面）同样支持中文 prompt，而 Flux 的部分接口也能处理中文输入。

**方案 2：使用 API 聚合平台**

如果你需要统一管理多个 AI 模型，[laozhang.ai](https://laozhang.ai) 等平台的 API 网关提供了便捷的解决方案。这类平台不仅能自动处理中文 prompt 翻译，还能让你在 Gemini、DALL-E、Flux 等模型之间灵活切换，通过一个统一接口调用不同服务。

**方案 3：使用浏览器插件**

另一个简单的方法是安装"沉浸式翻译"等浏览器插件，它能实时翻译 Google AI Studio 的界面和你的输入内容，让整个使用过程更加流畅。

---

## 开发者指南：API 集成代码示例

如果你想在应用中集成 Gemini 图像生成能力，这里提供快速开始的代码示例。

### Python 快速开始

```python
# 1. 安装依赖
# pip install google-generativeai

# 2. 导入库
import google.generativeai as genai

# 3. 配置 API Key（从 Google AI Studio 获取）
genai.configure(api_key="YOUR_API_KEY_HERE")

# 4. 创建模型实例
model = genai.GenerativeModel('gemini-2.5-flash-image')

# 5. 生成图片
response = model.generate_content([
    "A cute orange tabby cat with big eyes, sitting on wooden table, professional photography"
])

# 6. 获取生成的图片
if response.candidates:
    image_data = response.candidates[0].content.parts[0].inline_data.data

    # 7. 保存图片
    import base64
    with open("output.png", "wb") as f:
        f.write(base64.b64decode(image_data))

    print("图片已保存为 output.png")
else:
    print("生成失败")
```

### Node.js 快速开始

```javascript
// 1. 安装依赖
// npm install @google/generative-ai

// 2. 导入库
const { GoogleGenerativeAI } = require("@google/generative-ai");
const fs = require("fs");

// 3. 配置 API Key
const genAI = new GoogleGenerativeAI("YOUR_API_KEY_HERE");

// 4. 创建模型实例
const model = genAI.getGenerativeModel({ model: "gemini-2.5-flash-image" });

// 5. 生成图片
async function generateImage() {
  const prompt = "A cute orange tabby cat with big eyes, sitting on wooden table, professional photography";

  const result = await model.generateContent([prompt]);
  const response = await result.response;

  // 6. 获取并保存图片
  const imageData = response.candidates[0].content.parts[0].inlineData.data;
  fs.writeFileSync("output.png", Buffer.from(imageData, "base64"));

  console.log("图片已保存为 output.png");
}

// 7. 执行
generateImage();
```

### REST API 示例

```bash
curl -X POST \
  https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-image:generateContent \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -d '{
    "contents": [{
      "parts": [{
        "text": "A cute orange tabby cat with big eyes, sitting on wooden table, professional photography"
      }]
    }]
  }'
```

### 速率限制处理

免费层有速率限制（500 次/天，2 次/分钟）。在代码中添加速率限制：

```python
import time

def generate_with_rate_limit(prompt):
    """每次生成后等待 30 秒，避免超过速率限制"""
    response = model.generate_content([prompt])
    time.sleep(30)  # 30 秒 = 2 次/分钟
    return response

# 批量生成示例
prompts = ["prompt 1", "prompt 2", "prompt 3"]
for prompt in prompts:
    result = generate_with_rate_limit(prompt)
    # 处理结果...
```

### 迁移到正式版模型

**重要**：Preview 模型 `gemini-2.5-flash-image-preview` 将于 2025-10-31 退役。

**迁移步骤**（只需改 1 行代码）：

```python
# 旧代码（Preview）
model = genai.GenerativeModel('gemini-2.5-flash-image-preview')

# 新代码（正式版）
model = genai.GenerativeModel('gemini-2.5-flash-image')
```

如果你想了解 API 集成的更多成本细节，可以参考[ChatGPT API 价格详解](/zh/chatgpt-api-pricing-guide)中的详细分析。

---

## 5 大避坑指南：新手必看

Gemini 2.5 Flash Image 虽然强大，但有一些常见陷阱需要避免。

### 坑 1：中文输入直接失败

**问题**：直接输入中文 prompt，返回文本而非图片

**表现**：
```
输入：生成一只可爱的橘猫
输出：（文本响应）对不起，我目前只支持英文 prompt...
```

**解决方案**：

最简单的方法是使用英文 prompt（参考本文"中文用户专属"章节的翻译技巧），或者通过 ChatGPT 先将中文翻译为精确的英文描述再输入。如果完全不想处理翻译，可以考虑使用[免费 AI 图像转换工具](/zh/ai-image-to-image-generator-free-unlimited)等原生支持中文的替代方案。

### 坑 2：Preview 模型即将退役

**问题**：使用 `gemini-2.5-flash-image-preview` 模型，2025-10-31 后将无法使用

**表现**：
- 代码运行正常，但突然在 10 月 31 日后报错："Model not found"

**解决方案**：
```python
# 立即迁移到正式版
model = genai.GenerativeModel('gemini-2.5-flash-image')  # 去掉 -preview
```

**迁移清单**：检查代码中的模型 ID，更新文档和配置文件，测试正式版模型（功能与 Preview 版完全相同）。

### 坑 3：注册时地区选择错误

**问题**：注册 Google 账号时选择中国，可能无法访问 Google AI Studio

**表现**：
- 打开 AI Studio 提示"该服务在您的地区不可用"
- API 调用返回 403 Forbidden

**解决方案**：

最直接的方法是创建新 Google 账号时选择**美国**或其他支持地区。如果已有账号遇到此问题，可以参考[Gemini 2.5 API 国内访问指南](/zh/gemini-2-5-api-china-access)，该文提供了详细的中转服务配置方案，帮助中国用户稳定访问 Gemini API。

### 坑 4：免费额度速率限制

**问题**：500 次/天额度充裕，但**每分钟不超过 2 次**，过快调用会被限制

**表现**：
- 快速连续生成 3 张图，第 3 张报错："Rate limit exceeded"
- 批量处理 100 张图，前 2 张成功，后续全部失败

**解决方案**：
```python
import time

for prompt in prompts:
    response = model.generate_content([prompt])
    time.sleep(30)  # 每次生成后等待 30 秒
```

或使用队列机制：
```python
from queue import Queue
import threading

def worker(queue):
    while True:
        prompt = queue.get()
        if prompt is None:
            break
        response = model.generate_content([prompt])
        # 处理响应...
        time.sleep(30)  # 速率限制
        queue.task_done()

# 创建队列和线程
queue = Queue()
thread = threading.Thread(target=worker, args=(queue,))
thread.start()

# 添加任务
for prompt in prompts:
    queue.put(prompt)

queue.join()  # 等待所有任务完成
```

### 坑 5：SynthID 隐形水印无法去除

**问题**：所有生成图片自动嵌入 SynthID 隐形水印，肉眼不可见但可被检测

**表现**：
- 图片看起来正常，但上传到某些平台会被标记为"AI 生成"
- 无法通过编辑、裁剪、压缩等方式去除水印

**影响**：
- 版权声明：图片被识别为 AI 生成
- 某些平台可能拒绝 AI 生成内容

**解决方案**：
- **接受现实**：SynthID 是 Google 防止 AI 滥用的设计，无法去除
- 如果需要无水印图片，考虑其他模型（如 Flux、Stable Diffusion）
- 对于商业用途，明确标注"AI 生成"以符合法律要求

**SynthID 检测工具**：

Google 提供了专门的在线工具用于检测图片是否含有 SynthID 水印，你可以访问 [https://deepmind.google/technologies/synthid/](https://deepmind.google/technologies/synthid/) 进行验证。

### 额外提示：避免支付问题

当你决定使用付费方案时，可能会遇到信用卡支付被拒绝的情况。这在 AI 服务中较为常见，具体的解决方法可以参考[AI 服务支付失败解决方案](/zh/chatgpt-payment-declined-solutions)一文中的详细说明。

---

## 总结与下一步

Gemini 2.5 Flash Image 是 2025年 AI 图像生成领域的重要进展，以**低成本、高速度、慷慨免费额度**为核心优势，特别适合个人用户、开发者和成本敏感的创业团队。

**核心要点回顾**：
1. **免费额度**：每天 500 次，个人和小团队完全够用
2. **价格优势**：$0.039/图，比 DALL-E 3 便宜 40-67%
3. **速度优势**：3-4 秒生成，比 DALL-E 3 快 15 倍
4. **中文限制**：不支持中文输入，需通过 ChatGPT 翻译
5. **独特功能**：角色一致性、多图融合、对话式编辑

**行动建议**：

**如果你是个人用户/博主**：

首先访问 [Google AI Studio](https://aistudio.google.com) 注册免费账号，然后参考本文"零基础上手"章节的 10 步教程生成第一张图。如果需要使用中文 prompt，可以通过 ChatGPT 进行翻译（具体方法见"中文用户专属"章节），之后就能享受每天 500 次的免费额度。

**如果你是开发者**：

从 Google AI Studio 获取 API Key 后，可以参考本文"开发者指南"章节的代码示例将 Gemini 集成到你的应用中。记得在代码中添加速率限制逻辑（免费层限制为每分钟 2 次），并持续监控使用量，提前规划何时切换到付费方案。

**如果你是企业用户**：

建议先评估你的月需求量（参考本文"免费额度深度解析"章节的场景分析），然后对比 Gemini、DALL-E 3 和 Midjourney 的综合成本（详见"全方位对比"章节）。如果每月需要生成超过 10000 张图片，建议考虑 Vertex AI 企业级方案，并联系 Google 销售团队获取定制化定价。

**学习资源**：

想要深入了解 Gemini 的更多技术细节，可以查阅 [Google AI Studio 官方文档](https://ai.google.dev/gemini-api/docs/image-generation)和 [Gemini API 定价详情](https://ai.google.dev/pricing)。如果你还在对比不同模型，[GPT-4o 图像生成能力](/zh/gpt-4o-image-generation)提供了详细的对比分析。对于希望获取免费 API 的用户，[免费 Gemini 2.5 API 指南](/zh/free-gemini-2-5-api-guide)也值得一读。

**遇到问题？**

如果在使用过程中遇到地区限制问题，可以访问[Gemini 地区限制解决](/zh/solve-gemini-region-restriction-problem)获取详细的解决方案。建议加入 Google AI Studio 社区与其他开发者讨论经验。对于需要稳定国内访问的用户，[laozhang.ai](https://laozhang.ai) 提供了可靠的技术支持。

---

**最后的话**：Gemini 2.5 Flash Image 不是完美的（中文限制是明显短板），但对于追求性价比和速度的用户，它是 2025年最值得尝试的图像生成模型之一。结合合理的工具链（如 ChatGPT 翻译），中文用户同样能享受其强大能力。

立即开始你的创作之旅吧！