رفتن به محتوا

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. Крупный план Джулса, который с философским видом накалывает кусок блина на вилку. Он смотрит на Винни с легким снисхождением. Винни на заднем плане выглядит взбешенным, его лицо искажено от злости. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT...

Art style: 3D Pixar. Мальчик раскрывает упаковку и находит внутри красивую книгу с историями о пр...

Art style: 3D Pixar. Мальчик раскрывает упаковку и находит внутри красивую книгу с историями о приключениях. Мама сидит рядом и улыбается. Мягкий свет, радость и уют. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative rendering directive — it overrides any...

Art style: 3D Pixar. Стойка ресепшн в дорогом отеле. Соня в униформе натянуто улыбается раздражен...

Art style: 3D Pixar. Стойка ресепшн в дорогом отеле. Соня в униформе натянуто улыбается раздраженному гостю. Рядом стоит ее коллега с сочувствующим видом. Стиль Pixar, обстановка строгая и деловая, освещение холодное. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the...

Art style: 3D Pixar. Взрослый персонаж опускается на одно колено перед ребенком в центре загромож...

Art style: 3D Pixar. Взрослый персонаж опускается на одно колено перед ребенком в центре загроможденной комнаты. Она мягко касается плеча девочки, глядя ей прямо в глаза с доброй улыбкой. Вокруг них разбросаны плюшевые медведи и детали конструктора. Камера на уровне глаз персонажей, создавая...

Art style: 3D stylized animation. Девушка со светлыми волосами в черном платье стоит у красной ко...

Art style: 3D stylized animation. Девушка со светлыми волосами в черном платье стоит у красной ковровой дорожки. Ее глаза широко раскрыты от удивления, рот слегка приоткрыт. Теплое освещение падает на ее лицо. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the...

Art style: 3D Pixar, cinematic lighting, glossy materials. Оникс и Жемчужина с маленькой белой со...

Art style: 3D Pixar, cinematic lighting, glossy materials. Оникс и Жемчужина с маленькой белой собачкой на поводке стоят на улице перед очень богатым, современным особняком с большими окнами. Вечернее освещение, теплый свет из окон дома. 3D Pixar стиль, высокая детализация....

Art style: 3D Pixar. A cinematic close-up of a 3-year-old boy named Maxim looking guilty and clut...

Art style: 3D Pixar. A cinematic close-up of a 3-year-old boy named Maxim looking guilty and clutching his stomach, large expressive eyes filled with regret, soft warm indoor lighting with a shallow depth of field. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the...

Art style: 3D Pixar cinematic. In the same chocolate hallway, Kai, the mango boy from the poster,...

Art style: 3D Pixar cinematic. In the same chocolate hallway, Kai, the mango boy from the poster, walks past Luna. He suddenly stops in his tracks and looks at her, completely amazed. Soft cinematic lighting, 3D Pixar style. Он с ее не сводит глаз. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL...

ساخت درخواست

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

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