API Quickstart & אינטגרציה

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

פרויקט Heriction מספק נקודת קצה אחת מאוחסנת ליצירת טקסט. השתמש https://api.hereticproject.com/v1 ככתובת הבסיס שלך. האימות מתבסס על אסימון bearer המועבר דרך ה- Authorization כותרת. צור את המפתח שלך על ידי התחברות עם Google או דוא"ל בלוח הבקרה. המערכת מנפיקה מפתח פעיל אחד לכל חשבון; יצירת מפתח חדש מבטלת את הקודם מיד.

אתה משלם רק עבור טוקנים שצרכת. שגיאות ודחיות לא גובות מהאשראי המקדין שלך. חשבון חדש מקבל $0.50 באשראי ניסיון בתוקף ל-7 days. אתה מוסיף אשראי באמצעות USDT (TRC20) או USDC (Base) בסכומים בין $20 ל-$500.

נקודת הקצה /v1/chat/completions

שלח הודעות לנקודת הקצה הסטנדרטית להשלמת צ'אט. מזהה המודל הוא uncensored. הוא מקבל רשימה של אובייקטי הודעות עם תפקידים כמו system, user, או assistant. המודל לא מסרב לנושאים מבוגרים חוקיים, בדיוניים או שנויים במחלוקת. זהו מודל בעל משקל פתוח שהותאם לתשובות ישירות.

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

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

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

השתמשו בספריית הפיתון הרשמית של OpenAI עם כתובת Base URL מותאמת אישית. הגדירו api_key למחרוזת ה-API שלך. הגדר base_url לצביעה לשרת פרויקט Heretic. זה מאפשר לך להשתמש בשיטות מוכרות כמו chat.completions.create() ללא שינוי משמעותי במבנה הקוד הקיים שלך.

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

Copyfrom openai import OpenAI

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

שילוב Node SDK

SDK Node.js עובד באופן זהה לגרסת Python. אתחל את הלקוח עם מפתח ה-API וכתובת ה-URL הבסיסית הנכונה. ניתן לשלוח בקשות השלמה באמצעות חתימות השיטה זהות. זה מבטיח עקביות בין חלקים שונים של מערך הטכנולוגיה שלך.

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.hereticproject.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). כל חלק מכיל עדכוני טקסט חלקיים. זה מפחית את תחומת העיכוי עבור המשתמשים הסופיים. נתוני שימוש בטוקנים מופיעים בחלק הסופי של הזרם.

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

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)

מגבלות, שגיאות והקשר

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

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