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 ---. Молодая девушка около 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 ---. Ярко-голубой надувной бассейн посреди зеленого газона. Катя ...

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

Strong rule: style --- 3D Pixar ---. Уютный уголок сада с деревянным шезлонгом под раскидистой яб...

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

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