انتقل إلى المحتوى

مرجع صيغة Gemini الأصلية: generateContent

مرجع صيغة Gemini الأصلية، وحقول الطلب، وإخراج JSON، واستدعاء الدوال، والبث، وتوليد الصور بنماذج Gemini للصور، والأخطاء.

آخر تحديث 2 أكتوبر 2026
في هذه الصفحة

صيغة Google الأصلية لنماذج Gemini، وهي التي تستخدمها مكتبات Gemini وأداة Gemini CLI. يوضع معرّف النموذج في العنوان لا في جسم الطلب. نماذج Gemini للمحادثة تعمل أيضًا في Chat Completions وMessages.

POSThttps://api.5abeer.ai/v1beta/models/{model}:generateContent

المصادقة#

أرسل مفتاحك في الترويسة x-goog-api-key مع العنوان الأساسي لصيغة Gemini. تحتاج مفتاحًا لنماذج Gemini، فمفاتيح Claude وGPT لا تعمل تحت /v1beta. صيغ العنوان:

  • /v1beta/models/{model}:generateContent للرد الكامل.
  • /v1beta/models/{model}:streamGenerateContent?alt=sse للرد المتدفق.
  • /v1beta/models/{model}:countTokens لعدّ توكنات الإدخال دون استدعاء النموذج.

مثال سريع#

curl --request POST "https://api.5abeer.ai/v1beta/models/gemini-4-argon:generateContent" \
  --header "x-goog-api-key: $KHABEER_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"contents":[{"role":"user","parts":[{"text":"اكتب فكرة منتج في سطر واحد"}]}]}'
الرد
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "مرحبًا! كيف أساعدك اليوم؟"
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "modelVersion": "gemini-4-argon"
}

المفتاح يُقرأ من متغير البيئة ⁦KHABEER_API_KEY⁩، فلا يظهر في الكود.

المعاملات#

يمرّ طلبك بصيغة Gemini كما هو، فتعمل الحقول أدناه كما في وثائق Google. مدعوم أي أننا نمرّره إلى النموذج؛ ويُرفض أي أن الطلب يفشل، وهنا لأن المفتاح لمزوّد آخر.

المعاملالوصفClaudeGPTGemini
contentsarrayمطلوبالمحادثة: أدوار user وmodel، وكل دور فيه parts من نص أو صورة.ClaudeيُرفضGPTيُرفضGeminiمدعوم
systemInstructionobjectتعليمات النظام في parts.ClaudeيُرفضGPTيُرفضGeminiمدعوم
generationConfigobjectإعدادات الإخراج: temperature وtopP وtopK وmaxOutputTokens وstopSequences وresponseMimeType وresponseSchema وthinkingConfig وresponseModalities.ClaudeيُرفضGPTيُرفضGeminiمدعوم
toolsarrayfunctionDeclarations للدوال التي يستطيع النموذج استدعاءها.ClaudeيُرفضGPTيُرفضGeminiمدعوم
toolConfigobjectمتى يستدعي النموذج الدوال: AUTO أو ANY أو NONE.ClaudeيُرفضGPTيُرفضGeminiمدعوم
safetySettingsarrayعتبات تصفية المحتوى لكل فئة.ClaudeيُرفضGPTيُرفضGeminiمدعوم

توليد الصور#

تولّد نماذج Gemini للصور الصور عبر العنوان نفسه: أضف "responseModalities": ["TEXT", "IMAGE"] إلى generationConfig، فتصلك الصورة في inlineData ببيانات Base64، كما في مثال توليد الصورة. تجد نماذج الصور في قائمة نماذج صفحة توليد الصور.

البث المتدفق#

استدعِ :streamGenerateContent?alt=sse بدلًا من :generateContent. كل حدث رد جزئي بالشكل نفسه للرد الكامل، وآخر حدث يحمل usageMetadata. التفاصيل في البث المتدفق.

أمثلة#

تعليمات وإعدادات وإخراج JSON#

curl https://api.5abeer.ai/v1beta/models/gemini-3.1-pro:generateContent \
  -H "x-goog-api-key: $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "systemInstruction": {
      "parts": [
        {
          "text": "Answer in one sentence."
        }
      ]
    },
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Give me one product idea."
          }
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.4,
      "topP": 0.9,
      "topK": 40,
      "maxOutputTokens": 300,
      "stopSequences": [
        "END"
      ],
      "responseMimeType": "application/json",
      "responseSchema": {
        "type": "OBJECT",
        "properties": {
          "idea": {
            "type": "STRING"
          }
        },
        "required": [
          "idea"
        ]
      }
    },
    "safetySettings": [
      {
        "category": "HARM_CATEGORY_HARASSMENT",
        "threshold": "BLOCK_MEDIUM_AND_ABOVE"
      }
    ]
  }'
شكل الرد
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "{\"idea\":\"Lumen Notes: a notebook that turns voice memos into tidy to-do lists.\"}"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 21,
    "candidatesTokenCount": 18,
    "totalTokenCount": 39
  },
  "modelVersion": "gemini-3.1-pro"
}

استدعاء دالة#

curl https://api.5abeer.ai/v1beta/models/gemini-3.1-pro:generateContent \
  -H "x-goog-api-key: $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "What is the weather in Cairo?"
          }
        ]
      }
    ],
    "tools": [
      {
        "functionDeclarations": [
          {
            "name": "get_weather",
            "description": "Get the weather for a city",
            "parameters": {
              "type": "OBJECT",
              "properties": {
                "city": {
                  "type": "STRING"
                }
              },
              "required": [
                "city"
              ]
            }
          }
        ]
      }
    ],
    "toolConfig": {
      "functionCallingConfig": {
        "mode": "AUTO"
      }
    }
  }'
شكل الرد
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "functionCall": {
              "name": "get_weather",
              "args": {
                "city": "Cairo"
              }
            }
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 21,
    "candidatesTokenCount": 18,
    "totalTokenCount": 39
  },
  "modelVersion": "gemini-3.1-pro"
}

بث متدفق#

curl -N https://api.5abeer.ai/v1beta/models/gemini-3.1-pro:streamGenerateContent?alt=sse \
  -H "x-goog-api-key: $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Write a product idea in one sentence."
          }
        ]
      }
    ]
  }'
أحداث البث
data: {"candidates":[{"content":{"role":"model","parts":[{"text":"Lumen Notes: a notebook that turns "}]},"index":0}],"modelVersion":"gemini-3.1-pro"}

data: {"candidates":[{"content":{"role":"model","parts":[{"text":"voice memos into tidy to-do lists."}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":21,"candidatesTokenCount":18,"totalTokenCount":39},"modelVersion":"gemini-3.1-pro"}

توليد صورة#

curl https://api.5abeer.ai/v1beta/models/gemini-2.5-flash-image:generateContent \
  -H "x-goog-api-key: $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "A minimal orange logo for a note-taking app."
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": [
        "TEXT",
        "IMAGE"
      ]
    }
  }'
شكل الرد
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Here is the logo."
          },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
            }
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 21,
    "candidatesTokenCount": 18,
    "totalTokenCount": 39
  },
  "modelVersion": "gemini-2.5-flash-image"
}

الطلب أعلاه جُرِّب على بيئة الاختبار المحلية يوم 2026-10-02؛ الرد يوضح الشكل، والنص فيه مثال.

الأخطاء#

الأخطاء التي تظهر أثناء تنفيذ الطلب تصلك بشكل Google: error وفيه code رقمي وmessage وstatus مثل INVALID_ARGUMENT أو RESOURCE_EXHAUSTED. أما فحوص المفتاح والرصيد والحدود فتجيب بـ {"code", "message"} برموز مثل INVALID_API_KEY وUSAGE_LIMIT_EXCEEDED. الجدول الكامل في الحدود ورموز الأخطاء.

النماذج#

لكل مليون توكن
  • Gemini 4 Argonالإدخال‏30 ج.م‏الإخراج‏150 ج.م‏السياق—
  • Gemini 2.5 Proالإدخال‏18.75 ج.م‏الإخراج‏150 ج.م‏السياق1M
  • Gemini 3.8 Flashالإدخال‏11.25 ج.م‏الإخراج‏56.25 ج.م‏السياق—
  • Gemini 3 Flashالإدخال‏7.50 ج.م‏الإخراج‏45 ج.م‏السياق1M
  • Gemini 3.1 Proالإدخال‏30 ج.م‏الإخراج‏180 ج.م‏السياق1M
  • Gemini 3.1 Flash Image (Nano Banana 2)الإدخال—الإخراج—السياق64K

السعر الرسمي من صفحة المزوّد، بتاريخ 19 أكتوبر 2026.

كل النماذج والأسعار