מדריך להתחלה מהירה ל-API ללא צנזורה

אימות וכתובת בסיס

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

נקודת קצה להשלמות צ'אט

שלח בקשות טקסט ל- /v1/chat/completions נקודת קצה (endpoint) ליצירת תגובות. נקודת קצה זו מטפלת בהיסטוריות שיחה סטנדרטיות ובפקודות מערכת. עליך לציין את מזהה המודל כ- uncensored בגוף הבקשה. ה-API מחזיר תגובות בפורמט JSON הכוללות את הטקסט שנוצר וסטטיסטיקות שימוש באסימונים. שגיאות כמו אשראי לא מספיק או מפתחות לא חוקיות מוחזרות עם קודי סטטוס HTTP מתאימים. השתמש בנקודת הקצה הזו לכל משימות יצירת הטקסט הסטנדרטיות. היא אינה תומכת בהטמעות, תמונות או עדינות. שמור על הגוף מתחת ל-8 MB כדי להבטיח עיבוד אמין. המודל מעבד אסימוני קלט ופלט בתוך חלון הקשר משותף.

תגובות בסטרימינג

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

פקודות פונקציה ומצב JSON

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

פרמטרים ומגבלות קצב

התאם את התנהגות היצירה באמצעות פרמטרים כמו temperature, top_p, וכן seed. הגדירו max_tokens להגביל את אורך הפלט, עם ברירת מחדל של 2,048 אם לא צוין. ה-API אוכף מגבלת קצב של 300 בקשות לדקה למפתח. בקשות מקבילות מוגבלות ל-8 למפתח. אם תחרוג ממגבלות אלו, ה-API יחזיר קוד סטטוס 429. בקשות נגבות על פי שימוש בפועל בטוקנים, כאשר שגיאות וסירובים הם ללא תשלום. אשראי לא פג תוקף, וסכומים מקודמים הם שקופים. נהל את המפתחות שלך בזהירות, שכן כל חשבון תומך רק במפתח פעיל אחד בכל זמן.

מגבלות, שגיאות והקשר

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

cURL

Copycurl https://api.uncensoredmodelsollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the ollama library."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

זרימה

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)