תיעוד API

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

חברו את היישום שלכם על ידי הצמדה לנקודת הקצה הייעודית שלנו והעברת מפתח ה-API הייחודי שלכם. כתובת ה-URL הבסיסית לכל הבקשות היא https://api.apertusapp.com/v1. אתה מקבל את המפתח שלך מיד לאחר ההרשמה באמצעות Google או דואר אלקטרוני ב- קבל מפתח API דף. כללו מפתח זה ב- Authorization header לכל בקשה.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

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

בקשה ראשונה

שלחו prompt ראשון אל נקודת הקצה של השלמות צ'אט כדי לקבל טקסט גולי, ללא סינון. השתמשו ב-mdl ID uncensored לגישה למודל בעל משקל פתוח ספציפי שלנו המותאם לשימוש מבוגר חוקי ונושאים שנויים במחלוקת.

Copyfrom openai import OpenAI

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

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

שילוב Node SDK

השתמשו ב-SDK הרשמי של Node לטיפול במצב JSON וקריאת פונקציות ביעילות. הגדירו response_format אל {"type": "json_object"} לפלטות מבניות או הגדרת כלים להתנהגות דמוית סוכן.

Copyimport OpenAI from "openai";

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

המודל תומך בקריאות לכלים עם tool_choice אפשרויות. אתה יכול גם להגדיר seed לתוצאות דטרמיניסטיות. גמישות זו מאפשרת לך לבנות אפליקציות מורכבות ללא עזיבת אקוסיסטמת OpenAI-compatible.

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

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

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

חלון הקשר וקיבולת

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

חלון גדול זה מאפשר ניתוח מסמכים נרחב או היסטוריות שיחה ארוכות. עם זאת, שמור על גופי הבקשה מתחת ל-8 MB. המודל אינו GPT או Llama; זהו מודל AI ללא צנזורה ייחודי המותאם למקרה השימוש הספציפי שלך.

טיפול בשגיאות ומגבלות

טפלו בשגיאות HTTP סטנדרטיות בצורה תקינה כדי לשמור על זרימת אפליקציה חזקה. A 401 שגיאה מצביעה על מפתח API לא תקין או חסר. A 402 שגיאה משמעותה שאזל האשראי ששולם מראש. A 429 שגיאה מציינת שחרגת מ-300 בקשות לדקה או מ-8 בקשות מקבילות.

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