אינטגרציה שלב-אחר-שלב של API ה-LLM של uncensored.com

דרישות מוקדמות: SDK והגדרת סביבה

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

ודאו שהסביבה שלכם כוללת Python 3.8+ או Node.js 18+. התקינו את החבילה באמצעות pip או npm. תזדקקו למפתח API מהלוח הבקרה. אין צורך במספר טלפון להרשמה.

• Python: pip install openai
• Node.js: npm install openai

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

הגדרת כתובת ה-URL הבסיסית

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

הגדר את כתובת הבסיס ל-HTTPS://api.uncensoredaicom.com/v1. זה מכוון בקשות לתשתית ה-LLM ה-uncensored. מזהה המודל שאתה חייב לשלוח הוא "uncensored". זהו מודל בעל משקל פתוח שמוטא למינון סירובים מינימלי.

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

הגדרת כותרות ואימות

העבירו את מפתח ה-API שלכם בראש ה-Authorization. השתמשו בסכמת Bearer לכל הבקשות. ראש זה מאמת את חשבון האשראי הקנוי שלכם.

הגדר את הכותרת כ: Authorization: Bearer YOUR_API_KEY. ה-SDK מטפל בזה באופן אוטומטי אם אתה מעביר את המפתח לבנאי הלקוח. ודא שלא נכלל רווח לבן נוסף. מפתחות לא חוקיים מחזירים שגיאת 401 Unauthorized.

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

שליחת בקשת צ'אט סטנדרטית

שלחו בקשת POST ל-/v1/chat/completions. שלחו את ההודעות שלכם כמערך של אובייקטים עם role ו-content. המערכת תומכת בתפקידי user, assistant ו-system.

מבנה לדוגמה: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. ה-API מחזיר השלמת טקסט. חלון ההקשר הוא 100,000 אסימונים בסך הכל. הפלט המקסימלי הוא 16,000 אסימונים לכל בקשה.

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

הפעלת זרם נתונים לפלט בזמן אמת

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

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

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

שימוש בכלים וב-FUNCTION CALLING

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

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

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

טיפול בתגובות מצב JSON

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

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

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

ניטור מגבלות ושגיאות

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

נטר קודי סטטוס HTTP. 429 מציינת חריגת מגבלת קצב. 400 מציינת בקשה שגויה. 500 מציינת שגיאת שרת. יישם החזרה מעריכית לניסיונות חוזרים. זה מונע עומס יתר על ה-API.

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

חישוב עלויות ושימוש באסימונים

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

הטען יתרה באמצעות קריפטו בלבד. USDT (TRC20) או USDC (Base). הסכומים נעים בין $20 ל-$500. קרדיט בונוס מיושם על הפקדות גדולות יותר. +5% החל מ-$50, +10% החל מ-$100, +15% החל מ-$200.

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