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

Ideogram V4.5 Edit

التكامل

معرّف النموذج ideogram/v4.5/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/v4.5/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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ⁨‏0.06 $⁩ 60 رصيد API · ≈ ⁨‏6.33 ₽⁩ تشغيله في هذه الصفحة

الحصول على مفتاح API
Ideogram تحرير الصور مدخلات مرجعية #realism#typography#editing

تحرير صور قائم على مطالبة في Ideogram 4.5 مع قناع اختياري وما يصل إلى 4 مراجع ووضع عالي الدقة

Ideogram · صورة

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

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

إنشاء طلب

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

•مطلوب 88 / 10000

موجّه يصف التوليد أو التعديل.

•مطلوب image_url
أفلت ملفًا، أو

الصورة المصدر الرئيسية للتعديل.

quality الافتراضي medium

مستوى الجودة المطبق مع أي من إعدادَي دقة التعديل؛ وmedium هو الافتراضي.

image_size الافتراضي auto

اختيار حجم المخرج: لا تتوفر الإعدادات المسبقة المسماة والأبعاد المخصصة إلا للتعديلات العادية من دون أقنعة، على أن يكون كل بُعد >=256 وقابلاً للقسمة على 32، والمساحة <=4194304، والنسبة <=6:1. اختر auto للاحتفاظ بهندسة المصدر، مع السماح للمزوّد بتصغير الصورة عند الحاجة.

num_images الافتراضي 1

عدد الصور المطلوب إنتاجها.

متقدم images · mask · edit_precision · seed
reference_image_urls
أفلت ملفًا، أو · حتى 4

صور مرجعية مرافقة للمصدر الأساسي: أربع صور كحد أقصى من دون قناع، أو ثلاث عند تقديم قناع أيضاً.

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

قناع التعديل والحفظ: بعد التقريب، يجب أن يظل متضمناً مناطق سوداء للتعديل ومناطق بيضاء للحفظ. يجب أن تطابق أبعاده أبعاد المصدر.

edit_precision الافتراضي regular

اختر دقة التعديل؛ تُجهّز تعليمات التعديل المنظّمة بغض النظر عن الاختيار. عند اختيار high، يعيد Precise Edit البكسلات غير المتغيرة؛ أما regular فيستخدم Generate بدلاً منه.

بذرة عشوائية تُختار تلقائياً عند حذفها.

POST /run/ideogram/v4.5/edit?wait=20 عرض السعر → ⁨‏0.06 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/v4.5/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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Ideogram V4.5 Edit

يحرر صورة مصدر باستخدام مطالبة يصل طولها إلى 10,000 حرف. يحد `mask_url` الاختياري منطقة التحرير، وتقبل `reference_image_urls` ما يصل إلى 4 مراجع. يعيد `edit_precision` high وحدات البكسل غير المتغيرة، بينما تتراوح `quality` من very_low إلى high. ينشئ ما يصل إلى 8 صور لكل استدعاء.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
≤ 10,000 حرف
موجّه يصف التوليد أو التعديل.
image_urlمطلوب image
النوعurl · image
الصورة المصدر الرئيسية للتعديل.
reference_image_urlsاختياري images
النوعurl[] · image
≤ 4 عناصر
صور مرجعية مرافقة للمصدر الأساسي: أربع صور كحد أقصى من دون قناع، أو ثلاث عند تقديم قناع أيضاً.
mask_urlاختياري mask
النوعurl · image
قناع التعديل والحفظ: بعد التقريب، يجب أن يظل متضمناً مناطق سوداء للتعديل ومناطق بيضاء للحفظ. يجب أن تطابق أبعاده أبعاد المصدر.
edit_precisionاختياري
النوعenum
الافتراضيregular
regularhigh
اختر دقة التعديل؛ تُجهّز تعليمات التعديل المنظّمة بغض النظر عن الاختيار. عند اختيار high، يعيد Precise Edit البكسلات غير المتغيرة؛ أما regular فيستخدم Generate بدلاً منه.
qualityاختياري
النوعenum
الافتراضيmedium
very_lowlowmediumhigh
مستوى الجودة المطبق مع أي من إعدادَي دقة التعديل؛ وmedium هو الافتراضي.
image_sizeاختياري
النوعobject
الافتراضيauto
autosquaresquare_hdportrait_4_3landscape_4_3portrait_16_9landscape_16_9
اختيار حجم المخرج: لا تتوفر الإعدادات المسبقة المسماة والأبعاد المخصصة إلا للتعديلات العادية من دون أقنعة، على أن يكون كل بُعد >=256 وقابلاً للقسمة على 32، والمساحة <=4194304، والنسبة <=6:1. اختر auto للاحتفاظ بهندسة المصدر، مع السماح للمزوّد بتصغير الصورة عند الحاجة.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 8
عدد الصور المطلوب إنتاجها.
seedاختياري
النوعinteger | null
بذرة عشوائية تُختار تلقائياً عند حذفها.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v4.5/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": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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
      }
    ],
    "seed": 42
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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}
seed
integerقيمة البذرة المستخدمة لتوليد الأرقام العشوائية.

مزيد من النماذج: تحرير الصور

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/ideogram/v4.5/edit.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt