מפתחות וכתובת ה-API

היכן לקבל מפתח, איזו כתובת לציין בערכות SDK שונות ואיך להעביר את המפתח.

המדריך המלא

מפתח API

המפתח נוצר באזור האישי ב- ailoot.ai לאחר הרשמה. הוא נראה כך: sk-…. אפשר ליצור כמה מפתחות: בנפרד למחשב העבודה, לשרת ולכל אפליקציה — כך קל לבטל מפתח אחד בלי להשפיע על האחרים.

למפתח אפשר להגדיר מגבלת הוצאות כוללת, תוקף, רשימות כתובות IP מותרות וחסומות ומגבלות הוצאות לחלונות של 5 שעות, 1 יום ו-7 ימים. כשמגבלה מופעלת, תתקבל שגיאה ברורה: api_key_quota_exhausted (המגבלה הכוללת נוצלה במלואה), usage_limit_reached (חלון ההוצאות של המפתח נוצל במלואו — המתינו להתחדשות החלון או הגדילו את המגבלה), api_key_expired או permission_denied (למשל, בקשה מכתובת IP שאינה מותרת).

כתובת API

הכלל העיקרי: ללקוחות התואמים ל-OpenAI, הכתובת כוללת /v1, ול-Anthropic ול-Gemini — בלעדיו.

לקוח	כתובת בסיס	לאן הבקשה נשלחת
OpenAI SDK ולקוחות תואמים	`https://api.ailoot.ai/v1`	`/v1/chat/completions`, `/v1/responses`, `/v1/embeddings`
Anthropic SDK, Claude Code	`https://api.ailoot.ai`	`/v1/messages`
Google GenAI SDK, Gemini CLI	`https://api.ailoot.ai`	`/v1beta/models/{model}:generateContent`
הלקוח מבקש כתובת מלאה	`https://api.ailoot.ai/v1/chat/completions`	כפי שמצוין

איך להעביר את המפתח

Ailoot מקבל את המפתח בכל אחת משלוש הכותרות — הכותרת שה-SDK שלכם שולח תתאים:

כותרת	מי שולח כך
`Authorization: Bearer sk-…`	OpenAI SDK, רוב הלקוחות
`x-api-key: sk-…`	Anthropic SDK, Claude Code עם ANTHROPIC_API_KEY
`x-goog-api-key: sk-…`	Google GenAI SDK, Gemini CLI

בנתיבים /v1/… מפתח בכתובת (?key= או ?api_key=) אינו מתקבל: הבקשה תקבל 400 עם הקוד invalid_request והודעה שהמפתח נשלח בכתובת. כך המפתח אינו מופיע ביומנים ובהיסטוריית הדפדפן. אם המפתח כבר נשלח בכתובת, עדיף ליצור מפתח חדש.

בנתיבי Gemini /v1beta/… מתקבל לצורך תאימות ל-Google ?key= — בעדיפות הנמוכה ביותר, אחרי הכותרות. ?api_key= נדחה גם שם עם 400. עדיין אמין יותר להעביר את המפתח בכותרת x-goog-api-key.

משתני סביבה

נוח להגדיר משתנה אחד ולהשתמש בו בהגדרות של כמה תוכנות:

# ~/.zshrc או ~/.bashrc
export AILOOT_API_KEY="sk-..."

# לתוכניות שקוראות את השמות הסטנדרטיים
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"

setx AILOOT_API_KEY "sk-..."

# לתוכניות שקוראות את השמות הסטנדרטיים
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# הפעילו מחדש את המסוף כדי שהמשתנים ייטענו

בדיקת המפתח

הדרך הזולה ביותר לבדוק את המפתח היא לבקש את רשימת המודלים: זה ללא תשלום.

curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"

נשארו שאלות? שלחו Request ID ותיאור — נעזור לברר.פנייה לתמיכה