Gemini 4 Argon

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

استخدم gemini-4-argon بتنسيق Gemini الأصلي. تتضمن صفحة النموذج Playground والأسعار الحالية؛ ويوضح دليل الإصدار حالة الإتاحة.

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

معرّف النموذج	نافذة السياق	مستوى التفكير الافتراضي
`gemini-4-argon`	1,048,576 توكن	`medium`

مثال سريع

curl https://api.seedrouter.ai/v1beta/models/gemini-4-argon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Explain a mutex in one sentence."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"low"},"maxOutputTokens":256}}'

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

نقاط النهاية

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

تتضمن مواصفة OpenAPI جميع المخططات المتداخلة للطلبات والاستجابات. تستخدم الحقول الاختيارية قيم API الافتراضية عند حذفها. تُحذف الحقول غير المعروفة وغير المدعومة رسمياً؛ أما القيم غير الصالحة للحقول المدعومة فتظل أخطاء.

المعاملات

الاسم	النوع	مطلوب	القيمة الافتراضية	ملاحظات
`contents`	object[]	نعم	—	مصفوفة المحادثة المطلوبة؛ يحمل `parts` النصوص والوسائط ونتائج الأدوات
`systemInstruction`	object	لا	—	تعليمات نظام نصية فقط
`generationConfig`	object	لا	—	ميزانية الإخراج والتفكير والإخراج المنظّم والإيقاف وإعدادات الوسائط
`tools`	object[]	لا	—	تعريفات الدوال والأدوات المدمجة
`toolConfig`	object	لا	—	اختيار الدوال وإعدادات الاسترجاع وأجزاء أدوات الخادم
`safetySettings`	object[]	لا	—	أزواج فريدة من الفئة والعتبة
`continuationToken`	string	لا	—	رمز متابعة يُستخدم كما هو من أحدث مرشّح
`serviceTier`	enum	لا	`standard`	`unspecified` و`standard` و`flex` و`priority`؛ الافتراضي standard
`labels`	object	لا	—	مفاتيح التسميات وقيمها بأحرف صغيرة، بحد أقصى 63 محرف Unicode لكل منها
`store`	boolean	لا	—	تفضيل تسجيل الطلب؛ لا يوفّر استرجاع المحادثات المخزّنة
`model`	string	لا	—	اسم مورد اختياري في جسم الطلب؛ يحدّد URL النموذج بشكل ثابت

يتضمن generationConfig كلاً من maxOutputTokens وthinkingConfig وstopSequences وresponseFormat والحقول القديمة responseMimeType/responseSchema/responseJsonSchema وresponseModalities وmediaResolution وseed وpresencePenalty وfrequencyPenalty وresponseLogprobs وlogprobs وenableEnhancedCivicAnswers وenableAffectiveDialog وtranslationConfig وaudioTranscriptionConfig. تظل الحقول العامة التي لم يُؤكَّد سلوكها الخاص بهذا النموذج خاضعة للتحقق من الإمكانات.

مستويات التفكير: low وmedium وhigh؛ والافتراضي medium. لا يمكن تعطيل التفكير. يطلب includeThoughts ملخصات. يُقبل thinkingBudget المهمل عند استخدامه منفرداً، لكن لا يمكن الجمع بينه وبين thinkingLevel.
يشترك الإدخال والتفكير والإخراج في 1,048,576 توكن. يشمل maxOutputTokens التفكير؛ وقد يقلل السياق المتبقي الميزانية الفعلية.
يستخدم REST الأصلي حداً أقصى وقيمة افتراضية للإخراج قدرهما 32,768 توكن لكل طلب، أو 65,536 عند البث. يحتاج الإخراج الأطول إلى المتابعة. تتعارض الوثائق الرسمية بشأن الطلبات الأولى غير المتدفقة التي تتجاوز 32,768؛ ولا يفرض هذا التكامل هذا الرقم بوصفه حداً لإجمالي التوليد.
خمسة عناصر stopSequences كحد أقصى. يتراوح logprobs بين 0 و20 ويتطلب responseLogprobs: true.
لا يمكن الجمع بين responseSchema وresponseJsonSchema، وكلاهما يتطلب responseMimeType: "application/json". يمكن للطلبات الجديدة استخدام responseFormat.text أدناه.
لا يمكن أن يحتوي responseModalities إلا على TEXT. لا تُعد Temperature وtop-p وtop-k وعدد المرشّحين عناصر تحكم فعّالة في Argon. لا يُدعم cachedContent الصريح أو توليد الصور أو توليد الكلام.

الإخراج المنظّم والأدوات

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 256,
    "responseFormat": {
      "text": {
        "mimeType": "APPLICATION_JSON",
        "schema": {"type": "object", "properties": {"ok": {"type": "boolean"}}, "required": ["ok"]}
      }
    }
  }
}

تستخدم الدوال tools[].functionDeclarations. يتطلب allowedFunctionNames الوضع ANY أو VALIDATED وأسماء دوال معلنة. احتفظ بالترتيب الأصلي لاستدعاءات الدوال والاستجابات والتوقيعات. تعد Google Search وMaps وتنفيذ التعليمات البرمجية وURL context وFile Search وComputer Use إمكانات رسمية؛ ويجب التحقق من الوصول إلى الموارد والرسوم والسلوك للعملية التي تنوي تنفيذها. لا ينفّذ Playground الأدوات محلياً.

الوسائط والأمان

يقبل parts الأصلي إدخال النصوص والصور والصوت والفيديو وملفات PDF عبر inlineData أو fileData. يحتوي الجزء على نوع واحد من البيانات، ويمكن أن تصاحبه توقيعات التفكير وبيانات الوسائط الوصفية. يختلف mediaResolution العام عن دقة كل جزء. يدعم الفيديو المعالجة STATIC وAGENTIC؛ ويجب أن تكون قيمة videoMetadata.fps أكبر من الصفر وألا تتجاوز 24.

يقبل Playground طلب JSON بحجم يصل إلى 12 MiB. هذا حد نقل للتطبيق، وليس حد الوسائط للنموذج. للوسائط الكبيرة، استخدم مراجع الملفات التي يدعمها حسابك. تختلف الحدود الرسمية لموارد الملفات عن حدود الوسائط المجلوبة من الخارج؛ ولم يُتحقق من إتاحتها هنا بعد.

تتبع إعدادات الأمان في API العامة العقد الأصلي. يتطلب Playground مستوى حظر متوسطاً أو أعلى لفئات الأمان الأربع الرئيسية؛ وتُتاح العتبات الأقل عبر API فقط، مع استثناء للمسؤولين.

البث والمتابعة

اقرأ أحداث JSON الأصلية من تدفق SSE. احتفظ بجميع الأجزاء، بما فيها البيانات الوصفية للأدوات والتفكير. عدادات الاستخدام داخل التدفق الواحد تراكمية: استخدم آخر كائن استخدام بدلاً من جمع كل حدث.

عندما يعيد مرشّح continuationToken، احتفظ به كما هو تماماً. عند CONTINUATION، أعد إرسال contents وتعليمات النظام والأدوات وإعدادات التوليد الأصلية، مع أحدث رمز في المستوى الأعلى. لا تُضف الإخراج الجزئي إلى contents. عند MAX_TOKENS، ارفع ميزانية الإخراج قبل الاستئناف. يجهّز Playground طلب متابعة للمراجعة، ولا يرسله إلا عند الضغط على زر الإرسال مجدداً.

كل متابعة طلب مستقل له استخدامه ورسومه. احتفظ بنقاط التحقق إذا كنت تنفّذ إعادة الاتصال؛ ولا تفترض أبداً أن التدفق الذي انقطع قد اكتمل. تُحفظ الاستجابة الأصلية في Playground لفحص جميع الحقول.

الاستخدام وحالة التحقق الحالية

يشمل استخدام الإدخال الإدخال المخزّن مؤقتاً؛ ويشمل الإخراج القابل للفوترة توكنات المرشّحين والتفكير. راجع الأسعار الحالية في صفحة النموذج وسجلات الاستخدام في حسابك. لا تُفرض رسوم على الطلبات الفاشلة.

تحققت الاختبارات المحلية في 14 أكتوبر 2026 من البث النصي، وJSON المنظّم، واستدعاءات الدوال مع التوقيعات وإرجاع النتائج، وتنفيذ التعليمات البرمجية، وGoogle Search وURL context، وفهم الصور والفيديو وملفات PDF، وإخراج التفكير، وتسلسلات الإيقاف. قُبل الصوت، لكن تفريغ جزء من العينة إلى نص كان غير صحيح.

رُفض logprobs صراحةً. فشلت الطلبات التي تتضمن maxOutputTokens: 32769 في اختبارات JSON وSSE كليهما. وردت إجابات سواء استُخدم continuationToken صالح أم غير صالح، ولذلك لم يُتحقق بعد من صحة المتابعة. قُبلت خيارات مستوى الخدمة وseed من دون دليل على تأثيرها. لا تزال Maps وFile Search وComputer Use وagentic video ومراجع الملفات الخارجية من دون اختبار.

لا تثبت هذه الاختبارات المحدودة جميع تركيبات المعلمات أو الإتاحة في بيئة الإنتاج. استخدم التنسيق الأصلي للحصول على العقد الكامل؛ فتوافق OpenAI مجموعة فرعية منفصلة ولا يوفّر long decode.

المراجع

اختيار مجموعة LLM اختياريًا

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

تحتفظ استدعاءات API بمفتاح API ومعرّف النموذج الحاليين. لاختيار مجموعة، أرسل اسمها المطابق تمامًا في ترويسة الطلب الاختيارية X-SeedRouter-Group. استبدل GROUP_NAME أدناه باسم ظاهر في Playground. احذف الترويسة أو استخدم auto للإبقاء على السلوك الافتراضي للمفتاح.

X-SeedRouter-Group: GROUP_NAME

قد يتيح مفتاح API ذو القيود مجموعات أقل مما يتيحه Playground. تُحاسَب الطلبات وفق أسعار المجموعة المحددة، ولا تنتقل إلى مجموعة أخرى إذا كانت المجموعة المحددة غير متاحة. يدعم هذا الخيار استدعاءات LLM عبر HTTP، بما فيها SSE؛ ولا ينطبق على استدعاءات WebSocket أو الصور أو الفيديو.

للتحقق من المجموعات المتاحة لمفتاح API معيّن من دون توليد استجابة من النموذج، استخدم نقطة النهاية هذه المخصّصة للقراءة فقط. يمثّل data[].id قيمة الترويسة، ويمثّل ratio مضاعف السعر المطبّق على الحساب لهذه المجموعة. يعكس الإدخال auto التقدير الحالي للاختيار الافتراضي؛ وتكون قيمة مضاعفه null عند عدم وجود مجموعة افتراضية متاحة. يُعاد التحقق من توفّر المجموعة عند استدعاء النموذج.

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

On this page