راه‌اندازی API Astra با احراز هویت رسمی OpenAI

با ارائه‌دهنده و حساب صورتحساب شروع کنید

از gpt-6-astra از مسیر API شرکت OpenAI و با کلید OpenAI Platform خود استفاده کنید. برای یک برنامه از نمونه Responses زیر شروع کنید. برای کار کدنویسی محلی از فرمان‌های ورود و انتخاب مدل Codex CLI استفاده کنید. هر دو مسیر از حساب Platform شما استفاده می‌کنند و بر اساس نرخ‌های مربوط OpenAI هزینه API دارند.

پیش از اجرای درخواست، تأیید کنید مالک پروژه Platform کیست، کلید آن به مدل دسترسی دارد یا نه و کدام کنترل‌های صورتحساب اعمال می‌شوند. دیده‌شدن مدل در ChatGPT یا Codex دسترسی به هر پروژه API را اعطا نمی‌کند. ورود اشتراکی و ورود با کلید API را در یادداشت اجرا جدا نگه دارید. این تمایز هنگام عیب‌یابی محدودیت یا تطبیق هزینه‌ها ضروری است.

کلید و کلاینت را در محیط مورد اعتماد آماده کنید

در داشبورد OpenAI یک کلید API بسازید و آن را از محیط خصوصی یا secret manager خود به‌صورت OPENAI_API_KEY ارائه کنید. SDK رسمی این متغیر را می‌خواند. کلید را هرگز در JavaScript مرورگر، مخزن عمومی، screenshot یا متن ترمینال اشتراکی جاسازی نکنید. هنگام کار با اعتبارنامه از shell tracing دوری کنید.

برای نمونه JavaScript زیر، بسته رسمی openai را با npm install openai در پروژه نصب کنید. نسخه نصب‌شده را در lockfile ثبت کنید. baseURL صریح، OpenAI را به‌جای endpoint سفارشی به‌ارث‌رسیده انتخاب می‌کند. پیکربندی agent موجود را هم بررسی کنید: override ارائه‌دهنده و اعتبارنامه سرویس دیگر صرفاً چون هر دو header به نام Authorization می‌پذیرند سازگار نمی‌شوند.

یک درخواست Responses بفرستید و پاسخ را بخوانید

فایلی به نام astra-example.mjs با کد زیر بسازید و سپس node astra-example.mjs را اجرا کنید. prompt یک چک‌لیست کوتاه می‌خواهد تا پیش از اتصال گردش‌کار بزرگ‌تر پاسخ برگشتی را بررسی کنید. retry خودکار SDK برای این درخواست اول غیرفعال است تا تشخیص خطای اتصال یا حساب آسان‌تر شود.

وقتی status برابر completed است، response.output_text متن ترکیبی SDK را در خود دارد. آن را در خروجی استاندارد چاپ کنید تا برنامه دیگری مصرفش کند یا به فایل redirect شود. فراداده پاسخ را به خطای استاندارد بفرستید تا از پاسخ جدا بماند. برای پاسخ‌های ناقص، incomplete_details و usage را حفظ کنید و کد خروجی غیرصفر برگردانید.

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://api.openai.com/v1',
  maxRetries: 0,
})
const response = await client.responses.create({
  model: 'gpt-6-astra',
  input: 'List three checks for a small code change.',
})
console.error(JSON.stringify({
  id: response.id,
  model: response.model,
  status: response.status,
  usage: response.usage,
  incomplete_details: response.incomplete_details,
}))
if (response.status === 'completed') {
  console.log(response.output_text)
} else {
  process.exitCode = 1
}

برای Codex محلی، احراز هویت با کلید API را انتخاب کنید

OpenAI ورود با کلید API را برای کار Codex محلی مستند کرده است. در CLI پیش از تغییر اعتبارنامه، وضعیت ورود Codex را بررسی کنید. فرمان stdin مستند زیر از چسباندن secret در آرگومان فرمان جلوگیری می‌کند. پس از ورود، روش احراز هویت فعال را دوباره بررسی و مدل دقیق را با flag مدل CLI انتخاب کنید.

فرمان نهایی یک نشست تعاملی با Astra انتخاب‌شده باز می‌کند. در پوشه پروژه خود شروع کنید تا agent فایل‌ها و دستورالعمل‌های درست مخزن را بخواند. overrideهای ارائه‌دهنده موجود و حساب فعال را بررسی کنید. حالت کلید API از کار محلی پشتیبانی می‌کند؛ Codex cloud به احراز هویت ChatGPT نیاز دارد. برای کاری ابری که می‌خواهید محلی ادامه دهید، فایل‌های کاری و خلاصه کوتاهی از کار باقی‌مانده را ابتدا وارد پروژه محلی کنید.

codex login status
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status
codex --model gpt-6-astra

قابلیت‌ها را با مسیر کلاینت هماهنگ کنید

Astra از Responses و Chat Completions پشتیبانی می‌کند، اما فراخوانی ابزار به Responses نیاز دارد. برای agentی که function یا ابزار سفارشی اجرا می‌کند از Responses استفاده کنید. کلاینتی که برای خواندن chat choices نوشته شده با تغییر URL نمی‌تواند خروجی Responses را parse کند و smoke صرفاً متنی حلقه ابزار را آزمایش نمی‌کند.

با یک نمونه کوچک از برنامه، هر بار یک قابلیت اضافه کنید. برای ابزارها آرگومان‌ها را اعتبارسنجی کنید، تابع را در برنامه اجرا کنید و نتیجه را از طریق Responses با call_id متناظر برگردانید. برای خروجی ساختاریافته schema را اعتبارسنجی و پاسخ ناقص را مدیریت کنید. برای streaming، رویدادهای تکمیل و لغو را در کنار متن پردازش کنید. هنگام افزودن قابلیت‌ها مسیر ساده درخواست متنی را به‌عنوان مسیر تشخیصی نگه دارید.

خطاهای دسترسی، نرخ و تکمیل را جداگانه تشخیص دهید

پیش از تلاش دوباره از status HTTP و فیلدهای ساختاریافته خطا استفاده کنید. راهنمای خطای OpenAI احراز هویت نامعتبر، اعتبار مصرف‌شده، limit هزینه اعمال‌شده و فشار نرخ درخواست را از هم جدا می‌کند. به‌ویژه پاسخ 429 برای انتخاب راه‌حل کافی نیست: error.code و تنظیمات حساب مربوط را بررسی کنید.

برای فشار موقت نرخ، Retry-After را در صورت وجود رعایت و تلاش‌های محدود اعمال کنید. خطای صورتحساب یا limit هزینه به تصمیم حساب نیاز دارد، نه درخواست‌های تکراری. نتیجه Responses با وضعیت incomplete نیز شرطی متفاوت است و ممکن است از قبل توکن مصرف کرده باشد. اطلاعات خطا را redacted و usage را حفظ کنید؛ timeout یا رسید مفقود را به تلاش موفق یا رایگان تبدیل نکنید.

دسترس‌پذیری ارائه‌دهنده و شواهد: September 5, 2026

OpenAI GPT-6 Astra را با عرضه مرحله‌ای اعلام کرده و مرجع مدل آن API رسمی را مستند می‌کند. نمونه‌های اینجا از همان منابع پیروی می‌کنند؛ برای این راهنما هیچ درخواست پولی یا تغییر احراز هویت Codex اجرا نشده است. بررسی کاتالوگ عمومی APIsRouter در September 5, 2026 با HTTP 200، success: true و 34 مدل برگشت و هیچ ورودی Astra یا GPT-6 نداشت.

اعتبارنامه‌های OpenAI را فقط با endpoint رسمی بالا استفاده کنید. کاتالوگ زنده APIsRouter را برای offerings خودش بررسی کنید. فهرست‌شدن Astra در آینده همچنان به بررسی model ID دقیق، قیمت و قابلیت‌های لازم کلاینت پیش از استفاده در برنامه نیاز دارد.

پاسخ را به گردش‌کار محلی مفید متصل کنید

یک کار محلی با نتیجه ملموس انتخاب کنید، مانند توضیح یک تابع و پیشنهاد یک test. مسیر فایل مرتبط، رفتار مورد انتظار و فرمان test را به agent بدهید. پس از تغییر کد diff را بررسی و testهای متمرکز را اجرا کنید. ورودی اصلی و پاسخ برگشتی را کنار هم نگه دارید تا مقایسه نسخه‌ها آسان باشد.

در برنامه، متن completed را به صفحه بازبینی یا pipeline سند بدهید. اگر مرحله بعد داده machine-readable می‌خواهد، از خروجی ساختاریافته استفاده و فیلدهای لازم را پیش از ذخیره اعتبارسنجی کنید. هویت درخواست و usage را کنار کار نگه دارید و سیاست تلاش محدود بگذارید. پس از آنکه ورودی، مدیریت پاسخ و کنترل تکمیل پایه با هم کار کردند، گردش‌کار را گسترش دهید.

پرسش‌های پرتکرار