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

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

התחילו כל בקשה על ידי הפניית הלקוח שלכם אל HTTPS://api.uncensoredia.com/v1 והצמדת המפת שלכם. הרשאה משתמש ב- Bearer שיטה, כך שפשוט מדביק את האסימון שקיבלת לאחר ההרשמה עם Google או אימייל. נקודת הקצה היא לחלוטין openai compatible API תואם תקן, כלומר אתה רק צריך להחליף את כתובת ה-base_url ואת מפתח ה-API בתצורה הקיימת שלך. אתה לא צריך לנהל שכבות ניהול מסועפות או כותרות proxy. פשוט ודא שה Authorization header מכיל את הטוקן הייחודי שלכם. הגדרה זו מבטיחה שהבקשות שלכם יגיעו לדגם ה-uncensored המיועד ללא סינון ביניים. אם אתם מקבלים 401 שגיאה, ודא שהמפתח שלך פעיל ומעוצב כראוי.

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

שלם הודעות ל POST /v1/chat/completions כדי לקבל תגובות טקסט מהמודל ללא צנזורה. נקודת הקצה הבודדת הזו מטפלת בכל צרכי היצירה שלך, החל מפרומפטים פשוטים ועד לשיחות רב-שלביים מורכבות. ניתן לשלוט באורך הפלט ובאקראיות באמצעות פרמטרים כמו max_tokens, temperature, וכן top_p. המודל תומך ב- אסימון 100,000 חלון הקשר, המאפשר לך להזין תיעוד נרחב או היסטוריות שיחה ארוכות. אתה יכול לשלוח עד 16,000 טוקנים בתגובה. אם תשמיט max_tokens, ברירת המחדל היא 2,048 טוקנים. נקודת הקצה הזו לא תומכת ביצירת תמונות או אודיו. זהו טקסט פלט וטקסט פלט בלבד. השתמשו בפקודת ה-curl הבאה כדי לבדוק את החיבור שלכם מיד.

אינטגרציית SDK Python

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

הגדרת SDK Node.js

שלב את ה-API באפליקציות JavaScript או TypeScript שלך באמצעות ה- @anthropic-ai/sdk או ה- openai חבילה. הגדר את baseURL לנקודת הקצה שלנו וספק את מפתח ה-API שלך. זה מאפשר לך להשתמש בשיטות מוכרות כמו chat.completions.create() ישירות. ה-SDK מטפל בבקשות ה-HTTP ובניתוח תגובות ה-JSON עבורך. ניתן לטפל בקלות בשגיאות כמו 402 (insufficient credit) או 429 (rate limit) בתוך לוגיקת היישום שלך. הגדרה זו מושלמת לשרתי אינטרנט, בוטים או כל סביבת Node.js. המודל ללא צנזורה עובד בצורה חלקה עם פורמט הבקשה הסטנדרטי. הגדר את הלקוח שלך כדי להבטיח תאימות לציפיות ה-API.

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

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

מגבלות קצב & מגבלות הקשר

ה-API קובע מגבלות קשיחות כדי להבטיח ביצועים יציבים לכל המשתמשים. ניתן לשלוח עד 300 בקשות לדקה per מפתח ויש ל- 8 בקשות מקבילות פעיל בכל עת. גודל גוף הבקשה המקסימלי הוא 8 MB. אם תחריגו מגבלות אלו, תקבלו 429 קוד סטטוס. ודא שאתה מטפל בניסיונות חוזרים עם האצה מעריכית כדי להימנע מחציית המגבלות הללו שוב ושוב. חלון ההקשר הוא 100,000 טוקנים, אך הפלט המרבי הוא 16,000 טוקנים. אם אתה צריך יותר פלט, התאם את ה- max_tokens פרמטר. שגיאות כמו 401 (invalid key) ו- 402 (no credit) הם מיידיים ואינם צורכים את מגבלת הטוקנים שלך. נהל את המכסה שלך בזהירות כדי להימנע מהפרעות בשירות במהלך משימות יצירה בנפח גבוה.

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

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