---
title: "رقّيت SDK تبع Claude؟ أي طلب بيبعت temperature رح يرجعلك 400"
description: "نسخة Claude API 2026-10-21 شالت temperature وtop_p وtop_k، وأي طلب بيبعتهن بيرجع 400 حتى بالقيمة الافتراضية. والإصدارات الرئيسية الجديدة من الـ SDK بتبعت هالنسخة لحالها، فالترقية بدها تعديل بكودك."
url: https://ihsanalapsi.dev/articles/claude-api-2026-10-21-temperature-removed
lang: ar
date: 2026-10-23
updated: 2026-10-24
tags: ["AI", "أدوات المطورين"]
author: Ihsan Alapsi (إحسان العبسي)
---
# رقّيت SDK تبع Claude؟ أي طلب بيبعت temperature رح يرجعلك 400

إذا عندك كود بيحكي مع Claude API وناوي ترقّي مكتبة الـ SDK، في نسخة API جديدة بتغيّر شو بيقبل الطلب. نسخة الـ API هي قيمة ترويسة `anthropic-version` يلي بتنبعت مع كل طلب، والـ SDK بيحطها عنك. Anthropic أطلقت النسخة 2026-10-21 يوم 21 تشرين الأول 2026، ومعها إصدارات رئيسية جديدة من كل مكتبات الـ SDK بتبعتها لحالها. بآخر المقال بتعرف شو بينكسر عندك، وإذا بترقّي هلق ولا بتضل على 2023-06-01.

## شو تغيّر بنسخة 2026-10-21 من Claude API؟

نسخة 2026-10-21 من Claude API شالت `temperature` و`top_p` و`top_k`، فأي طلب بيبعت واحد منهن بيرجع خطأ 400 على كل النماذج، حتى لو القيمة هي الافتراضية. وفوقها قيدين جداد على مكان المستندات والاقتباسات، وحقول تغيّر اسمها بالـ Admin API.

هي أول نسخة جديدة من بعد 2023-06-01 حسب [صفحة الإصدارات](https://platform.claude.com/docs/en/api/versioning). تغييرات الـ Messages API بتنطبق كمان على عدّ التوكنز وعلى كل طلب جوّا Message Batch انعمل على النسخة الجديدة، حسب [دليل الهجرة](https://platform.claude.com/docs/en/api/migration-2026-10-21):


| شو بتبعت                                                                           | شو بيصير على 2026-10-21                                                                                                                                                                     |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `temperature` أو `top_p` أو `top_k`                                                | خطأ 400، حتى بالقيمة الافتراضية                                                                                                                                                             |
| بلوك `document` مباشرة برسالة `assistant`                                          | خطأ 400. المستند بينبعت برسالة `user`، والمستند جوّا بلوك تاني (متل نتيجة web fetch) بيضل مقبول                                                                                             |
| بلوك `text` فيه `citations` مش فاضية برسالة `user`، مباشرة أو جوّا `search_result` | خطأ 400. الاقتباسات برسائل `assistant` بتضل مقبولة                                                                                                                                          |
| Admin API                                                                          | `roles` صارت `role_ids`، و`group_id` صارت `rbac_group_id`، و`name` بالأدوار صارت `display_name`، و`group_type` صارت `group.type`، و`workspace_id` بمفاتيح الـ API صارت `scope.workspace_id` |
| Claude Enterprise Analytics API                                                    | `actor.email` صارت `actor.email_address`، و`summaries` صارت `data`                                                                                                                          |


## مين بينكسر لما يرقّي الـ SDK؟

كل إصدارات الـ SDK القديمة كانت تبعت 2023-06-01 مع كل طلب. الإصدارات الرئيسية الجديدة بتبعت 2026-10-21، فترقية المكتبة لحالها بتنقل كل طلباتك للنسخة الجديدة.

هي الإصدارات حسب [ملاحظات الإصدار يوم 21 تشرين الأول](https://platform.claude.com/docs/en/release-notes/overview):


| المكتبة                          | أول إصدار بيبعت 2026-10-21 |
| -------------------------------- | -------------------------- |
| Python (`anthropic`)             | 2.0.0                      |
| TypeScript (`@anthropic-ai/sdk`) | 1.0.0                      |
| C# (`Anthropic`)                 | 13.0.0                     |
| Go (`anthropic-sdk-go/v2`)       | 2.0.0                      |
| Java (`anthropic-java`)          | 3.0.0                      |
| PHP (`anthropic-ai/sdk`)         | 1.0.0                      |
| Ruby (`anthropic`)               | 2.0.0                      |
| `ant` CLI                        | 2.0.0                      |


بهالإصدارات الحقول التلاتة انشالت من أنواع الـ SDK ومن خيارات الـ CLI، فالكود يلي بيمرّقهن لازم يتعدّل مع الترقية نفسها. بـ C# في حالة ما بتعطي خطأ أبداً: محوّلات `IChatClient` صارت تتجاهل `Temperature` و`TopK` و`TopP` بصمت.

الـ 400 بيطلع لما الطلب ينبني برّا أنواع الـ SDK: كود بيبعت HTTP مباشرة وحاطط الترويسة 2026-10-21، أو إطار أو بوابة بين كودك وAnthropic بتضيف القيم عنك. إذا عندك بوابة متل [LiteLLM](/articles/litellm-1-107-0-credential-stealer) بالنص، شوف شو بتبعت فعلياً بسجل طلب حقيقي.

والإصدارات الجديدة فيها تغييرات ما إلها علاقة بنسخة الـ API: Text Completions انشالت من مكتبات TypeScript وGo وJava وRuby ومن الـ CLI، ومفتاح الـ API بالـ client الأساسي صار ينبعت بـ `Authorization: Bearer` بدل `X-Api-Key` (انتبه إذا عندك proxy بيقرا `X-Api-Key`)، والرخصة صارت Apache 2.0 بدل MIT. وعلى Amazon Bedrock النسخة الجديدة متاحة بس لـ Claude 4.7 والأحدث.

## شو بيصير لنتائج النموذج لما تشيل temperature؟

الطلب بلا الحقول التلاتة بياخد قيمها الافتراضية، و`temperature` فيها 1.0، متل طلب على 2023-06-01 ما بعتهن. على Claude 4.7 والأحدث ما بيتغيّر شي، لأنو هالنماذج أصلاً بتقبل القيم الافتراضية بس.

الفرق بيبيّن على النماذج يلي بتقبل قيم تانية، متل Claude Sonnet 4.6. إذا كنت منزّل `temperature` لحتى تطلع النتيجة أثبت (تصنيف، أو استخراج JSON)، هالتأثير بيروح، و[دليل الهجرة](https://platform.claude.com/docs/en/api/migration-2026-10-21#sampling-parameters) بيقول إنو ما في إعداد تاني بيحل محله. الطلب رح يرجع 200 عادي، بس النتائج ممكن تتنوّع أكتر من قبل.

لهيك ما بيكفي تشوف إنو الطلبات مرقت. خود عيّنة من الطلبات يلي بتعتمد على نتيجة ثابتة، وشغّل كل وحدة كذا مرة على النسختين، وقارن قديش النتائج بتختلف.

## بترقّي هلق ولا بتضل على 2023-06-01؟

Anthropic بتنصح بآخر نسخة قد ما فيك. بس صفحة الإصدارات لسا بتعرض 2023-06-01 بلا أي إشارة إنها انلغت، ودليل الهجرة نفسه بيقول: الطلب يلي بيعتمد على قيمة غير افتراضية، يا بتوقف تبعتها، يا بتخليه على 2023-06-01.


| وضعك                                                                | شو بتعمل                                  |
| ------------------------------------------------------------------- | ----------------------------------------- |
| ما بتبعت الحقول التلاتة، أو بتبعت الافتراضي                         | رقّي، وشيل الحقول من الكود                |
| نماذجك Claude 4.7 والأحدث                                           | رقّي: النتيجة ما بتتغيّر                  |
| عندك طلبات بتعتمد على `temperature` منخفضة على نموذج متل Sonnet 4.6 | خلي هالطلبات على 2023-06-01، ورقّي الباقي |
| عم تنادي نموذج أقدم من Claude 4.7 على Bedrock                       | خليك على إصدار الـ SDK الحالي             |


إذا بتنادي الـ API بلا SDK، الترويسة بإيدك بكل طلب. وإذا عبر SDK، الإصدار القديم من المكتبة بيضل يبعت 2023-06-01. أي خيار بتاخده، اكتبه بمكان واحد: أي خدمة على أي نسخة، وليش، لأنو المنصات عم تتغيّر من تحتك بسرعة، متل [النماذج يلي طلعت من Copilot وCodex](/articles/ai-model-retirements-codex-copilot).

## كيف ترقّي لنسخة 2026-10-21 بالترتيب؟

الترقية خمس خطوات، ودليل الهجرة بيقول انشر ترقية المكتبة مع تعديلات الكود بنفس الإصدار:

1. فتّش عن الحقول التلاتة بكودك وبالإعدادات والـ wrappers. البحث النصي ما بيلقط القيم يلي بيضيفها إطار وقت التشغيل، فشوف كمان سجل طلب حقيقي:

```bash
grep -rn "temperature\|top_p\|top_k" --include="*.py" --include="*.ts" --include="*.js" --include="*.go" --include="*.java" --include="*.cs" --include="*.php" --include="*.rb" .
```

2. فتّش عن بلوكات `document` برسائل `assistant`، وعن `citations` برسائل `user`، وصلّحهن حسب الجدول فوق.
3. رقّي المكتبة للإصدار يلي بالجدول. بـ TypeScript، إذا بتستعمل حزم المنصات (`@anthropic-ai/bedrock-sdk` و`@anthropic-ai/vertex-sdk` وغيرهن)، رقّيهن لـ `v1` بنفس الوقت، وإلا مدير الحزم بينزّل نسخة تانية قديمة من `@anthropic-ai/sdk`. وبـ Go مسار الاستيراد صار ينتهي بـ `/v2`.
4. إذا بتشتغل بـ Claude Code، من الإصدار 2.1.307 (انرفع على npm يوم 21 تشرين الأول) في أمر `/claude-api api-version` بينقل كود Claude API للنسخة الجديدة، حسب [سجل تغييرات Claude Code](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md). `/claude-api` مهارة جاية مع Claude Code؛ وإذا بدك تشوف شو المهارات وكيف بتشتغل، في [مهارات AI](/products/c/ai-skills) بالمتجر. شغّل الأمر على فرع لحاله وراجع الفرق قبل الدمج.
5. جرّب على 2026-10-21 قبل ما تنشر. هاد طلب تجريبي بلا SDK من دليل الهجرة:

```bash
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'
```

بعد النشر، راقب أخطاء 400 الجاية من Anthropic بأول أيام. وإنت، كم طلب بكودك لسا بيبعت `temperature`؟

## FAQ

**إذا ما ببعت temperature أبداً، بيخصّني التغيير؟**

ممكن. في تغييرات تانية بنفس النسخة: بلوك document برسالة assistant، وcitations برسالة user، وحقول بالـ Admin API تغيّر اسمها. وإذا في إطار أو بوابة بتبني الطلب عنك، شوف شو بتبعت فعلياً.

**هل نسخة 2023-06-01 رح تنطفي؟**

ما في شي رسمي بيقول هيك. صفحة الإصدارات عند Anthropic لسا بتعرضها بلا أي إشارة إنها انلغت، ودليل الهجرة بيقترح تخلي عليها الطلبات يلي بدها temperature غير افتراضية. بس Anthropic بتنصح بآخر نسخة قد ما فيك.

**في إعداد جديد بيحل محل temperature؟**

لأ. دليل الهجرة بيقول حرفياً إنو ما في إعداد تاني بيحل محلها. الطلب بلاها بياخد القيم الافتراضية، و temperature فيها 1.0.

**بستعمل Claude على Amazon Bedrock، بقدر أرقّي؟**

بس مع Claude 4.7 والأحدث. نسخة 2026-10-21 على Bedrock متاحة لهالنماذج بس، فإذا عم تنادي نموذج أقدم هونيك، خليك على إصدار الـ SDK يلي عندك أو على النسخة يلي عم تبعتها هلق.