תיעוד API

התחלה מהירה: חיבור ב-3 שורות

ה-API שלנו עובד בדיוק כמו ממשק ה-chat-completions הסטנדרטי שאתם כבר מכירים. פשוט ציינו את ה-base URL של הלקוח שלכם אלינו וספקו את מפתח ה-API שלכם. אין צורך בניתוב מורכב או תכונות ייחודיות לספק. אנו מטפלים בשאר.

כתובת הבסיס לכל הבקשות היא https://api.toolsaiuncensored.com/v1. ניתן להשתמש בכל ספריית SDK רשמית או ספרייה תואמת על ידי עדכון תצורת כתובת הבסיס. האימות מסתמך על אסימון נשיאה (bearer token) יחיד המסופר דרך ה Authorization header. זה מבטיח אינטגרציה חלקה עם הערימה הקיימת שלך.

Copycurl https://api.toolsaiuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "run unit tests on the legacy auth module"}]
  }'

נקודות קצה: השלמות בצ'אט & מודלים

אנו חושפים רק את הנקודות הקצה החיוניות ליצירת טקסט. ה POST /v1/chat/completions נקודת קמע מעבדת את ההנחיות שלך ומחזירה טקסט שנוצר. השתמש ב- GET /v1/models לבדיקת מזהה המודל הזמין. אנו לא מציעים הטמעות, יצירת תמונות, עיבוד אודיו או שירותי עיבוד עדין. שמור על התשתית שלך פשוטה.

מזהה המודל שחייב לשלוח הוא uncensored. זהו מודל המשקל הפתוח שלנו, מותאם אישית, ולא מודל GPT או Claude מושכר. הוא עונה ישירות ללא מסנני תוכן לשימוש מבוגר חוקי. בדוק את תיעוד הנקודה הסופית (endpoint) למבני payload ספציפיים.

Copyfrom openai import OpenAI

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

פרמטרים: טמפרטורה, Top P, ו-seed

שלוו את היצירתיות והדטרמיניזם של הפלט שלכם באמצעות פרמטרים סטנדרטיים. התאימו temperature לשנות אקראיות. הגדר top_p להגביל דגימת גרעין (nucleus sampling). השתמש ב seed לשם תוצאות שחזוריות. כלי אלה מעניקים לך שליטה מדויקת על תהליך יצירת הטקסט.

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

Copyimport OpenAI from "openai";

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

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

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

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

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

מגבלות קצב & אילוצים

מפתח ה-API שלך מאפשר 300 בקשות לדקה. ניתן להריץ 8 בקשות מקבילות בו זמנית. גודל גוף הבקשה המקסימלי הוא 8 MB. כל מפתח קשור לחשבון אחד; יצירת מפתח חדש מחליפה את הישן.

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