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

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

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

## 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 مزوّدًا custom:runapi في Hermes Agent للمحادثة، فالمفتاح ذاته وbase_url يعملان مع توليد صور 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 ذاتها.

### كيف أنتقل بين توليد النص إلى صورة وتعديل الصور في Hermes Agent؟

لتوليد النص إلى صورة، أرسل POST إلى /api/v1/nano_banana/text_to_image مع أي متغير توليد (nano-banana-pro أو nano-banana-2 أو nano-banana). للتعديل، أرسل POST إلى /api/v1/nano_banana/edit_image مع النموذج nano-banana-edit وأضف image_url المصدر. يستخدم نقطتا النهاية المزوّد custom:runapi ذاته وRUNAPI_API_KEY.

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

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

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

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

### هل يحتاج Hermes Agent إلى ComfyUI أو GPU لاستخدام Nano Banana؟

لا. يستدعي Hermes Agent نموذج Nano Banana عبر نقطة نهاية المزوّد custom:runapi في RunAPI. يتولى RunAPI جميع بنية GPU التحتية من جانب الخادم. لا حاجة إلى سير عمل ComfyUI، ولا استئجار GPU سحابي، ولا اشتراطات VRAM محلية — أرسل مطالبة واستلم رابط الصورة.


## Links

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