هل يمكنني استخدام 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.

HERMES + 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 Key اقرأ الوثائق

مفتاح API واحد · نقطة نهاية دردشة متوافقة مع OpenAI · دعم البث

Use RunAPI to send a chat request to Google Gemini 3.5 Flash through Hermes Agent.

Requirements:
- Use the custom:runapi provider already configured in Hermes Agent
- Call the RunAPI chat completions endpoint at https://runapi.ai/v1/chat/completions
- Set model to "gemini-3.5-flash"
- The RUNAPI_API_KEY environment variable provides authorization
- The response is synchronous — the reply arrives in choices[0].message.content
- For streaming, set stream to true and process server-sent events

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
  }'

{
  "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
  }
}

انسخ أمر curl للاختبار gemini

HOW IT WORKS

استخدم Gemini في Hermes Agent في ثلاث خطوات

هيّئ RunAPI

عيّن متغير البيئة RUNAPI_API_KEY. إن كنت قد أضفت RunAPI مسبقاً كمزوّد custom:runapi في Hermes Agent، فالمفتاح نفسه وbase_url يعملان مع Gemini — ما عليك سوى تغيير معرّف النموذج. لا حاجة لبيانات اعتماد Google Cloud.

export RUNAPI_API_KEY=runapi_xxx

استدعِ Gemini عبر إكمال الدردشة

أرسل طلب POST إلى /v1/chat/completions مع تعيين النموذج على gemini-3.5-flash. مرّر مصفوفة messages مع أدوار system وuser. يرسل Hermes Agent الشكل المتوافق مع OpenAI نفسه الذي يستخدمه مع GPT — يوجّه RunAPI الطلب إلى Gemini بناءً على معامل model.

POST /v1/chat/completions

اقرأ الاستجابة

تصل الاستجابة بشكل متزامن بتنسيق إكمال دردشة OpenAI. رد المساعد موجود في choices[0].message.content، واستخدام الرموز في كائن usage. للبث، عيّن stream على true ويحلّل Hermes Agent أحداث SSE delta تلقائياً.

choices[0].message.content

PARAMETERS

معاملات واجهة برمجة إكمال دردشة Gemini

المعامل	النوع	الوصف
`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 للتحكم في عشوائية المخرجات.

ما هو Gemini في Hermes Agent؟

Google Gemini متاح عبر الموفر custom:runapi من RunAPI دون أي إعداد Google Cloud. يستدعيه Hermes Agent جنباً إلى جنب مع Claude وGPT وDeepSeek في نفس إعداد سير العمل.