Skip to content

Gemini 3.1 Flash Image Preview · Edit

Integrate

Model 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"

This request: $0.08 80 API credits Run it on this page

Get API key
Google Image Editing 4K outputFastup to 4K

Gemini 3.1 Flash Image editing that also accepts video, audio or PDF context alongside images

Made on Doitong

Public works made with Gemini 3.1 Flash Image Preview by the Doitong community. Reuse a prompt in one click.

Public works shown: 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...

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required 88 / 50000

Text instructions for editing an image.

resolution default 1K

Resolution for the output image.

default auto

Output image aspect ratio, including the extreme options 4:1, 1:4, 8:1, 1:8.

num_images default 1

Image count requested for generation.

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

Optional request-wide persona and output-style guidance, delivered to Gemini as a system instruction or to OpenAI-compatible providers as a system message. Nothing is sent for this instruction when the value is blank.

image_urls
Drop a file, or

Supply source images by URL for image editing or image-to-image generation, unless you provide at least one alternative input: `video_url`, `audio_url`, or `pdf_url`.

video_url
Drop a file, or

Optional video context supplied as either a YouTube URL or an http(s)/data URL for a video file. YouTube links reach the model directly without downloading; video files are downloaded and sent inline, subject to a 15 MB maximum.

audio_url
Drop a file, or

Provide optional audio context through an http(s) or data URL pointing to a file no larger than 15 MB. The file is sent inline after downloading.

output_format default png

File format for the resulting image.

safety_tolerance default 4

Set content-moderation tolerance between the least restrictive level, 6, and the strictest level, 1, which blocks most content.

thinking_level

Select 'minimal' or 'high' to activate model thinking at that level and include its thoughts in the generation; leaving the level unset keeps thinking disabled.

Provide optional PDF context through an http(s) or data URL pointing to a document no larger than 15 MB. The document is sent inline after downloading.

Seed value that initializes random-number generation.

POST /run/gemini-3.1-flash-image-preview/edit?wait=20 quote → $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"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Gemini 3.1 Flash Image Preview · Edit

Edits images with a `prompt`, using `image_urls` and optionally `video_url`, `audio_url` or `pdf_url` as context (each limited to 15MB). Supports `resolution` from 0.5K to 4K, extreme aspect ratios, web search, a `system_prompt` and `thinking_level`. Returns 1 to 4 edited images.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptrequired
Typestring
≤ 50,000 characters≥ 3 characters
Text instructions for editing an image.
num_imagesoptional num_outputs
Typeinteger
Default1
1 – 4
Image count requested for generation.
seedoptional
Typeinteger | null
Seed value that initializes random-number generation.
aspect_ratiooptional
Typeenum
Defaultauto
auto21:916:93:24:35:41:14:53:42:39:164:11:48:11:8
Output image aspect ratio, including the extreme options 4:1, 1:4, 8:1, 1:8.
output_formatoptional
Typeenum
Defaultpng
jpegpngwebp
File format for the resulting image.
safety_toleranceoptional
Typeenum
Default4
123456
Set content-moderation tolerance between the least restrictive level, 6, and the strictest level, 1, which blocks most content.
image_urlsoptional images
Typeurl[] · image
Supply source images by URL for image editing or image-to-image generation, unless you provide at least one alternative input: `video_url`, `audio_url`, or `pdf_url`.
system_promptoptional
Typestring
Default
≤ 50,000 characters
Optional request-wide persona and output-style guidance, delivered to Gemini as a system instruction or to OpenAI-compatible providers as a system message. Nothing is sent for this instruction when the value is blank.
resolutionoptional
Typeenum
Default1K
0.5K1K2K4K
Resolution for the output image.
video_urloptional video
Typeurl · video
Optional video context supplied as either a YouTube URL or an http(s)/data URL for a video file. YouTube links reach the model directly without downloading; video files are downloaded and sent inline, subject to a 15 MB maximum.
audio_urloptional audio
Typeurl · audio
Provide optional audio context through an http(s) or data URL pointing to a file no larger than 15 MB. The file is sent inline after downloading.
pdf_urloptional
Typestring | null
Provide optional PDF context through an http(s) or data URL pointing to a document no larger than 15 MB. The document is sent inline after downloading.
limit_generationsoptional
Typeboolean
Defaulttrue
Experimental generation cap that may affect quality when enabled. With `True`, each prompting round is restricted to 1 generation, overriding image-count instructions in the prompt and ignoring model-generated intermediate images.
thinking_leveloptional
Typeenum
minimalhigh
Select 'minimal' or 'high' to activate model thinking at that level and include its thoughts in the generation; leaving the level unset keeps thinking disabled.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

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"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
images
array of object {url, content_type, file_name, file_size, width, height}Images resulting from editing.
description
stringDescription accompanying the generated images.

More models: Image Editing

For AI agents: this page as Markdown is at https://doitong.com/developers/models/gemini-3.1-flash-image-preview/edit.md. All models and guides: https://doitong.com/developers/llms.txt