תיעוד API
הדביקו את הקוד התואם ל-OpenAI שלך לקצה שלנו. מדריך זה מראה כיצד להתחבר, לאמת ולזרום תגובות ללא עלות תצורה.
אימות & כתובת הבסיס
התחל על ידי הפניית הלקוח שלך לכתובת הבסיס הנכונה. אנו מקבלים ראשים סטנדרטיים של OpenAI לתאימות. מפתח ה-API שלך מופיע בראש Authorization כ-bearer token. העבר אותו ישירות ממשתני הסביבה שלך כדי להימנע מהכנסת סודות בקוד. תצורה זו עובדת עם כל ספרייה התומכת בפרוטוקול OpenAI.
בקשה ראשונה
שלח השלמת צ'אט פשוטה כדי לאמת חיבוריות. השתמש במזהה המודל "uncensored" ליצירת טקסט. נקודת הקצה מחזירה JSON סטנדרטי עם בחירות ומדדי שימוש. אם אתה מקבל 401, בדוק את פורמט המפתח שלך. 402 מצביע על מאזן אשראי ששולם מראש לא מספיק. בדיקה מהירה זו מאשרת שהאינטגרציה שלך מוכנה לתעבורת ייצור.
curl https://api.mistralbaseurl.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List installed python packages with versions"}]
}'
אינטגרציית SDK Python
הגדר את חבילת OpenAI Python להשתמש בכתובת הבסיס שלנו. הגדר את מפתח ה-API ושם המודל במפורש. העבר את ההודעות שלך כרשימה של מילונים עם מפתחות role ו-content. אובייקט התגובה מכיל את הטקסט שנוצר ב-choices[0].message.content. טפל בחריגות בעדינות כדי לתפוס שגיאות רשת או הגבלת קצב במהלך הביצוע.
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralbaseurl.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)
הגדרת SDK Node.js
אתחל את לקוח OpenAI עם כתובת ה-URL הבסיסית והמפתח. הגדר את מערך ההודעות עם תפקידי משתמש ועוזר. קרא ל-chat.completions.create עם המודל uncensored. התגובה מספקת את הטקסט שנוצר באפשרות הראשונה. השתמש בשיטה זו הן לקריאות סינכרוניות והן אסינכרוניות באפליקציות Node שלך.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mistralbaseurl.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 ל-true. ה-API שולף מקטעי נתונים כפי שהם נוצרים. כל מקטע מכיל טקסט חלקי שניתן לצרף למאגר. גישה זו מפחיתה את תחומת העיכוב בפלט ארוך. מעקב אחר שימוש במטבעות במקטע הסופי מאפשר מעקב מדויק אחר החיוב.
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)
מגבלות & חלון הקשר
חשבונך תומך בחלון הקשר של 100,000 טוקנים. מקס תפוקה הוא 16,000 טוקנים לבקשה. ניתן לשלוח 300 בקשות לדקה. רק 8 בקשות רצות במקבילות. בקשות עם גוף מעל 8MB ייכשלו. השתמש במגבלות אלו כדי לתכנן את לוגיקת האיטרציה שלך. שגיאות כמו 429 מציינות פגיעה במגבלת הקצב. דחיות לא צורכות אשראי.
שאלות נפוצות
מהי כתובת ה-base URL של ה-mistral עבור ה-API הזה?
השתמשו ב-HTTPS://api.mistralbaseurl.com/v1 ככתובת הבסיס שלכם. זה עובד עם כל SDK תואם OpenAI. הפנו את הלקוח שלכם לשם והגדירו את המודל ל-uncensored.
כיצד לטפל בשגיאות מגבלת קצב (429)?
אתה מקבל 429 כאשר עובר את 300 בקשות לדקה. מומלץ ליישם החזרה אקספוננציאלית בלקוח שלך. נסה שוב לאחר פרק הזמן שצוין בכותרת retry-after.
האם המודל ללא צנזורה תומך בזרימה (streaming)?
כן, הגדר stream ל-true בבקשה. ה-API שולח אירועים שנשלחו על ידי שרת עם פסי טוקנים. פענח חלקים אלה כדי לעדכן את הממשק שלך בזמן אמת ללא המתנה להשלמה מלאה.
קבלו את מפתח ה-API שלכם עכשיו
הירשם, קבל את המפתח שלך, עדכן את כתובת ה-URL הבסיסית. זהו הכל.