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

Ideogram V3 Edit

التكامل

معرّف النموذج ideogram/v3/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/v3/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",
    "mask": "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 · صورة

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

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

إنشاء طلب

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

•مطلوب

موجّه يصف الملء لمنطقة الصورة المقنّعة.

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

مصدر التوليد المقدّم كعنوان URL لصورة، مع اشتراط تطابق العرض والارتفاع تمامًا مع الأبعاد المناظرة للقناع.

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

قناع الرسم الداخلي المقدّم عبر URL، مع اشتراط تطابق العرض والارتفاع تمامًا مع الأبعاد المناظرة للصورة المُدخلة.

rendering_speed الافتراضي BALANCED

إعداد سرعة العرض.

num_images الافتراضي 1

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

متقدم images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
أفلت ملفًا، أو

صور مرجعية للأسلوب بتنسيق JPEG أو PNG أو WebP. يجب ألا يتجاوز حجمها الإجمالي 10 MB.

إعداد نمط مسبق يوجّه اختياره توليد الصورة.

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

رموز نمط الصورة، تُقدّم كسلاسل سداسية من 8 محارف لكل منها؛ احذف كلًا من style_reference_images وstyle عند استخدام هذه القائمة.

لوحة الألوان المستخدمة أثناء التوليد. حدّد إعدادًا مسبقًا عبر name أو ألوانًا سداسية صريحة عبر members، مع إمكانية تضمين الأوزان.

POST /run/ideogram/v3/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/v3/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",
    "mask": "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 V3 Edit

يملأ منطقة مقنّعة من صورة وفق `prompt`. يجب أن تكون للصورة (`image_url`) والقناع (`mask_url`) أبعاد متطابقة. يمكن توجيه الأسلوب باستخدام صور مرجعية أو `style_codes` أو `color_palette` أو `style_preset`. سرعة العرض TURBO أو BALANCED أو QUALITY، ويمكن إرجاع 1 إلى 8 صور.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlsاختياري images
النوعurl[] · image
صور مرجعية للأسلوب بتنسيق JPEG أو PNG أو WebP. يجب ألا يتجاوز حجمها الإجمالي 10 MB.
rendering_speedاختياري
النوعenum
الافتراضيBALANCED
TURBOBALANCEDQUALITY
إعداد سرعة العرض.
color_paletteاختياري
النوعobject
لوحة الألوان المستخدمة أثناء التوليد. حدّد إعدادًا مسبقًا عبر name أو ألوانًا سداسية صريحة عبر members، مع إمكانية تضمين الأوزان.
color_palette.membersاختياري
النوعobject[]
قائمة أعضاء اللوحة التي تحدد ألوانها.
color_palette.members[].rgbمطلوب
النوعobject
لون عضو اللوحة، معبّرًا عنه بصيغة RGB.
color_palette.members[].color_weightاختياري
النوعnumber | null
الافتراضي0.5
0.05 – 1
الوزن المعيّن لهذا اللون ضمن اللوحة.
color_palette.nameاختياري
النوعenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
اختيار إعداد مسبق للوحة الألوان.
style_codesاختياري
النوعstring[]
رموز نمط الصورة، تُقدّم كسلاسل سداسية من 8 محارف لكل منها؛ احذف كلًا من style_reference_images وstyle عند استخدام هذه القائمة.
expand_promptاختياري
النوعboolean
الافتراضيtrue
مفتاح تبديل استخدام MagicPrompt لتوليد الطلب.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 8
عدد الصور المطلوب إنتاجها.
seedاختياري
النوعinteger | null
قيمة البذرة لتوليد الأرقام العشوائية.
style_presetاختياري
النوعenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 أخرىCOLORING_BOOK_ICOLORING_BOOK_IICUBISMDARK_AURADOODLEDOUBLE_EXPOSUREDRAMATIC_CINEMAEDITORIALEMOTIONAL_MINIMALETHEREAL_PARTYEXPIRED_FILMFLAT_ARTFLAT_VECTORFOREST_REVERIEGEO_MINIMALISTGLASS_PRISMGOLDEN_HOURGRAFFITI_IGRAFFITI_IIHALFTONE_PRINTHIGH_CONTRASTHIPPIE_ERAICONICJAPANDI_FUSIONJAZZYLONG_EXPOSUREMAGAZINE_EDITORIALMINIMAL_ILLUSTRATIONMIXED_MEDIAMONOCHROMENIGHTLIFEOIL_PAINTINGOLD_CARTOONSPAINT_GESTUREPOP_ARTRETRO_ETCHINGRIVIERA_POPSPOTLIGHT_80SSTYLIZED_REDSURREAL_COLLAGETRAVEL_POSTERVINTAGE_GEOVINTAGE_POSTERWATERCOLORWEIRDWOODBLOCK_PRINT
إعداد نمط مسبق يوجّه اختياره توليد الصورة.
promptمطلوب
النوعstring
موجّه يصف الملء لمنطقة الصورة المقنّعة.
image_urlمطلوب image
النوعurl · image
مصدر التوليد المقدّم كعنوان URL لصورة، مع اشتراط تطابق العرض والارتفاع تمامًا مع الأبعاد المناظرة للقناع.
mask_urlمطلوب mask
النوعurl · image
قناع الرسم الداخلي المقدّم عبر URL، مع اشتراط تطابق العرض والارتفاع تمامًا مع الأبعاد المناظرة للصورة المُدخلة.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3/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",
    "mask_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/v3/edit.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt