Source: https://ailoot.ai/docs/he/keys/
Canonical: https://ailoot.ai/docs/he/keys/
Language: he

[התחלה](https://ailoot.ai/docs/he/) 

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

[Markdown](https://ailoot.ai/docs/he/keys/index.md)

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

## [](https://ailoot.ai/docs/he/keys/#key)מפתח API

המפתח נוצר באזור האישי ב- [ailoot.ai](https://ailoot.ai) לאחר [הרשמה](https://ailoot.ai/register). הוא נראה כך: `sk-…`. אפשר ליצור כמה מפתחות: בנפרד למחשב העבודה, לשרת ולכל אפליקציה — כך קל לבטל מפתח אחד בלי להשפיע על האחרים.

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

אל תפרסמו את המפתח בקוד, במאגרים או בצילומי מסך. שמרו אותו במשתנה סביבה או במנהל סודות. אם המפתח דלף — מחקו אותו באזור האישי וצרו מפתח חדש.

## [](https://ailoot.ai/docs/he/keys/#base-url)כתובת 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` | כפי שמצוין |

קיבלתם 404 מיד לאחר ההגדרה? כמעט תמיד הבעיה בכתובת: רכיב מיותר או חסר של `/v1`, לוכסן כפול או `/chat/completions` במקום שבו הלקוח מוסיף אותו בעצמו.

## [](https://ailoot.ai/docs/he/keys/#auth)איך להעביר את המפתח

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`.

## [](https://ailoot.ai/docs/he/keys/#env)משתני סביבה

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

```bash
# ~/.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"
```

```powershell
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-..."
# הפעילו מחדש את המסוף כדי שהמשתנים ייטענו
```

## [](https://ailoot.ai/docs/he/keys/#check)בדיקת המפתח

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

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

נשארו שאלות? שלחו Request ID ותיאור — נעזור לברר.[פנייה לתמיכה](mailto:support@ailoot.ai)

## Ailoot · החברה ופורטפוליו הפרויקטים שלה





Ailoot נשענת על ניסיון תפעולי מצטבר, בסיס לקוחות רחב, שירות יציב ובקרה שוטפת של KPI.





החברה ופורטפוליו הפרויקטים שלה: מיליוני לקוחות; מכירות בהיקף של מיליארדים מדי חודש.





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