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

Ideogram V3 Character Remix

التكامل

معرّف النموذج ideogram/character/remix
# 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/ideogram/character/remix?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",
    "reference_image_urls": [
      "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

الحصول على مفتاح API
Ideogram تحرير الصور مدخلات مرجعية #character-consistency

إعادة مزج Ideogram V3 لصورة إدخال إلى أنماط أو مشاهد جديدة مع الحفاظ على شخصية مرجعية

Ideogram · صورة

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

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

إنشاء طلب

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

•مطلوب

الموجّه المستخدم لتوجيه إعادة مزج الصورة.

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

عنوان URL للصورة التي تجري إعادة مزجها.

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

صور مرجعية للشخصية بتنسيق JPEG أو PNG أو WebP، بحد إجمالي 10 MB لجميع مراجع الشخصيات. يقتصر الدعم حاليًا على صورة واحدة؛ وتُتجاهل الصور الإضافية.

rendering_speed الافتراضي BALANCED

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

image_size الافتراضي square_hd

الدقة المستخدمة لصورة المخرج.

num_images الافتراضي 1

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

متقدم negative_prompt · images · reference_mask_urls · style · strength · seed · expand_prompt · style_codes · color_palette
الافتراضي

حدّد محتوى الصورة غير المرغوب فيه، مع إعطاء أوصاف الموجّه الرئيسي الأولوية على أوصاف الموجّه السلبي هذه.

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

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

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

أقنعة مرجعية للشخصية بتنسيق JPEG أو PNG أو WebP؛ ولا يمكن أن يتجاوز الحجم الإجمالي عبر جميع مراجع الشخصيات 10 MB. يُستخدم قناع واحد حاليًا، وتُتجاهل الأقنعة الإضافية.

style الافتراضي AUTO

نوع النمط المستخدم للتوليد؛ وهو متنافي مع style_codes.

الافتراضي 0.8

تأثير الصورة المصدر في إعادة المزج.

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

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

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

POST /run/ideogram/character/remix?wait=20 عرض السعر → ⁨‏0.15 $⁩
# 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/ideogram/character/remix?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",
    "reference_image_urls": [
      "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Ideogram V3 Character Remix

يعيد مزج `image_url` مع `prompt` مع الحفاظ على الشخصية من `reference_image_urls` (تُستخدم صورة واحدة). يتحكم `strength` (0.01-1، القيمة الافتراضية 0.8) في تأثير صورة الإدخال. يدعم إعدادات `image_size` المسبقة والمراجع الأسلوبية و`style` بقيم AUTO أو REALISTIC أو FICTION وما يصل إلى 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 عند استخدام هذه القائمة.
styleاختياري
النوعenum
الافتراضيAUTO
AUTOREALISTICFICTION
نوع النمط المستخدم للتوليد؛ وهو متنافي مع style_codes.
expand_promptاختياري
النوعboolean
الافتراضيtrue
مفتاح تبديل استخدام MagicPrompt لتوليد الطلب.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 8
عدد الصور المطلوب إنتاجها.
seedاختياري
النوعinteger | null
قيمة البذرة لتوليد الأرقام العشوائية.
promptمطلوب
النوعstring
الموجّه المستخدم لتوجيه إعادة مزج الصورة.
image_urlمطلوب image
النوعurl · image
عنوان URL للصورة التي تجري إعادة مزجها.
strengthاختياري
النوعnumber
الافتراضي0.8
0.01 – 1
تأثير الصورة المصدر في إعادة المزج.
image_sizeاختياري
النوعobject
الافتراضيsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
الدقة المستخدمة لصورة المخرج.
negative_promptاختياري
النوعstring
الافتراضي
حدّد محتوى الصورة غير المرغوب فيه، مع إعطاء أوصاف الموجّه الرئيسي الأولوية على أوصاف الموجّه السلبي هذه.
reference_image_urlsمطلوب
النوعurl[] · image
صور مرجعية للشخصية بتنسيق JPEG أو PNG أو WebP، بحد إجمالي 10 MB لجميع مراجع الشخصيات. يقتصر الدعم حاليًا على صورة واحدة؛ وتُتجاهل الصور الإضافية.
reference_mask_urlsاختياري
النوعurl[] · image
أقنعة مرجعية للشخصية بتنسيق JPEG أو PNG أو WebP؛ ولا يمكن أن يتجاوز الحجم الإجمالي عبر جميع مراجع الشخصيات 10 MB. يُستخدم قناع واحد حاليًا، وتُتجاهل الأقنعة الإضافية.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/character/remix",
  "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": 150,
    "usd": "0.15",
    "charged": 150,
    "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",
    "reference_image_urls": [
      "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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/character/remix.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt