תיעוד ה-API של Ablated ai

אימות: שימוש במפתח ה-API שלך

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

מבנה כתובת URL בסיסית ונקודת קצה

הפנה את כל הבקשות לכתובת הבסיס היחידה שלנו להשלמת צ'אט. אנו לא מציעים קצות API להטמעה (embeddings), יצירת תמונות או הדגמה מחדש (fine-tuning). השתמש ב- POST /v1/chat/completions נתיב לשליחת ההנחיות שלך. אתה יכול גם לבצע שאילתות GET /v1/models לבדיקת מזהה המודל הזמין. מבנה זה מבטיח תאימות עם לקוחות SDK קיימים של OpenAI ללא לוגיקת הפניה מותאמת אישית.

התחלה מהירה: הבקשה הראשונה שלך עם ablated AI

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

Copycurl https://api.aiablated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the api"}]
  }'

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

אינטגרציית SDK Python

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.aiablated.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)

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

שילוב SDK Node.js

שלב את ה-API בפרויקטים JavaScript או TypeScript שלך באמצעות ה-SDK הסטנדרטי. הגדר את כתובת ה-URL הבסיסית כדי להצביע על השירות שלנו. זה מאפשר לך להשתמש בשיטות מוכרות כמו chat.completions.create. ה-SDK מטפל בכותרות הבקשה וניתוח התגובה. ניתן להוסיף בקלות טיפול בשגיאות עבור מגבלות קצב או כשלי אימות.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.aiablated.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);

תצורה זו מבטיחה שהאפליקציה שלך ב-Node תקשר בצורה נכונה. החלפת כתובת ה-URL הבסיסית היא השלב הקריטי. ללא זאת, ה-SDK ינסה להתחבר לענן של OpenAI במקום לשרתים שלנו.

תגובות בסטרימינג וצריכת טוקנים

קבלו תגובות טוקן אחר טוקן באמצעות Server-Sent Events (SSE). זה מפחית את תחוכת העיכוי הנקלטת עבור פלט ארוך. החבילה הסופית של הזרם מכילה את סך השימוש בטוקנים עבור הבקשה. אתם יכולים לעקוב אחר צריכת האשראי הקנוי שלכם בזמן אמת. הגדירו stream: true בפלט הבקשה שלך כדי להפעיל מצב זה. זה אידיאלי לממשקי צ'אט ויצירת טקסט חיה.

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)

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