# התחלה מהירה

> הבקשה הראשונה למודל של NotHoly, בערך בשתי דקות.


## 1. מפתח API

1. יש ליצור חשבון ב-[notholy.com/signup](https://notholy.com/he/signup) ולאשר את האימייל.
2. יש להוסיף קרדיטים בעמוד **חיוב**. הטעינה המינימלית מופיעה באותו עמוד.
3. יש לפתוח את **מפתחות API** וליצור מפתח. המפתח מתחיל ברצף `nh_live_` ומוצג פעם אחת בלבד.

יש לייצא אותו ב-shell. הוא נשלח בכותרת `Authorization` כ-bearer token.

```bash
export NOTHOLY_API_KEY="nh_live_..."
```

## 2. רשימת המודלים

```bash test
curl https://api.notholy.com/v1/models -H "Authorization: Bearer $NOTHOLY_API_KEY"
```

הרשימה ציבורית ומציגה את המגבלות והמחירים של כל מודל. פרטים ב[מודלים](/he/getting-started/models).

## 3. שליחת השלמת צ׳אט

```bash test
curl https://api.notholy.com/v1/chat/completions \
  -H "Authorization: Bearer $NOTHOLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "notholy-specter", "messages": [{"role": "user", "content": "Explain IDOR in two sentences."}]}'
```

```python test
import os
from openai import OpenAI

client = OpenAI(base_url="https://api.notholy.com/v1", api_key=os.environ["NOTHOLY_API_KEY"])

r = client.chat.completions.create(
    model="notholy-specter",
    messages=[{"role": "user", "content": "Explain IDOR in two sentences."}],
)
print(r.choices[0].message.content)
```

```js test
import OpenAI from 'openai';

const client = new OpenAI({ baseURL: 'https://api.notholy.com/v1', apiKey: process.env.NOTHOLY_API_KEY });

const r = await client.chat.completions.create({
  model: 'notholy-specter',
  messages: [{ role: 'user', content: 'Explain IDOR in two sentences.' }],
});
console.log(r.choices[0].message.content);
```

## 4. סטרימינג

יש להוסיף `"stream": true` ולקרוא server-sent events. כל אירוע הוא `data: {...}`, והזרם מסתיים בשורה `data: [DONE]`. פרטים ב[סטרימינג](/he/guides/streaming).

## מהטרמינל

ה-CLI משתמש באותו חשבון ומתחבר דרך הדפדפן, כך שאין צורך לייצא מפתח.

```bash
# macOS and Linux
curl -fsSL https://notholy.com/install.sh | sh
```

```powershell
# Windows (PowerShell)
irm https://notholy.com/install.ps1 | iex
```

```bash
notholy --version
notholy login
notholy "explain IDOR in two sentences"
```

כל שלב מוסבר ב[התקנת ה-CLI](/he/cli/install).

## שגיאות נפוצות

| סטטוס | קוד | פתרון |
|---|---|---|
| 401 | `invalid_api_key` | לבדוק את המפתח ואת הכותרת `Authorization: Bearer` |
| 402 | `insufficient_credits` | להוסיף קרדיטים בעמוד חיוב |
| 404 | `model_not_found` | להשתמש במזהה מתוך `GET /v1/models` |

## השלבים הבאים

- [אימות](/he/getting-started/authentication): כותרות, מפתחות ושגיאות אימות
- [מודלים](/he/getting-started/models): המודלים הנוכחיים, המגבלות והמחירים
- [השלמות צ׳אט](/he/api/chat-completions): הבקשה והתשובה המלאות
- [ערכות SDK](/he/getting-started/sdks): ה-SDK של OpenAI ושל Anthropic