مستويات التفكير في Gemini 4 Neon: متى تستخدم High مقابل xhigh
تتيح لك مستويات التفكير في Gemini 4 Neon أربعة إعدادات تحدد مدى عمق استدلال النموذج قبل أن يجيب: low وmedium وhigh وxhigh. القيمة الافتراضية في Neon هي high. وتوصي Google بالاحتفاظ بـhigh في معظم الأعمال المعقدة، والانتق
تتيح لك مستويات التفكير في Gemini 4 Neon أربعة إعدادات تحدد مدى عمق استدلال النموذج قبل أن يجيب: low وmedium وhigh وxhigh. القيمة الافتراضية في Neon هي high. وتوصي Google بالاحتفاظ بـhigh في معظم الأعمال المعقدة، والانتقال إلى xhigh فقط عندما يخفق high في المسائل الصعبة متعددة الخطوات، لأن xhigh يستهلك عددًا أكبر من الرموز ويستغرق وقتًا أطول.
{% cta https://apidog.com/?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation %}
جرّب Apidog اليوم
{% endcta %}
ما هي مستويات التفكير في Gemini 4 Neon؟
مستويات التفكير هي قيم المعامل thinking_level التي تحدد مقدار الاستدلال الداخلي الذي يقوم به gemini-4-neon قبل كتابة الرد. يدعم Neon أربعة مستويات: low وmedium وhigh (الافتراضي) وxhigh. تستهلك المستويات الأعلى رموز تفكير أكثر وتضيف زمن استجابة، بينما تجيب المستويات الأدنى بسرعة أكبر وبتكلفة أقل.
إليك كيف يصف دليل التفكير من Google كل مستوى بالنسبة إلى Neon:
thinking_level |
استهلاك الرموز | الاستخدام المقترح من Google |
|---|---|---|
low |
أقل عدد من الرموز، وأقل زمن استجابة | الدردشة السريعة، والمعالجة عالية الإنتاجية؛ ولا يزال قادرًا على المهام الوكيلية |
medium |
استهلاك أقل للرموز، واستجابات أسرع | البرمجة التفاعلية، والنماذج الأولية للواجهات المباشرة، واستدعاءات الأدوات الحساسة لزمن الاستجابة |
high (الافتراضي) |
توازن بين الذكاء والسرعة | البرمجة المعقدة، والتنفيذ الوكيلي، واستدعاء الأدوات، والعمل المعرفي متعدد الوسائط |
xhigh |
أكبر عدد من الرموز، وأعمق استدلال | الهندسة الصعبة متعددة الخطوات، والمشكلات التحليلية والعلمية التي يخفق فيها high
|
هناك قيمتان قد تتوقعهما لكنهما غائبتان. يرفض Neon القيمة minimal ويعيد خطأً، لذا فإن أي كود منسوخ من تطبيق Gemini 3 Flash سيتعطل إذا أرسل هذه القيمة. كذلك أصبح عدد الرموز القديم thinkingBudget مهجورًا في Gemini 4: فعند إرساله منفردًا، يُترجم إلى أقرب مستوى مع تحذير؛ وعند إرساله مع thinkingLevel، يعيد الخطأ 400.
كيف يقارن المستوى الافتراضي في Neon بغيره من نماذج Gemini 4؟
يبدأ Neon بدرجة أعلى من أشقائه الأكبر. ووفقًا لـملاحظات إصدار Gemini 4 Neon، فإن Neon وHydrogen يستخدمان high افتراضيًا ويدعمان xhigh، في حين يستخدم Carbon وArgon القيمة medium افتراضيًا ويقتصران على high كحد أقصى.
| النموذج | المستوى الافتراضي | المستويات المدعومة |
|---|---|---|
gemini-4-neon |
high |
low، medium، high، xhigh
|
gemini-4-hydrogen |
high |
low، medium، high، xhigh
|
gemini-4-carbon |
medium |
low، medium، high
|
gemini-4-argon |
medium |
low، medium، high
|
وهذا مهم عند تبديل النماذج. فإذا نقلت عبئًا من Carbon إلى Neon دون تعيين thinking_level، فسيرتفع كل طلب من الاستدلال بمستوى medium إلى high، ما يغيّر عدد رموزك. وإذا كنت توازن بين النماذج الأكبر، فإن مقارنتنا بين Gemini 4 Carbon وArgon تغطي هذا الفارق.
كيف تعيّن thinking_level في Gemini API؟
يعمل Neon على الطبقة المدفوعة من كلٍّ من Interactions API وgenerateContent. ويختلف اسم الحقل بينهما.
Interactions API: ضع thinking_level داخل generation_config.
curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"model": "gemini-4-neon",
"input": "Audit this payment retry queue for race conditions.",
"generation_config": {
"thinking_level": "xhigh",
"max_output_tokens": 65536
}
}'
generateContent: استخدم thinkingLevel داخل generationConfig.thinkingConfig.
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-4-neon:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"contents": [{"parts": [{"text": "Audit this payment retry queue for race conditions."}]}],
"generationConfig": {
"thinkingConfig": {"thinkingLevel": "medium"}
}
}'
في حزمة Python SDK، يأخذ استدعاء Interactions الوسيط generation_config={"thinking_level": "high"}، ويأخذ استدعاء generateContent الوسيط thinking_config=types.ThinkingConfig(thinking_level="low"). اترك temperature وtop_p وtop_k خارج الطلب: إذ تقول Google إن Neon يتجاهل القيم ضمن النطاق ويرفض القيم الخارجة عنه بالخطأ 400. للحصول على دليل كامل للطلب الأول على نفس تصميم الـAPI، راجع دليل Gemini 4 Hydrogen API.
متى تستخدم high مقابل xhigh؟
استخدم high افتراضيًا، ولا ترقّ مهمة إلى xhigh إلا بعد أن يخفق high في معيار الجودة لديك. ويصف منشور الإطلاق من Google xhigh بأنه «استدلال أعمق متعدد الخطوات لأصعب أعباء الهندسة والتحليل والعلوم».
اختر xhigh عندما:
- تتضمن المهمة خطوات مترابطة كثيرة ويُفسد خطأ مبكر النتيجة، مثل إعادة هيكلة متعددة الملفات أو تدقيق التزامن.
-
يعطي
highإجابة واثقة لكنها خاطئة على مجموعة التقييم لديك، لا مجرد إجابة أبطأ. - لا يمثل زمن الاستجابة أهمية كبيرة، كما في المهام الخلفية أو المراجعات الليلية أو التحليل الدفعي.
- تكلفة الإجابة الخاطئة أكبر من تكلفة الرموز، كما في تصحيحات الأمان أو الحسابات المالية.
وابقَ على high (أو انزل إلى مستوى أدنى) عندما:
-
يكون الطلب للاستخراج أو التنسيق. تحذّر Google من أن
xhigh«قد يسبب تفكيرًا مفرطًا أو يستنفدmax_output_tokensفي الطلبات الأبسط مثل استخراج النصوص أو JSON». -
يكون المستخدم في انتظار الرد. فالدردشة والإكمال التلقائي واستدعاءات الأدوات المباشرة تناسب
mediumأوlow. - تعمل بحجم كبير. فكل رمز تفكير إضافي يُحتسب عليك، والفارق يتضاعف عبر الطلبات.
وأرقام Google القياسية تدعم هذا التقسيم. ففي إعلان الإطلاق، يحصل Neon عند xhigh على 61 في مؤشر الذكاء من Artificial Analysis، محتلًا المرتبة الثالثة. وعند المستوى الافتراضي high، تذكر Google تكلفة أقل بنسبة 32% لكل مهمة مقارنة بـCarbon. هذه أرقام Google وليست اختباراتنا، لكنها تُظهر المقايضة: يشتري xhigh أعلى نتيجة لـNeon، بينما يشتري high الكفاءة.
كم تبلغ تكلفة كل مستوى تفكير؟
لكل مستوى السعر نفسه لكل رمز؛ ما يتغير هو عدد الرموز التي تدفع مقابلها. تكلفة Neon 3.00 دولارات لكل مليون رمز إدخال و15.00 دولارًا لكل مليون رمز إخراج، وتذكر صفحة الأسعار من Google أن سعر الإخراج يشمل رموز التفكير. وينخفض الإدخال المخزَّن مؤقتًا إلى 0.15 دولار لكل مليون عبر التخزين المؤقت الضمني (التخزين المؤقت الصريح غير مدعوم في Neon). ولا توجد طبقة مجانية لهذا النموذج.
إذن تكلفة أي مستوى هي رموز التفكير التي يضيفها، مضروبة في 15 دولارًا لكل مليون. إليك الحساب لطلب واحد يتضمن 2,000 رمز إدخال وإجابة ظاهرة من 800 رمز. أعداد رموز التفكير افتراضية، اختيرت لإظهار الحساب وليست مقيسة:
| رموز التفكير (افتراضية) | تكلفة الإدخال | تكلفة الإخراج + التفكير | الإجمالي لكل طلب | لكل 10,000 طلب |
|---|---|---|---|---|
| 500 | 0.006 دولار | 0.0195 دولار | 0.0255 دولار | 255 دولارًا |
| 2,000 | 0.006 دولار | 0.042 دولار | 0.048 دولار | 480 دولارًا |
| 8,000 | 0.006 دولار | 0.132 دولار | 0.138 دولار | 1,380 دولارًا |
يهيمن التفكير على الفاتورة بسرعة. فعند 8,000 رمز تفكير، يشكّل الاستدلال 87% من تكلفة الطلب. لهذا تنصح Google نفسها بتشغيل التقييم لديك على المستويات الأربعة و«اختيار أدنى thinking_level يلبي معيار الجودة لديك». ويغطي دليل مستويات التفكير في Gemini 3.8 Flash المقايضة نفسها على نموذج أرخص إذا أردت المقارنة.
كيف تقيس الرموز وزمن الاستجابة لكل مستوى؟
شغّل الطلب نفسه عند كل مستوى واقرأ كتلة الاستخدام. في Interactions API، يذكر كائن usage في الاستجابة total_input_tokens وtotal_output_tokens وtotal_thought_tokens كلًّا على حدة. وفي generateContent، تظهر رموز التفكير باسم usageMetadata.thoughtsTokenCount.
ترسل هذه الحلقة طلبًا واحدًا عند المستويات الأربعة جميعًا وتطبع رموز التفكير إضافةً إلى الزمن الفعلي:
for level in low medium high xhigh; do
start=$(date +%s)
usage=$(curl -s "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-d "{\"model\":\"gemini-4-neon\",
\"input\":\"Find the race condition in this retry loop: ...\",
\"generation_config\":{\"thinking_level\":\"$level\",\"max_output_tokens\":65536}}" \
| jq -c '{status, thought: .usage.total_thought_tokens, out: .usage.total_output_tokens}')
echo "$level $(( $(date +%s) - start ))s $usage"
done
شغّلها على 10 إلى 20 طلبًا من عبئك الحقيقي. فالطلب الواحد لا يخبرك بالكثير؛ أما مجموعة الطلبات فتُظهر أين يبدأ high وxhigh بالاختلاف في الجودة.
اضبط مهلة عميل HTTP على قيمة عالية أثناء الاختبار. فملاحظات الترحيل من Google تقول إن الطلبات الصعبة قد تستغرق دقائق عدة، وتقترح مهلة لا تقل عن 15 دقيقة، أو التنفيذ في الخلفية.
لماذا يعيد xhigh أحيانًا إجابة فارغة؟
يحدّ max_output_tokens من التفكير والإخراج الظاهر معًا. فإذا أنفق Neon الميزانية كلها في الاستدلال، يتوقف التفاعل بحالة incomplete ويعيد إجابة مقتطعة أو فارغة، وستدفع مع ذلك مقابل رموز التفكير التي أنتجها.
هناك ثلاث قواعد من وثائق Google تجنّبك ذلك:
- أزل الحدود المنخفضة القديمة. إذا كان تطبيقك يثبّت قيمة مثل 8,192، فارفعها إلى 65,536، وهو الحد الافتراضي للطلبات المتزامنة.
-
اخفض المستوى، لا الحد. لتقليل التكلفة أو زمن الاستجابة، انزل إلى
mediumأوlowبدلًا من تقليصmax_output_tokens. -
استخدم التنفيذ الخلفي للأعمال الطويلة. للإجابات التي تتجاوز 65,536 رمزًا، اضبط
backgroundعلىtrueوmax_output_tokensحتى 1,048,576 ناقص الإدخال. فالإدخال والتفكير والإخراج تتقاسم نافذة واحدة من مليون رمز. ويشرح دليل الإخراج الطويل في Gemini 4 Argon نمط الاستقصاء الدوري.
دع وكيل البرمجة لديك يقيس المستويات الأربعة باستخدام Apidog CLI
إعادة تشغيل تلك الحلقة يدويًا تصبح مملة. بدلًا من ذلك، دع وكيل البرمجة لديك (Claude Code أو Codex أو Cursor) يبني اختبارًا واحدًا قابلًا لإعادة الاستخدام باستخدام Apidog CLI ويعيد تشغيله عند كل مستوى متى أردت أرقامًا جديدة.
أعدّه مرة واحدة:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
ثم أعطِ وكيلك طلبًا واحدًا:
In Apidog project <projectId>, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and variables GEMINI_API_KEY and
THINKING. Add an endpoint for POST /v1beta/interactions that sends the
x-goog-api-key header from GEMINI_API_KEY. Create a test case that sends model
"gemini-4-neon", my audit prompt, generation_config.thinking_level {{THINKING}}
and max_output_tokens 65536, and asserts: HTTP 200, status is "completed",
and usage.total_thought_tokens exists. Run it once per level (low, medium,
high, xhigh) and give me a table of thought tokens and response time.
يقرأ الوكيل مخطط كل حِمل ويتحقق من صحة JSON الخاص به، ثم يكتب الموارد ويكرر التشغيل:
apidog environment create gemini --project <projectId> --base-url https://generativelanguage.googleapis.com
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file endpoint.json
apidog endpoint create --project <projectId> --file endpoint.json
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
for level in low medium high xhigh; do
apidog run --test-case <caseId> --project <projectId> -e <envId> \
--env-var "THINKING=$level" -r cli,json --out-file "neon-$level"
done
يلتقط التحقق من أن status is "completed" فخ incomplete من القسم السابق، بحيث يفشل أي مستوى يستنفد ميزانيته بصوت عالٍ بدلًا من إرجاع سلسلة فارغة. واستبدل -r cli,json بـ-r junit لينتقل التشغيل نفسه إلى CI؛ ويعرض دليل Apidog CLI لخطوط CI/CD خط الأنابيب، ويغطي Apidog CLI في Claude Code إعداد الوكيل. وتغطي خطة Apidog المجانية ما يصل إلى 4 مستخدمين.
الأسئلة الشائعة
ما مستوى التفكير الافتراضي في Gemini 4 Neon؟ high. لا تحتاج إلى إرسال thinking_level للحصول عليه. ويستخدم Carbon وArgon القيمة medium افتراضيًا، لذا عيّن المستوى صراحةً عند الترحيل منهما.
هل يدعم Gemini 4 Neon التفكير الأدنى (minimal)؟ لا. يدعم Neon المستويات low وmedium وhigh وxhigh، ويرفض minimal بخطأ. استخدم low لأسرع وأرخص الاستجابات.
هل تُحتسب رموز التفكير في فاتورة Gemini 4 Neon؟ نعم. تُحتسب رموز التفكير بسعر الإخراج البالغ 15.00 دولارًا لكل مليون رمز. وتحتسب Google كل رمز يعالجه النموذج، بما في ذلك رموز التفكير.
هل يمكنني الاستمرار في استخدام thinkingBudget مع Gemini 4 Neon؟ إنه مهجور في نماذج Gemini 4. فعند إرساله منفردًا، يُترجم إلى أقرب thinkingLevel ويعيد تحذيرًا. وعند إرساله إلى جانب thinkingLevel، يفشل الطلب بالخطأ 400.
هل xhigh أدق دائمًا من high؟ ليس دائمًا. تقول Google إن xhigh قد يفرط في التفكير في الطلبات البسيطة مثل استخراج النصوص أو JSON وقد يستنفد max_output_tokens. اختبرهما على طلباتك الخاصة واحتفظ بأدنى مستوى يجتاز الاختبار.
هل يمكنني استخدام مستويات التفكير في Gemini 4 Neon مجانًا؟ لا. Gemini 4 Neon غير متاح في الطبقة المجانية من Gemini API. وفي Google AI Studio وGoogle Antigravity، يرتبط بخطط Google AI Pro وUltra المدفوعة.
Originally published by Dev.to AI. Aggregated on AIWithGhost for educational purposes — full credit and traffic to the original publisher.

