
Gemini 3.1 Flash Image Preview API
支持文生图、图片编辑,提供 1k / 2k / 4k 分辨率。
- 文生图
- 图片编辑
- 图生图
gemini-3.1-flash-image-previewPlayground
正在加载工作台…
人民币计费
接入方式
API 接入
查看接入文档基础域名 https://api.icodeeasy.cc
- 图片生成
POST/v1/images/generations - 图片编辑
POST/v1/images/edits - Gemini 原生
POST/v1beta/models/{model}:generateContent
API 示例
curl -X POST "https://api.icodeeasy.cc/v1/images/generations" \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary @- <<'JSON'
{
"model": "gemini-3.1-flash-image-preview",
"prompt": "一只柯基宇航员站在月球上,电影感画面",
"aspect_ratio": "16:9",
"image_size": "2K"
}
JSON先在本地设置 ICODEEASY_API_KEY。示例中的参考素材链接或任务 ID 请替换为你自己的值。
调用参数
图片生成
| 参数 | 类型 | 说明 |
|---|---|---|
model必填 | string | 模型 ID,使用页首可复制的值。 |
prompt必填 | string | 描述主体、构图和预期结果。编辑时说明需要修改与保留的内容。 |
图片编辑
| 参数 | 类型 | 说明 |
|---|---|---|
model必填 | string | 模型 ID,使用页首可复制的值。 |
prompt必填 | string | 描述主体、构图和预期结果。编辑时说明需要修改与保留的内容。 |
image_urls必填 | string[] | 编辑所用参考图。可传公网 HTTPS URL 或图片 Data URL,数量上限见模型说明。 |
Gemini 原生
| 参数 | 类型 | 说明 |
|---|---|---|
model必填 | string | 路径参数,使用页首的模型 ID。 |
contents必填 | array | 请求内容列表。文本放入 contents[].parts[].text。 |
核心功能
- 文生图
用文字描述主体和场景,生成新的静态图像。
- 支持
- 图生图
把原图作为生成依据,说明需要延续的元素和希望改变的部分。
提交参考图与修改描述
- 支持
- 参考图
把主体或风格参考随请求传入,作为构图、配色或外观的依据。
最多 4 张,支持 HTTPS 图片链接或 Base64 图片
- 支持
- 图片编辑
指定要调整的对象、背景或画面元素,生成修改版本供前后对照。
- 支持
- Gemini 原生图像接口
使用 Gemini 原生图像接口,将提示词与图像写入同一请求。
- 支持
模型亮点
高效多参考图生成
这款 Flash 支持 1K、2K、4K 和最多 4 张参考图,可在经常生成变体的流程里兼顾素材约束和高分辨率输出。
规格与限制
- 图片数量上限
- 最多 4 张
- 输出规格
- 1k / 2k / 4k
使用场景
商品陈列图改版
以商品实拍作为参考,分别尝试桌面、窗边或展台布景,选定后再核对商品细节。
品牌素材延展
提供已有视觉稿作为色彩与氛围参考,生成同一活动的封面和配图草稿。
场景改季节
将既有场景作为参考,保留画面结构,试做秋季、雨天或夜间光线版本。
活动海报底图
描述活动主题与主色,把画面重心放到一侧,留出后期排标题和时间的空间。
文章封面
从文章主题提取两个视觉元素,分别做横版封面草稿供编辑选用。
电商场景概念图
用文字描述商品类别、陈列方式和使用环境,试做拍摄方案供美术确认。
相关文章
常见问题
第一张图怎么试?
登录后在本页 Playground 用一句话写清主体、场景和光线,先生成一张。确认构图后再修改提示词或调整本模型提供的输出规格。
打开本页 Playground参考图怎么传,第一次要传几张?
先用一张主体清晰的图片,描述哪些部分要保留、哪些要改。本型号的参考图要求为 最多 4 张,支持 HTTPS 图片链接或 Base64 图片。
查看核心功能和规格生成新图和编辑旧图,用哪个接口?
新图用 /v1/images/generations。对已有图做修改时,按本型号的图片编辑示例调用 /v1/images/edits,传入原图和改动描述。
查看接入方式出草稿和出最终图,分辨率怎么选?
本型号可选 1k、2k、4k。先用较低的档位定构图和风格,确认画面后再根据最终用途提高分辨率。
查看核心功能和规格提示词很长,画面为什么还是跑偏?
先说主体和它在画面中的位置,再补机位、光线和风格。下一版只调整最明显的一个问题,便于看出是哪条描述改变了结果。
接口只返回任务 ID,怎么拿到成图?
异步模式下,保存 task_id,调用 GET /v1/images/tasks/{task_id} 查询。完成后读取结果地址。用 Playground 时可在本页等状态更新。
查看接入方式为什么两张图的费用可能不同?
先对照该型号的计费单位和对应规格。分辨率、参考素材和输出格式是否影响费用,以本页计费口径为准。已完成任务可在用量明细核对实际金额。
查看本站计费


