Claude API · نسخه 2026-10-21

Claude API 2026-10-21: پارامترهای نمونه‌گیری حذف شدند

از 2026-10-26، Anthropic نسخه 2026-10-21 از Claude API را منتشر کرده است؛ درخواستی که temperature، top_p یا top_k را ارسال کند، روی هر مدل خطای 400 برمی‌گرداند، حتی با مقدار پیش‌فرض. نسخه 2023-06-01 هنوز کار می‌کند و صفحه رسمی نسخه هیچ تاریخی برای منسوخ شدن آن فهرست نکرده است.

به‌روزرسانی شده 2026-11-14

یک کلید برای Claude، GPT و مدل‌های پیشروی چینی، با صورت‌حساب به‌ازای توکن، آماده به کار در چند دقیقه.

#2026-10-21#temperature / top_p / top_k#HTTP 400#Apache-2.0

چهار نکته کلیدی

400

پارامترهای نمونه‌گیری خطا می‌دهند

صفحه رسمی نسخه: ارسال هر یک از temperature، top_p یا top_k روی هر مدل خطای 400 برمی‌گرداند.

2023-06-01

نسخه قدیمی هنوز کار می‌کند

راهنمای رسمی مهاجرت می‌گوید درخواست‌هایی که به مقدارهای نمونه‌گیری غیرپیش‌فرض وابسته‌اند می‌توانند روی 2023-06-01 بمانند؛ صفحه نسخه هیچ تاریخی برای منسوخ شدن فهرست نکرده است.

Python 2.0.0

SDK‌ها به‌طور پیش‌فرض نسخه جدید را ارسال می‌کنند

یادداشت‌های انتشار رسمی: Python SDK 2.0.0 و TypeScript SDK 1.0.0 به‌طور پیش‌فرض 2026-10-21 را ارسال می‌کنند؛ C#، Go، Java، PHP، Ruby و ant CLI هم نسخه‌های جدید دارند.

Apache 2.0

تغییر مجوز

یادداشت‌های انتشار رسمی: نسخه‌های جدید SDK و CLI به Apache 2.0 منتقل می‌شوند؛ نسخه‌های پیشین تحت MIT می‌مانند.

چه چیزی در 2026-10-21 تغییر کرد

یادداشت‌های انتشار رسمی، 2026-10-21 را به‌عنوان یک نسخه جدید API فهرست می‌کنند. صفحه نسخه تغییرات Messages API را فهرست می‌کند، از جمله: قرار دادن مستقیم یک بلوک document در پیام assistant خطای 400 برمی‌گرداند؛ یک بلوک text با آرایه citations غیرخالی در پیام user خطای 400 برمی‌گرداند؛ temperature، top_p و top_k حذف شده‌اند و ارسال هر یک از آن‌ها روی هر مدل خطای 400 برمی‌گرداند. راهنمای مهاجرت اضافه می‌کند که این خطا حتی با مقدار پیش‌فرض هم رخ می‌دهد، بنابراین هر سه را حذف کنید.

آنچه یادداشت‌های انتشار می‌گویند

یادداشت‌های انتشار 2026-10-21 همچنین نسخه‌های جدید SDK و ant CLI را فهرست می‌کنند: Python 2.0.0، TypeScript 1.0.0، C# 13.0.0، Go 2.0.0، Java 3.0.0، PHP 1.0.0، Ruby 2.0.0 و ant CLI 2.0.0 که همگی به‌طور پیش‌فرض 2026-10-21 را ارسال می‌کنند. این نسخه‌ها تغییرات ناسازگار نامرتبط با نسخه API هم دارند و مجوز از MIT به Apache 2.0 تغییر می‌کند.

گاه‌شمار

2026-10-21

Anthropic نسخه API 2026-10-21 را همراه با نسخه‌های SDK و ant CLI که به‌طور پیش‌فرض از آن استفاده می‌کنند منتشر می‌کند.

2026-10-21

Claude Code 2.1.307 فرمان /claude-api api-version را اضافه می‌کند تا کد Claude API را به 2026-10-21 منتقل کند.

2026-10-26

بررسی‌شده با صفحه رسمی نسخه: نسخه 2023-06-01 هنوز هیچ تاریخ منسوخ‌شدنی در فهرست ندارد.

تأییدشده در برابر منتشرنشده

تأییدشده (عیناً در صفحه‌های رسمی)

2026-10-21 منتشر شده است؛ ارسال temperature، top_p یا top_k خطای 400 برمی‌گرداند؛ نسخه 2023-06-01 هنوز کار می‌کند؛ نسخه‌های جدید SDK به‌طور پیش‌فرض 2026-10-21 را ارسال می‌کنند؛ SDK و CLI جدید از Apache 2.0 استفاده می‌کنند؛ Claude Code 2.1.307 فرمان /claude-api api-version را اضافه می‌کند.

تأییدنشده و منتشرنشده

صفحه رسمی نسخه و یادداشت‌های انتشار هیچ تاریخ منسوخ‌شدنی برای 2023-06-01 و هیچ تاریخی برای پایان پشتیبانی از نسخه قدیمی ارائه نمی‌دهند. صفحه نسخه فقط می‌گوید Anthropic توصیه می‌کند در صورت امکان از آخرین نسخه API استفاده شود.

درخواست قدیمی در برابر درخواست جدید

یک درخواست 2023-06-01

می‌تواند temperature، top_p و top_k را ارسال کند؛ SDK‌های قدیمی‌تر به‌طور پیش‌فرض 2023-06-01 را ارسال می‌کنند. راهنمای مهاجرت می‌گوید درخواست‌هایی که به مقدارهای غیرپیش‌فرض وابسته‌اند می‌توانند روی این نسخه بمانند.

یک درخواست 2026-10-21

نمی‌تواند آن سه پارامتر را ارسال کند؛ ارسال هر یک از آن‌ها روی هر مدل خطای 400 برمی‌گرداند. بدون آن‌ها، درخواست نمونه‌گیری را با مقادیر پیش‌فرض انجام می‌دهد، از جمله با temperature برابر 1.0.

مراحل مهاجرت

① درخواست‌های خود را همان‌طور که راهنمای رسمی مهاجرت می‌گوید به‌روزرسانی کنید: temperature، top_p و top_k را حذف کنید (ارسال هر یک از آن‌ها خطای 400 برمی‌گرداند)، بلوک‌های document را در پیام‌های user به‌جای پیام‌های assistant ارسال کنید و citations را از بلوک‌های text در پیام‌های user حذف کنید. ② بدون SDK، هدر anthropic-version را روی 2026-10-21 تنظیم کنید؛ با SDK، به نخستین نسخه‌ای ارتقا دهید که آن را به‌طور پیش‌فرض ارسال می‌کند، مانند Python 2.0.0 یا TypeScript 1.0.0. ③ تغییرات ناسازگار نسخه اصلی SDK را که نامرتبط با نسخه API هستند مدیریت کنید و یکپارچه‌سازی خود را پیش از انتشار در برابر 2026-10-21 آزمایش کنید.

فراخوانی Claude در QCode

جدول نقاط پایانی QCode نشانی https://api.qcode.cc/api را به‌عنوان base_url برای Claude Agent SDK ارائه می‌دهد، همراه با یک کلید cr_ از داشبورد. صورت‌حساب به‌ازای هر توکن است، با نرخ‌های هر مدل در /models. برای مهاجرت، کد درخواست خودتان باید temperature، top_p و top_k را حذف کند (راهنمای رسمی مهاجرت).

پرسش‌های متداول

آیا پس از 2026-10-21 همچنان می‌توان temperature ارسال کرد؟

خیر. صفحه رسمی نسخه می‌گوید آن سه پارامتر حذف شده‌اند و ارسال هر یک از آن‌ها روی هر مدل خطای 400 برمی‌گرداند؛ راهنمای مهاجرت اضافه می‌کند که این اتفاق حتی با مقدار پیش‌فرض هم رخ می‌دهد.

نسخه 2023-06-01 چه زمانی از کار می‌افتد؟

صفحه نسخه رسمی هیچ تاریخ منسوخ‌شدنی را فهرست نمی‌کند و یادداشت‌های انتشار هیچ زمان‌بندی‌ای ارائه نمی‌دهند. راهنمای مهاجرت فقط می‌گوید درخواست‌هایی که به مقادیر نمونه‌گیری غیرپیش‌فرض متکی هستند می‌توانند روی 2023-06-01 بمانند.

کدام نسخه‌های SDK به‌طور پیش‌فرض از 2026-10-21 استفاده می‌کنند؟

یادداشت‌های انتشار رسمی این موارد را فهرست می‌کنند: Python 2.0.0، TypeScript 1.0.0، C# 13.0.0، Go 2.0.0، Java 3.0.0، PHP 1.0.0، Ruby 2.0.0 و ant CLI 2.0.0.

اگر پارامترهای نمونه‌گیری را حذف کنید چه اتفاقی می‌افتد؟

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

آیا Claude Code دستور مهاجرت دارد؟

مدخل رسمی تغییرات برای 2.1.307 (2026-10-21) می‌گوید این انتشار /claude-api api-version را اضافه می‌کند تا کد Claude API را به 2026-10-21 منتقل کند.

هنگام فراخوانی Claude روی QCode چه چیزی تغییر می‌کند؟

از مستندات QCode استفاده کنید: base_url در Claude Agent SDK برابر https://api.qcode.cc/api است و کلید، یک کلید cr_ است. برای مهاجرت، کد درخواست خودتان باید temperature، top_p و top_k را حذف کند؛ مدل‌ها به‌ازای هر توکن صورت‌حساب می‌شوند و نرخ هر مدل در /models آمده است.

منابع

یادداشت‌های انتشار رسمی Anthropic، صفحه نسخه API و راهنمای مهاجرت 2026-10-21 (ثبت‌شده در 2026-10-26)؛ تغییرات رسمی Claude Code (ثبت‌شده در 2026-10-26)؛ صفحه نقطه پایانی مستندات QCode و صفحات پرداخت به‌ازای مصرف (ثبت‌شده در 2026-10-26)؛ صفحه /models در QCode (ثبت‌شده در 2026-10-26).

پیش از شروع خطاهای 400، مراحل رسمی را دنبال کنید

می‌خواهید ابتدا چند روز آن را امتحان کنید؟ برای پلن ماهانه آماده نیستید؟ بسته‌های پرداخت به‌ازای مصرف از $4 شروع می‌شوند برای سهمیه‌ای یک‌باره که ظرف 7 روز مصرف می‌کنید؛ اگر از قبل پلن شخصی دارید، هر زمان به سهمیه بیشتری نیاز داشتید یک بسته تقویتی اضافه کنید.

مطمئن نیستید از کجا شروع کنید؟

یک هفته امتحان کنید

بسته کوچک: $4 برای $30 سهمیه، به مدت 7 روز معتبر

هر روز از آن استفاده کنید

Starter: $9.00/ماه با $5 سهمیه در هر روز — فقط $0.060 به‌ازای هر $1 سهمیه، در برابر حدود $0.113 برای بسته متوسط