התחלה מהירה: שילבו את ממשק ה-API ללא צנזורה

דרישות מוקדמות והתקנת SDK

ה-API דורש מפתח API תקף ו-SDK מודרני. התקן את הספרייה לשפה המועדפת עליך באמצעות pip או npm. אנחנו תומכים בספריות לקוח סטנדרטיות של OpenAI שטופלות באימות ופיענוח JSON אוטומטית.

ודא שיש לך Python 3.8+ או Node.js 18+ מותקנים. ה-SDKs מנהלים איגום חיבורים ולוגיקת ניסיונות חזרה עבורך. זה מפחית משמעותית את כמות הקוד החוזר (boilerplate).

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ablatedmodels.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

הגדרת כתובת ה-URL הבסיסית ומפתח ה-API

כוון את הלקוח שלך לנקודת הקצה הספציפית שלנו. השתמש בכתובת ה-URL הבסיסית שסופקה בלוח הבקרה שלך. העבר את מפתח ה-API שלך בכותרת Authorization. זה מבטיח שהבקשות יגיעו לתשתית ללא צנזורה ישירות.

אל תשתמשו בכתובת הבסיס הסטנדרטית של OpenAI. המפתח שלכם ייכשל אם יופנה בצורה שגויה. הגדירו את כתובת ה-URL הבסיסית באובייקט התצורה של ה-SDK שלכם לפני שליחת כל נתון.

Copycurl https://api.ablatedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
  }'

שליחת בקשת ההשלמה הראשונה שלך

שלח בקשת POST ל-/v1/chat/completions. כלול את מזהה המודל ומערך ההודעות. המודל מגיב בתוכן טקסט מיד. לא נדרשת לוגיקת ניהול מורכבת.

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ablatedmodels.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

טיפול בתגובות זרם ושימוש בכלים

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

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

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

הבנת מגבלות טוקנים וחלון ההקשר

חלון ההקשר תומך ב-100,000 טוקנים בסך הכל. זה כולל טוקני קלט ופלט. הגדר max_tokens כדי להגביל את אורך התשובה. הפלט המקסימלי ברירת המחדל הוא 2,048 טוקנים אם לא צוין.

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

פתרון שגיאות נפוצות

בדוק תחילה את מפתח ה-API שלך. שגיאת 401 מציינת מפתח לא חוקי או פג תוקף. שגיאת 402 משמעותה שאשראי הקדמי שלך אזל. טען מחדש באמצעות קריפטו כדי להמשיך.

שגיאת 429 מסמלת הגבלת קצב. אתה מוגבל ל-300 בקשות לדקה. הפחית את הסינכרון שלך או המתן לפני ניסיון חוזר. מגבלת גוף ה-8 MB גוררת גם שגיאות 400 אם חורגים ממנה.