מדריך התחלה מהירה

התקנה ותצורה

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

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

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

ביצוע הבקשה הראשונה

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

ה-API מקבל פרמטרים סטנדרטיים כמו temperature ו-top_p. השתמשו בפקודת cURL הבאה כדי לאמת חיבור ואיכות תגובה מיד.

Copycurl https://api.chatbotunrestricted.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fetch current temperature in Tokyo."}]
  }'

תגובה זו מאשרת שהמודל פעיל ומוכן לתעבורה ייצורית.

טיפול בתגובות זרם

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

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

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)

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

שימוש בכלים וקריאת פונקציות

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

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

Copyimport OpenAI from "openai";

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

תמיד אמת את סכמת הפלט לפני הביצוע.

ניהול אסימונים ומגבלות

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

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

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

טיפול בשגיאות ופתרון תקלות

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

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

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

Python

Copyfrom openai import OpenAI

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