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

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

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

## 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 في ملف تعريف الشل. إذا كان RunAPI مُهيَّأً مسبقًا في OpenClaw للدردشة، فإن المفتاح ذاته يعمل مع 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 ذاته — الفرق في وقت الحساب والدقة، لا في إصدار النموذج.

### هل يمكنني تحرير الصور الموجودة أو إعادة مزجها باستخدام 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 الاستطلاعَ تلقائيًا. لا يُحتسب على التوليدات الفاشلة.


## Links

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