תיעוד ה-API של Mistral: התחלה מהירה ואינטגרציה

אימות: הגדרת הראש שלך

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

נקודת הקצה /v1/chat/completions

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

תגובות בזרם עם SSE

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

קריאת פונקציות ומצב JSON

מבנה את הפלט באמינות באמצעות הפרמטרים הנתמכים שלנו. הפעל מצב JSON על ידי הגדרת response_format אל {"type": "json_object"}. זה מכריח את המודל להחזיר JSON ללא גדרות Markdown. אתה יכול גם להגדיר סכמות פונקציה לשימוש בכלים. המודל יעקוב אחר המבנה שסופק בקפידה. זה שימושי לחילוץ נתונים אוטומטי או שרשרת API. השתמש ב tools פרמטר להגדרת פונקציות זמינות. המודל יכול לבחור איזו פונקציה לקרוא בהתאם ל-Prompt. יכולת זו חיונית לבניית זרימות עבודה של סוכנים (agentic workflows) ללא צורך בלוגיקת פיענוח נוספת.

פרמטרים: טמפרטורה, Top-p, ו-seeds

שלוץ באקראיות ובדטרמיניזם של הפלט שלך. התאם את ה- temperature לשנות יצירתיות. ערכים נמוכים מייצרים תגובות יותר ממוקדות. ערכים גבוהים מוסיפים יותר מגוון. השתמש ב- top_p לצמצם את בחירת המילים. זה עובד בשילוב עם הטמפרטורה כדי לשפר את איכות הפלט. הגדר את seed פרמטר לתוצאות ניתנות לשחזור. קלטים וזרעים זהים יניבו פלט זהה. זה קריטי לאבחון ולבדיקת השילוב שלך. ניתן גם להגדיר stop רצפים לעצירת ייצור בסימנים ספציפיים. פרמטרים אלו נותנים לך בקרה עדינה על התנהגות המודל.

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

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

cURL

Copycurl https://api.apimistral.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set temperature to 0.7 for code generation"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

זרימה

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)