מפתח API של Mistral: מדריך התחלה מהירה

דרישות מוקדמות: SDK וסביבה

התחל בהתקנת ה-SDK התואם ל-OpenAI המועדף עליך. אתה צריך רק מפתח API תקף ואת כתובת הבסיס של השירות שלנו.

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

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

הגדרת כתובת הבסיס

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

השתמשו ב-HTTPS://api.apikeymistral.com/v1 ככתובת הבסיס שלכם. זה מבטיח שכל הבקשות יועברו דרך השרתים בעלי התפוקה הגבוהה שלנו. אין צורך לשנות את נתיב הנקודה הקצה אם ה-SDK שלכם כבר מוגדר כברירת מחדל ל-/chat/completions.

שמרו על מפתח ה-API שלכם בזיכרון או בארון מאובטח. המפתח מאמת כל בקשה שאתם שולחים לכתובת URL זו.

ביצוע בקשת POST ראשונה

שלח בקשת השלמת צ'אט סטנדרטית כדי לקבל פלט טקסט. השתמש ב-ID של המודל "uncensored" כדי לגשת למודל המותאם שלנו.

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

להלן פקודת curl בסיסית לבדיקת חיבוריות:

Copycurl https://api.apikeymistral.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json object with keys name age"}]
  }'

ודא שהתגובה מכילה את הטקסט שנוצר. בדוק שקוד הסטטוס הוא 200 להצלחה.

אינטגרציה עם SDK ב-Python

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

התקשר לשיטת chat.completions.create עם ההנחיה שלך. אובייקט התגובה מכיל את הטקסט שנוצר ב-choices[0].message.content.

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

Copyfrom openai import OpenAI

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

גישה זו עובדת עם כל ספרייה התואמת ל-OpenAI. ניתן להשתמש בקוד הקיים עם שינויים מינימליים.

שילוב Node SDK

אתחל את לקוח Node.js עם כתובת הבסיס המותאמת אישית. העבר את מפתח ה-API שלך באובייקט התצורה.

הפעל את הפונקציה chat.completions.create עם הפרמטרים הרצויים לך. התגובה עוקבת אחר הפורמט הסטנדרטי של OpenAI.

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

Copyimport OpenAI from "openai";

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

תצורה זו מאפשרת לך לשלב הסקה לא-מסונסת באפליקציות Node שלך במהירות.

טיפול בתגובות זרם

אפשרו זרמת נתונים על ידי הגדרת stream=true בבקשה שלכם. ה-API מחזיר נתונים במקטעים כפי שהם נוצרים.

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

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

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)

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

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

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

פלט מקסימלי הוא 16,000 טוקנים לכל בקשה. הגדר max_tokens במפורש כדי להימנע מהגעה לברירת המחדל של 2,048.

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

טפל בשגיאות 401 על ידי בדיקת חוקיות המפתח. שגיאות 402 מציינות חוסר בקרדיט. שגיאות 429 אומרות שחצית את מגבלת הקצב.

בקשות העולות על מגבלת גודל הגוף של 8 MB ייכשלו. תכנן את העומס שלך בהתאם.