إعداد Astra API مع مصادقة OpenAI الرسمية

ابدأ بالمزود وحساب الفوترة

استخدم gpt-6-astra عبر OpenAI API بمفتاح OpenAI Platform الخاص بك. بالنسبة إلى تطبيق، ابدأ بمثال Responses أدناه. وبالنسبة إلى عمل الكود المحلي، استخدم أوامر تسجيل الدخول واختيار النموذج في Codex CLI. يستخدم المساران حساب Platform الخاص بك ويتكبدان رسوم API بأسعار OpenAI المنطبقة.

قبل تشغيل طلب، أكد مالك مشروع Platform وما إذا كان مفتاحه يستطيع الوصول إلى النموذج وضوابط الفوترة المنطبقة. لا يمنح ظهور نموذج في ChatGPT أو Codex وصولًا إلى كل مشروع API. أبقِ تسجيل الاشتراك وتسجيل الدخول بمفتاح API منفصلين في ملاحظات التشغيل. هذا التمييز ضروري عند تشخيص حد أو مطابقة رسوم لاحقًا.

جهّز المفتاح والعميل في بيئة موثوقة

أنشئ مفتاح API في لوحة OpenAI وقدّمه باسم OPENAI_API_KEY عبر بيئتك الخاصة أو مدير أسرار. يقرأ SDK الرسمي هذا المتغير. لا تضمّن المفتاح في JavaScript المتصفح أو مستودع عام أو لقطة شاشة أو سجل طرفية مشترك. تجنب تتبع Shell أثناء التعامل مع بيانات الاعتماد.

في مثال JavaScript التالي، ثبّت حزمة openai الرسمية في مشروعك باستخدام npm install openai. سجّل الإصدار المثبت في ملف القفل. تختار baseURL الصريحة OpenAI بدل نقطة نهاية مخصصة موروثة. راجع تهيئة الوكيل الحالية أيضًا: لا تصبح تجاوزات المزود وبيانات اعتماد خدمة أخرى متوافقة لمجرد أن كليهما يقبل Authorization header.

أرسل طلب Responses واقرأ الإجابة

أنشئ astra-example.mjs بالكود التالي ثم شغّل node astra-example.mjs. يطلب الـ prompt قائمة فحص قصيرة حتى تفحص الإجابة المعادة قبل ربط سير عمل أكبر. تُعطّل إعادات SDK التلقائية لهذا الطلب الأول، ما يسهل تشخيص أخطاء الاتصال أو الحساب.

عندما تكون الحالة completed، يحتوي response.output_text على ناتج النص المدمج من SDK. اطبعه إلى الإخراج القياسي حتى يستهلكه برنامج آخر أو تعيد توجيهه إلى ملف. أرسل بيانات الاستجابة الوصفية إلى الخطأ القياسي لإبقائها منفصلة عن الإجابة. في الاستجابات غير المكتملة، احتفظ بـ 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
}

اختر مصادقة API-key لـ Codex المحلي

توثق OpenAI تسجيل الدخول بمفتاح API لعمل Codex المحلي. في CLI، افحص codex login status قبل تغيير بيانات الاعتماد. يتجنب أمر stdin الموثق أدناه لصق سر في وسيطة أمر. بعد تسجيل الدخول، افحص طريقة المصادقة النشطة مرة أخرى، ثم اختر النموذج الدقيق باستخدام معامل النموذج في CLI.

يفتح الأمر الأخير جلسة تفاعلية مع اختيار Astra. ابدأ من دليل مشروعك حتى يقرأ الوكيل الملفات وتعليمات المستودع الصحيحة. راجع تجاوزات المزود الحالية وأكد الحساب النشط. يدعم نمط API-key العمل المحلي؛ ويتطلب 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. استخدم Responses لوكيل ينفذ وظائف أو أدوات مخصصة. لا يستطيع عميل مكتوب لقراءة chat choices تحليل ناتج Responses بتغيير عنوان URL فقط، كما أن اختبار smoke نصي فقط لا يختبر حلقة أدوات.

أضف قدرة واحدة في كل مرة باستخدام مثال صغير من تطبيقك. بالنسبة للأدوات، تحقق من الوسائط وشغّل الوظيفة في تطبيقك وأعد النتيجة عبر Responses مع call_id المطابق. بالنسبة إلى المخرج المنظم، تحقق من المخطط وتعامل مع الاستجابات غير المكتملة. وبالنسبة إلى streaming، عالج أحداث الإكمال والإلغاء إضافة إلى النص. أبقِ طلب النص البسيط متاحًا كمسار تشخيص أثناء إضافة هذه الميزات.

شخّص إخفاقات الوصول والمعدل والإكمال بصورة منفصلة

استخدم حالة HTTP وحقول الخطأ المنظمة قبل إعادة المحاولة. يميز دليل أخطاء OpenAI بين المصادقة غير الصالحة والائتمانات المستنفدة وحدود الإنفاق المفروضة وضغط معدل الطلب. وبخاصة، لا تكفي استجابة 429 لاختيار علاج؛ افحص error.code وإعدادات الحساب ذات الصلة.

عند ضغط المعدل المؤقت، احترم Retry-After إن وُجد واستخدم إعادات محدودة. تحتاج إخفاقات الفوترة أو حد الإنفاق إلى قرار حساب لا إلى طلبات متكررة. كما أن نتيجة Responses المعلمة incomplete حالة مختلفة وقد تكون استهلكت رموزًا بالفعل. احتفظ بمعلومات الخطأ المنقحة والاستخدام؛ لا تحول مهلة أو إيصالًا مفقودًا إلى محاولة ناجحة أو مجانية.

توفر المزود والأدلة: 5 سبتمبر 2026

أعلنت OpenAI عن GPT-6 Astra مع طرح مرحلي، ويوثق مرجعها النموذجي API الرسمية. تتبع الأمثلة هنا تلك المصادر؛ ولم يُنفّذ طلب مدفوع أو تبديل مصادقة Codex لهذا الدليل. أعاد فحص كتالوج APIsRouter العام في 5 سبتمبر 2026 HTTP 200 وsuccess: true و34 نموذجًا دون إدخال Astra أو GPT-6.

استخدم بيانات اعتماد OpenAI مع نقطة النهاية الرسمية الموضحة أعلاه فقط. افحص كتالوج APIsRouter الحي لعروضه الخاصة. حتى الإدراج اللاحق لـ Astra سيحتاج إلى فحص معرّف النموذج الدقيق والسعر وميزات العميل المطلوبة قبل استخدامه في تطبيقك.

اربط الاستجابة بسير عمل محلي مفيد

اختر مهمة محلية ذات نتيجة ملموسة، مثل شرح دالة واقتراح اختبار. أعطِ الوكيل مسار الملف المعني والسلوك المتوقع وأمر الاختبار. بعد تغيير الكود، افحص diff وشغّل الاختبارات المركزة. احتفظ بالمدخل الأصلي والإجابة المعادة معًا حتى تسهل مقارنة المراجعات.

في التطبيق، مرّر النص المكتمل إلى شاشة المراجعة أو خط أنابيب الوثائق. إذا كانت الخطوة التالية تتوقع بيانات قابلة للقراءة آليًا، فاستخدم مخرجًا منظمًا وتحقق من الحقول المطلوبة قبل التخزين. احتفظ بهوية الطلب والاستخدام بجوار المهمة وضع سياسة إعادة محاولة محدودة. وسّع سير العمل بعد أن تعمل مدخلاته الأساسية ومعالجة الاستجابة وفحوص الإكمال معًا.

الأسئلة الشائعة