مستندات API Mistral: یکپارچه‌سازی شروع سریع

احراز هویت: تنظیم هدر شما

ابتدا یک کلید در داشبورد ما تولید کنید. این فرآیند فوری است و نیاز به احراز هویت شماره تلفن ندارد. شما فقط به یک آدرس ایمیل یا یک حساب گوگل برای ایجاد حساب نیاز دارید. پس از تولید، کلید بلافاصله روی صفحه شما ظاهر می‌شود. آن را به صورت امن ذخیره کنید زیرا ما رشته کامل را برای بازیابی ذخیره نمی‌کنیم. این رشته را در Authorization هدر برای هر درخواست. سیستم ما این توکن را با موجودی پیش‌پرداخت شما اعتبارسنجی می‌کند قبل از پردازش درخواست شما. اگر کلید نامعتبر یا منقضی شده باشد، خطای 401 دریافت خواهید کرد. ما فقط یک کلید فعال برای هر حساب مجاز می‌دانیم تا دسترسی ساده بماند. یک کلید جدید کلید قبلی را بلافاصله جایگزین می‌کند وقتی که جایگزین را تولید می‌کنید.

endpoint /v1/chat/completions

ارسان اولین درخواست به URL پایه خود با استفاده از endpoint استاندارد تکمیل چت. جایگزین کلید را با اعتبارات واقعی خود جایگزین کنید. شناسه مدل به سادگی uncensored. این مدل برای پاسخ‌دهی بدون رد محتوای بزرگسالان قانونی تنظیم شده است. ورودی و خروجی متن را به‌طور کارآمد مدیریت می‌کند. نیازی به پیکربندی مسیریابی پیچیده یا انتخاب نسخه‌های خاص مدل ندارید. فقط مشتری خود را به URL پایه ما متصل کنید و پیکربندی را ارسال کنید. سرورهای ما استنتاج را انجام داده و متن تولید شده را برمی‌گردانند. این رویکرد سازگاری با ابزارها و کتابخانه‌های موجود را تضمین می‌کند.

پاسخ‌های جریان‌دار با SSE

پخش زنده را فعال کنید تا توکن‌ها به محض تولید دریافت شوند. این کار تأخیر ادراک‌شده را برای خروجی‌های طولانی کاهش می‌دهد. مقدار stream پارامتر به true در بدنه درخواست. سرور سری‌ای از رویدادهای ارسال شده توسط سرور را برمی‌گرداند. هر رویداد شامل یک دلتای جزئی از پاسخ است. می‌توانید این توکن‌ها را برای یک رابط چت به صورت بلادرنگ پردازش کنید. قطک نهایی شامل کل استفاده از توکن برای درخواست است. این به شما امکان می‌دهد هزینه‌ها را به دقت در طول پیشرفت مکالمه ردیابی کنید. پخش زنده برای برنامه‌هایی ایده‌آل است که در آن‌ها بازخورد فوری تجربه کاربری را بهبود می‌بخشد.

فراخوانی تابع و حالت JSON

خروجی‌های خود را با استفاده از پارامترهای پشتیبانی‌شده ما به طور قابل اعتماد ساختار دهید. حالت JSON را با تنظیم response_format به {"type": "json_object"}. این موضوع مدل را مجبور می‌کند تا JSON معتبر بدون حصارهای مارک‌داون بازگرداند. همچنین می‌توانید طرح‌واره‌های تابع را برای استفاده ابزار تعریف کنید. مدل به شدت از ساختار ارائه‌شده پیروی می‌کند. این برای استخراج داده‌های خودکار یا زنجیره‌ای API مفید است. از tools پارامتری برای تعریف توابع موجود. مدل می‌تواند بر اساس پرامپت انتخاب کند که کدام تابع را فراخوانی کند. این قابلیت برای ساخت گردش‌های کاری عامل‌محور (Agentic) بدون منطق تجزیه اضافی ضروری است.

پارامترها: دما، Top-p و Seeds

تصادفی بودن و قطعی بودن خروجی‌های خود را کنترل کنید. تنظیم temperature به تغییر خلاقیت. مقادیر پایین‌تر پاسخ‌های متمرکزتری تولید می‌کنند. مقادیر بالاتر تنوع بیشتری ایجاد می‌کنند. استفاده top_p برای محدود کردن انتخاب واژگان. این گزینه همراه با دما برای بهبود کیفیت خروجی کار می‌کند. مقدار seed پارامتر را برای نتایج تکرارپذیر تنظیم کنید. ورودی‌ها و بذرهای یکسان، خروجی‌های یکسان تولید می‌کنند. این موضوع برای اشکال‌زدایی و تست یکپارچه‌سازی شما حیاتی است. همچنین می‌توانید stop sequences برای توقف تولید در نشانگرهای خاص. این پارامترها کنترل دقیقی بر رفتار مدل به شما می‌دهند.

Limits, errors, and context window

مصرف خود را در برابر محدودیت‌های تعریف‌شده پایش کنید. پنجره زمینه از ۱۰۰,۰۰۰ توکن ترکیبی پشتیبانی می‌کند. این موضوع امکان تحلیل اسناد گسترده یا مکالمات طولانی را فراهم می‌کند. هر درخواست می‌تواند تا ۱۶,۰۰۰ توکن خروجی داشته باشد. اگر مشخص نکنید max_tokens, حد پیش‌فرض ۲,۰۴۸ است. شما مجاز به ارسال ۳۰۰ درخواست در دقیقه به ازای هر کلید هستید. تنها هشت درخواست می‌تواند هم‌زمان برای هر کلید اجرا شود. حجم بدنه درخواست به ۸ مگابایت محدود است. خطاهایی مانند ۴۰۲ نشان‌دهنده اعتبار ناکافی است. محدودیت نرخ (۴۲۹) زمانی رخ می‌دهد که از آستانه در دقیقه تجاوز کنید. اعتبار هرگز منقضی نمی‌شود، بنابراین می‌توانید استفاده را متوقف کنید بدون اینکه از دست بروید.

cURL

Copycurl https://api.apimistral.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set temperature to 0.7 for code generation"}]
  }'

پایتون

Copyfrom openai import OpenAI

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