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

Ideogram · v3 · Layerize Text

التكامل

معرّف النموذج ideogram/v3/layerize-text
# 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/v3/layerize-text?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

الحصول على مفتاح API
Ideogram · صورة

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

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

إنشاء طلب

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

موجّه اختياري يوجّه التحويل إلى طبقات.

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

URL لصورة رسومية مسطحة لتحويلها إلى طبقات. التنسيقات المقبولة هي JPEG وPNG وWebP؛ والحد الأقصى لحجم الملف 10 MB.

متقدم font_file_h1_url · font_name_h1 · font_file_h2_url · font_name_h2 · font_file_body_url · font_name_body · font_file_small_url · font_name_small · seed

URL لملف الخط لنص h1؛ لا يمكن استخدامه مع font_name_h1.

اسم الخط لنص h1؛ لا يمكن استخدامه مع font_file_h1_url.

URL لملف الخط لنص h2؛ لا يمكن استخدامه مع font_name_h2.

اسم الخط لنص h2؛ لا يمكن استخدامه مع font_file_h2_url.

URL لملف الخط للنص الأساسي؛ لا يمكن استخدامه مع font_name_body.

اسم الخط للنص الأساسي؛ لا يمكن استخدامه مع font_file_body_url.

URL لملف الخط للنص الصغير؛ لا يمكن استخدامه مع font_name_small.

اسم الخط للنص الصغير؛ لا يمكن استخدامه مع font_file_small_url.

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

POST /run/ideogram/v3/layerize-text?wait=20 عرض السعر → ⁨‏0.09 $⁩
# 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/v3/layerize-text?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Ideogram · v3 · Layerize Text

يأخذ رسمًا مسطحًا (`image_url`، بصيغة JPEG أو PNG أو WebP، وبحجم يصل إلى 10MB) ويعيد الخلفية بعد إزالة النص، وطبقات الصور المستخرجة، وحاويات نصية منظمة، وHTML تراكبيًا لإعادة التركيب. يمكن تعيين الخطوط لـ h1 وh2 والنص الأساسي والنص الصغير بالاسم أو عبر عنوان URL لملف. يُقبل اختياريًا `prompt` و`seed`.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
URL لصورة رسومية مسطحة لتحويلها إلى طبقات. التنسيقات المقبولة هي JPEG وPNG وWebP؛ والحد الأقصى لحجم الملف 10 MB.
promptاختياري
النوعstring | null
موجّه اختياري يوجّه التحويل إلى طبقات.
seedاختياري
النوعinteger | null
البذرة المستخدمة بواسطة مولّد الأرقام العشوائية.
font_file_h1_urlاختياري
النوعstring | null
URL لملف الخط لنص h1؛ لا يمكن استخدامه مع font_name_h1.
font_name_h1اختياري
النوعstring | null
اسم الخط لنص h1؛ لا يمكن استخدامه مع font_file_h1_url.
font_file_h2_urlاختياري
النوعstring | null
URL لملف الخط لنص h2؛ لا يمكن استخدامه مع font_name_h2.
font_name_h2اختياري
النوعstring | null
اسم الخط لنص h2؛ لا يمكن استخدامه مع font_file_h2_url.
font_file_body_urlاختياري
النوعstring | null
URL لملف الخط للنص الأساسي؛ لا يمكن استخدامه مع font_name_body.
font_name_bodyاختياري
النوعstring | null
اسم الخط للنص الأساسي؛ لا يمكن استخدامه مع font_file_body_url.
font_file_small_urlاختياري
النوعstring | null
URL لملف الخط للنص الصغير؛ لا يمكن استخدامه مع font_name_small.
font_name_smallاختياري
النوعstring | null
اسم الخط للنص الصغير؛ لا يمكن استخدامه مع font_file_small_url.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3/layerize-text",
  "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": 90,
    "usd": "0.09",
    "charged": 90,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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
    },
    "prompt": "string",
    "text_containers": [
      {}
    ],
    "text_html": "string",
    "image_layers": [
      {}
    ],
    "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
image
object {url, content_type, file_name, file_size}صورة الخلفية بعد إزالة نصها.
prompt
stringيحتوي على موجّه تقسيم الطبقات بعد أي توسعة بواسطة MagicPrompt، لذلك قد لا يطابق المدخل الأصلي.
text_containers
array of object | nullحاويات نصية منظمة في تسلسل هرمي من الحاويات والعناصر والمقاطع.
text_html
string | nullطبقة HTML متراكبة مُصيّرة تُستخدم لتركيب النص فوق صورة الخلفية.
image_layers
array of objectطبقات الصورة المفصولة عن التصميم.
seed
integerقيمة البذرة المستخدمة لتوليد الأرقام العشوائية.

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

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