تخطّي إلى المحتوى

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://vit.doitong.com/api/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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ⁨‏0.08 $⁩ 80 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Google تحرير الصور إخراج بدقة 4Kسريعحتى 4K

تحرير Gemini 3.1 Flash Image، ويقبل أيضًا سياق فيديو أو صوت أو PDF إلى جانب الصور

Google · صورة

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب 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
أفلت ملفًا، أو

وفّر الصور المصدر عبر عنوان URL لتحرير الصور أو التوليد من صورة إلى صورة، ما لم توفّر مدخلًا بديلًا واحدًا على الأقل: `video_url` أو `audio_url` أو `pdf_url`.

video_url
أفلت ملفًا، أو

سياق فيديو اختياري يُقدّم إما كرابط YouTube أو عنوان URL من نوع http(s)/data لملف فيديو. تصل روابط YouTube إلى النموذج مباشرةً دون تنزيل؛ أما ملفات الفيديو فتُنزل وتُرسل مضمنة، بحد أقصى 15 MB.

audio_url
أفلت ملفًا، أو

وفّر سياقًا صوتيًا اختياريًا عبر عنوان URL من نوع http(s) أو data يشير إلى ملف لا يتجاوز حجمه 15 MB. يُرسل الملف مضمنًا بعد تنزيله.

output_format الافتراضي png

تنسيق ملف الصورة الناتجة.

safety_tolerance الافتراضي 4

اضبط تسامح تعديل المحتوى بين المستوى الأقل تقييدًا، 6، والمستوى الأشد تقييدًا، 1، الذي يحظر معظم المحتوى.

thinking_level

اختر 'minimal' أو 'high' لتفعيل تفكير النموذج بهذا المستوى وإدراج أفكاره في التوليد؛ ويؤدي ترك المستوى دون تعيين إلى إبقاء التفكير معطّلًا.

وفّر سياق PDF اختياريًا عبر عنوان URL من نوع http(s) أو data يشير إلى مستند لا يتجاوز حجمه 15 MB. يُرسل المستند مضمنًا بعد تنزيله.

قيمة البذرة التي تهيّئ توليد الأرقام العشوائية.

POST /run/gemini-3.1-flash-image-preview/edit?wait=20 عرض السعر → ⁨‏0.08 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/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://vit.doitong.com/api/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
≤ 50,000 حرف≥ 3 أحرف
تعليمات نصية لتحرير صورة.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب توليده.
seedاختياري
النوعinteger | null
قيمة البذرة التي تهيّئ توليد الأرقام العشوائية.
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، الذي يحظر معظم المحتوى.
image_urlsاختياري images
النوعurl[] · image
وفّر الصور المصدر عبر عنوان URL لتحرير الصور أو التوليد من صورة إلى صورة، ما لم توفّر مدخلًا بديلًا واحدًا على الأقل: `video_url` أو `audio_url` أو `pdf_url`.
system_promptاختياري
النوعstring
الافتراضي
≤ 50,000 حرف
إرشادات اختيارية للشخصية ونمط المخرج على مستوى الطلب، تُرسل إلى Gemini كتعليمة نظام أو إلى المزوّدين المتوافقين مع OpenAI كرسالة نظام. لا يُرسل شيء لهذه التعليمة عندما تكون القيمة فارغة.
resolutionاختياري
النوعenum
الافتراضي1K
0.5K1K2K4K
دقة صورة المخرج.
video_urlاختياري video
النوعurl · video
سياق فيديو اختياري يُقدّم إما كرابط YouTube أو عنوان URL من نوع http(s)/data لملف فيديو. تصل روابط YouTube إلى النموذج مباشرةً دون تنزيل؛ أما ملفات الفيديو فتُنزل وتُرسل مضمنة، بحد أقصى 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`، تُقيّد كل جولة موجّه إلى توليد واحد، مع تجاوز تعليمات عدد الصور في الموجّه وتجاهل الصور الوسيطة التي يولّدها النموذج.
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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?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/ar/developers/models/gemini-3.1-flash-image-preview/edit.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt