Gemini 4 Carbon

استخدم gemini-4-carbon بتنسيق Gemini الأصلي. تتضمن صفحة النموذج Playground والأسعار الحالية. يستخدم ⁦Gemini 4 Carbon⁩ تنسيق الطلب نفسه المستخدم في ⁦Gemini 4 Argon⁩؛ ويقول دليل Google إن الانتقال بينهما يتطلب تغيير معرّف النموذج فقط.

معرّف النموذج

مثال سريع

curl https://api.seedrouter.ai/v1beta/models/gemini-4-carbon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Find the race condition in a retry loop that re-reads a balance before locking it."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"medium"},"maxOutputTokens":32768}}'

يوضع النموذج في URL. الحقل contents مطلوب. تتضمن الإجابة الحقول الأصلية candidates وfinishReason وusageMetadata؛ احتفظ بأجزاء المحتوى كاملة، بما فيها thoughtSignature، في سجل المحادثة. قد تستغرق الموجّهات الصعبة عدة دقائق. قد ينتهي طلب من دون بث يستغرق أكثر من نحو 100 ثانية بالرمز ⁦HTTP 524⁩ قبل وصول الإجابة، لذا استخدم streamGenerateContent للمهام الطويلة؛ وتضبط الأمثلة أيضاً مهلة العميل على 15 دقيقة، كما توصي Google.

نقاط النهاية

تتضمن مواصفة OpenAPI جميع مخططات الطلبات والاستجابات المتداخلة. تستخدم الحقول الاختيارية قيم API الافتراضية عند حذفها. تمرّر SeedRouter جسم الطلب المرسَل من دون تصفية الحقول غير المعروفة أو إزالة الحقول غير المدعومة أو التحقق من قيم معلمات النموذج. تقرّر ⁦Gemini API⁩ قبول الطلب من عدمه.

معلمات الطلب

يحدّد URL النموذج gemini-4-carbon. تتضمن مواصفات الطلب 11 حقلاً في المستوى الأعلى. الحقول اختيارية ما لم تُعلّم بأنها مطلوبة؛ ويختلف حذف الحقل عن قيمة JSON null. يُحفظ JSON الحرّ الذي يقبل null حيث يسمح المخطط الرسمي بذلك.

لا يدعم ⁦Gemini 4 Carbon⁩ التخزين المؤقت الصريح للسياق (الموارد cachedContent وcachedContents). يُفعّل التخزين المؤقت الضمني افتراضياً للموجّهات التي تحتوي على 4,096 توكن على الأقل.

معلمات التوليد

يسرد مستند OpenAPI الأنواع المتداخلة وقيم التعداد والخصائص المطلوبة والحدود الموثّقة لكل رسالة. تصف المخططات المعلمات الرسمية؛ وليست قائمة سماح لطلبات SeedRouter. تُحفظ الحقول والقيم التي يقدّمها المستدعي. قبول المخطط لحقل لا يثبت دعمه في كل حساب. ليس minimal مستوى تفكير مدرجاً. تقول Google إن temperature وtopP وtopK تُتجاهل في هذا النموذج؛ وليس candidateCount عنصر تحكم رسمياً. عند إرسالها في JSON الأصلي، تمرّ مع ذلك من دون تغيير لتتولى ⁦Gemini API⁩ معالجتها. أنه المحادثة بمحتوى المستخدم؛ وتظل أدوار المستخدم التي تحتوي على استجابة دالة فقط صالحة.

التوليد الطويل

تعيد استجابة ⁦Gemini 4 Carbon⁩ الواحدة حتى 65,536 توكن عند البث وحتى 32,768 توكن من دون بث. لتجاوز ذلك، اضبط maxOutputTokens على أكثر من 65,536 وتولّ متابعة الإجابة بنفسك:

1. أرسل الطلب. إذا انتهت الاستجابة بالقيمة finishReason: "CONTINUATION"، فاقرأ candidates[0].continuationToken.
2. أعد إرسال الطلب نفسه مع تلك القيمة في الحقل continuationToken في المستوى الأعلى. لا تُلحق الإخراج الجزئي بـ contents؛ فالرمز يحمل حالة النموذج، بما فيها تفكيره.
3. كرّر حتى تصبح قيمة finishReason هي STOP أو MAX_TOKENS.

{
  "contents": [{"role": "user", "parts": [{"text": "Write a complete, rigorous proof of the prime number theorem."}]}],
  "generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
  "continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}

قد يعيد جزء خُصّص بالكامل للتفكير نصاً فارغاً مع CONTINUATION؛ وهذا تقدّم طبيعي. يعيد كل جزء إرسال موجّهك مع كل ما وُلّد حتى تلك اللحظة إلى النموذج، لذا تُحتسب توكنات الإدخال مجدداً في كل جزء لاحق. تُحاسب SeedRouter كل جزء كطلب مستقل. ليس وضع background على الخادم في ⁦Interactions API⁩ جزءاً من نقطة النهاية هذه.

الإخراج المنظّم

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 32768,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

لا يمكن استخدام الحقلين القديمين responseSchema وresponseJsonSchema معاً. يتطلب كلاهما responseMimeType: "application/json". يجب أن يحدّد مخطط responseFormat.text الأحدث JSON أيضاً. استخدم صيغ تعداد REST (APPLICATION_JSON وTEXT_PLAIN) في تلك الرسالة. تمرّ الطلبات من دون تغيير؛ ولا تُعاد كتابة أنواع MIME للوسائط أو JSON الحرّ للدوال.

الدوال والأدوات المضمّنة

استخدم tools[].functionDeclarations مع اسم وأحد الحقلين parameters أو parametersJsonSchema، وليس كليهما. يُضبط اختيار الدوال في toolConfig.functionCallingConfig؛ ويتطلب allowedFunctionNames الوضع ANY أو VALIDATED وأسماء معلنة.

ينفّذ تطبيقك الدوال المعادة ويقدّم نتائجها في الدور التالي من المحادثة. احتفظ بكل thoughtSignature أصلي وكل استدعاء دالة واستجابة دالة. لا تقرّب المعرّفات الرقمية عند تسلسل وسيطات الدوال المعتمة.

تدرج Google كلاً من Search وMaps وتنفيذ الشيفرة وسياق URL وFile Search وComputer Use لهذا النموذج. تتطلب موارد File Search صلاحية وصول وفق بيانات الاعتماد التي تخدم الطلب. يظهر إعداد MCP الأصلي في المخطط العام، لكن لم تُثبت إتاحته لهذا النموذج. يتطلب ⁦Google Maps⁩ إدخالاً نصياً فقط؛ راجع قيود API الرسمية قبل الجمع بين Maps والوسائط. عند الاستناد إلى المصادر، تحتسب Google تعليمات الأدوات الداخلية وتعريفات الدوال ضمن توكنات الإدخال. لا ينفّذ Playground دوالك المخصّصة.

الإدخال متعدد الوسائط والأمان

يحتوي العنصر contents[].parts[] على حمولة واحدة بالضبط: نص أو وسائط مضمّنة أو مرجع ملف أو استدعاء دالة/استجابة دالة أو جزء تنفيذ. وقد يحمل أيضاً توقيعاً أو بيانات وصفية للوسائط. يدعم الإدخال النصوص والصور والصوت والفيديو وملفات PDF؛ والإخراج نص فقط. لا يولّد النموذج صوراً أو صوتاً ولا يدعم ⁦Live API⁩.

للبايتات المضمّنة، استخدم inlineData.mimeType وdata بتنسيق base64. لمراجع الملفات، استخدم fileData.mimeType وfileUri. لا يثبت URL الصحيح الصياغة قدرة النموذج على جلبه. يمكن لبيانات الفيديو الوصفية تحديد إزاحتي البداية والنهاية وقيمة fps موجبة لا تتجاوز 24. يُختار فهم الفيديو باستخدام الوكلاء لكل جزء عبر mediaProcessing: "AGENTIC" بجانب fileData أو inlineData للفيديو؛ والمعالجة الثابتة هي الافتراضية. يحتوي videoMetadata فقط على startOffset وendOffset وfps.

تستخدم إعدادات الأمان التنسيق الأصلي الرسمي وتمرّ عبر API من دون تغيير. في Playground، يجب ضبط الفئات الأربع كلها على BLOCK_MEDIUM_AND_ABOVE أو أشد؛ والعتبات الأقل متاحة عبر API فقط.

استجابات JSON والبث

تعيد generateContent استجابة JSON بالتنسيق الأصلي. ترسل streamGenerateContent?alt=sse كائنات JSON أصلية في أحداث SSE من نوع data:. تشمل الحقول المهمة candidates[].content.parts وfinishReason وcontinuationToken وsafetyRatings وgroundingMetadata وpromptFeedback وmodelVersion وresponseId وusageMetadata.

احتفظ بالمحتوى الأصلي كاملاً في سجل المحادثة. ملخصات التفكير ليست هي توقيعات التفكير. لا يثبت انقطاع الاتصال فشل التوليد أو اكتماله؛ افحص النتيجة الجزئية وسجل الحساب قبل إرسال طلب آخر. استخدام البث تراكمي، لذا استخدم أحدث العدادات بدلاً من جمع كل جزء.

الاستخدام والأسعار

يشمل promptTokenCount الإدخال المخزّن مؤقتاً. تُحاسَب cachedContentTokenCount بسعر الإدخال المخزّن مؤقتاً، بدلاً من احتسابها مجدداً كإدخال غير مخزّن مؤقتاً. يشمل الإخراج المفوتر candidatesTokenCount إضافةً إلى thoughtsTokenCount. يستهلك ⁦Gemini 4 Carbon⁩ توكنات تفكير أكثر في كل دور من ⁦Gemini 4 Argon⁩، لذا توقّع استخدام إخراج أعلى للموجّه نفسه.

لا توجد زيادة سعرية بحسب طول السياق لهذا النموذج. Flex وPriority مستويان منفصلان للمعالجة. يجب ألا تُفرض زيادة Priority على نتيجة يُبلّغ عنها بأنها Standard؛ وإذا لم تثبت استجابة طُلبت بمستوى Priority مستواها الفعلي، تُطبّق أسعار توكنات Standard. تُحتسب رسوم الاستناد إلى مصادر ⁦Google Search⁩ وMaps لكل استعلام، بصورة منفصلة عن توكنات التوليد. لا تُفرض رسوم على الطلبات الفاشلة. راجع جدول الأسعار المباشر.

مجموعات الحساب

اختر مجموعة متاحة في Playground، أو استخدم ترويسة API الاختيارية مع اسم المجموعة المطابق تماماً:

X-SeedRouter-Group: GROUP_NAME

تحدّد المجموعة المختارة السعر والسعة المتاحة؛ ولا يتحوّل الاختيار الصريح بصمت إلى مجموعة أخرى. احذف الترويسة أو استخدم auto للحفاظ على السلوك الافتراضي لمفتاح API.

تحقّق من المجموعات المتاحة لمفتاح API من دون توليد استجابة:

curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-carbon" \
  -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

حالة التحقق

تتبع عناصر التحكم والوثائق التنسيق الأصلي الرسمي. تتولى ⁦Gemini API⁩ التحقق من المعلمات. أظهرت طلبات الإنتاج في 11 نوفمبر 2026 (محاولة واحدة لكل منها) ما يلي:

تحتاج مستويات المعالجة وmediaProcessing: "AGENTIC" ورموز المتابعة إلى فحص لاحق بعد وصول الإصدار الحالي إلى الإنتاج. لا ندّعي مقارنة مقاسة للجودة أو زمن الاستجابة مع ⁦Gemini 4 Argon⁩.

المراجع

• مواصفة النموذج من Google
• الجديد في ⁦Gemini 4 Carbon⁩
• التوليد الطويل باستخدام generateContent
• التفكير
• الأسعار
• مرجع GenerateContent REST