Gemini 4 Hydrogen

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

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

تحقّق من قائمة النماذج والفئات المتاحة لك قبل تشغيل الأمثلة. استخدم معرّف الاستدعاء الكامل المعاد من الاكتشاف عندما تكون فئة Default غير متاحة.

مثال سريع

curl https://api.seedrouter.ai/v1beta/models/gemini-4-hydrogen: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":"high"},"maxOutputTokens":65536}}'

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

نقاط النهاية

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

معلمات الطلب

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

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

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

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

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

تعيد استجابة Gemini 4 Hydrogen الواحدة ما يصل إلى 65,536 توكن مع البث وما يصل إلى 65,536 توكن دون البث. لتجاوز ذلك، اضبط 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": 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 وأسماءً معرّفة.

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

تدرج Google أدوات Search وMaps وتنفيذ الشيفرة وسياق URL وFile Search وComputer Use لهذا النموذج. تتطلب موارد File Search صلاحية وصول ببيانات الاعتماد المستخدمة لخدمة الطلب. تظهر إعدادات MCP الأصلية في المخطط العام، لكن توفّرها لهذا النموذج لم يثبت. تحقّق من القيود الرسمية لكل أداة قبل جمعها مع الوسائط. عند الاستناد إلى المصادر، تحتسب 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. يستخدم Hydrogen مستوى التفكير high افتراضياً. اضبط المستوى صراحةً عند مقارنة استخدامه بنموذج آخر.

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

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

تستخدم فئة Default معرّف النموذج المجرّد gemini-4-hydrogen. تستخدم الفئات الإضافية gemini-4-hydrogen: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-hydrogen" \
  -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

حالة التحقق

فُحصت الوثائق الرسمية في 13 نوفمبر 2026. في ذلك التاريخ نجحت ثلاثة فحوص مدفوعة عبر SeedRouter بمحاولة واحدة لكل منها: JSON منظّم بتفكير low، وSSE بتفكير xhigh، واستدعاء دالة مُعلنة بتفكير low. تطابقت رموز الإدخال والإخراج والتفكير المُبلغ عنها مع الرسوم المسجّلة وفق الأسعار المنشورة. يظل فهم الوسائط والاستناد إلى المصادر وComputer Use والمتابعة/فك الترميز الطويل والحقول العامة الأخرى ومستويات المعالجة دون تحقق. لا تثبت هذه الفحوص جودة أو زمن استجابة مقارنين.

المراجع

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