תיעוד API

אימות

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

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

שלח JSON ל POST /v1/chat/completions לקבל תגובות טקסט. זוהי נקודת הקצה היחידה ליצירת טקסט. היא אינה תומכת בהשמה (embeddings), תמונות או אודיו.

הגדר את model field to "uncensored". המודל ענה ללא סירובי תוכן לשימוש מבוגר חוקי. זהו מודל בעל משקל פתוח שהותאם לפלט ללא הגבלות. זה לא GPT, Claude או מודל של ספק אחר.

נקודת קצה למודלים

שיחה GET /v1/models לרשום מודלים זמינים. התגובה כוללת את uncensored מזהה המודל. השתמש בזה לאימות חיבוריות או לפתרון בעיות תצורה בלקוח שלך.

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

פרמטרים & אפשרויות

תומך בפרמטרים סטנדרטיים כמו temperature, top_p, stop, seed, presence_penalty, וכן frequency_penalty. הגדירו max_tokens לשליטה באורך הפלט. ברירת המחדל היא 2,048 טוקנים אם תשמיט שדה זה.

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

תגובות בסטרימינג

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

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

Tool Calling & JSON Mode

שימוש response_format עם {"type": "json_object"} לפלט JSON מחמיר. זה שימושי לניתוח נתונים מבניים מה-LLM. קריאת פונקציות עובדת עם הגדרות כלים סטנדרטיות.

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

cURL

Copycurl https://api.mistralaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the api limit for this service"}]
  }'

Python

Copyfrom openai import OpenAI

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