מדריך אינטגרציה ל-API של Character AI

למה להחליף את Character AI ב-API?

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

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

שלב 1: קבלת מפתח ה-API שלכם

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

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

שלב 2: הגדרת כתובת הבסיס

רוב לקוחות LLM המודרניים מצפים לממשק תואם OpenAI. אתה צריך להפנות את ה-SDK שלך לכתובת הבסיס הנכונה. עבור שירות זה, הנקודה היא https://api.uncutlyai.com/v1. מבנה כתובת ה-URL זה משקף את ה-API הסטנדרטי של OpenAI. זה אומר שניתן להשתמש בספריות קיימות ללא שינויי קוד משמעותיים.

עדכן את אובייקט התצורה שלך כדי לכלול את כתובת הבסיס הזו. בנוסף, הגדר את מפתח ה-API ב-header ההרשאה. מזהה המודל שבו תשתמש הוא פשוט "uncensored". מודל זה מותאם ליותר פחות סירובים וחופש יצירתי טוב יותר. הוא מטפל בהקשרים ארוכים היטב, עד 100,000 טוקנים. אורך זה מאפשר היסטוריה עמוקה של דמויות.

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

בנו בקשה ל /v1/chat/completions נקודת קצה. הגוף צריך להכיל רשימה של הודעות. כל הודעה כוללת תפקיד כמו "system", "user" או "assistant". ההודעה מהמערכת מגדירה את האישיות של הדמות. ההודעות מהמשתמש מניעות את השיחה.

הנה כיצד מבנים את הבקשה:

Copycurl https://api.uncutlyai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
  }'

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

שלב 4: טיפול בתגובות סטרימינג

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

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

Copyfrom openai import OpenAI

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

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

שלב 5: ניהול טוקנים ועלויות

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

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

שלב 6: יישום קריאה לפונקציות

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

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

Copyimport OpenAI from "openai";

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

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

שלב 7: טיפול בשגיאות ומגבלות

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

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

שלב 8: סקלת האינטגרציה שלך

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

דמיינו אחסון במטמון של תגובות תכופות. אם משתמשים רבים שואלים את אותה שאלה, הגישו את התוצאה מהמטמון. זה מפחית קריאות API וחוסך כסף. ניתן גם ליישם הגבלת קצב (Rate Limiting) בשרת שלכם. זה מונע ממשתמש בודד לצרוך את כל האשראי שלכם. שילוב מדרג היטב נשאר מהיר ואמין.