API Quickstart

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

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

שליחת הבקשה הראשונה שלך

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

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

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

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

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

Copyfrom openai import OpenAI

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

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

שילוב Node SDK

שלב את ה-API באפליקציות JavaScript או TypeScript שלך באמצעות ה-Node SDK. הגדר את כתובת ה-URL הבסיסית ומפת ה-API בדיוק כמו בדוגמה ב-Python. גישה זו מתאימה היטב לשרטוט צד שרת או מיקרו-שירותי backend. ה-SDK מסתיר את שכבת הרשת, ומאפשר לך להתמקד בלוגיקת ה-prompt.

Copyimport OpenAI from "openai";

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

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

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

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

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

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

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