gemini-3.1-flash-lite-image,通过 Gemini generateContent 请求结构调用,适合输出固定为 1K 的应用配图、商品素材和批量内容。
模型 ID 必须包含
-image。gemini-3.1-flash-lite-preview 是名称相近的文本模型,不能用于图片生成。Gemini 3.1 Flash Lite Image API 能做什么
Google 将该模型定位为效率优先的图片模型,适合对吞吐量和交互速度敏感、但不需要高分辨率成品的工作流。上游能力说明见 Gemini 3.1 Flash Lite Image 模型页。
哪些 1K 图片任务适合 Lite
批量生成 1K 素材
商品缩略图、应用卡片、文章配图、社交媒体素材和内容运营图片通常不需要 2K 或 4K。固定使用 1K 可以减少响应体积,也能让生成管线保持简单。交互式图片编辑
请求可以同时包含编辑指令和多张 Base64 来源图片,适合更换背景、调整视觉风格、组合参考元素或保持主体后重新构图。每张图片放在独立inlineData 中,mimeType 必须与实际文件一致。
从 Gemini 2.5 Flash Image 迁移
仍使用gemini-2.5-flash-image 的 1K 工作流,可以优先比较 Lite。迁移不能只替换模型 ID,还应检查提示词效果、图片编辑结果、返回格式和错误处理。
输出规格与限制
Lite 只提供 1K 输出。imageSize 可以省略,也可以设置为大写 1K;2K、4K、1k 和 1024px 都不属于有效值。
当前参数页列出十种宽高比:1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。完整请求字段见参数说明。
响应图片位于 candidates[].content.parts[].inlineData。调用方应遍历全部内容片段,并根据返回的 mimeType 决定文件扩展名;不要假设图片必定位于 parts[0],也不要把 PNG 写成固定输出格式。
Lite 与 Flash Image 的区别
如果产品路线可能加入高分辨率图片,直接采用
gemini-3.1-flash-image 可以避免后续更换模型。精确金额以价格页为准。
网关请求容量、上游 429 和可用性目标统一见流量能力与可用性。Google 对 Lite 的低延迟定位不等于本站对单张图片完成时间作出保证。
通过 API 调用
同步请求发送到POST /v1beta/models/gemini-3.1-flash-lite-image:generateContent。无法持续等待连接时,改用 /v1/images/tasks 并设置 action=generate|edit,保存 task_id,再查询 GET /v1/tasks/{task_id}。
查看完整参数
配置 1K、宽高比、响应类型和来源图片。
复制调用示例
查看同步、异步、图片编辑和响应解析代码。