שגיאת API 400 של OpenAI: תיקוני Axios ופתרון בעיות

\n\n## פיענוח שגיאת 400 ב-API של OpenAI: המדריך המקיף שלכם לפתרון בעיות

בנוף המתפתח במהירות של פיתוח AI, ה-API של OpenAI הפך לכלי הכרחי עבור אינספור יישומים, מצ'אטבוטים מתוחכמים ועד למנועי יצירת תוכן מתקדמים. כוחו וגמישותו פותחים יכולות חסרות תקדים. עם זאת, כמו בכל מערכת מורכבת, מפתחים נתקלים מדי פעם במכשולים. בין הנפוצים ביותר ולעיתים קרובות המבלבלים ביותר היא שגיאת OpenAI API: AxiosError Request failed with status code 400.

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

הבנת קוד הסטטוס HTTP 400 Bad Request

לפני שנצלול לפרטים הספציפיים של ה-API של OpenAI ו-Axios, בואו נבסס הבנה בסיסית של קוד הסטטוס HTTP 400. בעולם תקשורת האינטרנט, קודי סטטוס HTTP הם כמו רמזורים, המציינים את תוצאת בקשת הלקוח לשרת.

• 1xx (אינפורמטיבי): הבקשה התקבלה, התהליך נמשך.
• 2xx (הצלחה): הפעולה התקבלה, הובנה ואושרה בהצלחה.
• 3xx (הפניה): יש לבצע פעולה נוספת כדי להשלים את הבקשה.
• 4xx (שגיאת לקוח): הבקשה מכילה תחביר שגוי או לא ניתנת לביצוע.
• 5xx (שגיאת שרת): השרת נכשל בביצוע בקשה שנראתה תקינה.

קוד הסטטוס 400 Bad Request נופל במפורש לקטגוריית שגיאות הלקוח. הוא מציין שהשרת (במקרה זה, ה-API של OpenAI) אינו יכול או לא יבצע את הבקשה עקב משהו שנתפס כשגיאת לקוח (לדוגמה, תחביר בקשה מעוצב באופן שגוי, מסגור הודעת בקשה לא חוקי, או ניתוב בקשה מטעה). עבור ה-API של OpenAI, זה מצביע בדרך כלל על בעיות עם:

• פרמטרים חובה חסרים או שגויים.
• סוגי נתונים לא חוקיים עבור פרמטרים.
• חריגה מאילוצי אורך או תוכן עבור פרמטרים.
• עיצוב JSON שגוי בגוף הבקשה.
• בעיות אימות (למרות שאלה לעיתים קרובות מחזירות 401 או 403, כותרת אימות מעוצבת באופן שגוי יכולה לפעמים להפעיל 400).

מדוע Axios? תפקיד לקוח ה-HTTP שלכם

Axios הוא לקוח HTTP פופולרי מבוסס Promise עבור דפדפנים ו-Node.js. הוא מפשט שליחת בקשות HTTP אסינכרוניות לנקודות קצה של REST וביצוע פעולות CRUD. אימוצו הנרחב פירושו שמספר משמעותי של מפתחים המקיימים אינטראקציה עם ה-API של OpenAI ישתמשו ב-Axios כדי לבנות ולשלוח את בקשותיהם.

כאשר אתם רואים AxiosError Request failed with status code 400, זה אומר:

1. השתמשתם ב-Axios כדי לשלוח בקשה ל-API של OpenAI.
2. השרת של OpenAI קיבל את בקשתכם.
3. השרת של OpenAI זיהה בעיה במבנה או בתוכן של בקשתכם.
4. השרת של OpenAI הגיב עם קוד סטטוס HTTP 400.
5. Axios תפס את תגובת ה-400 הזו וזרק AxiosError.

הבנת שרשרת אירועים זו חיונית לניפוי באגים יעיל. השגיאה אינה ב-Axios עצמו, אך Axios הוא השליח שאומר לכם שתוכן ההודעה שלכם ל-OpenAI נדחה.

סיבות נפוצות לשגיאות 400 ב-API של OpenAI עם Axios

בואו ננתח את הגורמים התכופים ביותר מאחורי שגיאת OpenAI API: AxiosError Request failed with status code 400. איתור הגורם המדויק דורש לעיתים קרובות סקירה שיטתית של מטען הבקשה שלכם.

1. פרמטרים חובה חסרים או לא חוקיים

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

• דוגמה: עבור ה-API של השלמות צ'אט (/v1/chat/completions), model ו-messages הם חובה.

  // פרמטר 'messages' חסר
  {
    "model": "gpt-3.5-turbo"
  }
  

  זה בהחלט יפעיל 400.

2. סוגי נתונים או פורמטים שגויים

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

• דוגמה: מתן מספר שלם עבור temperature הוא נכון, אך מתן מחרוזת כמו "0.7" עלול לגרום לבעיות אם לא מטופל במפורש על ידי ניתוח ה-API.

  // 'messages' צריך להיות מערך של אובייקטים
  {
    "model": "gpt-3.5-turbo",
    "messages": "This is a single message string."
  }
  

  זה יוביל ל-400 מכיוון ש-messages הוא מחרוזת, לא מערך.

3. מטען JSON מעוצב באופן שגוי

ה-API של OpenAI מתקשר בעיקר באמצעות JSON. כל שגיאת תחביר בגוף ה-JSON שלכם תגרום ל-400. זה כולל:

• סוגריים מסולסלים או מרובעים לא סגורים.
• פסיקים חסרים בין זוגות מפתח-ערך.
• פסיקים נגררים (למרות שחלק מהמנתחים סלחניים, עדיף להימנע).
• מפתחות או ערכי מחרוזת שאינם סגורים במרכאות כפולות.
• Escape שגוי של תווים מיוחדים.