gemini-2.5-flash-image。它仍可用于维护现有接入，但 Google 已把 2026 年 10 月 2 日列为最早停用日期，新项目不应再把它作为长期默认模型。
Gemini 2.5 Flash Image 是否还能继续使用
Google 将 Gemini 2.5 Flash Image 定位为面向高频生成和对话式图片编辑的稳定模型，同时已经公布后续停用计划。最新状态应以 Gemini 2.5 Flash Image 模型页和 Gemini API 停用时间表为准。图片生成与编辑能力
请求使用 Gemini 的contents[].parts[] 结构。文生图时只需要文字内容；图片编辑时，在同一数组中加入 inlineData 来源图片，并确保 mimeType 与实际文件一致。
支持的宽高比包括 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9 和 21:9。这个模型没有可选的 2K 或 4K 档位，imageSize 必须省略；发送 1K 也会违反当前参数合同。
完整字段、有效值和请求结构见参数说明。
接入时需要注意的限制
不要依赖固定图片格式
响应图片位于candidates[].content.parts[].inlineData。文字和图片可能同时返回，因此解析器应遍历全部内容片段，并根据 inlineData.mimeType 决定保存格式。
不要继续使用旧预览版 ID
gemini-2.5-flash-image-preview 已经弃用。正式接入只能使用 gemini-2.5-flash-image，迁移目标则应选择 3.1 系列，而不是回到预览版名称。
不要把上游全部字段视为可用
当前 API 提供的是 Gemini 图片生成与编辑子集。Google 文档中出现的其他工具、文件或 grounding 能力，只有在参数页和 OpenAPI 中明确列出时才属于公共接口范围。应该迁移到哪个模型
迁移检查项
- 把模型 ID 放入配置，不要写死在业务逻辑中。
- 使用同一组真实提示词和来源图片比较新旧结果。
- 检查新模型的
imageSize、宽高比和错误响应。 - 确认客户端不依赖固定 MIME 或
parts[0]。 - 为切换失败保留可回滚的模型配置。
开始调用
同步生成使用POST /v1beta/models/gemini-2.5-flash-image:generateContent；需要后台任务时使用 /v1/images/tasks，设置 action=generate|edit，再通过 GET /v1/tasks/{task_id} 查询结果。
检查 2.5 参数
确认必须省略 imageSize 以及十种宽高比。
查看调用示例
复制同步、异步、编辑和响应解析代码。