Claude Opus 5.5 متاح الآن على SeedRouter

Text

Gemini 4 Neon

View Markdown

طلبات Gemini الأصلية وأربعة مستويات للتفكير والتوليد الطويل برموز المتابعة والأدوات والإدخال متعدد الوسائط والبث. يشمل حدود النموذج وحالة التحقق.

استخدم gemini-4-neon بتنسيق Gemini الأصلي. تتضمن صفحة النموذج Playground والأسعار الحالية. يقع Gemini 4 Neon بين Gemini 4 Hydrogen وGemini 4 Carbon ويستخدم تنسيق طلب generateContent الأصلي نفسه؛ ويذكر دليل الترحيل من Google أن الانتقال بين نماذج Gemini 4 لا يتطلب أي تغييرات في مخطط الطلب.

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

معرّف النموذجنافذة السياقالجهد الافتراضي
gemini-4-neon1,048,576 توكن، مشتركة بين الإدخال والتفكير والإخراجhigh

استخدم gemini-4-neon لفئة Default، أو اختر فئة gemini-4-neon:GROUP_NAME صريحة يعيدها اكتشاف النماذج. تحقّق من الفئات المتاحة لك قبل إرسال الطلبات.

مثال سريع

curl https://api.seedrouter.ai/v1beta/models/gemini-4-neon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Audit this payment retry queue for race conditions and propose lock acquisition steps."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"high"},"maxOutputTokens":65536}}'

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

نقاط النهاية

العمليةنقطة النهاية
استجابة JSONPOST /v1beta/models/gemini-4-neon:generateContent
أحداث مرسلة من الخادمPOST /v1beta/models/gemini-4-neon:streamGenerateContent?alt=sse

تتضمن مواصفات OpenAPI جميع مخططات الطلبات والاستجابات المتداخلة. تستخدم الحقول الاختيارية إعدادات API الافتراضية عند حذفها. تحافظ API العامة بالتنسيق الأصلي على جسم الطلب المرسل ليجري Gemini التحقق منه. ويتحقق Playground أيضاً من القيود الموثّقة قبل الإرسال ويفرض إعدادات الأمان الخاصة به.

معلمات الطلب

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

الحقلالنوعمطلوبالقيمة الافتراضية والقيود
contentsobject[]نعممحادثة غير فارغة؛ يحتوي كل محتوى على parts غير فارغة
systemInstructionobjectلاأجزاء نصية فقط؛ لا تُدرج هوية المستخدم تلقائياً
generationConfigobjectلامعلمات التوليد في الجدول التالي
toolsobject[]لاتعريفات الدوال وإعدادات الأدوات المدمجة
toolConfigobjectلاإعدادات اختيار الدوال والاسترجاع
safetySettingsobject[]لاإعداد واحد لكل فئة؛ دون فئات مكررة
serviceTierstringلاunspecified وstandard وflex وpriority؛ المعالجة العادية هي standard
continuationTokenstringلارمز يُعاد مع finishReason: CONTINUATION أو MAX_TOKENS؛ أعد إرسال الطلب نفسه معه لمتابعة إجابة طويلة
labelsobjectلاقيم نصية؛ مفاتيح/قيم بأحرف صغيرة، بحد أقصى 63 نقطة ترميز Unicode لكل منها
modelstringلااسم مورد اختياري؛ يحدّد URL النموذج الفعلي
storebooleanلاتفضيل عام لتخزين الطلب؛ التأثير الخاص بالنموذج غير متحقق منه

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

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

الحقل في generationConfigالنوعالقيمة الافتراضية والقيود
maxOutputTokensintegerالافتراضي 65,536، بما يشمل التفكير. حتى 1,048,576 ناقص الإدخال مع المتابعة. تدعم كل استجابة بث أو دون بث ما يصل إلى 65,536 توكن؛ استخدم المتابعة للإخراج الأطول
thinkingConfigobjectthinkingLevel: القيم low وmedium وhigh وxhigh (الافتراضي high)؛ تُقبل الكتابة بالأحرف الكبيرة. includeThoughts: قيمة boolean، الافتراضي false. استخدم thinkingLevel؛ يُربط thinkingBudget المهجور بمستوى عند تقديمه منفرداً مع تحذير، ولا يمكن جمعه مع thinkingLevel
stopSequencesstring[]خمس سلاسل كحد أقصى
responseMimeTypestringالافتراضي text/plain؛ يتطلب إخراج مخطط JSON القديم application/json
responseSchemaobjectلهجة المخطط الرسمية؛ لا يمكن جمعه مع responseJsonSchema
responseJsonSchemaJSONJSON Schema؛ لا يمكن جمعه مع responseSchema
responseFormatobjectإعدادات تنسيق النص؛ text.mimeType وtext.schema الاختياري. يتطلب المخطط نوع MIME خاصاً بـ JSON
responseModalitiesstring[]نص فقط: TEXT؛ القيمة الفارغة تعني نصاً
mediaResolutionenumMEDIA_RESOLUTION_UNSPECIFIED وLOW وMEDIUM وHIGH مع البادئة MEDIA_RESOLUTION_
seedintegerقيمة 32 بت بإشارة؛ السلوك الحتمي الخاص بالنموذج غير متحقق منه
presencePenaltynumberحقل عام؛ التأثير/النطاق الخاص بالنموذج غير متحقق منه
frequencyPenaltynumberحقل عام؛ التأثير/النطاق الخاص بالنموذج غير متحقق منه
responseLogprobsbooleanحقل عام؛ التوفّر الخاص بالنموذج غير متحقق منه
logprobsinteger0–20؛ يتطلب responseLogprobs: true؛ دعم النموذج غير متحقق منه
enableEnhancedCivicAnswersbooleanحقل عام؛ دعم النموذج غير متحقق منه
enableAffectiveDialogbooleanحقل عام؛ دعم النموذج غير متحقق منه
audioTranscriptionConfigobjectحقل عام؛ الخيارات الخاصة بالنموذج غير متحقق منها
translationConfigobjectحقل عام؛ الخيارات الخاصة بالنموذج غير متحقق منها

تسرد وثيقة OpenAPI الأنواع المتداخلة والتعدادات والخصائص المطلوبة والحدود الموثّقة لكل رسالة، بما في ذلك audioMetadata وdocumentMetadata وspreadsheetMetadata وvideoMetadata.contentLayers من مواصفات اكتشاف v1beta. تصف المخططات المعلمات الرسمية؛ وليست قائمة سماح لطلبات SeedRouter. يُحافَظ على الحقول والقيم التي يقدّمها المستدعي. قبول المخطط لحقل ليس دليلاً على دعمه لكل حساب. مستوى التفكير minimal ليس ضمن المستويات المدرجة. تذكر Google أن temperature وtopP وtopK وcandidateCount مهجورة وينبغي إزالتها؛ وتُتجاهل قيم أخذ العينات المخصّصة الواقعة ضمن النطاق، بينما تعيد القيم الخارجة عن النطاق الرمز 400. إذا أُرسلت في JSON الأصلي، فإنها تظل تمرّ دون تغيير لتتعامل معها Gemini API.

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

تعيد استجابة Gemini 4 Neon الواحدة ما يصل إلى 65,536 توكن مع البث وما يصل إلى 65,536 توكن دون البث. لتجاوز ذلك، اضبط maxOutputTokens على قيمة أعلى من 65,536 وتابع الإجابة بنفسك:

  1. أرسل الطلب. إذا انتهت الاستجابة بالقيمة finishReason: "CONTINUATION"، فاقرأ candidates[0].continuationToken.
  2. أعد إرسال الطلب نفسه مع وضع تلك القيمة في حقل continuationToken على المستوى الأعلى. لا تُلحِق الإخراج الجزئي بـ contents؛ فالرمز يحمل حالة النموذج، بما فيها تفكيره.
  3. كرّر حتى تصبح قيمة finishReason هي STOP أو MAX_TOKENS. إذا وصل استدعاء إلى MAX_TOKENS وأعاد continuationToken، فلا يمكنك الاستئناف إلا بزيادة maxOutputTokens؛ أما تكرار الحد نفسه فيعيد 400 INVALID_ARGUMENT.
{
  "contents": [{"role": "user", "parts": [{"text": "Generate a complete multi-module migration specification and verification checklist for this payment service."}]}],
  "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": 65536,
    "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 وأسماءً معرّفة. لا تطلب من النموذج عبر تعليمات النظام إصدار استدعاءات أدوات JSON كنص خام دون أدوات معرّفة، إذ قد يعيد ذلك MALFORMED_FUNCTION_CALL.

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

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

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

يحتوي عنصر contents[].parts[] على حمولة واحدة بالضبط: نص أو وسائط مضمّنة أو مرجع ملف أو استدعاء/استجابة دالة أو جزء تنفيذ. وقد يحمل أيضاً توقيعاً أو بيانات وصفية للوسائط (videoMetadata وaudioMetadata وdocumentMetadata وspreadsheetMetadata وmediaResolution وmediaProcessing). يدعم الإدخال النصوص والصور والصوت والفيديو وملفات PDF؛ والإخراج نصي فقط. لا يولّد النموذج صوراً أو صوتاً وليس لديه Live API.

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

تستخدم إعدادات الأمان التنسيق الأصلي الرسمي وتمرّ عبر 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 Neon مستوى التفكير high افتراضياً. اضبط المستوى صراحةً عند مقارنة استخدامه بنموذج آخر.

لا توجد زيادة سعرية بحسب طول السياق لهذا النموذج. تستخدم أسعار SeedRouter الحالية أسعار توكنات Standard؛ ولم تُضبط خصومات Flex ورسوم Priority الإضافية لهذا التكامل. لا يزال دعم فئات المعالجة تلك بحاجة إلى تحقق. قد يضيف الاستناد إلى Google Search رسوماً لكل استعلام تتجاوز استخدام التوكنات؛ تحقّق من أسعار الأدوات قبل تفعيله. لا تُفرض رسوم على الطلبات الفاشلة. راجع جدول الأسعار الحالي.

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

تستخدم فئة Default معرّف النموذج المجرّد gemini-4-neon. تستخدم الفئات الإضافية gemini-4-neon:GROUP_NAME في URL. يختار Playground فئة متاحة؛ وتقبل API أيضاً ترويسة صريحة:

X-SeedRouter-Group: GROUP_NAME

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

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

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

حالة التحقق

فُحصت الوثائق الرسمية ومراجعة اكتشاف REST رقم 20261119 في 20 نوفمبر 2026. وفي ذلك التاريخ، أكّد اكتشاف النماذج للقراءة فقط (GET /v1/models) واكتشاف المجموعات (GET /api/seedrouter/llm/groups?model=gemini-4-neon) والأسعار العامة (GET /v1/pricing) كلاً من فئة Default gemini-4-neon والفئة الصريحة gemini-4-neon:googlellm-vertext. كما اكتملت ثلاثة استدعاءات فحص مدفوعة بمحاولة واحدة عبر api.seedrouter.ai برمز HTTP 200: توليد JSON بتفكير low على Default (54 توكن موجّه و28 توكن إخراج و39 توكن تفكير)، وبث SSE بتفكير xhigh على Default (50 توكن موجّه و13 توكن إخراج و207 توكن تفكير)، واستدعاء functionCall مُعلَن بتفكير low على gemini-4-neon:googlellm-vertext (95 توكن موجّه و22 توكن إخراج و49 توكن تفكير، مع إرجاع thoughtSignature). يتطلب تمرير جسم الطلب الأصلي وقائمة السماح بحقول الاستجابة نشر إصدار الخلفية المحدّث. ويظل فهم الوسائط والاستناد إلى المصادر وComputer Use والمتابعة/التوليد الطويل والحقول العامة الأخرى وفئات المعالجة غير متحقق منها، ولا تثبت هذه الفحوص جودة أو زمن استجابة مقارنين.

المراجع