مرجع صيغة Gemini الأصلية: generateContent
مرجع صيغة Gemini الأصلية، وحقول الطلب، وإخراج JSON، واستدعاء الدوال، والبث، وتوليد الصور بنماذج Gemini للصور، والأخطاء.
في هذه الصفحة
صيغة Google الأصلية لنماذج Gemini، وهي التي تستخدمها مكتبات Gemini وأداة Gemini CLI. يوضع معرّف النموذج في العنوان لا في جسم الطلب. نماذج Gemini للمحادثة تعمل أيضًا في Chat Completions وMessages.
https:/ / 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. مدعوم أي أننا نمرّره إلى النموذج؛ ويُرفض أي أن الطلب يفشل، وهنا لأن المفتاح لمزوّد آخر.
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.
كل النماذج والأسعارهل كانت هذه الصفحة مفيدة؟