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

[API של האזור האישי](https://ailoot.ai/docs/he/) 

# API של האזור האישי

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

מתודות האזור האישי: התחברות, פרופיל, מפתחות והיסטוריית הוצאות.

זהו ה-API של האזור האישי ב-ailoot.ai: התחברות, פרופיל, מפתחות והיסטוריית הוצאות. בקשות למודלים נשלחות לכתובת אחרת — `https://api.ailoot.ai` עם מפתח `sk-…`. הגישה למתודות תלויה בהרשאות החשבון שלכם ובפונקציות המופעלות.

## [](https://ailoot.ai/docs/he/cabinet/#adresa-i-avtorizatsiya)כתובות ואימות

- האזור האישי: https://ailoot.ai (התחברות עם פרטי החשבון, טוקן של האזור האישי)
- API המודלים: https://api.ailoot.ai (מפתח sk-…)

| מה | כתובת | אימות |
| --- | --- | --- |
| API של האזור האישי | `https://ailoot.ai/api/v1` | `Authorization: Bearer $TOKEN` — טוקן של האזור האישי לאחר התחברות |
| API המודלים | `https://api.ailoot.ai/v1` | מפתח `sk-…` מהסעיף "מפתחות API"; ראו [מפתחות וכתובת ה-API](https://ailoot.ai/docs/he/keys/) |

מפתח `sk-…` אינו מחליף את הטוקן של האזור האישי, והטוקן של האזור האישי אינו מעניק גישה ל-API המודלים. הנתיב המלא מצוין בכל מתודה.

קריאת הפרופיל שלכם

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"
```

## [](https://ailoot.ai/docs/he/cabinet/#format-otveta-i-oshibki)פורמט התשובה ושגיאות

התשובה מכילה code, message ו-data. בשגיאה עשויים להופיע reason ו-metadata. החלוקה לעמודים בתוך data מכילה items, total, page, page\_size ו-pages. הפורמט של כל מתודה מצוין בתיאור שלה.

מבנה תשובה עם חלוקה לעמודים

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}
```

הטוקן של האזור האישי נבדק לפי תוקפו ולפי השאלה אם המשתמש פעיל; אם קישור הסשן מופעל — גם לפי IP ודפדפן. הקודים TOKEN\_EXPIRED, TOKEN\_REVOKED, USER\_INACTIVE, INVALID\_TOKEN ו-FORBIDDEN מבחינים בין בעיות בסשן ובעיות בהרשאות. מגבלת הקצב ואימות נוסף באמצעות 2FA עשויים לחסום בקשה מסוימת.

## [](https://ailoot.ai/docs/he/cabinet/#kak-chitat-spravochnik)איך לקרוא את המדריך

- כל רשומה מכילה מתודת HTTP, נתיב מלא, תנאי גישה, פרמטרים, שדות גוף הבקשה ותשובה.
- קחו את המזהים מהתשובה הקודמת: KEY\_ID — מ-GET /api/v1/keys, ומזהה הבקשה — מ-GET /api/v1/usage.
- שדות האובייקטים והטיפוסים שלהם מופיעים בעמודי "סכמות נתונים".
- התבניות מציגות שמות שדות וטיפוסים. PLACEHOLDER ו-TOKEN הם סמנים; אין כאן נתונים אמיתיים.
- הוספת כסף ליתרה נמצאת בסעיף "תעריפים" באזור האישי: [איך להוסיף כסף](https://ailoot.ai/docs/he/billing/topup/).

## [](https://ailoot.ai/docs/he/cabinet/#balans-i-frozen-balance)יתרה ו-frozen\_balance

הפרופיל מכיל balance ו-frozen\_balance. frozen\_balance הוא הסכום שנשמר כרזרבה לבקשות שלא הושלמו. בדקו את שני השדות יחד עם ההיסטוריה.

## [](https://ailoot.ai/docs/he/cabinet/#klyuchi-i-limity)מפתחות ומגבלות

GET /api/v1/keys מחזיר את המפתחות שלכם. השדות `quota` וכן `quota_used` — מגבלת ההוצאות של המפתח והחלק שכבר נוצל; `ip_whitelist`, `ip_blacklist`, `status` וכן `expires_at` קובעים כיצד אפשר להשתמש במפתח; `rate_limit_5h`, `rate_limit_1d` וכן `rate_limit_7d` — מגבלות הוצאות לפי חלונות זמן.

רשימה והמפתח שלכם

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID — ה-id של המפתח שלכם מתשובת הרשימה
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"
```

## [](https://ailoot.ai/docs/he/cabinet/#rashody-i-bezopasnost)הוצאות ואבטחה

ההיסטוריה וה-dashboard מציגים actual\_cost — החיוב בפועל, ו-total\_cost — העלות לפי המחיר הרגיל. מסנני התאריך, המודל, המפתח וסוג הבקשה מפורטים במתודה. שינוי סיסמה, TOTP ו-passkey דורשים את האימותים המתוארים במתודות המתאימות.

בסעיף הזה: `39` מתודות.

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

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





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





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





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