رفتن به محتوا

Gemini 3.1 Flash Image Preview · Edit

یکپارچه‌سازی

شناسه مدل 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"

این درخواست: ⁨‎$۰٫۰۸⁩ ۸۰ اعتبار API اجرای آن در این صفحه

دریافت کلید API
Google ویرایش تصویر خروجی 4Kسریعحداکثر 4K

ویرایش Gemini 3.1 Flash Image که علاوه بر تصاویر، ویدیو، صدا یا زمینه PDF را نیز می‌پذیرد

ساخته‌شده در Doitong

آثار عمومی ساخته‌شده با Gemini 3.1 Flash Image Preview توسط جامعه Doitong. یک پرامپت را با یک کلیک دوباره استفاده کنید.

آثار عمومی نمایش‌داده‌شده: 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

راهنمای اختیاری مربوط به پرسونا و سبک خروجی در سطح درخواست که به Gemini به‌عنوان دستور سیستمی یا به ارائه‌دهندگان سازگار با OpenAI به‌عنوان پیام سیستمی ارسال می‌شود. اگر مقدار خالی باشد، چیزی برای این دستور ارسال نمی‌شود.

image_urls
یک فایل بیندازید، یا

تصاویر منبع را برای ویرایش تصویر یا تولید image-to-image از طریق URL ارائه کنید، مگر اینکه حداقل یک ورودی جایگزین ارائه دهید: `video_url`، `audio_url` یا `pdf_url`.

video_url
یک فایل بیندازید، یا

زمینه ویدیویی اختیاری، به‌صورت URL یوتیوب یا URL ‏http(s)/data برای فایل ویدیو. پیوندهای یوتیوب بدون دانلود مستقیماً به مدل می‌رسند؛ فایل‌های ویدیو دانلود و به‌صورت درون‌خطی ارسال می‌شوند و حداکثر 15 MB هستند.

audio_url
یک فایل بیندازید، یا

زمینه صوتی اختیاری را از طریق URL ‏http(s) یا data ارائه کنید که به فایلی حداکثر 15 MB اشاره کند. فایل پس از دانلود به‌صورت درون‌خطی ارسال می‌شود.

output_format پیش‌فرض png

قالب فایل تصویر نهایی.

safety_tolerance پیش‌فرض 4

تحمل تعدیل محتوا را بین کم‌محدودکننده‌ترین سطح، 6، و سخت‌گیرانه‌ترین سطح، 1، تنظیم می‌کند؛ سطح 1 بیشتر محتوا را مسدود می‌کند.

thinking_level

برای فعال‌کردن تفکر مدل در سطح موردنظر و گنجاندن افکار آن در تولید، 'minimal' یا 'high' را انتخاب کنید؛ خالی‌گذاشتن سطح، تفکر را غیرفعال نگه می‌دارد.

زمینه PDF اختیاری را از طریق URL ‏http(s) یا data ارائه کنید که به سندی حداکثر 15 MB اشاره کند. سند پس از دانلود به‌صورت درون‌خطی ارسال می‌شود.

مقدار seed که تولید اعداد تصادفی را آغاز می‌کند.

POST /run/gemini-3.1-flash-image-preview/edit?wait=20 قیمت → ⁨‎$۰٫۰۸⁩
# 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). از `resolution` بین 0.5K تا 4K، نسبت‌های بسیار گسترده، جست‌وجوی وب، `system_prompt` و `thinking_level` پشتیبانی می‌کند. 1 تا 4 تصویر ویرایش‌شده برمی‌گرداند.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
≤ ۵۰٬۰۰۰ نویسه≥ ۳ نویسه
دستورهای متنی برای ویرایش تصویر.
num_imagesاختیاری num_outputs
نوعinteger
پیش‌فرض1
۱ – ۴
تعداد تصاویر درخواستی برای تولید.
seedاختیاری
نوعinteger | null
مقدار seed که تولید اعداد تصادفی را آغاز می‌کند.
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
تصاویر منبع را برای ویرایش تصویر یا تولید image-to-image از طریق URL ارائه کنید، مگر اینکه حداقل یک ورودی جایگزین ارائه دهید: `video_url`، `audio_url` یا `pdf_url`.
system_promptاختیاری
نوعstring
پیش‌فرض
≤ ۵۰٬۰۰۰ نویسه
راهنمای اختیاری مربوط به پرسونا و سبک خروجی در سطح درخواست که به Gemini به‌عنوان دستور سیستمی یا به ارائه‌دهندگان سازگار با OpenAI به‌عنوان پیام سیستمی ارسال می‌شود. اگر مقدار خالی باشد، چیزی برای این دستور ارسال نمی‌شود.
resolutionاختیاری
نوعenum
پیش‌فرض1K
0.5K1K2K4K
وضوح تصویر خروجی.
video_urlاختیاری video
نوعurl · video
زمینه ویدیویی اختیاری، به‌صورت URL یوتیوب یا URL ‏http(s)/data برای فایل ویدیو. پیوندهای یوتیوب بدون دانلود مستقیماً به مدل می‌رسند؛ فایل‌های ویدیو دانلود و به‌صورت درون‌خطی ارسال می‌شوند و حداکثر 15 MB هستند.
audio_urlاختیاری audio
نوعurl · audio
زمینه صوتی اختیاری را از طریق URL ‏http(s) یا data ارائه کنید که به فایلی حداکثر 15 MB اشاره کند. فایل پس از دانلود به‌صورت درون‌خطی ارسال می‌شود.
pdf_urlاختیاری
نوعstring | null
زمینه PDF اختیاری را از طریق URL ‏http(s) یا data ارائه کنید که به سندی حداکثر 15 MB اشاره کند. سند پس از دانلود به‌صورت درون‌خطی ارسال می‌شود.
limit_generationsاختیاری
نوعboolean
پیش‌فرضtrue
سقف آزمایشی تولید که در صورت فعال‌بودن ممکن است بر کیفیت اثر بگذارد. با `True`، هر دور پرامپت‌نویسی به 1 تولید محدود می‌شود، دستورهای تعداد تصویر در پرامپت بازنویسی می‌شوند و تصاویر میانی تولیدشده توسط مدل نادیده گرفته می‌شوند.
thinking_levelاختیاری
نوعenum
minimalhigh
برای فعال‌کردن تفکر مدل در سطح موردنظر و گنجاندن افکار آن در تولید، 'minimal' یا 'high' را انتخاب کنید؛ خالی‌گذاشتن سطح، تفکر را غیرفعال نگه می‌دارد.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا 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-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
images
array of object {url, content_type, file_name, file_size, width, height}تصاویر حاصل از ویرایش.
description
stringتوضیح همراه تصاویر تولیدشده.

مدل‌های بیشتر: ویرایش تصویر

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/gemini-3.1-flash-image-preview/edit.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt