رفتن به محتوا

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
Art style: Cinematic Realistic. Интерьер роскошного банкетного зала в загородном особняке, заполн...

Art style: Cinematic Realistic. Интерьер роскошного банкетного зала в загородном особняке, заполненного нарядными гостями. Повсюду видны хрустальные бокалы с шампанским. Освещение яркое, с динамичными вспышками света, создающими атмосферу праздника. В центре композиции — Стася (желтые волосы и...

Art style: Cinematic Realistic. Макросъемка ладони Стаси, скрытой за ее спиной, в которой она сжи...

Art style: Cinematic Realistic. Макросъемка ладони Стаси, скрытой за ее спиной, в которой она сжимает современный смартфон. Экран телефона ярко вспыхивает в полумраке, отображая текстовое сообщение от неизвестного номера. Текст сообщения четкий и контрастный на темном фоне дисплея. На заднем...

Art style: Cinematic Realistic. A clearly recognizable likeness of Подруга — keep their real face...

Art style: Cinematic Realistic. A clearly recognizable likeness of Подруга — keep their real face shape, skin tone, hairstyle, build and any signature look (hair, kit, number). Девушка модельной внешности с ярким макияжем и ослепительной улыбкой. У нее платиновые волосы, собранные в высокий...

Art style: 3D Pixar. Luna abriendo la última carta con dedos temblorosos, una flor seca cayendo d...

Art style: 3D Pixar. Luna abriendo la última carta con dedos temblorosos, una flor seca cayendo de su interior, expresión de asombro en su rostro, pétalos y cartas alrededor, composición vertical con ángulo medio, luz suave dorada iluminando la carta y la flor, atmósfera reveladora...

Art style: 3D Pixar. Salón con una luz suave y difusa. Él está de pie junto a Ella, ofreciéndole ...

Art style: 3D Pixar. Salón con una luz suave y difusa. Él está de pie junto a Ella, ofreciéndole una taza de café en un gesto de atención inusual. Ella está sentada, mirando hacia el frente sin tomar la taza, con una distancia emocional evidente. Los colores son ocres y apagados. El teléfono de...

Art style: 3D Pixar. Горизонтальний крупний план нижньої частини дверей та порога. Чітко видно ви...

Art style: 3D Pixar. Горизонтальний крупний план нижньої частини дверей та порога. Чітко видно випадаючий з нижньої частини дверей ущільнювач, типу гільотина,. Підлога вкрита м'яким ковроліном нейтрального кольору. Світло відбивається від латунних деталей фурнітури. Атмосфера спокою та...

Art style: Cinematográfico realista. Marcos de rodillas frente a Elena, suplicando. Elena lo mira...

Art style: Cinematográfico realista. Marcos de rodillas frente a Elena, suplicando. Elena lo mira con compasión pero sin amor. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative rendering directive — it overrides any style wording elsewhere in the prompt):...

Art style: Cinematic Realistic. Крупный план мужской руки в черном рукаве смокинга, грубо и сильн...

Art style: Cinematic Realistic. Крупный план мужской руки в черном рукаве смокинга, грубо и сильно сжимающей тонкое женское запястье. На фоне видна часть лица Артура с неестественной, застывшей улыбкой, адресованной гостям. Кожа на запястье Стаси бледнеет от давления. Освещение становится более...

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی 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