API של Mistral AI - מדריך התחלה מהירה

כתובת URL בסיסית ואימות

השלב הראשון הוא הגדרת הלקוח שלך להפנות לתשתית שלנו. החלף את כתובת ה-URL הבסיסית הסטנדרטית של OpenAI ב-HTTPS://api.apimistralai.com/v1 והכנס את מפתח ה-API הייחודי שלך לכותרת ההרשאה. החלפה פשוטה זו מפנה את כל הבקשות למודל ללא צנזורה שלנו תוך שמירה על לוגיקת השילוב הקיימת שלך.

• כתובת URL בסיסית: HTTPS://api.apimistralai.com/v1
• אימות: אסימון Bearer דרך ה- Authorization כותרת

ודאו שהמפתח שלכם פעיל בלוח הבקרה של החשבון שלכם לפני בדיקת חיבורים.

בקשה ראשונה

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

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

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

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

אינטגרציית SDK Python

השתמשו בספריית הפיתון הרשמית של OpenAI כדי לפעול מול ה-API שלנו ללא שינוי מבנה הבקשה המרכזי. אתחלו את הלקוח עם כתובת הבסיס החדשה ואת מפתח ה-API שלכם, ואז קראו chat.completions.create.

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apimistralai.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 סטנדרטיות, מה שהופך את המעבר לקל עבור מפתחי Python.

שילוב Node SDK

לסביבות JavaScript או TypeScript, אתחל את החבילה OpenAI עם ה-base URL המותאם אישית. הגדר את apiKey וגם baseURL תכונות לפני קריאה chat.completions.create.

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

Copyimport OpenAI from "openai";

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

מבנה התגובה נשאר עקבי עם סטנדרטים של OpenAI, ומאפשר שילוב קל בתהליכי העבודה הקיימים של Node.js.

תגובות בסטרימינג באמצעות SSE

אפשרו יצירת אסימונים בזמן אמת על ידי הגדרת stream: true בבקשה שלך. ה-API מחזיר זרם אירועים שנשלחו על ידי השרת (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)

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

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

נטר את השימוש שלך מול מגבלות קצב קפדיות וטפל בשגיאות HTTP נפוצות בצורה הגיונית. מותר לך 300 בקשות לדקה ו-8 בקשות מקבילות לכל מפתח.

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

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