תיעוד ה-API של Mistral: מדריך התחלה מהירה

התקן את ה-SDK והגדר את כתובת הבסיס שלך

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

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

בצעו את הבקשה הראשונה למודל ללא צנזורה

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

Copycurl https://api.mistralapidoc.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models and their context windows"}]
  }'

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

אפשרו זרימה וניהול שימוש באסימונים

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

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)

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

השתמש ב-calling פונקציות ובמצב JSON

העבר מערך כלים כדי לאפשר קריאת פונקציות. המודל יפלט קריאות כלים מבניות כאשר מתאים. אתה יכול גם להטיל מצב JSON על ידי הגדרת response_format ל-json_object. זה מבטיח שהפלט הוא JSON תקף, מה שמפשט פיענוח ביישום שלך. שתי התכונות עובדות עם תחביר ה-SDK הסטנדרטי של OpenAI.

Copyimport OpenAI from "openai";

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

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

הגדר פרמטרים: טמפרטורה, top_p ו-seed

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

Copyfrom openai import OpenAI

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

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

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

ה-API שלנו תומך בחלון הקשר של 100,000 טוקנים. המקסימום לפלט בכל בקשה הוא 16,000 טוקנים, או 2,048 אם תשמיט את max_tokens. אתה מוגבל ל-300 בקשות לדקה ו-8 בקשות מקבילות למפתח. גוף הבקשה חייב להיות מתחת ל-8 MB. מגבלות אלו מבטיחות שימוש הוגן לכל הלקוחות בתשלום מראש.

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