כתובת URL בסיסית ואימות
התחבר מיידית על ידי הפניית הלקוח שלך לכתובת ה-URL הבסיסית שלנו והעברת המפתח שלך בכותרת. האימות פשוט: כלול Authorization: Bearer YOUR_API_KEY עם כל בקשה. אתה מקבל את המפתח שלך מיד לאחר ההרשמה עם Google או אימייל. לא נדרש מספר טלפון, והמפתח מופיע על המסך מיד. הגדרה זו עובדת עם כל SDK תואם OpenAI סטנדרטי כי אנו עוקבים אחר מבנה הממשק הזהה. אינך צריך לנהל סשני התחברות מורכבים או להתמודד עם פג תוקף של סשנים שמאפיינים פלטפורמות אחרות. המפתח שלך הוא האישור היחיד שאתה צריך לכל נקודות הקצה. פשטות זו אומרת שניתן לשלב את ה-API בתסריטים או באפליקציות שלך ללא דאגה לגבי מחזורי רענון טוקנים או זרימות OAuth. השירות מיועד למפתחים שרוצים גישה ישירה ללא מכשולים бюrocrטיים. אנו מספקים ממשק נקי וצפוי שמתנהג בדיוק כמו הסטנדרט בתעשייה. זה מפחית משמעותית את זמן האינטגרציה בהשוואה להתמודדות עם מערכות התחברות פרופריטריים.
נקודת קצה להשלמות צ'אט
Send messages to the uncensored model using the standard chat completions endpoint. The endpoint accepts POST requests to /v1/chat/completions עם גוף JSON המכיל את ההודעות שלך. עליך לציין את מזהה המודל כ uncensored לשימוש במודל השפה הגדולה הספציפי שלנו. המערכת מחזירה תגובות טקסט שניתן לעבד או להציג. זהו API של טקסט-קלט, טקסט-פלט ללא יכולות יצירת תמונה או אודיו. אתה שולט בטון ובסגנון על ידי התאמת פרמטרים כמו טמפרטורה או top_p. פורמט התגובה עקבי וצפוי, מה שמקל על הניתוח בכל שפה. ניתן לשלוח מספר תורות בבקשה אחת לשמירה על היסטוריית שיחה. גישה זו מדמה את ההתנהגות של ספקים גדולים תוך הצעת המודל הספציפי שלנו ללא צנזורה. זהו הפונקציונליות ליבתית לבניית בוטים, עוזרים או יוצרי תוכן. הנקודה הסופית מותאמת למהירות ואמינות.
אינטגרציית SDK Python
שלב במהירות באמצעות ה-SDK הרשמי של Python עם תצורה מינימלית. עליך רק להגדיר את כתובת הבסיס ומפתח ה-API באתחול הלקוח שלך. קטע הקוד להלן מראה כיצד ליצור בקשת השלמת צ'אט פשוטה. שיטה זו עובדת בצורה חלקה עם מאגרי קוד קיימים של OpenAI מכיוון הממשק זהה. ניתן להעביר רשימת הודעות עם תפקידים כמו system, user, או assistant. אובייקט התגובה נותן לך גישה לטקסט שנוצר ולשימוש בטוקנים. זה הופך את ניפוי השגיאות והניטור של האפליקציה שלך לפשוטים. אינך צריך לכתוב לקוחות HTTP מותאמים אישית או לטפל ב-JSON serialization באופן ידני. ה-SDK מטפל בכל העבודה הכבדה עבורך. זה מפחית קוד boilerplate ומאיץ משמעותית מחזורי פיתוח. ניתן להתחיל לבנות אב טיפוס תוך דקות ולהרחיב מאוחר יותר כשצריך. הספרייה תיעודית היטב ונשמרת באופן פעיל.
שילוב Node SDK
השתמשו ב-SDK של Node.js כדי לשלב את ה-API בפרויקטים של JavaScript או TypeScript. ההגדרה דומה ל-Python: הגדירו את כתובת הבסיס והמפתח פעם אחת. דוגמת הקוד מציגה בקשה פשוטה לנקודת הקצה של צ'אט. אתם יכולים להשתמש באותו מבנה הודעות כמו ב-Python, מה שמבטיח עקביות בין כל המערכת שלכם. אובייקט התגובה מספק את טקסט ההשלמה וסטטיסטיקות שימוש. זה שימושי לעקוב אחר צריכת טוקנים באפליקציות Node שלכם. ה-SDK מטפל בזרימה וטיפול בשגיאות באופן פנימי, ומפשט את הקוד שלכם. אתם יכולים לשלב את זה בנתיבי Express, פונקציות ללא שרת או משימות רקע. הממשק מוכר לכל מי שהשתמש בספריית Node של OpenAI. זה אומר שאתם יכולים להשתמש מחדש בלוגיקה ודפוסים קיימים בלי ללמוד מבנה API חדש. זה מתאים באופן טבעי לאקוסיסטמות JavaScript מודרניות. אתם מקבלים את היתרונות של ממשק סטנדרטי עם יכולות המודל הספציפיות שלנו. זה מפחית עומס קוגניטיבי בעת מעבר בין חלקים שונים של האפליקציה שלכם.
תגובות בסטרימינג
אפשרו פלט בזמן אמת על ידי הגדרת פרמטר ה- stream ל- true בבקשה שלכם. ה-API מחזיר זרימה של קטעים במקום תגובה שלמה אחת. זה אידיאלי לממשקי צ'אט שבהם אתם רוצים להציג טקסט כשהוא נוצר. כל קטקט מכיל תגובה חלקית, המאפשרת לכם לעדכן את ממשק המשתמש בהדרגה. הקטקט הסופי כולל את סך השימוש באסימונים לבקשה. תכונה זו עובדת עם SDKs של Python ו- Node עם שינויי קוד מינימליים. אתם מטפלים בזרימה על ידי איטרציה על הקטעים וצירוף הטקסט. זה יוצר חווית משתמש חלקה יותר בהשוואה להמתנה לתגובה המלאה. זה שימושי במיוחד ליצירת תוכן ארוך או משימות חשיבה מורכבות. יכולת הזרימה היא סטנדרטית ב-APIs של LLM מודרניים ותומכת במלואה כאן. אתם יכולים לשלוט בזרימה על ידי ניהול קצב צריכת הזרימה. זה נותן לכם שליטה עדינה על אופן הצגת הפלט למשתמש.
מגבלות, שגיאות והקשר
חלון ההקשר תומך עד 100,000 טוקנים עבור פלט וקלט משולבים. ניתן לשלוח עד 8 בקשות מקבילות לכל מפתח ו-300 בקשות לדקה. אם תעבור את המגבלות הללו, תקבל שגיאת מגבלת קצב 429. שגיאות אימות מחזירות סטטוס 401 אם המפתח שלך לא תקין. סטטוס 402 מציין שאוצר האשראי המקדיד שלך אזל. ניתן להטעין עם קריפטו בכל עת כדי להמשיך את השירות. שגיאות אינן צורכות את האשראי שלך, כך שבקשות כושלות הן בחינם. מקסימום הפלט לכל בקשה הוא 16,000 טוקנים, או 2,048 אם לא מציינים מגבלה. גופי הבקשה מוגבלים ל-8 MB. מגבלות אלו נועדו להבטיח שימוש הוגן ויציבות המערכת. ניתן לעקוב אחר השימוש שלך דרך כותרות התגובה או אובייקטי ה-SDK. שקיפות זו עוזרת לך לנהל את התקציב ולתכנן את אדריכלות היישום שלך ביעילות. המודל המקדים אומר שאתה משלם רק על מה שאתה משתמש, ללא עמלות נסתרות.
cURL
curl https://api.mistralapilogin.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fix my token expiry error"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralapilogin.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.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mistralapilogin.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);זרימה
stream = 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)