كيف يتعامل Ideogram V3 مع النصوص في الصور مقارنةً بالنماذج الأخرى؟

صُمِّم Ideogram V3 خصيصًا لتصيير الطباعة. يستطيع إنتاج نصوص متعددة الأسطر مقروءة، وعناوين مُصمَّمة، وحروف بجودة الشعارات تفشل فيها نماذج كـ Flux أو Imagen. إذا كانت حالتك تتطلب نصوصًا دقيقة على الملصقات أو اللافتات أو ملصقات المنتجات، فإن Ideogram V3 هو الخيار الأقوى في كتالوج RunAPI.

ما الفرق بين سرعات التصيير turbo وbalanced وquality؟

يُولِّد turbo بأسرع وقت بنحو نصف تكلفة balanced. يُنتج quality أعلى مستوى تفاصيل لكنه يستغرق وقتًا أطول. balanced هو الخيار الوسط الافتراضي. تستخدم المستويات الثلاثة نموذج Ideogram V3 ذاته — الفرق في وقت الحساب والدقة، لا في إصدار النموذج.

هل يمكنني تحرير الصور الموجودة أو إعادة مزجها باستخدام Ideogram V3؟

نعم. استخدم نقطة النهاية edit_image مع ideogram-v3-edit لتعديل صورة مصدر بتوجيه من مطالبة نصية. استخدم نقطة النهاية remix_image مع ideogram-v3-remix لنقل أسلوب صورة مصدر إلى تركيبة جديدة. كلتاهما تتطلب source_image_url كمعامل.

كيف يعمل التسعير لكل صورة مع output_count؟

تُحتسب كل صورة مُولَّدة بشكل منفصل. إذا ضبطت output_count على 4، يُحتسب عليك 4 صور. يعتمد سعر الصورة الواحدة على إعداد rendering_speed — يكلّف turbo نحو نصف تكلفة balanced. راجع صفحة أسعار RunAPI للاطلاع على الأسعار الحالية.

هل Ideogram V3 غير متزامن أم متزامن؟

غير متزامن. تُعيد الواجهة البرمجية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تكتمل. تتولى حزم RunAPI SDK وأداة CLI الاستطلاعَ تلقائيًا. لا يُحتسب على التوليدات الفاشلة.

OPENCLAW + IDEOGRAM V3

استخدم Ideogram V3 في OpenClaw.

يولّد Ideogram V3 صورًا بتصيير نصوص رائد في الصناعة — طباعة مقروءة على الملصقات والشعارات واللافتات تعجز عنها نماذج الصور الأخرى. يوفر ثلاث نقاط نهاية (text_to_image، edit_image، remix_image) ومستوى سرعة turbo يخفّض وقت التوليد إلى النصف بتكلفة أقل. تستدعيه وكلاء OpenClaw عبر مفتاح RunAPI ونقطة النهاية /v1 ذاتهما المستخدمَين للدردشة، دون الحاجة إلى تثبيت مهارات إضافية.

احصل على API Key اقرأ الوثائق

مفتاح API واحد · توليد يُولي الطباعة الأولوية · مستوى سرعة turbo

Use RunAPI to generate an image with accurate text rendering using Ideogram V3.

Requirements:
- Use the RunAPI API at https://runapi.ai/v1/text_to_image.
- Read the API key from RUNAPI_API_KEY environment variable.
- Set the model to "ideogram-v3-text-to-image".
- Write a prompt that includes specific text you want rendered in the image.
- Optionally set rendering_speed to turbo for faster generation, or quality for best results.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the output URL.

curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram-v3-text-to-image",
    "prompt": "A minimalist cafe menu poster, cream background, the text FRESH BREWED written in elegant serif font at the top, three coffee cup illustrations below, warm earth tones",
    "style": "design",
    "aspect_ratio": "3:4",
    "rendering_speed": "balanced"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "ideogram-v3-text-to-image"
}

انسخ أمر curl للاختبار ideogram-v3

HOW IT WORKS

استخدم Ideogram V3 في OpenClaw في ثلاث خطوات

هيّئ RunAPI

عيّن متغير البيئة RUNAPI_API_KEY في ملف تعريف الشل. إذا كان RunAPI مُهيَّأً مسبقًا في OpenClaw للدردشة، فإن المفتاح ذاته يعمل مع Ideogram V3 — دون أي إعداد إضافي.

export RUNAPI_API_KEY=runapi_xxx

استدعِ Ideogram V3

أرسل طلب POST إلى نقطة النهاية text_to_image مع تحديد النموذج ideogram-v3-text-to-image. أدرج مطالبتك مع أي نص تريد تصييره في الصورة. اضبط style على design لأعمال الملصقات والشعارات، أو realistic للمخرجات التصويرية. استخدم rendering_speed turbo للحصول على نتائج أسرع بتكلفة أقل.

POST /v1/text_to_image

احصل على النتيجة

تُعيد الواجهة البرمجية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تتغير الحالة إلى completed، ثم استرجع رابط الصورة الناتجة من الاستجابة. اطلب ما يصل إلى 4 صور لكل استدعاء باستخدام output_count.

task_id: tsk_abc123

PARAMETERS

معاملات واجهة برمجة Ideogram V3

المعامل	النوع	الوصف
`model`	`string`	مطلوب. ideogram-v3-text-to-image أو ideogram-v3-edit أو ideogram-v3-remix.
`prompt`	`string`	وصف نصي للصورة المطلوبة. أدرج النص المحدد الذي تريد تصييره.
`style`	`string`	اختياري. auto أو general أو realistic أو design. استخدم design للملصقات والشعارات.
`rendering_speed`	`string`	اختياري. turbo (الأسرع، أقل تكلفة) أو balanced (الافتراضي) أو quality (أعلى تفاصيل).
`aspect_ratio`	`string`	اختياري. 1:1 أو 3:4 أو 9:16 أو 4:3 أو 16:9.
`output_count`	`integer`	اختياري. عدد الصور المُولَّدة لكل طلب. من 1 إلى 4.
`source_image_url`	`string`	مطلوب لنقطتَي نهاية التحرير وإعادة المزج. رابط الصورة المصدر.

ما هو Ideogram V3 في OpenClaw؟

Ideogram V3 النموذج الذي يصفه المستخدمون بـ"تغيير قواعد اللعبة" للطباعة في الصور المُولَّدة. يعرض النص بدقة في التركيبات المعقدة. تستدعيه وكلاء OpenClaw عبر RunAPI للتصاميم التي تجمع النص والمرئيات.