跳转到内容

Gemini 3.1 Flash Image Preview · Edit

集成

模型 id gemini-3.1-flash-image-preview/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/gemini-3.1-flash-image-preview/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

此请求: $0.08 80 API 积分 在此页面运行

获取 API 密钥
Google 图像编辑 4K 输出快速最高 4K

Gemini 3.1 Flash Image 编辑模型,还可在图像之外接受视频、音频或 PDF 上下文

在 Doitong 上制作

Doitong 社区使用 Gemini 3.1 Flash Image Preview 制作的公开作品。一键复用提示词。

显示的公开作品:16
Яркая и радостная сцена в детской. Папа склонился над пеленальным столиком, развлекая Саю яркой п...

Яркая и радостная сцена в детской. Папа склонился над пеленальным столиком, развлекая Саю яркой погремушкой в форме солнца. Ракурс снизу, со стороны ребенка, подчеркивает масштаб и значимость фигуры отца. Освещение дневное, контрастное и веселое. Вокруг разбросаны мягкие кубики и яркие игрушки....

Strong rule: style --- 3D Pixar ---. Финальный кадр: Сая погружена в глубокий сон, и на её личике...

Strong rule: style --- 3D Pixar ---. Финальный кадр: Сая погружена в глубокий сон, и на её личике появляется едва уловимая, блаженная улыбка. Папа продолжает баюкать её на руках, его темный силуэт четко выделяется на фоне большого окна, за которым мерцает ночное звездное небо. Камера установлена...

Strong rule: style --- 3D Pixar ---. Ярко освещенный современный супермаркет с бесконечными рядам...

Strong rule: style --- 3D Pixar ---. Ярко освещенный современный супермаркет с бесконечными рядами полок. Марина сидит за кассовым аппаратом, её движения механические. На переднем плане — лента с продуктами: молоко, хлеб, консервы. Освещение резкое, люминесцентное, создающее холодную атмосферу....

Strong rule: style --- Реалистичная 3D-анимация в духе Pixar, но без м... ---. Дневное кафе с бол...

Strong rule: style --- Реалистичная 3D-анимация в духе Pixar, но без м... ---. Дневное кафе с большими окнами. Пасмурный свет, нейтральная палитра: серые улицы, мягкие тени. На столе две чашки, ложечки, салфетки. Аня в бежевом тренче и белом топе, Олег в тёмной куртке/свитере. Они сидят напротив,...

Art style: Cinematic Realistic. Интерьер роскошного банкетного зала в загородном особняке, заполн...

Art style: Cinematic Realistic. Интерьер роскошного банкетного зала в загородном особняке, заполненного нарядными гостями. В воздухе парят золотистые конфетти, повсюду видны хрустальные бокалы с шампанским. Освещение яркое, с динамичными вспышками света, создающими атмосферу праздника. В центре...

Art style: Cinematic Realistic. Un dormitorio en penumbra durante la noche, iluminado solo por la...

Art style: Cinematic Realistic. Un dormitorio en penumbra durante la noche, iluminado solo por la luz azulada de la luna que entra por las persianas. Elena está sentada en el borde de la cama, meciendo a un bebé envuelto en una manta blanca que llora. Javier duerme profundamente al otro lado de...

Art style: 3D анимация в стиле Pixar. Девочка с распущенными волосами с ножницами стоит перед зер...

Art style: 3D анимация в стиле Pixar. Девочка с распущенными волосами с ножницами стоит перед зеркалом в ванной, рядом на раковине сидит рыжий кот. Держит левой рукой длинную прядь в районе челки, а левой ее начинает отстригать ножницами. Бирюзовая плитка на фоне, мягкое освещение. Лицо девочки...

Art style: Cinematográfico realista. Marcos abraza a Elena por los hombros en el sofá, ella perma...

Art style: Cinematográfico realista. Marcos abraza a Elena por los hombros en el sofá, ella permanece rígida. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative rendering directive — it overrides any style wording elsewhere in the prompt): Render this image...

构建请求

控件根据模型架构生成。更改控件时,代码和价格会同步更新。

•必填 88 / 50000

用于编辑图像的文本指令。

resolution 默认 1K

输出图像的分辨率。

默认 auto

输出图像宽高比,包括 4:1、1:4、8:1、1:8 等极端选项。

num_images 默认 1

请求生成的图像数量。

高级 system_prompt · images · video · audio · output_format · safety_tolerance · thinking_level · pdf_url · seed · limit_generations
0 / 50000

可选的请求级 persona 和输出风格指导,会作为系统指令发送给 Gemini,或作为系统消息发送给 OpenAI 兼容提供商。该值为空时不会发送此指令。

image_urls
拖放文件,或

通过 URL 提供源图像,用于图像编辑或图生图生成;除非至少提供一种替代输入:`video_url`、`audio_url` 或 `pdf_url`。

video_url
拖放文件,或

可选的视频上下文,可以是 YouTube URL 或指向视频文件的 http(s)/data URL。YouTube 链接会直接传给模型而不下载;视频文件会下载后以内联方式发送,大小上限为 15 MB。

audio_url
拖放文件,或

通过指向不超过 15 MB 文件的 http(s) 或 data URL 提供可选音频上下文。文件下载后以内联方式发送。

output_format 默认 png

结果图像的文件格式。

safety_tolerance 默认 4

将内容审核容忍度设置在限制最少的级别 6 与限制最严格的级别 1 之间;级别 1 会阻止大多数内容。

thinking_level

选择 'minimal' 或 'high',以启用相应级别的模型思考并将其思考过程纳入生成;不设置级别则保持思考禁用。

通过指向不超过 15 MB 文档的 http(s) 或 data URL 提供可选 PDF 上下文。文档下载后以内联方式发送。

用于初始化随机数生成的种子值。

POST /run/gemini-3.1-flash-image-preview/edit?wait=20 报价 → $0.08
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/gemini-3.1-flash-image-preview/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

运行此请求

你的密钥会保留在此浏览器中:仅发送到 Doitong API;只有勾选“记住”后才会保存到 localStorage。 获取 API 密钥

关于 Gemini 3.1 Flash Image Preview · Edit

使用 `prompt` 编辑图像,以 `image_urls` 以及可选的 `video_url`、`audio_url` 或 `pdf_url` 作为上下文(每项限制为 15MB)。支持 0.5K 到 4K 的 `resolution`、极端宽高比、网页搜索、`system_prompt` 和 `thinking_level`。返回 1 到 4 张编辑后的图像。

参数

发送规范名称或原生名称之一,不要同时发送两者。 规范名称

名称类型 默认值允许值 描述
prompt必填
类型string
≤ 50,000 个字符≥ 3 个字符
用于编辑图像的文本指令。
num_images可选 num_outputs
类型integer
默认值1
1 – 4
请求生成的图像数量。
seed可选
类型integer | null
用于初始化随机数生成的种子值。
aspect_ratio可选
类型enum
默认值auto
auto21:916:93:24:35:41:14:53:42:39:164:11:48:11:8
输出图像宽高比,包括 4:1、1:4、8:1、1:8 等极端选项。
output_format可选
类型enum
默认值png
jpegpngwebp
结果图像的文件格式。
safety_tolerance可选
类型enum
默认值4
123456
将内容审核容忍度设置在限制最少的级别 6 与限制最严格的级别 1 之间;级别 1 会阻止大多数内容。
image_urls可选 images
类型url[] · image
通过 URL 提供源图像,用于图像编辑或图生图生成;除非至少提供一种替代输入:`video_url`、`audio_url` 或 `pdf_url`。
system_prompt可选
类型string
默认值
≤ 50,000 个字符
可选的请求级 persona 和输出风格指导,会作为系统指令发送给 Gemini,或作为系统消息发送给 OpenAI 兼容提供商。该值为空时不会发送此指令。
resolution可选
类型enum
默认值1K
0.5K1K2K4K
输出图像的分辨率。
video_url可选 video
类型url · video
可选的视频上下文,可以是 YouTube URL 或指向视频文件的 http(s)/data URL。YouTube 链接会直接传给模型而不下载;视频文件会下载后以内联方式发送,大小上限为 15 MB。
audio_url可选 audio
类型url · audio
通过指向不超过 15 MB 文件的 http(s) 或 data URL 提供可选音频上下文。文件下载后以内联方式发送。
pdf_url可选
类型string | null
通过指向不超过 15 MB 文档的 http(s) 或 data URL 提供可选 PDF 上下文。文档下载后以内联方式发送。
limit_generations可选
类型boolean
默认值true
实验性生成上限,启用后可能影响质量。使用 `True` 时,每轮提示限制为 1 次生成,会覆盖提示词中的图像数量指令,并忽略模型生成的中间图像。
thinking_level可选
类型enum
minimalhigh
选择 'minimal' 或 'high',以启用相应级别的模型思考并将其思考过程纳入生成;不设置级别则保持思考禁用。
必填 规范名称,也可接受

文件参数接受公开的 https:// URL、最大 10 MB 的 data: URI,或上传文件的 file_url。 文件

输出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "gemini-3.1-flash-image-preview/edit",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "description": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
你的文件,由你选择每个 outputs[].url 都是存储中的副本:可永久保存(按 GB-月付费),也可免费保存 7 天,由账户设置或 ?storage= 决定。
每个模型的结构相同图像、视频和音频均包含 type、url、content_type、width、height 和 duration。output 是模型自身的结果对象。
输出字段
images
array of object {url, content_type, file_name, file_size, width, height}编辑生成的图像。
description
string随生成图像附带的描述。

更多模型:图像编辑

对于 AI 代理:此页面的 Markdown 版本位于 https://doitong.com/zh/developers/models/gemini-3.1-flash-image-preview/edit.md. 所有模型和指南: https://doitong.com/developers/llms.txt