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

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

# התחלה מהירה — API בינה מלאכותית: מפתח ובקשה ראשונה

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

תשובת מודל ראשונה דרך Ailoot בתוך כמה דקות: מפתח, כתובת ובקשה אחת.

Ailoot הוא API משותף למודלי בינה מלאכותית של חברות שונות: OpenAI, Anthropic, Google, xAI, DeepSeek, Alibaba, Moonshot, Z.ai, MiniMax, NVIDIA, Meta, Poolside ו-TypeSafe. מפתח אחד, יתרה אחת בדולרים. בקטלוג 1256 כרטיסי מודלים ו-2692 שיטות מתועדות. מזהי קריאה חלופיים או כינויים מופיעים תחת השיטה שנבחרה, אם הם זמינים.

Ailoot תומך בשלושה פורמטי API: OpenAI, Anthropic ו-Gemini. לכן אפשר להשתמש בערכות SDK מוכנות ובכמעט כל אפליקציה שמאפשרת להגדיר כתובת API משלכם: Claude Code, Codex CLI, Cline, Cursor, Open WebUI, n8n ועשרות אחרות.

| דרך | מתי מתאים |
| --- | --- |
| [בקשת HTTP](https://ailoot.ai/docs/he/connect/curl/) | כל שפה, ללא תלויות, לבדיקה מהירה של המפתח |
| [OpenAI SDK](https://ailoot.ai/docs/he/connect/openai-sdk/) | Python ו-Node.js; כל מודלי הקטלוג בפורמט OpenAI |
| [Anthropic SDK](https://ailoot.ai/docs/he/connect/anthropic-sdk/) | Claude ומודלים אחרים בפורמט Messages |
| [אפליקציות מוכנות](https://ailoot.ai/integrations/he/) | 85 סוכנים, עורכים וצ'אטים: ל-77 יש הגדרה מוכנה ועוד 8 נמצאים בבדיקה |

צריכים תוכנה מסוימת? פתחו את [קטלוג האינטגרציות](https://ailoot.ai/integrations/he/): לכל אפליקציה מצוין היכן להזין את הכתובת והמפתח, ומופיעה הגדרה מוכנה שאפשר להעתיק.

## צרו מפתח API בינה מלאכותית

[](https://ailoot.ai/docs/he/#key)קבלו מפתח

1. **הירשמו**

   צרו חשבון ב- [ailoot.ai/register](https://ailoot.ai/register). לאחר מכן התחברו דרך [ailoot.ai/login](https://ailoot.ai/login).
2. **הוסיפו כסף ליתרה**

   באזור האישי, פתחו את הסעיף "תעריפים": הוספת כסף חד-פעמית החל מ-$18 או מנוי עם בונוס ליתרה. פרטים נוספים: [הוספת כסף ליתרה](https://ailoot.ai/docs/he/billing/topup/) וכן [מנויים](https://ailoot.ai/docs/he/billing/subscriptions/).
3. **צרו מפתח API**

   באזור האישי, פתחו את סעיף המפתחות וצרו מפתח חדש. המפתח מתחיל ב- `sk-`. אפשר להעתיק אותו מסעיף המפתחות באזור האישי; שמרו עליו כמו על סיסמה.

שמרו את המפתח במשתנה סביבה

```bash
export AILOOT_API_KEY="sk-..."
# בדיקה: אמורה להתקבל רשימת מודלים
curl -s https://api.ailoot.ai/v1/models -H "Authorization: Bearer $AILOOT_API_KEY" | head -c 300
```

## [](https://ailoot.ai/docs/he/#first-request)שלחו את הבקשה הראשונה

כתובת ה-API היא `https://api.ailoot.ai`. עבור SDK בפורמט OpenAI, כתובת הבסיס היא `https://api.ailoot.ai/v1`, ועבור Anthropic ו-Gemini — `https://api.ailoot.ai` ללא סיומת: ערכות ה-SDK האלה מוסיפות את הנתיב בעצמן.

```bash
curl https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [
      {"role": "user", "content": "הסבר בשני משפטים מהו API."}
    ]
  }' 
```

```python
from openai import OpenAI
import os

client = OpenAI(max_retries=0, 
    base_url="https://api.ailoot.ai/v1",
    api_key=os.environ["AILOOT_API_KEY"],
)

resp = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "הסבר בשני משפטים מהו API."}],
)
print(resp.choices[0].message.content)
```

```js
import OpenAI from "openai";

const client = new OpenAI({ maxRetries: 0,
  baseURL: "https://api.ailoot.ai/v1",
  apiKey: process.env.AILOOT_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5-5",
  messages: [{ role: "user", content: "הסבר בשני משפטים מהו API." }],
});
console.log(resp.choices[0].message.content);
```

```python
import anthropic
import os

client = anthropic.Anthropic(max_retries=0, 
    base_url="https://api.ailoot.ai",   # ללא /v1: ה-SDK יוסיף בעצמו /v1/messages
    api_key=os.environ["AILOOT_API_KEY"],
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "הסבר בשני משפטים מהו API."}],
)
print(msg.content[0].text)
```

התשובה תגיע בפורמט המוכר. בבלוק `usage` — מספר הטוקנים ששימשו לשאלה ולתשובה: לפיהם מחושב החיוב.

200 OK

```json
{
  "id": "chatcmpl-8f2c…",
  "object": "chat.completion",
  "created": 1790812800,
  "model": "claude-sonnet-5-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "API הוא מוסכמה לגבי הדרך שבה תוכנית אחת מבקשת מאחרת לבצע פעולה…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 48,
    "total_tokens": 69
  }
}
```

## [](https://ailoot.ai/docs/he/#streaming)תשובה בזרם

עם `"stream": true` התשובה מגיעה בפורמט Server-Sent Events, כמו בממשקי ה-API המקוריים, ולכן ערכות SDK ולקוחות מנתחים אותה ללא שינוי. ב-OpenAI SDK נוח לבקש את הנתונים הסופיים של `usage` באירוע האחרון.

Ailoot מחזיר תשובת טקסט בתשלום לאחר חישוב העלות. לכן עם `stream: true` הפורמט נשאר זרם (SSE), אך הטקסט מגיע כבלוק אחד כשהמודל מסיים, ולא מילה אחר מילה. אם הכנת התשובה נמשכת יותר מכ-15 שניות, בזרמים של Chat Completions, Responses ו-Messages מגיעות תחילה שורות השירות `: ping` (בערך פעם ב-10 שניות), ולאחר מכן השורה `: ailoot-charged-usd …` עם סכום החיוב והנתונים עצמם. ערכות SDK מדלגות על שורות כאלה.

```python
stream = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "כתוב הייקו על גשם"}],
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
```

```js
const stream = await client.chat.completions.create({
  model: "gpt-6.1-sol",
  messages: [{ role: "user", content: "כתוב הייקו על גשם" }],
  stream: true,
  stream_options: { include_usage: true },
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
```

```bash
curl -N https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6.1-sol", "stream": true,
       "messages": [{"role": "user", "content": "כתוב הייקו על גשם"}]}' 
```

## [](https://ailoot.ai/docs/he/#models)בחרו מודל

השדה `model` — המזהה המדויק מתוך [קטלוג המודלים](https://ailoot.ai/models/he/) או מתשובת `GET /v1/models`. למודלים רבים יש כינויים קצרים, לדוגמה `claude-sonnet-latest` או `qwen`. המודל שאליו הכינוי מצביע כרגע מופיע בקטלוג; לתוצאות שניתן לשחזר, השתמשו במזהה המדויק.

| משימה | מאיפה להתחיל |
| --- | --- |
| קוד וסוכנים | `claude-sonnet-5-5`, `gpt-6.1-sol`, `claude-opus-5-5` |
| מהיר וזול | `gemini-3.8-flash`, `deepseek-v4.1-flash`, `qwen3.8-flash` |
| חלון הקשר גדול עד 1M טוקנים | `claude-sonnet-5-5`, `deepseek-v4-pro`, `qwen3.8-max` |
| תמונות | `gpt-image-2.5`, `gemini-3.1-flash-image`, `grok-imagine-image-2.0` |

לא כל מודל זמין בכל הפורמטים. למשל, מודלי Gemini פועלים דרך Anthropic Messages והפורמט המקורי של Gemini, וב-OpenAI Chat — רק `gemini-3.6-flash`. הפורמטים של כל מודל מוצגים ב- [קטלוג](https://ailoot.ai/models/he/).

## [](https://ailoot.ai/docs/he/#next)מה הלאה

[**איך זה עובד** מסלול הבקשה, רזרבה וחיוב, שגיאות](https://ailoot.ai/docs/he/how-it-works/)

[**תאימות** אילו פורמטים ולקוחות נתמכים](https://ailoot.ai/docs/he/compatibility/)

[**אינטגרציות** 77 אפליקציות עם הגדרה מוכנה](https://ailoot.ai/integrations/he/)

[**שגיאות ומגבלות** קודי תשובות ומה לעשות איתם](https://ailoot.ai/docs/he/errors/)

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

## API בינה מלאכותית: מפתח ובקשה ראשונה

### היכן יוצרים מפתח ל-API בינה מלאכותית?

באזור האישי, פתחו את סעיף המפתחות וצרו מפתח חדש. המפתח מתחיל ב- sk-. אפשר להעתיק אותו מסעיף המפתחות באזור האישי; שמרו עליו כמו על סיסמה.

חברו Ailoot ל- Claude Code, OpenCode, Hermes או ליישום שלכם.

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

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

## קנו אסימונים בהנחה.

הנחת מנוי לעבודה קבועה. קודי הנחה עד 50% על רכישת אסימונים.

מנוי

בחרו מסלול עם הנחה לבקשות הקבועות שלכם.

קוד הנחה עד 50%

הזינו קוד ברכישה. המחיר יחושב מחדש לפי המבצע הפעיל.

הוצאות בהיסטוריה

המודל, האסימונים והסכום נשמרים לכל בקשה.

[בחירת מנוי](https://ailoot.ai/docs/he/billing/subscriptions/) · [מחירי מודלים](https://ailoot.ai/models/he/)

## חברו API למוצר שאתם מוכרים.

SaaS, יישומים ובוטים לפי ההצעה והסכם הרישוי של Ailoot. למכירה מחדש בקשו רישיון משווק.

יישום מסחרי

שלבו יצירת טקסט, תמונות, וידאו ושמע בתכונות בתשלום של השירות שלכם.

רישיון למכירה מחדש

שלחו תיאור פרויקט ואופן מתן גישה. בקשו תנאי שימוש ומכירה מחדש בכתב.

מסמכים באתר

ההצעה, הסכם הרישוי ומדיניות עיבוד הנתונים זמינים לפני החיבור.

[בקשת רישיון למכירה מחדש](mailto:support@ailoot.ai) · [ההצעה והסכם הרישוי](https://ailoot.ai/legal/offer?lang=he)

## שאלות

איך שולחים את בקשת ה-API הראשונה?

צרו מפתח API של Ailoot. הגדירו את https://api.ailoot.ai/v1 עבור OpenAI SDK, או את https://api.ailoot.ai עבור Anthropic ו-Gemini SDK. הבקשה GET /v1/models חינמית ומציגה את המודלים הזמינים למפתח שלכם; לאחר מכן השתמשו בדוגמה עבור המודל ושיטת ה-API שנבחרו.

באיזה מפתח API צריך להשתמש?

השתמשו במפתח API של Ailoot מהחשבון שלכם בשדה האימות של פורמט הלקוח שנבחר. שלחו GET /v1/models עם אותו מפתח כדי לבדוק בחינם לאילו מודלים הוא מאפשר גישה; מפתח משירות אחר אינו מעניק גישה ל-Ailoot.

מה צריך לבדוק אם הבקשה הראשונה נכשלת?

השוו את כתובת ה-API, מפתח ה-API של Ailoot, ה-ID המדויק של המודל ושיטת ה-API לכרטיס המודל ולדוגמת הבקשה. קראו את השגיאה שהוחזרה; אם דרושה עזרה, שלחו ל-support@ailoot.ai את השגיאה ואת ה-ID של הבקשה, ללא מפתח ה-API שלכם.

מה המנוי נותן?

הנחה לרכישת אסימונים לעבודה קבועה. בחרו מסלול לפי היקף הבקשות שלכם; התנאים ועלות המנוי מוצגים ברכישה.

איך משתמשים בקוד הנחה עד 50%?

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

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





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





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





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