---
title: "استخدام Ideogram V3 في Hermes Agent عبر RunAPI — دليل واجهة برمجة الصور"
url: "https://runapi.ai/ar/hermes-ideogram-v3.md"
canonical: "https://runapi.ai/ar/hermes-ideogram-v3"
locale: "ar"
model: "ideogram-v3"
---

# استخدم Ideogram V3 في Hermes Agent.

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

## API example

```bash
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"
  }'

```

### Response

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

```

## How it works

1. **هيّئ RunAPI** — عيّن متغير البيئة RUNAPI_API_KEY في ملف تعريف الشل. إذا كان مزوّد custom:runapi مُهيَّأً مسبقًا في Hermes Agent للدردشة، فإن المفتاح ذاته يعمل مع Ideogram V3 — دون أي إعداد إضافي.
2. **استدعِ Ideogram V3** — أرسل طلب POST إلى نقطة النهاية text_to_image مع تحديد النموذج ideogram-v3-text-to-image. أدرج مطالبتك مع أي نص تريد تصييره في الصورة. اضبط style على design لأعمال الملصقات والشعارات، أو realistic للمخرجات التصويرية. استخدم rendering_speed turbo للحصول على نتائج أسرع بتكلفة أقل.
3. **احصل على النتيجة** — تُعيد الواجهة البرمجية task_id فورًا. استطلع نقطة نهاية حالة المهمة حتى تتغير الحالة إلى completed، ثم استرجع رابط الصورة الناتجة من الاستجابة. اطلب ما يصل إلى 4 صور لكل استدعاء باستخدام output_count.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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` | مطلوب لنقطتَي نهاية التحرير وإعادة المزج. رابط الصورة المصدر. |

## FAQ

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

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

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

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

### كيف أُهيّئ مزوّد custom:runapi في Hermes Agent لاستخدام 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؟

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


## Links

- [دليل إعداد Hermes Agent →](https://runapi.ai/ar/hermes-agent)
- [نماذج Ideogram V3 →](https://runapi.ai/ar/models/ideogram-v3)
- [Model catalog](https://runapi.ai/ar/models)
- [API docs](https://runapi.ai/ar/docs)