بررسی‌شده خط‌به‌خط با راهنمای رسمی مهاجرت · 2026-10-21

مهاجرت از GPT-5.6 به Astra
چهار نکته‌ای که شما را به اشتباه می‌اندازد

راهنمای رسمی مهاجرت OpenAI هفت مورد دارد؛ چهار محدودیت قطعی برای gpt-6-astra عبارت‌اند از: حذف temperature، top_p و top_logprobs (به‌همراه logprobs در Chat Completions)؛ سطح استدلال none پشتیبانی نمی‌شود، بنابراین هر چیزی روی none یا minimal از low شروع می‌شود؛ فراخوانی ابزار به نقطه پایانی Responses نیاز دارد؛ و سقف خروجی 128,000 شامل توکن‌های استدلال است. مورد سوم همانی است که افراد آن را باگ کد خودشان اشتباه می‌گیرند. با بازخوانی خط‌به‌خط راهنمای کامل «Using GPT-6» در 2026-10-21، دو مورد دیگر نیز باید در فهرست شما باشد: هنگام مهاجرت از GPT-5.5 یا نسخه‌های پیش‌تر، prompt_cache_retention را با prompt_cache_options.ttl روی «30m» جایگزین کنید، و از configuration_update برای تغییر میزان تلاش استدلال در میانه گفتگو استفاده کنید.

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

Claude، GPT و مدل‌های چینی با یک کلید، با صورت‌حساب به‌ازای توکن؛ مدل‌های قابل فراخوانی را در /models ببینید.

#مدل GPT-6 Astra#محدودیت‌های مهاجرت#Responses الزامی است#بدون سطح none

چهار محدودیت قطعی

4 پارامتر

باید حذف شوند

temperature، top_p، top_logprobs — و همچنین logprobs اگر روی Chat Completions هستید؛ در Responses، message.output_text.logprobs را از include حذف کنید. راهنما این را به برابر نبودن میزان تلاش استدلال با none مرتبط می‌کند.

بدون none

فقط پنج سطح استدلال

low، medium، high، xhigh، max. Astra و GPT-6.1 Sol از none پشتیبانی نمی‌کنند — راهنما می‌گوید به‌جای آن از low استفاده کنید — در حالی که GPT-6 Sol و GPT-6 Luna هنوز پشتیبانی می‌کنند. اگر درخواست شما از minimal استفاده می‌کند، با low شروع کنید و نتایج را روی وظایف نمونه مقایسه کنید.

Responses

تنها نقطه پایانی برای فراخوانی ابزار

عبارت رسمی: Astra از Chat Completions پشتیبانی می‌کند، اما فراخوانی ابزار به Responses نیاز دارد. گفتگو می‌کند؛ ابزارها را فراخوانی نمی‌کند.

128,000

سقف خروجی شامل استدلال است

توکن‌های استدلال جزو خروجی محسوب می‌شوند، بنابراین اگر max_tokens را بر اساس پاسخ قابل‌مشاهده تعیین کنید، خروجی زودتر قطع می‌شود.

موردی که شبیه باگ خودتان به نظر می‌رسد

بیشتر مشکلات مهاجرت به‌صورت خطایی در کد خودتان بروز می‌کنند: همان مسیر function calling روی GPT-5.6 کار می‌کند، اما روی gpt-6-astra ابزارها به‌سادگی فراخوانی نمی‌شوند، بدون خطای آشکار. راهنمای رسمی مهاجرت در این باره صریح است — Astra از Chat Completions پشتیبانی می‌کند، اما فراخوانی ابزار به نقطه پایانی Responses نیاز دارد. روی Chat Completions یک گفتگوی عادی انجام می‌دهد و هرگز ابزاری را فراخوانی نمی‌کند. پیش از اشکال‌زدایی schema خود، نقطه پایانی را بررسی کنید.

چرا پارامترهای نمونه‌برداری باید حذف شوند

راهنمای مهاجرت حذف temperature، top_p و top_logprobs را الزامی می‌کند، و همچنین logprobs را اگر از Chat Completions استفاده می‌کنید. این‌ها معمولاً به‌صورت پیش‌فرض در لایه wrapper یک تیم تنظیم می‌شوند، بنابراین کم‌هزینه‌ترین راه‌حل این است که به‌جای ویرایش هر محل فراخوانی، هنگام ارسال درخواست بر اساس نام مدل فیلتر کنید. مرتبط: اگر wrapper شما میزان تلاش استدلال را به‌صورت پیش‌فرض روی none یا minimal می‌گذارد، همان‌جا به آن رسیدگی کنید — Astra چنین سطحی ندارد. در بازخوانی مطابق راهنمای کامل «Using GPT-6» در 2026-10-21، GPT-6 این موارد را نیز اضافه می‌کند: فراخوانی ابزار async (روی یک function یا ابزار سفارشی async: true را تنظیم کنید و نتیجه را با همان call_id اصلی برگردانید)، هدایت میان‌نوبت، و پایش ناهم‌راستایی. در Codex، مهارت OpenAI Docs کل فهرست را با یک فرمان اعمال می‌کند: `$openai-docs migrate this project to the GPT-6 model family`.

زمان‌بندی

2026-09-03

GPT-6 Astra با شناسه مدل API برابر gpt-6-astra عرضه می‌شود: 1,050,000 پنجره زمینه، 922,000 حداکثر ورودی، 128,000 حداکثر خروجی، تاریخ قطع دانش 2026-04-30.

2026-09-03

راهنمای رسمی مهاجرت هم‌زمان با آن منتشر می‌شود: حذف پارامترهای نمونه‌برداری، بدون سطح none، فراخوانی ابزار روی Responses. نقاط پایانی پشتیبانی‌شده عبارت‌اند از Chat Completions، Responses و Batch.

2026-10-21

این صفحه خط‌به‌خط با مستندات رسمی مدل و راهنمای مهاجرت بررسی شد؛ از هیچ خلاصه دست‌دوم از پارامترها استفاده نشد. در 2026-10-21، راهنمای کامل «Using GPT-6» خط‌به‌خط بازخوانی شد و TTL کش prompt، configuration_update و شکل‌های جدیدتر فراخوانی ابزار نیز اضافه شد.

آنچه نوشته شده و آنچه نشده

✅ مستقیماً از راهنمای رسمی

temperature، top_p و top_logprobs را حذف کنید (به‌علاوه logprobs در Chat Completions)؛ مقدار none پشتیبانی نمی‌شود، بنابراین از low شروع کنید و مقایسه کنید؛ Astra از Chat Completions پشتیبانی می‌کند اما tool calling به Responses نیاز دارد؛ سطوح استدلال عبارت‌اند از low، medium، high، xhigh و max؛ نقاط پایانی پشتیبانی‌شده عبارت‌اند از Chat Completions، Responses و Batch؛ پنجره زمینه 1,050,000، حداکثر ورودی 922,000، حداکثر خروجی 128,000. زمینه بلند در همان صفحه رسمی مدل آمده است: promptهایی با بیش از 272K توکن ورودی با نرخ‌های 2x ورودی و کش و 1.5x خروجی برای کل درخواست قیمت‌گذاری می‌شوند، نه فقط مقدار مازاد (بازبینی‌شده در 2026-09-29). در 2026-10-21 در برابر راهنمای کامل «Using GPT-6» بازبینی شد، که همچنین بیان می‌کند: وقتی reasoning effort برابر none نیست، Responses همچنین message.output_text.logprobs را از include حذف می‌کند؛ GPT-6 Sol و GPT-6 Luna از none پشتیبانی می‌کنند، Astra و GPT-6.1 Sol پشتیبانی نمی‌کنند؛ GPT-6 Sol و GPT-6 Luna از function calling در Chat Completions فقط با reasoning_effort: 'none' پشتیبانی می‌کنند؛ برای تغییر reasoning effort در میانه مکالمه، یک آیتم ورودی configuration_update اضافه کنید و reasoning.effort را در سطح درخواست بدون تغییر نگه دارید تا پیشوند prompt برای کش حفظ شود؛ هنگام مهاجرت از GPT-5.5 یا نسخه‌های پیش‌تر، prompt_cache_retention را با prompt_cache_options.ttl تنظیم‌شده روی «30m» جایگزین کنید؛ Fast mode از اقامت داده‌های EU برای GPT-6.1 Sol، GPT-6 Sol و GPT-6 Luna پشتیبانی می‌کند، اما برای GPT-6 Astra نه؛ و GPT-6 همچنین از قابلیت‌های موجود API که با GPT-5.6 در دسترس‌اند پشتیبانی می‌کند.

⚠️ در مستندات رسمی نیست

تعداد پارامترها و امتیاز SWE-bench Verified چیزهایی هستند که مستندات رسمی هنوز ارائه نمی‌دهد. اینکه آیا زمینه بلند (ورودی بالای 272,000) کل درخواست را دوباره قیمت‌گذاری می‌کند یا فقط مقدار مازاد را، دیگر یکی از آن‌ها نیست: صفحه رسمی مدل آن را بیان می‌کند، و پس از بازبینی واژه‌به‌واژه در 2026-09-29 این خط به ستون سمت چپ منتقل شد. اعدادی که به‌صورت آنلاین درباره آن دو مورد می‌چرخند رسمی نیستند و در این صفحه استفاده نمی‌شوند.

دو مسیر مهاجرت

فیلتر در لایه wrapper

پارامترهای پشتیبانی‌نشده را هنگام خروج بر اساس نام مدل حذف کنید و none/minimal را به low نگاشت کنید. یک تغییر، همه نقاط فراخوانی از آن سود می‌برند، و بازگردانی هم فقط یک تغییر است. زمانی بهترین گزینه است که نقاط فراخوانی پراکنده باشند.

ویرایش هر نقطه فراخوانی

دقیق اما کند است و معمولاً پیش‌فرض‌های wrapper را از دست می‌دهد. فقط زمانی ارزش دارد که نقاط فراخوانی کم باشند یا نقاط مختلف واقعاً به رفتار متفاوت نیاز داشته باشند.

یک ترتیب معقول

ابتدا مسیر tool calling را به نقطه پایانی Responses منتقل کنید و آن را به کار بیندازید، زیرا تنها موردی است که بی‌صدا شکست می‌خورد. سپس چهار پارامتر نمونه‌گیری را در لایه wrapper حذف کنید، none/minimal را به low نگاشت کنید و در Responses، message.output_text.logprobs را از include حذف کنید. اگر از GPT-5.5 یا نسخه‌های پیش‌تر مهاجرت می‌کنید، prompt_cache_retention را با prompt_cache_options.ttl تنظیم‌شده روی «30m» جایگزین کنید؛ برای تغییر reasoning effort در میانه مکالمه، یک آیتم ورودی configuration_update اضافه کنید و reasoning.effort را در سطح درخواست بدون تغییر نگه دارید تا پیشوند کش‌شده همچنان از کش خوانده شود. سپس max_tokens را با محاسبه جدید بازبینی کنید — 128,000 شامل توکن‌های استدلال است. در نهایت همان درخواست‌های واقعی را روی gpt-5.6-sol و gpt-6-astra اجرا کنید و بگذارید تفاوت کیفیت و هزینه تعیین کند چه مقدار را منتقل می‌کنید.

در QCode

gpt-6-astra در جدول مدل‌های QCode قرار دارد. این مدل یک کلید و یک سهمیه را با GPT-5.6 Sol / Terra و Claude مشترک دارد، که مقایسه مهاجرت را آسان می‌کند: همان نقطه پایانی، همان کلید، فیلد model را تغییر دهید و همان دسته درخواست‌ها را روی هر دو اجرا کنید. تفاوت هزینه و کیفیت همان روز نمایان می‌شود. یک تمایز دیگر: CNBC گزارش داد (WSJ نخست آن را گزارش کرد) که OpenAI تصمیم گرفت GPT-6.1 Astra را منتشر نکند؛ سایت خود OpenAI و حساب‌های رسمی آن چنین بیانیه‌ای ندارند، بنابراین این صفحه آن را به‌عنوان گزارش رسانه‌ای ثبت می‌کند. تا تاریخ 2026-10-21، مدل‌های منتشرشده GPT-6 در دسترس در QCode عبارت‌اند از gpt-6-astra، gpt-6-sol و gpt-6.1-sol. QCode در حال حاضر از gpt-6-luna یا gpt-5.6-luna پشتیبانی نمی‌کند؛ لطفاً از مدل GPT دیگری مانند gpt-6.1-sol، gpt-6-sol یا gpt-5.6-terra استفاده کنید. جدول منسوخ‌سازی خود OpenAI مجموعه‌ای از snapshotهای قدیمی GPT را که در 2026-04-22 اعلام شده‌اند، به‌عنوان حذف‌شده در 2026-10-23 فهرست می‌کند.

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

چرا function calling من روی Astra کار نمی‌کند؟

معمولاً نقطه پایانی است. راهنمای مهاجرت رسمی بیان می‌کند که Astra از Chat Completions پشتیبانی می‌کند، اما tool calling به Responses نیاز دارد. در Chat Completions به‌طور عادی گفتگو می‌کند و صرفاً هرگز ابزاری را فراخوانی نمی‌کند. GPT-6 Sol و GPT-6 Luna از function calling در Chat Completions پشتیبانی می‌کنند، اما فقط با reasoning_effort تنظیم‌شده روی «none». آن مسیر را پیش از اشکال‌زدایی schema خود به Responses منتقل کنید.

کدام پارامترها باید حذف شوند؟

وقتی تلاش استدلال برابر none نیست، راهنما می‌گوید temperature، top_p و top_logprobs را حذف کنید؛ اگر روی Chat Completions هستید logprobs را هم حذف کنید، و روی Responses، message.output_text.logprobs را از include بردارید. همان چهار پارامتر نمونه‌گیری هستند که راهنمای رسمی مهاجرت فهرست می‌کند.

از تلاش استدلال = none استفاده می‌کردم. حالا چه کنم؟

Astra و GPT-6.1 Sol از none پشتیبانی نمی‌کنند — راهنما می‌گوید به‌جای آن از low استفاده کنید. همچنین توصیه می‌کند اگر درخواست فعلی شما از minimal استفاده می‌کند، با low شروع کنید و نتایج را روی وظایف نمونه مقایسه کنید. نام این تنظیم در Responses به‌صورت reasoning.effort و در Chat Completions به‌صورت reasoning_effort نوشته می‌شود. برای بالا یا پایین بردن تلاش در میانه گفتگو، یک آیتم ورودی configuration_update اضافه کنید و reasoning.effort را در سطح درخواست بدون تغییر نگه دارید؛ این کار پیشوند prompt را برای کش حفظ می‌کند. توجه کنید که توکن‌های استدلال جزو خروجی به حساب می‌آیند، بنابراین سطح بالاتر در سمت خروجی هزینه بیشتری دارد.

max_tokens را چگونه تنظیم کنم؟

به یاد داشته باشید که سقف خروجی 128,000 شامل توکن‌های استدلال است. اگر اندازه آن را بر اساس پاسخ قابل‌مشاهده تعیین کنید، مدل می‌تواند سهمیه را در حین استدلال خرج کند و زودتر قطع شود. هنگام مهاجرت، آن سقف را با محاسبه جدید دوباره بررسی کنید.

چقدر می‌توانم از زمینه استفاده کنم؟

مستندات رسمی مدل، پنجره زمینه 1,050,000 با حداکثر ورودی 922,000 و حداکثر خروجی 128,000 را اعلام می‌کند. قاعده زمینه بلند هم ذکر شده است: prompt‌هایی با بیش از 272K توکن ورودی، برای کل درخواست با نرخ‌های 2x ورودی و کش و 1.5x خروجی قیمت‌گذاری می‌شوند — کل درخواست، نه فقط مازاد (بازبینی‌شده در 2026-09-29). QCode به‌ازای هر توکن صورت‌حساب می‌کند؛ قیمت واحد هر مدل در /models است.

راه کم‌ریسک برای تغییر چیست؟

در QCode، همان دسته از درخواست‌های واقعی را به gpt-5.6-sol و gpt-6-astra بفرستید — یک کلید، یک سهمیه، فقط فیلد model تغییر می‌کند. پیش از انتخاب بین مسیریابی بر اساس وظیفه و انتقال همه‌چیز، تصمیم بگیرید که آیا تفاوت کیفیت ارزش تفاوت هزینه را دارد یا نه.

منابع

راهنمای رسمی مهاجرت OpenAI با عنوان «Using GPT-6» (سطح‌های استدلال، نقطه پایانی فراخوانی ابزار، پارامترهای پشتیبانی‌نشده، اقامت داده، تغییر تلاش استدلال در میانه گفتگو، کش prompt)، مستندات رسمی مدل (زمینه، سقف خروجی، نقاط پایانی پشتیبانی‌شده، قطع دانش) و جدول رسمی منسوخ‌سازی، همه در 2026-10-21 ثبت شده‌اند. مواردی که مستندات بیان نمی‌کنند اینجا به‌عنوان منتشر‌نشده علامت خورده‌اند، نه اینکه از اشخاص ثالث پر شده باشند. حجم فراخوانی‌های QCode از آمار مصرف 30 روزه خود همین سایت می‌آید.

یک کلید، هر دو مدل را روی همان دسته اجرا کنید

gpt-6-astra یک کلید QCode و یک سهمیه را با GPT-6.1 Sol، GPT-5.6 Sol / Terra و Claude به اشتراک می‌گذارد؛ مقایسه مهاجرت یک تغییر فیلد model است. پلن‌های شخصی از $9 در ماه شروع می‌شوند و کلید همان لحظه‌ای که پرداخت می‌کنید فعال است. کاربران پلن‌های شخصی یک بسته تقویتی می‌خرند؛ بدون پلن، یک بسته پرداخت به‌ازای مصرف بخرید.

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

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

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

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

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