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 ---. Молодая девушка около 22 лет с яркими, выразительными карими...

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

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 ---. Подводный мир в лазурных тонах. Лучи солнца пронзают толщу воды, создавая танцующие световые столбы (каустику) на песчаном дне. Камера находится под водой, снимая снизу вверх. Видны косяки мелких серебристых рыб и медленно колышущиеся водоросли. Атмосфера...

Strong rule: style --- 3D Pixar ---. Стилизованный молодой мужчина около 30 лет с округлым лицом ...

Strong rule: style --- 3D Pixar ---. Стилизованный молодой мужчина около 30 лет с округлым лицом и светлой кожей. У него светло-каштановые волосы средней длины, разделенные на прямой пробор, и выразительные большие голубые глаза за очками в широкой черной оправе. На лице аккуратная бородка и...

Strong rule: style --- 3D Pixar ---. Стилизованный молодой мужчина около 30 лет с округлым лицом ...

Strong rule: style --- 3D Pixar ---. Стилизованный молодой мужчина около 30 лет с округлым лицом и светлой кожей. У него светло-каштановые волосы средней длины, разделенные на прямой пробор, и выразительные большие голубые глаза за очками в широкой черной оправе. На лице аккуратная бородка и...

Strong rule: style --- 3D Pixar ---. Сюрреалистичный и нежный образ: огромные волны, напоминающие...

Strong rule: style --- 3D Pixar ---. Сюрреалистичный и нежный образ: огромные волны, напоминающие по форме ладони, бережно держат маленькие бумажные кораблики и сказочные фрегаты. Камера на среднем плане. Освещение мягкое, лунное, создающее сказочную атмосферу. Море выглядит живым и заботливым....

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/en-US/developers/models/gemini-3.1-flash-image-preview/edit.md. All models and guides: https://doitong.com/developers/llms.txt