תיעוד API & מדריך התחלה מהיר

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

התחל בהגדרת כתובת הבסיס ל-HTTPS://api.uncensoredal.com/v1 והעבר את מפתח ה-API שלך בכותרת ה-Authorization. אתה מקבל מפתח פעיל אחד לכל חשבון, ויצירת מפתח חדש מבטלת מיד את הקודם. התצורה הפשוטה הזו עובדת עם כל לקוח תואם OpenAI סטנדרטי ללא לוגיקת הפניות מורכבת.

Copycurl https://api.uncensoredal.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate the next 50 lines of a python script"}]
  }'

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

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

שלח בקשת POST ל-/v1/chat/completions עם היסטוריית ההודעות שלך במערך messages. המעבד מעבד קלט טקסט ומחזיר טקסט שנוצר ללא סירובי תוכן לשימוש מבוגר חוקי. עליך לציין את המודל כ-"uncensored" בפלטפורמה שלך כדי להבטיח תאימות.

Copyfrom openai import OpenAI

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

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

תגובות בסטרימינג עם SSE

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

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 מחזיר אירעי זרימה סטנדרטיים התואמים ל-OpenAI, מה שמקל על שילוב עם ספריות ממשק משתמש קיימות. אתם יכולים לעצור את הזרימה מוקדם אם המשתמש משנה את הקלט שלו.

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

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

Copyimport OpenAI from "openai";

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

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

תצורת פרמטרי מודל

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

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

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

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

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