כל ספריית OpenAI רשמית עובדת; רק base_url משתנה. הדוגמאות משתמשות ב-gpt-5.6-sol; לחבילת Astra השתמשו ב-gpt-astra.
Chat Completions
base_url חייב לכלול /v1 ואסור שיסתיים ב-/. הספרייה מוסיפה /chat/completions בעצמה.
התשובות עוקבות בדיוק אחר סכמת OpenAI: id הוא chatcmpl-..., usage מכיל prompt_tokens, completion_tokens ו-completion_tokens_details.reasoning_tokens. המכסה נגבית בדיוק לפי usage.total_tokens.
Responses API
Codex ו-SDKs חדשים יותר משתמשים בפרוטוקול זה. הגדרת ה-reasoning נמצאת ב-reasoning.effort.
מאמץ reasoning
עם Chat Completions השתמשו ב-reasoning_effort (low, medium, high). אם לא הוגדר, השער משתמש ב-high. למשימות פשוטות הגדירו low לחיסכון בטוקנים:
reasoning_effort הוא ל-Chat Completions בלבד. עם Responses API השתמשו ב-reasoning: {"effort": ...}; שליחת reasoning_effort ל-/v1/responses נדחית עם “Unsupported parameter”.
Streaming
בשאלות קשות המודל עשוי לחשוב זמן מה לפני הטוקן הראשון. השתמשו ב-stream: true כדי שהחיבור לא ייפסק. stream_options.include_usage גורם לחתיכה האחרונה לשאת usage כדי שתוכלו להתאים מכסה בעצמכם.
שליחת תמונות (vision)
תמונות עוברות במערך content, כ-URL ציבורי או base64 לקבצים מקומיים.
תמונות עולות טוקנים לפי גודל. חתכו לחלק הרלוונטי במקום לשלוח צילום מסך מלא של 4K.
מודלים ומכסה דרך API
subscription מחזיר את הסכום הכולל ב-hard_limit_usd; usage מחזיר את מה שנוצל ב-total_usage, בסנטים (חלקו ב-100 לפני השוואה). דף הבדיקה עושה זאת עבורכם.