נקודת-קצה API (API Endpoint)

נקודת-קצה API (API Endpoint) היא כתובת ספציפית שדרכה תוכנה אחת שולחת בקשה לשירות אחר ומקבלת תשובה — הדלת המדויקת שדרכה מפתחים "מדברים" עם מודל-AI מרוחק. שירות עם ממשק-תכנות-יישומים חושף בדרך-כלל כמה נקודות-קצה שונות, כל אחת למטרה מוגדרת — למשל אחת ליצירת-טקסט, אחרת ליצירת-תמונה — וכל נקודת-קצה מקבלת פרמטרים מוגדרים ומחזירה תשובה בפורמט קבוע.

רוב נקודות-הקצה המודרניות בנויות סביב ארכיטקטורת REST (העברת-מצב-ייצוגי, סגנון-עיצוב שהגדיר רוי פילדינג בעבודת-הדוקטורט שלו בשנת 2000, עבור האינטרנט כולו — לא רק עבור AI), שבה כל נקודת-קצה מזוהה על-ידי כתובת-אינטרנט ייחודית, ופעולות מתבצעות באמצעות שיטות-HTTP (HyperText Transfer Protocol) סטנדרטיות (בקשת-קבלת-מידע, בקשת-יצירה, בקשת-מחיקה) — עיצוב שהופך את השימוש בממשקים שונים לצפוי ואחיד יחסית בין שירותים שונים, גם כשמדובר בספקים שונים לחלוטין. חלק מהעקרונות של REST, כמו "חוסר-מצב" — כל בקשה נשלחת עם כל המידע שהיא צריכה, בלי להסתמך על זיכרון של בקשות קודמות — הפכו לחשובים במיוחד ב-API-ים של AI, בגלל הצורך לשרת מיליוני בקשות במקביל בלי שהשרת יצטרך לזכור שיחה שלמה בעצמו בין קריאה לקריאה.

כשמפתח בונה אפליקציה שמשתמשת במודל-AI, הקוד שלו שולח בקשות לנקודות-הקצה הרלוונטיות של ספק-המודל — כל הודעה שנשלחת לצ'אטבוט "מאחורי-הקלעים" עוברת דרך נקודת-קצה כזו, לרוב עם כתובת שמסתיימת בסימון-גרסה כמו v1, שמאפשר לספק לשנות ולשפר את הנקודה בלי לשבור אפליקציות ישנות שכבר משתמשות בגרסה הקודמת.

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