מדריך אינטגרציה

התחלה מהירה: הבקשה הראשונה שלכם

ה-API הוא API תואם OpenAI המשקף את מבנה Chat Completions. אתם שולחים טקסט ומקבלים טקסט. אין נקודות קצה נוספות ל-Embeddings או אודיו שמבלבלות את זרימת העבודה. התחילו על ידי הפניית הלקוח שלכם לכתובת ה-Base URL שלנו.

• כתובת URL בסיסית: HTTPS://api.filtrosemia.com/v1
• מזהה מודל: "uncensored"

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

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

אימות וכותרות

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

• כותרת: Authorization: Bearer YOUR_API_KEY
• ללא זרימות OAuth או אסימוני רענון לניהול.

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

Copyfrom openai import OpenAI

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

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

שלם הודעות ל POST /v1/chat/completions. המודל תומך בפרמטרים סטנדרטיים כמו temperature, top_p, וכן stop רצפים. זהו מודל ללא צנזורה המותאם לתוכן מבוגר ויצירתי.

• תומך ב- json_object פורמט התגובה.
• מקבל הגדרות כלים לפקודות פונקציות.

בקשות מעובדות ברצף בתוך מגבלות הקצב שלך. ודא שהמטען שלך נמוך מ-8 MB.

Copyimport OpenAI from "openai";

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

תגובות בסטרימינג (SSE)

השתמשו באירועים מוכווני שרת למסירת טוקנים בזמן אמת. זה מפחית את תחושת הזמן המתפרסמת לתפליטים ארוכים. הקובץ הסופי מכיל את סטטיסטיקות השימוש המלאות בטוקנים.

• הגדר stream: true בבקשה שלך.
• נתח את זרם ה-SSE בלקוח שלך.

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

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)

חלון ההקשר ומגבלות

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

• פלט מקסימלי ברירת מחדל: 2,048 אסימונים.
• גבול קצב: 300 בקשות לדקה.

חריגת גבולות מפעילה 429 Too Many Requests שגיאה. התאם את הסינכרון כדי להישאר בתוך הגבולות. מותרות 8 בקשות מקבילות לכל מפתח.

טיפול בשגיאות וטוקנים

טפלו בשגיאות HTTP סטנדרטיות. 402 Payment Required משמעות הדבר שהאשראי המקדימים שלך אזל. 429 מציין הגבלת קצב. 401 אותות לבעיות אימות.

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

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