---
title: "استخدام Gemini في Hermes Agent عبر RunAPI — دليل واجهة برمجة النماذج اللغوية"
url: "https://runapi.ai/ar/hermes-gemini.md"
canonical: "https://runapi.ai/ar/hermes-gemini"
locale: "ar"
model: "gemini"
---

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

يتوفر Google Gemini عبر نقطة نهاية RunAPI المتوافقة مع OpenAI. يستدعيه Hermes Agent باستخدام مزوّد custom:runapi — Gemini 3.5 Flash لحلقات الوكيل الحساسة للسرعة، وGemini 3.x Pro للاستدلال متعدد الخطوات، وGemini 2.5 Pro لمهام الإنتاج ذات السياق الطويل. لا يلزم مشروع Google Cloud أو بيانات اعتماد Vertex AI — يكفي مفتاح RUNAPI_API_KEY وbase_url اللذان هيّأتهما مسبقاً للدردشة.

## API example

```bash
curl -X POST https://runapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "messages": [
      {"role": "system", "content": "You are a concise technical assistant."},
      {"role": "user", "content": "Explain the difference between gRPC and REST in three sentences."}
    ],
    "temperature": 0.7,
    "max_tokens": 256
  }'

```

### Response

```json
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gemini-3.5-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "gRPC uses HTTP/2 and Protocol Buffers for strongly-typed, multiplexed RPC calls with built-in code generation. REST uses HTTP/1.1 (or 2) with JSON payloads and relies on URL paths and HTTP verbs for resource semantics. gRPC is faster for service-to-service calls; REST is simpler to debug and more widely supported by browsers."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 34,
    "completion_tokens": 71,
    "total_tokens": 105
  }
}

```

## How it works

1. **هيّئ RunAPI** — عيّن متغير البيئة RUNAPI_API_KEY. إن كنت قد أضفت RunAPI مسبقاً كمزوّد custom:runapi في Hermes Agent، فالمفتاح نفسه وbase_url يعملان مع Gemini — ما عليك سوى تغيير معرّف النموذج. لا حاجة لبيانات اعتماد Google Cloud.
2. **استدعِ Gemini عبر إكمال الدردشة** — أرسل طلب POST إلى /v1/chat/completions مع تعيين النموذج على gemini-3.5-flash. مرّر مصفوفة messages مع أدوار system وuser. يرسل Hermes Agent الشكل المتوافق مع OpenAI نفسه الذي يستخدمه مع GPT — يوجّه RunAPI الطلب إلى Gemini بناءً على معامل model.
3. **اقرأ الاستجابة** — تصل الاستجابة بشكل متزامن بتنسيق إكمال دردشة OpenAI. رد المساعد موجود في choices[0].message.content، واستخدام الرموز في كائن usage. للبث، عيّن stream على true ويحلّل Hermes Agent أحداث SSE delta تلقائياً.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | مطلوب. gemini-3.5-flash أو gemini-2.5-flash أو gemini-2.5-pro أو gemini-3-flash-preview أو gemini-3-pro-preview أو gemini-3.1-pro-preview. |
| `messages` | `array` | مطلوب. مصفوفة من كائنات الرسائل تحتوي على حقلَي role (system أو user أو assistant) وcontent. |
| `temperature` | `number` | اختياري. درجة حرارة أخذ العينات بين 0 و2. تنتج القيم المنخفضة مخرجات أكثر تحديداً. القيمة الافتراضية تختلف حسب النموذج. |
| `max_tokens` | `integer` | اختياري. الحد الأقصى لعدد الرموز المولَّدة في الاستجابة. |
| `stream` | `boolean` | اختياري. عند التعيين على true، تُبثّ الاستجابة كأحداث server-sent. يحتوي كل حدث على delta بمحتوى جزئي. |
| `top_p` | `number` | اختياري. عتبة أخذ عينات النواة بين 0 و1. بديل عن temperature للتحكم في عشوائية المخرجات. |

## FAQ

### هل يمكنني استخدام Google Gemini في Hermes Agent دون بيانات اعتماد Google Cloud؟

نعم. يوفّر RunAPI Gemini عبر نقطة نهايته المتوافقة مع OpenAI. هيّئ RunAPI كمزوّد custom:runapi مع base_url على https://runapi.ai/v1 وkey_env على RUNAPI_API_KEY. لا يلزم مشروع Google Cloud أو حساب خدمة أو إعداد Vertex AI.

### أي إصدار من Gemini يناسب سير عمل الوكيل؟

Gemini 3.5 Flash (gemini-3.5-flash) هو الأحدث والأسرع — الأنسب لحلقات الوكيل الفورية وسلاسل استدعاء الأدوات. يتعامل Gemini 2.5 Pro (gemini-2.5-pro) مع المهام ذات السياق الطويل والاستدلال المعقد. تتيح معاينات Gemini 3.x Pro أحدث قدرات الاستدلال بتكلفة أعلى.

### كيف يعمل تسعير Gemini على RunAPI؟

يُحسَب Gemini بالرمز على RunAPI بتسعير الدفع حسب الاستخدام. تُحتسب رموز الإدخال والإخراج بشكل منفصل. لا اشتراك شهري، ولا حد أدنى للإنفاق. راجع صفحة تسعير RunAPI للاطلاع على الأسعار الحالية لكل مليون رمز.

### هل يمكن لـ Hermes Agent التبديل بين Gemini والنماذج اللغوية الأخرى في منتصف الجلسة؟

نعم. جميع نماذج RunAPI اللغوية تشترك في المزوّد custom:runapi والمفتاح نفسه. استخدم أمر /model أو hermes model للتبديل بين gemini-3.5-flash وgpt-5.5 وclaude-opus-4.6 أو أي نموذج RunAPI آخر دون تغيير إعداد المزوّد.

### هل يدعم Gemini عبر RunAPI استدعاء الدوال واستخدام الأدوات؟

نعم. يمرّر RunAPI معاملات tools وtool_choice المتوافقة مع OpenAI إلى Gemini. عرّف الأدوات في جسم الطلب ويُعيد Gemini tool_calls في رسالة المساعد. يعالج Hermes Agent هذه الاستدعاءات بالطريقة نفسها التي يتعامل بها مع استدعاءات الأدوات من GPT أو Claude.


## Links

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