הגדרת Astra API עם אימות OpenAI רשמי

התחילו אצל הספק ובחשבון החיוב

השתמשו ב-gpt-6-astra דרך ה-API של OpenAI עם מפתח OpenAI Platform שלכם. עבור יישום התחילו בדוגמת Responses שלהלן. עבור עבודת קידוד מקומית השתמשו בפקודות ההתחברות ובחירת המודל של Codex CLI. שני המסלולים משתמשים בחשבון Platform שלכם ויוצרים חיובי API לפי תעריפי OpenAI הרלוונטיים.

לפני הרצת בקשה אשרו מי הבעלים של פרויקט Platform, אם המפתח שלו יכול לגשת למודל ואילו בקרות חיוב חלות. הופעת מודל ב-ChatGPT או ב-Codex אינה מעניקה גישה לכל פרויקט API. שמרו התחברות מנוי והתחברות API key בנפרד בהערות ההרצה. ההבחנה הזו חיונית כשמאבחנים מגבלה או מתאימים חיובים בהמשך.

הכינו את המפתח והלקוח בסביבה מהימנה

צרו מפתח API בלוח הבקרה של OpenAI וספקו אותו כ-OPENAI_API_KEY דרך הסביבה הפרטית או מנהל סודות. ה-SDK הרשמי קורא את המשתנה הזה. לעולם אל תטמיעו את המפתח ב-JavaScript של דפדפן, במאגר ציבורי, בצילום מסך או בתמליל טרמינל משותף. הימנעו מ-shell tracing בזמן טיפול בפרטי גישה.

עבור דוגמת JavaScript שלהלן התקינו את חבילת openai הרשמית בפרויקט שלכם באמצעות npm install openai. תעדו את הגרסה המותקנת ב-lockfile. ה-baseURL המפורש בוחר ב-OpenAI ולא ב-endpoint מותאם שעבר בירושה. בדקו גם תצורת סוכן קיימת: עקיפת ספק ופרטי גישה משירות אחר אינם הופכים לתואמים רק מפני ששניהם מקבלים כותרת Authorization.

שלחו בקשת Responses וקראו את התשובה

צרו astra-example.mjs עם הקוד הבא, ואז הריצו node astra-example.mjs. ה-prompt מבקש רשימת בדיקה קצרה כדי שתוכלו לבדוק את התשובה המוחזרת לפני חיבור תהליך גדול יותר. ניסיונות חוזרים אוטומטיים של ה-SDK מושבתים בבקשה הראשונה, כך שקל יותר לאבחן שגיאת חיבור או חשבון.

כאשר status הוא completed, השדה response.output_text מכיל את פלט הטקסט המשולב של ה-SDK. הדפיסו אותו ל-standard output כדי שתוכנית אחרת תוכל לצרוך אותו או להפנותו לקובץ. שלחו metadata של תגובה ל-standard error כדי להפריד אותו מהתשובה. בתגובות incomplete שמרו 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 key לעבודת Codex מקומית. ב-CLI בדקו את סטטוס codex login לפני שינוי פרטי גישה. פקודת ה-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 אינו יכול לנתח פלט Responses באמצעות שינוי URL בלבד, ו-smoke של טקסט בלבד אינו מפעיל לולאת כלי.

הוסיפו יכולת אחת בכל פעם באמצעות דוגמה קטנה מהיישום שלכם. עבור כלים אמתו ארגומנטים, הריצו את הפונקציה ביישום והחזירו את התוצאה דרך Responses עם call_id תואם. עבור פלט מובנה אמתו את הסכמה וטפלו בתגובות incomplete. עבור streaming עבדו גם עם אירועי השלמה וביטול וגם עם טקסט. שמרו את בקשת הטקסט הפשוטה כנתיב אבחון בזמן הוספת היכולות האלה.

אבחון גישה, קצב והשלמה בנפרד

השתמשו בסטטוס HTTP ובשדות שגיאה מובנים לפני ניסיון חוזר. מדריך השגיאות של OpenAI מבדיל בין אימות לא תקין, קרדיטים שאזלו, מגבלות הוצאה שנאכפות ולחץ על קצב הבקשות. בפרט, תגובת 429 אינה מספיקה לבחירת פתרון: בדקו את error.code ואת הגדרות החשבון הרלוונטיות.

בלחץ קצב זמני כבדו Retry-After כאשר הוא קיים והשתמשו בניסיונות חוזרים מוגבלים. כשלים של חיוב או מגבלת הוצאה דורשים החלטת חשבון, לא בקשות חוזרות. תוצאת Responses שמסומנת incomplete היא מצב אחר ושונה, וכבר ייתכן שצרכה אסימונים. שמרו פרטי שגיאה מושחרים ו-usage; אל תהפכו timeout או קבלה חסרה לניסיון מוצלח או חינמי.

זמינות ספק וראיות: 5 בספטמבר 2026

OpenAI הכריזה על GPT-6 Astra עם השקה מדורגת, והפניית המודל שלה מתעדת את ה-API הרשמי. הדוגמאות כאן עוקבות אחר המקורות האלה; לא בוצעה בקשה בתשלום או החלפת אימות Codex עבור מדריך זה. בדיקת הקטלוג הציבורי של APIsRouter ב-5 בספטמבר 2026 החזירה HTTP 200, success: true ו-34 מודלים, ללא רשומת Astra או GPT-6.

השתמשו בפרטי גישה של OpenAI רק עם ה-endpoint הרשמי שמוצג למעלה. בדקו את הקטלוג החי של APIsRouter להצעות שלו. רישום Astra מאוחר יותר עדיין יצריך בדיקה של ID המודל המדויק, המחיר ותכונות הלקוח הנדרשות לפני שימוש בו ביישום.

חברו את התגובה לתהליך מקומי שימושי

בחרו משימה מקומית אחת עם תוצאה קונקרטית, כגון הסבר לפונקציה והצעת בדיקה. תנו לסוכן נתיב קובץ רלוונטי, התנהגות צפויה ופקודת בדיקה. לאחר שינוי קוד בדקו את ה-diff והריצו את הבדיקות הממוקדות. שמרו יחד את הקלט המקורי ואת התשובה המוחזרת כדי שיהיה קל להשוות תיקונים.

ביישום העבירו טקסט שהושלם למסך הבדיקה או לצינור המסמכים. אם השלב הבא מצפה לנתונים קריאים למכונה, השתמשו בפלט מובנה ואמתו שדות נדרשים לפני שמירתם. שמרו זהות בקשה ו-usage לצד המשימה והגדירו מדיניות ניסיונות חוזרים מוגבלת. הרחיבו את התהליך לאחר שהקלט, טיפול התגובה ובדיקות ההשלמה הבסיסיות פועלים יחד.

שאלות נפוצות