תיעוד ממשק API של Hermes: התחלה מהירה

התקנה והגדרה

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

• כתובת URL בסיסית: HTTPS://api.apihermes.cc/v1
• כותרת Auth: Authorization: Bearer YOUR_API_KEY
• מזהה מודל: uncensored

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

בקשת השלמת צ'אט בסיסית

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

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

Copycurl https://api.apihermes.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a GET request for the user endpoint"}]
  }'

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

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

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

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

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)

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

שימוש ב-FUNCTION CALLING וכלים

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

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apihermes.cc/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 אמין. שגיאות חסרות. מערכת התשלום המוקדם מבטיחת הוגנות. אתם שולטים בזרימה. כתובת הבסיס עקבית. האימות פשוט.

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

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

פרמטרים כוללים טמפרטורה, top_p, stop, seed, presence_penalty ו-frequency_penalty. טמפרטורה שולטת באקראיות. top_p שולט בשונות. רצפי עצירה עוצרים יצירה. Seed מבטיח שחזור. קנסות נוכחות ותדירות מתאימים את השימוש באסימונים. הגדר אלו כדי לשפר את הפלט. ממשק ה-API תומך בכל הפרמטרים הסטנדרטיים. השתמש בהם כדי לכוון את התגובה. כתובת ה-URL הבסיסית נשארת זהה. האימות זהה.

Copyimport OpenAI from "openai";

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

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

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

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