آنتروپیک پس از ۳ سال API مدل‌های Claude را بازنویسی کرد؛ حذف پارامتر دما و تحول در SDK

شرکت آنتروپیک راهنمای مهاجرت به نسخه 2026-10-21 رابط برنامه‌نویسی کاربردی (API) مدل‌های Claude را منتشر کرد؛ این اولین نسخه رسمی از زمان انتشار نسخه 2023-06-01 به شمار می‌رود. نسخه جدید پارامترهای کنترل نمونه‌برداری (Sampling) را حذف کرده، اعتبارسنجی پیام‌ها را سخت‌گیرانه‌تر می‌کند و سازوکار احراز هویت در کیت‌های توسعه نرم‌افزار (SDK) را تغییر می‌دهد. نسخه‌های اصلی کیت‌های توسعه نرم‌افزار آنتروپیک و رابط خط فرمان ant اکنون به‌صورت پیش‌فرض از این نسخه جدید استفاده می‌کنند.

سرویس‌ها و سیستم‌هایی که نسخه 2023-06-01 را تثبیت کرده‌اند همچنان بدون اختلال به کار خود ادامه خواهند داد، چراکه آنتروپیک هنوز آن نسخه را منسوخ نکرده است. تغییرات ناسازگار و شکننده (Breaking Changes) زمانی آغاز می‌شوند که یک برنامه هدر anthropic-version: 2026-10-21 را ارسال کند یا به کلاینتی ارتقا یابد که به‌طور خودکار این نسخه را برمی‌گزیند. آنتروپیک قصد دارد نسخه‌های جدید API را در فواصل زمانی کوتاه‌تر منتشر کند تا تغییرات ساختاری بر اساس یک جدول زمانی مشخص و پیش از عرضه مدل‌های جدید اعمال شوند.

حذف پارامترهای کنترل نمونه‌برداری

درخواست‌هایی که از نسخه 2026-10-21 استفاده می‌کنند، در صورت ارسال پارامترهای temperature (دما)، top_p یا top_k با خطای 400 مواجه می‌شوند؛ حتی اگر مقدار ارسالی دقیقاً برابر با مقدار پیش‌فرض قبلی باشد. نسخه‌های به‌روزرسانی‌شده کیت‌های توسعه نرم‌افزار و رابط خط فرمان نیز این فیلدها را از تایپ‌ها و فلگ‌های خود حذف کرده‌اند.

درخواست‌ها اکنون بر پایه رفتار پیش‌فرض نمونه‌برداری پردازش می‌شوند که معادل یک درخواست در نسخه 2023-06-01 با دمای 1.0 و بدون هیچ پارامتر نمونه‌برداری است. مدل‌هایی مانند Claude 4.7 از قبل همین مقادیر پیش‌فرض را به کار می‌بردند، بنابراین تغییری در رفتار خروجی آن‌ها ایجاد نمی‌شود.

بااین‌حال، برنامه‌هایی که دمای مدل‌هایی نظیر Claude Sonnet 4.6 را برای دریافت پاسخ‌های قطعی‌تر کاهش می‌دادند، در این نسخه جدید چنین کنترلی را از دست خواهند داد. آنتروپیک هیچ تنظیم جایگزینی برای این قابلیت ارائه نکرده است. فراخوانی‌هایی که به خروجی‌های با دمای پایین وابسته‌اند، باید همچنان روی نسخه 2023-06-01 باقی بمانند.

سخت‌گیرانه‌تر شدن اعتبارسنجی پیام‌ها

• اسناد نمی‌توانند مستقیماً در پیام‌های دستیار (Assistant) قرار گیرند: چنین درخواست‌هایی اکنون خطای 400 دریافت می‌کنند. بلوک‌های اسناد (Document blocks) باید در پیام‌های کاربر (User) قرار داده شوند. البته اسنادی که درون یک بلوک دیگر جاسازی شده‌اند، از جمله نتایج ابزار دریافت اطلاعات وب (Web-fetch)، همچنان معتبر خواهند بود.
• بلوک‌های متنی کاربر نمی‌توانند آرایه‌های ارجاع (Citation) غیرخالی داشته باشند: این درخواست‌ها نیز خطای 400 بازمی‌گردانند. آرایه‌های ارجاع فقط روی بلوک‌های متنی دستیار معتبر هستند؛ از جمله پاسخ‌های قبلی Claude که به‌عنوان تاریخچه گفت‌وگو بازگردانده می‌شوند.

تبدیل احراز هویت Bearer به حالت پیش‌فرض در SDK

کیت‌های توسعه نرم‌افزار و رابط خط فرمان به‌روزشده اکنون اطلاعات اعتباری را از طریق هدر Authorization: Bearer <key> ارسال می‌کنند، در حالی که نسخه‌های قبلی از هدر X-Api-Key استفاده می‌کردند. سرورهای API همچنان هر دو هدر را می‌پذیرند، بنابراین ارتباطات مستقیم مبتنی بر HTTP می‌توانند کدهای احراز هویت پیشین خود را حفظ کنند.

بااین‌حال، پروکسی‌ها و درگاه‌هایی (Gateways) که هدر X-Api-Key را بررسی، بازنویسی یا اعتبارسنجی می‌کردند، پیش از ارتقای SDK باید برای پردازش هدر Authorization نیز آماده شوند. علاوه بر این، کلاینت‌های SDK اکنون در هر لحظه تنها یک نوع اطلاعات اعتباری را نگهداری می‌کنند؛ ارسال هم‌زمان api_key و auth_token به سازنده کلاینت با خطای ValueError مواجه خواهد شد، در حالی که کلاینت‌های پیشین هر دو هدر را ارسال می‌کردند.

تغییرات بنیادین در سطح SDKها

• تبدیل MessageParam به یک Union: این متغیر اکنون از اجتماع انواع UserMessageParam، AssistantMessageParam و SystemMessageParam تشکیل شده است. ساختارهای دیکشنری همچنان معتبر هستند، اما فراخوانی مستقیم MessageParam(...) به‌عنوان سازنده کلاس، خطای TypeError ایجاد می‌کند.
• حذف فشرده‌سازی سمت کلاینت در رانرهای ابزار تایپ‌اسکریپت و روبی: مدیریت زمینه‌های قدیمی اکنون از طریق فشرده‌سازی سمت سرور انجام می‌شود. توسعه‌دهندگان باید compactionControl را با ویرایشگر context_management جایگزین کرده، هدر بتای anthropic-beta: compact-2026-01-12 را ارسال کنند و آستانه فعال‌سازی را روی دست‌کم ۵۰٬۰۰۰ توکن تنظیم نمایند.
• حذف API قدیمی Text Completions از چندین SDK و ابزار CLI: دستور ant completions create به‌طور کامل حذف شده است و باید از دستور ant messages create استفاده شود.
• تغییر نام فیلدهای پنل مدیریت و بخش Enterprise Analytics: فیلد roles به role_ids، فیلد group_id به rbac_group_id و فیلد actor.email به actor.email_address تغییر نام یافته‌اند. همچنین پاسخ‌های کلید API اکنون به‌جای workspace_id شیء جدیدی به نام scope ارائه می‌دهند.
• تغییر مجوز به Apache 2.0: نسخه‌های تازه SDK و رابط خط فرمان تحت مجوز آپاچی نسخه ۲٫۰ (Apache License 2.0) منتشر شده‌اند، در حالی که نسخه‌های قبلی تحت مجوز MIT بودند.

محدودیت‌های ارتقا در سرویس Bedrock

سرویس آمازون بدراک (Amazon Bedrock) از نسخه 2026-10-21 تنها برای مدل‌های Claude 4.7 و نسخه‌های پس از آن پشتیبانی می‌کند. سرویس‌هایی که از مدل‌های قدیمی‌تر میزبانی‌شده روی بدراک استفاده می‌کنند، باید پیش از ارتقا، ترکیب سازگار SDK و نسخه API را حفظ کنند یا پروژه‌های خود را به مدل‌های پشتیبانی‌شده انتقال دهند.

زمان‌بندی منظم برای نسخه‌گذاری API

رابط برنامه‌نویسی مدل‌های Claude بیش از سه سال تنها از یک شناسه نسخه استفاده می‌کرد. طی این مدت، رفتارهای مدل‌های جدید و هدرهای آزمایشی بتا تغییرات سازگاری پرشماری به‌همراه داشتند. تعیین یک برنامه زمان‌بندی منظم برای نسخه‌گذاری، چارچوب مشخصی برای مهاجرت در اختیار تیم‌های فنی قرار می‌دهد؛ از سوی دیگر، هدر درخواستی anthropic-version پیاده‌سازی مرحله‌به‌مرحله را ممکن می‌سازد تا نیازی به تغییر هم‌زمان تمام سرویس‌ها نباشد.

این به‌روزرسانی همچنین شامل یک اسکیل به نام /claude-api برای ابزار Claude Code است که می‌تواند بخش‌های تحت تأثیر در کدهای پروژه را شناسایی کند و تغییرات سراسری مخزن کد را راهنمایی نماید. بخش عمده فرآیند مهاجرت نیازمند حذف پارامترهای نمونه‌برداری، اعتبارسنجی پیام‌های ذخیره‌شده گفت‌وگو، بررسی قوانین احراز هویت در پروکسی‌ها و به‌روزرسانی قابلیت‌های SDK پیش از انتخاب نسخه 2026-10-21 خواهد بود.