התחלה מהירה: שילבו את צ'אט apertus ai

דרישות מוקדמות והגדרה

התחל ביצירת חשבון וקבלת מפתח ה-API שלך. הירשם באמצעות Google או סיסמת דוא"ל בדף יצירת המפתחות. המערכת מציגה את המפתח שלך מיד, כך שתוכל להעתיק אותו ללא עיכוב. לא נדרש מספר טלפון לרישום. אתה מקבל $0.50 באשראי ניסיוני בתוקף ל-7 ימים, כך שתוכל לבדוק חיבוריות ללא הוספת כספים.

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

ודאו שספריית הלקוח שלכם תומכת בפרוטוקול השלמת הצ'אט של OpenAI. רוב ה-SDKs המודרניים עובדים מהקופסה. ודאו שהרשת שלכם מאפשרת בקשות HTTPS יוצאות. השירות מקבל מטעני JSON סטנדרטיים. אין צורך בכותרות מיוחדות מעבר לאישור.

אימות עם מפתחות API

העבירו את מפתח ה-API שלכם בראש ה-Authorization לכל בקשה. השתמשו בסכמת Bearer ולאחריו מחרוזת המפתח שלכם. השירות מאמת את המפתח מול החשבון שלכם. מפתחות לא חוקיים מחזירים שגיאת 401 Unauthorized. תוקף שפג או איזון לא מספיק יגרמו לתגובת 402 Payment Required. בדקו את האיזון שלכם בלוח הבקרה אם בקשות נכשלות.

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

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

האימות הוא ללא מצב (stateless). השרת בודק את הטוקן בכל קריאה. אם תסובבו את המפתח, עדכנו את כל הלקוחות הפעילים מיד. חוסר ב-Header גורם לדחייה מיידית. הודעת השגיאה מציין בבירור את כשל האימות.

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

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

Copyfrom openai import OpenAI

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

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

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

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

אפשרו זרם על ידי הגדרת הפרמטר 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)

Streaming reduces perceived latency. Users see text appearing in real time. This is ideal for chat interfaces. Handle partial tokens carefully. Concatenate chunks to form the complete response. The server closes the connection when generation finishes.

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

טיפול בפרמטרים ומצבים

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

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

Copyimport OpenAI from "openai";

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

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

הבנת מגבלות ושגיאות

מגבלות קצב מגנות על יציבות השירות. אתה יכול לשלוח 300 בקשות לדקה. המקבילות מוגבלת לשמונה בקשות סימולטניות לכל מפתח. גופי הבקשה לא יכולים לעלות על 8 MB. חריגה ממגבלות מחזירה שגיאת 429 Too Many Errors. המתן לפני ניסיון חוזר.

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

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