תיעוד למפתחים

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

מפתח ה-API שלך מאמת כל בקשה ל- chat-completions נקודת קצה. אתה מקבל את המפת הזה מיד לאחר ההרשמה באמצעות Google או אימייל ב- קבל מפתח API דף. אין צורך במספר טלפון. שמרו את המפתח שלכם באופן מאובטח והעבירו אותו ב- Authorization כותרת.

כתובת בסיס: https://api.cheapllm.cc/v1. כל הבקשות חייבות לכלול את הכותרת הזו: Authorization: Bearer YOUR_API_KEY. שגיאות כמו 401 מצביעות על מפתח חסר או לא חוקי. החלף את המפתח הישן שלך בכל עת כדי ליצור מפתח חדש; קיים רק מפתח פעיל אחד לכל חשבון.

בקשה ראשונה

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

להלן דוגמה בסיסית ל-cURL. החליפו YOUR_API_KEY עם המפתח שלך. גוף הבקשה מגדיר את הודעת המשתמש. אנו מעבדים חלון הקשר של 100,000 אסימונים (הנחיה + השלמה). שגיאות וסירובים הם בחינם, אז ניתן לבדוק בחופשיות.

• הגדר model אל uncensored.
• כלול messages מערך.
• הוסף את כותרת מפתח ה-API שלך.

Copycurl https://api.cheapllm.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set timezone to UTC for all logs"}]
  }'

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

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

התקן את הספרייה עם pip install openai. אתחל את הלקוח עם כתובת ה-URL הבסיסית שלנו. הקוד להלן מציג בקשת השלמה פשוטה. התאם את תוכן ההודעה למקרה השימוש שלך. ה-API שלנו מטפל בהפניה למודל הנכון באופן פנימי.

Copyfrom openai import OpenAI

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

שילוב Node SDK

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

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

Copyimport OpenAI from "openai";

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

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

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

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

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)

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

ל-API שלנו יש מגבלות קפדניות כדי להבטיח יציבות. ניתן לשלוח 300 בקשות לדקה לכל מפתח. בקשות מקבילות מוגבלות ל-8. גופי בקשה לא יכולים לעלות על 8 MB. חלון ההקשר הוא 100,000 טוקנים בסך הכל. פלט מקסימלי הוא 16,000 טוקנים לבקשה (2,048 אם max_tokens לא מוגדר). שגיאות מחזירות קודים ספציפיים: 401 למפתחות לא חוקיים, 402 לחסר אשראי, ו-429 למגבלות קצב. אשראי לא פג תוקף. טעויות כמו חיובים כפולים מתוקנות דרך תמיכה. הפרטיות נשמרת; פרומפטים לא משמשים לאימון. אין תוכן מיני העוסק בקטינים.