API Quickstart

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

ה-API משתמש באימות סטנדרטי תואם OpenAI. אתה מקבל מפתח API מיד לאחר ההרשמה עם Google או אימייל. השתמש במפתח זה ב- Authorization header לכל הבקשות. כתובת הבסיק קבועה ב https://api.mistralabliterated.com/v1. אין צורך בתצורה נוספת עבור נתיב הנקודה הקצה.

Copycurl https://api.mistralabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the first five prime numbers"}]
  }'

המפתח שלך מזהה את החשבון שלך ועוקב אחר השימוש. אם תאבד את המפתח שלך, צור מפתח חדש; הישן יהפוך ללא תקף.

POST /v1/chat/completions

Send messages to the model using the standard chat completion endpoint. The model ID is always uncensored. נקודת הקבלה הזו מטפלת באינטראקציות טקסט נכנס/יוצא ללא צורך במבני מטען מורכבים. ניתן לשלוח הודעות מערכת, משתמש ועוזר בבקשה אחת.

Copyfrom openai import OpenAI

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

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

GET /v1/models

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralabliterated.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 נגיש. היא מחזירה מיד עם זמן תגובה נמוך, מה שהופך אותה לאידיאלית לבדיקות בריאות. לא צורכים אשראי בבקשה זו.

זרימה & כלים

אפשרו זרימה על ידי הגדרת 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)

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

פרמטרים & מגבלות

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

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

שגיאות & תמחור

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

המחיר הוא $0.15 לכל מיליון אסימוני קלט ו-$0.50 לכל מיליון אסימוני פלט. האשראי לא פג תוקף, ואין דמי מנוי חודשיים. תוספות מתחילות ב-$20 עם בונוסים על סכומים גדולים יותר. החזרים אינם זמינים, אך תמיכה יכולה לתקן חיובים כפולים.