התחלה
התחלה מהירה
הבקשה הראשונה למודל של NotHoly, בערך בשתי דקות.
1. מפתח API
- יש ליצור חשבון ב-notholy.com/signup ולאשר את האימייל.
- יש להוסיף קרדיטים בעמוד חיוב. הטעינה המינימלית מופיעה באותו עמוד.
- יש לפתוח את מפתחות API וליצור מפתח. המפתח מתחיל ברצף
nh_live_ומוצג פעם אחת בלבד.
יש לייצא אותו ב-shell. הוא נשלח בכותרת Authorization כ-bearer token.
export NOTHOLY_API_KEY="nh_live_..."2. רשימת המודלים
curl https://api.notholy.com/v1/models -H "Authorization: Bearer $NOTHOLY_API_KEY"הרשימה ציבורית ומציגה את המגבלות והמחירים של כל מודל. פרטים במודלים.
3. שליחת השלמת צ׳אט
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."}]}'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)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]. פרטים בסטרימינג.
מהטרמינל
ה-CLI משתמש באותו חשבון ומתחבר דרך הדפדפן, כך שאין צורך לייצא מפתח.
# macOS and Linux
curl -fsSL https://notholy.com/install.sh | sh# Windows (PowerShell)
irm https://notholy.com/install.ps1 | iexnotholy --version
notholy login
notholy "explain IDOR in two sentences"כל שלב מוסבר בהתקנת ה-CLI.
שגיאות נפוצות
| סטטוס | קוד | פתרון |
|---|---|---|
| 401 | invalid_api_key | לבדוק את המפתח ואת הכותרת Authorization: Bearer |
| 402 | insufficient_credits | להוסיף קרדיטים בעמוד חיוב |
| 404 | model_not_found | להשתמש במזהה מתוך GET /v1/models |
השלבים הבאים
- אימות: כותרות, מפתחות ושגיאות אימות
- מודלים: המודלים הנוכחיים, המגבלות והמחירים
- השלמות צ׳אט: הבקשה והתשובה המלאות
- ערכות SDK: ה-SDK של OpenAI ושל Anthropic