چگونه در 2026 به API GPT-5 دسترسی پیدا کنیم
Updated 2026-07-15
دو مسیر جواب میدهد: یک حساب OpenAI platform با اعتبار پیشپرداخت و سطوح مصرف، یا یک gateway سازگار با OpenAI با کلیدی که از طریق ایمیل تحویل داده میشود. این راهنما هر دو را پوشش میدهد، همراه با جدول سطوح، قیمتگذاری فعلی و کد شروع سریع آماده کپی.
پاسخ سریع: دو راه برای دسترسی به API GPT-5
دقیقاً دو مسیر کارآمد برای رسیدن به API GPT-5 در 2026 وجود دارد، و هر دو کمتر از یک روز طول میکشند. مسیر مستقیم: یک حساب در platform.openai.com بسازید، روش پرداخت اضافه کنید، اعتبار پیشپرداخت بخرید و یک کلید API از داشبورد بسازید. حساب شما از پایینترین سطح مصرف شروع میشود و با خرج کردن پول و گذشت زمان، محدودیتهای نرخ بالاتری باز میشود. اگر به یک رابطه صورتحساب مستقیم با OpenAI برای دلایل انطباق یا سازمانی نیاز دارید، این انتخاب درست است. مسیر gateway: از یک provider سازگار با OpenAI استفاده کنید که ظرفیت GPT-5.x را بازفروش میکند. از قبل برای موجودی پرداخت میکنید، یک کلید دریافت میکنید و مدل را با همان SDKها و همان فرمت درخواست فراخوانی میکنید. بدون حساب OpenAI، بدون تأیید شماره تلفن، بدون نردبان سطوح. اگر میخواهید اولین درخواست خود را در چند دقیقه ارسال کنید، اگر صورتحساب OpenAI از منطقه شما دردسرساز است، یا اگر کدبیس شما GPT-5.x را با Claude، Gemini یا DeepSeek ترکیب میکند و ترجیح میدهید یک موجودی را مدیریت کنید تا چهار تا، این انتخاب درست است. باقی این راهنما ابتدا مراحل OpenAI، سپس میانبر gateway، بعد قیمتگذاری، کد، و خطاهایی که واقعاً با آنها مواجه میشوید را مرور میکند.
دسترسی به API GPT-5 از OpenAI، گام به گام
کل این جریان وقتی تأیید هویت همکاری کند، ده تا بیست دقیقه طول میکشد. دو چیز تقریباً همه را غافلگیر میکند. اول، اعتبارها پیشپرداخت هستند. یک کلید معتبر با موجودی $0 هر درخواست را با خطای insufficient_quota شکست میدهد، که مثل یک مشکل احراز هویت به نظر میرسد اما در واقع یک مشکل صورتحساب است. دوم، محدودیتهای نرخ از سطح مصرف شما پیروی میکنند، نه از تمایل شما به پرداخت امروز. یک حساب تازه نمیتواند در یک بعدازظهر پول خود را به محدودیتهای سطح بالا تبدیل کند، چون ارتقای سطح هم به هزینه تجمعی و هم به روزهای سپریشده از اولین پرداخت شما نیاز دارد. اگر تاریخ راهاندازی دارید، ساعت سطح را زود شروع کنید.
- گام 1: یک حساب در platform.openai.com با ایمیل، Google یا SSO مایکروسافت بسازید. در بیشتر مناطق تأیید شماره تلفن لازم است.
- گام 2: Settings را باز کنید، سپس Billing، و یک روش پرداخت اضافه کنید. صورتحساب API پیشپرداخت است: ابتدا اعتبار میخرید و مصرف از موجودی کم میشود. حداقل خرید اعتبار کم است، بهطور تاریخی $5.
- گام 3: به صفحه API keys بروید و یک کلید بسازید. یک بار آن را کپی کنید، در یک متغیر محیطی یا secrets manager ذخیره کنید و هرگز آن را در کد سمت کلاینت ارسال نکنید.
- گام 4: شناسه مدلهایی که حساب شما میتواند ببیند را با یک درخواست GET به /v1/models فهرست کنید. مدلهای پرچمدار جدید GPT-5.x گاهی پیش از عرضه عمومی به سطوح مصرف بالاتر و سازمانهای تأییدشده میرسند.
- گام 5 (فقط در صورت نیاز): تأیید سازمانی، بررسی مدرک شناسایی دولتی، را تکمیل کنید وقتی مدل یا ویژگی خاصی که میخواهید پشت آن قفل شده باشد.
سطوح مصرف OpenAI: چه چیزی کِی باز میشود
سطوح برای مهار سوءاستفاده وجود دارند و بیشتر از آنچه صفحه قیمتگذاری نشان میدهد اهمیت دارند. محدودیتهای نرخ به ازای هر مدل بهصورت درخواست در دقیقه و token در دقیقه اعمال میشوند و هر دو با سطح مقیاس میگیرند. ترافیک اوج مورد انتظار خود را با سطحی که آن را پوشش میدهد تطبیق دهید پیش از اینکه به یک تاریخ راهاندازی متعهد شوید، و دورههای انتظار در جدول را در نظر بگیرید: پول بهتنهایی یک سطح را پیش نمیبرد، زمان سپریشده هم همینطور. چیزی که سطوح تغییر نمیدهند قیمت است. در سطح 1 و سطح 5 همان نرخهای هر token را پرداخت میکنید؛ سطح فقط سقف سرعت خرج کردن شما را تعیین میکند.
| سطح | شرایط احراز | معنای عملی آن |
|---|---|---|
| رایگان | بدون پرداخت ثبتشده | محدودیتهای بسیار پایین، دسترسی محدود به مدلها |
| سطح 1 | پرداخت $5 | محدودیتهای نرخ ورودی، بیشتر مدلها در دسترس |
| سطح 2 | پرداخت $50 و ۷+ روز از اولین پرداخت | درخواست و token در دقیقه بالاتر |
| سطح 3 | پرداخت $100 و ۷+ روز | مناسب برای اپلیکیشنهای تولیدی کوچک |
| سطح 4 | پرداخت $250 و ۱۴+ روز | بارهای کاری batch و همزمانی سنگینتر |
| سطح 5 | پرداخت $1,000 و ۳۰+ روز | بالاترین محدودیتهای منتشرشده |
مسیر gateway: دسترسی GPT-5.5 بدون حساب OpenAI
اگر راهاندازی حساب، نردبان سطوح، یا اصطکاک صورتحساب منطقهای مانع است، یک gateway سازگار با OpenAI کوتاهترین مسیر است. APIsRouter یکی از این gateway هاست: پرداخت در /topup بدون ثبتنام انجام میشود، شما اول پرداخت میکنید، و کلید API از طریق ایمیل میرسد. اولین شارژ +100% به موجودی اضافه میکند، مدلهای جهانی 20% پایینتر از قیمت رسمی اجرا میشوند و مدلهای چینی زیر نرخ رسمی قیمتگذاری شدهاند. خود این تعویض یک تغییر تکخطی است: base_url را به https://api.apisrouter.com/v1 اشاره دهید و مدل gpt-5.5 را درخواست کنید. بقیه چیزها، SDKها، شکل درخواست، streaming و tool call، دقیقاً همانطور میمانند که در کد فعلی OpenAI شما هستند. gateway ها در سه موقعیت بیشترین کاربرد را دارند: میخواهید پرداخت بر اساس مصرف بدون اشتراک و بدون حسابی برای نگهداری داشته باشید؛ خارج از دسترس آسان صورتحساب OpenAI هستید؛ یا همان اپلیکیشن ترافیک را بین GPT-5.5، Claude، Gemini، DeepSeek و GLM مسیردهی میکند و میخواهید یک موجودی و یک لاگ مصرف داشته باشید نه یک کنسول جداگانه به ازای هر vendor. چیزی که یک gateway جایگزینش نمیشود یک قرارداد سازمانی مستقیم است، بنابراین تیمهایی با الزامات تدارکاتی سختگیرانه معمولاً همچنان مستقیم میروند.
قیمت GPT-5.5 در کنار جایگزینها
جدول زیر نرخهای کاتالوگ gateway را به دلار آمریکا به ازای هر یک میلیون token نشان میدهد. الگویی که برای بودجهبندی اهمیت دارد: token های خروجی در مدلهای پرچمدار چند برابر بیشتر از token های ورودی هزینه دارند، و بارهای کاری چت و استدلال خروجیمحور هستند. یک agent gpt-5.5 که با صدای بلند فکر میکند میتواند چندین برابر آنچه همان ترافیک روی deepseek-v4-pro هزینه دارد، هزینه داشته باشد، بنابراین یک راهاندازی تولیدی رایج، پیشنویسها، استخراج و کارهای انبوه را به یک مدل ارزان مسیردهی میکند و gpt-5.5 را برای فراخوانیهایی نگه میدارد که واقعاً به استدلال پرچمدار نیاز دارند.
| شناسه مدل | ورودی / 1M token | خروجی / 1M token | بهترین کاربرد |
|---|---|---|---|
| gpt-5.5 | $4.00 | $24.00 | استدلال پرچمدار، کدنویسی، agent ها |
| claude-opus-4-7 | $4.00 | $20.00 | سختترین استدلال و کارهای طولانی |
| claude-sonnet-4-6 | $2.40 | $12.00 | نثر باکیفیت با قیمت میانی |
| gemini-3.5-flash | $1.20 | $7.20 | context طولانی، پاسخهای سریع |
| glm-5 | $0.514 | $2.314 | همهکاره با ارزش |
| deepseek-v4-pro | $0.3915 | $0.783 | اسب کاری اقتصادی برای ترافیک انبوه |
| grok-4.5 | $1.60 | $4.80 | پرچمدار xAI، context ۵۰۰K |
شروع سریع: اولین فراخوانی GPT-5.5 شما با curl و Python
هر دو قطعه کد به endpoint گیتوی میزنند. برای اجرای همان کد مستقیماً روی OpenAI، base URL را با https://api.openai.com/v1 عوض کنید، از کلید OpenAI خودتان استفاده کنید و مدل را روی یک شناسه GPT-5.x که حساب شما در معرض آن قرار میدهد تنظیم کنید (آنها را با GET /v1/models فهرست کنید). schema درخواست و پاسخ یکسان است، که کل هدف سازگاری OpenAI همین است: منطق retry، handlerهای streaming و parsing tool-call شما بدون تغییر منتقل میشوند.
curl https://api.apisrouter.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [
{"role": "user", "content": "Summarize RFC 9110 in three bullets"}
]
}'خطاهای رایج و معنای واقعی آنها
بیشتر شکستهای API GPT-5 در شش دسته قرار میگیرند. پیش از تغییر هرچیزی، دسته را از کد وضعیت و بدنه خطا شناسایی کنید، چون رایجترین اشتباه بازسازی یک کلید کاملاً معتبر برای رفع چیزی است که در واقع یک مشکل صورتحساب یا نرخ است. بهطور خاص برای خطاهای 429: backoff نمایی با jitter و سقف تلاش مجدد حدود پنج بار، موارد گذرا را جذب میکند. اگر 429 ها بهجای موجی، مداوم باشند، رفع مشکل ساختاری است. در OpenAI مستقیم یعنی بالا رفتن از یک سطح مصرف یا درخواست افزایش محدودیت؛ در یک gateway یعنی بررسی موجودی و کاهش همزمانی اوج.
| خطا | دلیل معمول | راهحل |
|---|---|---|
| 401 invalid_api_key | کلید اشتباه، هدر بدشکل، یا کلیدی که متعلق به endpoint دیگری است | Authorization: Bearer <key> ارسال کنید و تأیید کنید کلید با base URL که فراخوانی میکنید مطابقت دارد |
| 404 model_not_found | اشتباه تایپی در شناسه مدل، یا مدل برای حساب یا سطح شما در دسترس نیست | GET /v1/models بزنید و شناسه دقیق را از پاسخ کپی کنید |
| 429 rate_limit_exceeded | درخواست یا token در دقیقه بالاتر از سقف فعلی شما | backoff نمایی اضافه کنید، max_tokens را کاهش دهید، ترافیک را پخش کنید، یا سطح خود را بالا ببرید |
| 429 insufficient_quota | موجودی پیشپرداخت خالی است | شارژ کنید. همان کلید بهمحض مثبت شدن موجودی دوباره کار میکند |
| 400 context_length_exceeded | prompt بهعلاوه خروجی درخواستی از پنجره مدل فراتر میرود | تاریخچه مکالمه را کوتاه کنید یا max_tokens را کاهش دهید |
| 5xx یا timeout | حادثه upstream یا اضافهبار | با backoff دوباره تلاش کنید و پیش از دیباگ کد خود صفحه وضعیت provider را بررسی کنید |
پرسشهای پرتکرار
چطور به API GPT-5 دسترسی پیدا کنم؟
یک حساب در platform.openai.com بسازید، روش پرداخت اضافه کنید، اعتبار پیشپرداخت بخرید و یک کلید API از داشبورد بسازید. یا از یک gateway سازگار با OpenAI استفاده کنید که در آن برای موجودی پرداخت میکنید و کلید از طریق ایمیل بدون راهاندازی حساب دریافت میکنید. هر دو مسیر همان فرمت درخواست chat completions را ارائه میدهند.
آیا API GPT-5 رایگان است؟
خیر. OpenAI صورتحساب API را به ازای هر token صادر میکند و به اعتبار پیشپرداخت نیاز دارد، و اشتراکهای ChatGPT مصرف API را شامل نمیشوند. اعتبارهای تبلیغاتی گاهی ظاهر میشوند اما چیزی نیستند که بتوان یک پروژه را روی آن برنامهریزی کرد. اگر هزینه محدودیت است، مدلهای اقتصادی مانند deepseek-v4-flash یا glm-5 با کسری از نرخهای پرچمدار اجرا میشوند.
آیا برای استفاده از API GPT-5 به ChatGPT Plus نیاز دارم؟
خیر. ChatGPT Plus و API محصولات جداگانه با صورتحسابهای جداگانه هستند. اشتراک Plus برنامه چت را در اختیارتان میگذارد؛ دسترسی API به اعتبار platform و یک کلید API نیاز دارد. میتوانید هرکدام را بدون دیگری داشته باشید، و پرداخت برای هر دو آنها را به هم متصل نمیکند.
API GPT-5 چقدر هزینه دارد؟
GPT-5.x به ازای هر token صورتحساب میشود، با قیمت خروجی چند برابر بالاتر از ورودی. در کاتالوگ gateway، gpt-5.5 با $4.00 به ازای هر یک میلیون token ورودی و $24.00 برای هر یک میلیون token خروجی اجرا میشود. یک نوبت چت معمولی با prompt کوتاه و چند صد token خروجی، خیلی کمتر از یک سنت هزینه دارد.
آیا میتوانم بدون حساب OpenAI از API GPT-5 استفاده کنم؟
بله، از طریق یک gateway سازگار با OpenAI. موجودی شارژ میکنید، یک کلید API از طریق ایمیل دریافت میکنید و GPT-5.x را با SDKهای استاندارد OpenAI که به base URL گیتوی اشاره دارند فراخوانی میکنید. این کار همچنین دورههای انتظار سطح مصرف را دور میزند، هرچند تیمهایی با الزامات تدارکاتی یا انطباق سختگیرانه ممکن است همچنان به یک رابطه مستقیم با OpenAI نیاز داشته باشند.
چرا کلید API GPT-5 من مدام خطای 429 برمیگرداند؟
یک 429 یا به معنای محدودیت نرخ است یا موجودی خالی، و بدنه خطا میگوید کدامیک. rate_limit_exceeded یعنی از سقف درخواست یا token در دقیقه خود عبور کردهاید: backoff اضافه کنید یا سطح خود را بالا ببرید. insufficient_quota یعنی اعتبار پیشپرداخت شما تمام شده: شارژ کنید و همان کلید بلافاصله دوباره کار میکند.