Skip to content

Gemini 3.1 Flash Image Preview

Integrate

Model id gemini-3.1-flash-image-preview
# 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?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 Text to Image 4K outputFastup to 4K

Gemini 3.1 Flash Image text-to-image with 0.5K to 4K output, extreme ratios, web search and thinking

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 used to generate an image.

resolution default 1K

Resolution for the output image.

default auto

Choose the generated image's aspect ratio explicitly, including extreme options 4:1, 1:4, 8:1, 1:8, or select "auto" for a prompt-based choice by the model.

num_images default 1

Image count requested for generation.

Advanced system_prompt · output_format · safety_tolerance · thinking_level · 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.

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.

Seed value that initializes random-number generation.

POST /run/gemini-3.1-flash-image-preview?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?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

Generates images from a `prompt`, with `resolution` of 0.5K, 1K, 2K or 4K and aspect ratios including extreme ones such as 8:1 and 1:8. Optional `system_prompt`, `enable_web_search` and `thinking_level` (minimal or high) shape the generation. Produces 1 to 4 images in PNG, JPEG or WebP.

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 used to generate 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
Choose the generated image's aspect ratio explicitly, including extreme options 4:1, 1:4, 8:1, 1:8, or select "auto" for a prompt-based choice by the model.
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.
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.
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

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "gemini-3.1-flash-image-preview",
  "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 produced by the model.
description
stringDescription accompanying the generated images.

More models: Text to Image

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