استخدم Ideogram V3 في Hermes Agent.
يولّد Ideogram V3 صورًا بتصيير نصوص رائد في الصناعة — طباعة مقروءة على الملصقات والشعارات واللافتات تعجز عنها نماذج الصور الأخرى. يوفر ثلاث نقاط نهاية (text_to_image، edit_image، remix_image) ومستوى سرعة turbo يخفّض وقت التوليد إلى النصف بتكلفة أقل. يستدعيه Hermes Agent عبر مزوّد RunAPI المخصص ومفتاح API ذاتهما المستخدمَين للدردشة، دون الحاجة إلى تثبيت إضافات إضافية.
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.
- Use the custom:runapi provider already configured in Hermes Agent.
- 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"
}
استخدم Ideogram V3 في Hermes Agent في ثلاث خطوات
هيّئ RunAPI
عيّن متغير البيئة RUNAPI_API_KEY في ملف تعريف الشل. إذا كان مزوّد custom:runapi مُهيَّأً مسبقًا في Hermes Agent للدردشة، فإن المفتاح ذاته يعمل مع 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
معاملات واجهة برمجة 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 في Hermes Agent؟
Ideogram V3 أداة التصميم العملية التي يصفها المستخدمون بـ"النقطة المثلى" لدقة الطباعة وجودة المرئيات. يستدعيه Hermes Agent عبر RunAPI custom provider لمهام التصميم في سير العمل الآلي.
حالات استخدام Ideogram V3
تصميم القمصان والبضائع
أنتج تصاميم بضائع جاهزة للطباعة بشعارات واقتباسات وعناصر نصية رسومية.
الإنتاج الدفعي للمواد التسويقية
أنشئ مجموعات مواد تسويقية — ملصقات وبطاقات اجتماعية ولافتات — بأسلوب علامة تجارية متسق.
تصميم الأيقونات والرسوم البيانية
أنتج مجموعات أيقونات ورسوماً بيانية غنية بالبيانات حيث يكون كل عنصر نصي دقيقاً.
أسئلة Ideogram V3 و Hermes Agent
صُمِّم Ideogram V3 خصيصًا لتصيير الطباعة. يستطيع إنتاج نصوص متعددة الأسطر مقروءة، وعناوين مُصمَّمة، وحروف بجودة الشعارات تفشل فيها نماذج كـ Flux أو Imagen. إذا كانت حالتك تتطلب نصوصًا دقيقة على الملصقات أو اللافتات أو ملصقات المنتجات، فإن Ideogram V3 هو الخيار الأقوى في كتالوج RunAPI.
يُولِّد turbo بأسرع وقت بنحو نصف تكلفة balanced. يُنتج quality أعلى مستوى تفاصيل لكنه يستغرق وقتًا أطول. balanced هو الخيار الوسط الافتراضي. تستخدم المستويات الثلاثة نموذج Ideogram V3 ذاته — الفرق في وقت الحساب والدقة، لا في إصدار النموذج.
أضف مزوّدًا مخصصًا بـ base_url يساوي https://runapi.ai/v1 ومفتاح RUNAPI_API_KEY في إعدادات مزوّد Hermes Agent. بعد الإعداد، استدعِ أي نقطة نهاية RunAPI — text_to_image أو edit_image أو remix_image — عبر المزوّد ذاته. شغّل hermes doctor للتحقق من الاتصال.
نعم. استخدم نقطة النهاية remix_image مع النموذج ideogram-v3-remix. مرّر source_image_url مع صورة مرجعية الأسلوب، ثم صِف التركيبة الجديدة في المطالبة. يرث المخرج الأسلوب البصري للمصدر مع اتباع مطالبة النص للمحتوى. يمكنك أيضًا ضبط style على design أو realistic أو general لتوجيه المخرج بشكل أدق.
تُحتسب كل صورة مُولَّدة بشكل منفصل. إذا ضبطت output_count على 4، يُحتسب عليك 4 صور. يعتمد سعر الصورة الواحدة على إعداد rendering_speed — يكلّف turbo نحو نصف تكلفة balanced. راجع صفحة أسعار RunAPI للاطلاع على الأسعار الحالية. لا يُحتسب على التوليدات الفاشلة.
إعداد Hermes Agent العام
لم تُهيّئه بعد؟ ابدأ بدليل إعداد RunAPI لـ Hermes Agent.
دليل إعداد Hermes Agent →كتالوج نماذج Ideogram V3
اطلع على جميع متغيرات Ideogram V3 والأسعار وتوثيق الواجهة البرمجية.
نماذج Ideogram V3 →جرّب Ideogram V3 في Hermes Agent اليوم.
احصل على مفتاح RunAPI مجاني، هيّئ مزوّد custom:runapi، وابدأ توليد الصور بطباعة دقيقة باستخدام Ideogram V3.