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

# استخدم Nano Banana في OpenClaw.

Nano Banana هو نموذج توليد الصور المدعوم بـ Gemini من Google، ويتميّز بتصيير نصوص رائد في الصور المولَّدة. يُنتج Pro دقةً تصل إلى 4K، ويُحسّن Nano Banana 2 السرعةَ مع نسب عرض موسَّعة، فيما يُعدّل Edit الصور القائمة. تستدعي وكلاء OpenClaw المتغيرات الثلاثة عبر مفتاح RunAPI واحد ونقطة نهاية واحدة.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/nano_banana/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A minimalist product card for a coffee brand, the text DARK ROAST in bold sans-serif across the top, a steaming cup below, warm studio lighting",
    "aspect_ratio": "4:3",
    "output_resolution": "4k",
    "output_format": "png"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "nano-banana-pro"
}

```

## How it works

1. **هيّئ RunAPI** — عيّن متغير البيئة RUNAPI_API_KEY. إن كنت قد هيّأت RunAPI مزوّدًا في OpenClaw للمحادثة، فالمفتاح ذاته يعمل مع توليد صور Nano Banana.
2. **استدعِ Nano Banana** — أرسل طلب POST إلى نقطة نهاية text_to_image مع تعيين النموذج إلى nano-banana-pro للجودة الأعلى، أو nano-banana-2 للسرعة، أو nano-banana للمتغير الأساسي. عيّن output_resolution إلى 4k في Pro أو 2 للحصول على أقصى تفاصيل. للتعديل، أرسل POST إلى edit_image مع nano-banana-edit وأضف image_url.
3. **احصل على النتيجة** — تتضمّن الاستجابة task_id. استطلع نقطة نهاية حالة المهمة حتى تتغير الحالة إلى completed. تحتوي الاستجابة النهائية على رابط الصورة المولَّدة. تتولى حزم SDK وواجهة سطر أوامر RunAPI الاستطلاعَ تلقائيًا.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | مطلوب. nano-banana-pro (أعلى جودة، 4K)، أو nano-banana-2 (سريع، نسب عرض موسَّعة)، أو nano-banana (أساسي)، أو nano-banana-edit (للتعديل). |
| `prompt` | `string` | وصف نصي للصورة المطلوبة. أدرج أي نص تريد تصييره في الصورة — يتعامل Nano Banana مع الطباعة بصورة أصيلة. |
| `image_url` | `string` | رابط الصورة المصدر. مطلوب لـ nano-banana-edit، ويُتجاهل في متغيرات text_to_image. |
| `aspect_ratio` | `string` | اختياري. نسبة عرض المخرج. يقبل Pro: 1:1، 2:3، 3:2، 3:4، 4:3، 4:5، 5:4، 9:16، 16:9، 21:9، auto. يضيف Nano Banana 2: 1:4، 1:8، 4:1، 8:1. |
| `output_resolution` | `string` | اختياري. لـ Pro و2 فقط. القيم المقبولة: 1k، 2k، 4k. الافتراضي 1k. |
| `output_format` | `string` | اختياري. صيغة ملف المخرج. القيم المقبولة: png، jpeg، jpg. |
| `callback_url` | `string` | اختياري. رابط webhook يستقبل طلب POST عند اكتمال المهمة. |

## FAQ

### ما الفرق بين Nano Banana Pro و2 والمتغير الأساسي؟

يُقدّم Nano Banana Pro أعلى جودة للصور بدقة تصل إلى 4K. يتميّز Nano Banana 2 بالسرعة ويدعم نسب عرض إضافية كـ 1:4 و8:1 للبانرات والتصاميم الطولية. أما المتغير الأساسي nano-banana فهو الأقل تكلفةً بدقة قياسية. تشترك الثلاثة في نقطة نهاية text_to_image ذاتها.

### هل يستطيع Nano Banana تصيير نصوص مقروءة داخل الصور المولَّدة؟

نعم. صُمِّم Nano Banana خصيصًا لتصيير النصوص بدقة في الصور. أدرج الكلمات التي تريدها في المطالبة — يتولى النموذج توضعَ الخط وقراءته بصورة أصيلة، خلافًا لمعظم نماذج الانتشار التي تُشوّه الحروف.

### كيف يعمل تسعير مخرجات Nano Banana بدقة 4K؟

يتفاوت تسعير Nano Banana Pro بحسب output_resolution: دقتا 1k و2k بالسعر ذاته، بينما تكلّف 4k أكثر لكل صورة. يتبع Nano Banana 2 هيكلًا مماثلًا. راجع صفحة تسعير RunAPI للأسعار الدقيقة لكل صورة. لا يوجد حد أدنى شهري.

### هل يمكنني تعديل الصور القائمة باستخدام Nano Banana في OpenClaw؟

نعم. استخدم النموذج nano-banana-edit مع نقطة نهاية edit_image. مرّر الصورة المصدر عبر image_url وصف التغييرات المطلوبة في المطالبة. يدعم متغير التعديل التعديلاتِ المدركة للنص، فتستطيع إضافة تراكبات نصية أو تغييرها في الصور الموجودة.

### هل Nano Banana غير متزامن أم متزامن؟

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


## Links

- [دليل إعداد OpenClaw →](https://runapi.ai/ar/openclaw)
- [نماذج Nano Banana →](https://runapi.ai/ar/models/nano-banana)
- [Model catalog](https://runapi.ai/ar/models)
- [API docs](https://runapi.ai/ar/docs)