Skip to main content
כל ספריית 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 לפני השוואה). דף הבדיקה עושה זאת עבורכם.