Apertus ia API Documentation

1. Quickstart: Connect Your First Request

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

השתמשו בפקודת cURL הבאה כדי לבדוק חיבוריות מיד. החליפו את YOUR_API_KEY במפתח האמיתי שלכם.

Copycurl https://api.apertusia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
  }'

שגיאות אימות מחזירות 401. חוסר מספיק במאזן מחזיר 402. מגבלות קצב מחזירות 429.

2. פרמטרים נתמכים: טמפרטורה, Top P וזרע

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

דוגמה לקטע קוד פייתון לבדיקה מקומית:

Copyfrom openai import OpenAI

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

3. תגובות בזרימה עם אירועים שנשלחים מהשרת

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

דוגמה ב-Node.js באמצעות ה-SDK הרשמי:

Copyimport OpenAI from "openai";

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

4. תצורת קריאה לפונקציה ומצב JSON

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

5. מגבלות קצב וقيסויי גודל בקשה

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

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

צור את המפתח שלך דרך לוח הבקרה. השתמש בכניסה באמצעות Google או במייל. המפתח מופיע מיד. כלול אותו בכותרת Authorization: Bearer. מפתחות לא חוקיים מחזירים 401. שגיאות 429 מצייות שחל גמר מגבלת השימוש. שגיאות 402 משמעותן שהקרדיט המשולם מראש שלך אזל. מלא מחדש באמצעות USDT או USDC. קרדיטים לא פגים לעולם.

סטרימינג

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)