MiniMax api: Quickstart and SDK Guide

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

השתמשו במפת ה-API שסופקו והפנו את הלקוח שלכם לכתובת ה-URL הבסיסית הייעודית. נקודת הקצה ליצירת תגובות היא https://api.minimaxaiapi.com/v1/chat/completions. אתה מעביר את המפתח ב- Authorization header כערך bearer token. זה עובד עם כל SDK סטנדרטי של OpenAI מכיוון שאנו עוקבים אחר אותו פרוטוקול.

• שם הכותרת: Authorization
• ערך הכותרת: Bearer YOUR_API_KEY
• כתובת בסיס: https://api.minimaxaiapi.com/v1

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

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

נקודת קצה להשלמות צ'אט

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

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

Copyfrom openai import OpenAI

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

שימוש בטוקנים וסטרימינג

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

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

Copyimport OpenAI from "openai";

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

פקודות פונקציה ומצב JSON

השתמשו ב tools פרמטר לאפשר קריאת פונקציות. הגדר את הפונקציות שלך בגוף הבקשה ותן למודל לבחור איזו לקרוא. ה tool_choice פרמטר מאפשר לך לאלץ פונקציה ספציפית או בחירה אוטומטית. עבור פלט JSON קפדני, הגדר response_format אל {"type": "json_object"}. זה מבטיץ שהתגובה היא JSON תקין.

Function calling שימושי לחילוץ נתונים מובנים או הפעלת פעולות. מצב JSON מושלם לאינטגרציות 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)

פרמטרי מודל ומגבלות

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

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

מגבלות קצב ושגיאות

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

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