תיעוד API להשלמות בשיחה ללא צנזורה

התחלה מהירה: חיבור ב-Python או JavaScript

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

התחילו עם בקשת HTTP פשוטה לאימות חיבור. השתמשו בפקודת curl למטה כדי לשלוח פלט (prompt) בסיסי ל- uncensored מודל. החלף YOUR_API_KEY עם המפתח שנוצר בלוח הבקרה שלך.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

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

Copyfrom openai import OpenAI

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

משתמשי JavaScript יכולים להשיג את אותה תוצאה באמצעות ה-SDK של Node. הגדר את baseURL מאפיין לנקודת הקצה שלך. גישה זו מאפשרת לך לשלב את ה-API בשרתי אינטרנט או שירותי Backend עם שינויי קוד מינימליים.

Copyimport OpenAI from "openai";

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

ניהול אימות ומפתח API

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

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

השתמשו במפתח בבקשות שלכם כך: Authorization: Bearer YOUR_API_KEY. פורמט הכותרת הסטנדרטי הזה עובד עם כל ה-SDKs הגדולים. שמור על המפתח שלך קרוב ליד לחזרה מהירה במהלך הפיתוח.

פרמטרים לנקודת הקצה להשלמות צ'אט

שלח בקשות אל /v1/chat/completions נקודת קצה. כלול את מערך ההודעות שלך והגדר את המודל ל- uncensored. אתה יכול להתאים פרמטרים כמו temperature וגם top_p לשלוט ביצירתיות. ערכים גבוהים יותר מייצרים תגובות מגוונות יותר.

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

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

תגובות בזרם ונתוני שימוש

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

נתוני השימוש מופיעים בקטע הסופי. זה כולל את מספרי הטוקנים בקלט ופלט. בדוק את usage field in the last response object. This allows accurate billing verification without separate API calls. Track token consumption in real-time.

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

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)

טיפול בשגיאות ומגבלות קצב

ה-API מחייב מגבלה של 300 בקשות לדקה לכל מפתח. בקשות מקבילות מוגבלות לשמונה לכל מפתח. גוף הבקשה לא יכול לעלות על 8 MB. חריגה ממגבלות אלו מחזירה שגיאת 429. ממש backoff מעריכי כדי לטפל בשיאים ארעיים.

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

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

מדריך למצב JSON וקריאת פונקציות

הגדירו מצב JSON על ידי response_format אל {"type": "json_object"}. זה מכריח את המודל להפיק JSON תקף. אידיאלי לחילוץ נתונים מבניים או לתגובות API. ודא שהפרומפט מתאר במפורש את הסכמה הרצויה.

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

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

פרטי מודל ומגבלות חלון הקשר

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

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

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