تكامل البدء السريع لوثائق واجهة برمجة تطبيقات Mistral

المصادقة: ضبط الرأس الخاص بك

ابدأ بتوليد مفتاح من لوحة التحكم الخاصة بنا. العملية فورية ولا تتطلب التحقق من رقم الهاتف. تحتاج فقط إلى عنوان بريد إلكتروني أو حساب Google لإنشاء حساب. بعد التوليد، يظهر المفتاح على شاشتك على الفور. احفظه بأمان لأننا لا نخزن السلسلة الكاملة للاسترجاع. ستمرر هذه السلسلة في Authorization الرأس لكل طلب. يتحقق نظامنا من هذا التوكن مقابل رصيدك المدفوع مسبقاً قبل معالجة طلبك. إذا كان المفتاح غير صالح أو منتهي الصلاحية، ستتلقى خطأ 401. نسمح بمفتاح نشط واحد فقط لكل حساب لتبسيط الوصول. يستبدل المفتاح الجديد المفتاح القديم فوراً عند إنشاء الاستبدال.

نقطة نهاية /v1/chat/completions

أرسل الطلب الأول إلى عنوان URL الأساسي الخاص بنا باستخدام نقطة نهاية إكمال الدردشة القياسية. استبدل المفتاح الافتراضي ببيانات الاعتماد الفعلية الخاصة بك. معرف النموذج هو ببساطة uncensored. هذا النموذج مضبوط للإجابة دون رفضات المحتوى البالغ القانوني. يعالج المدخلات والمخرجات النصية بكفاءة. لا تحتاج إلى تكوين توجيه معقد أو اختيار إصدارات نموذج محددة. فقط وجه عميلك إلى عنوان URL الأساسي وأرسل الحمولة. تتولى خوادمنا الاستدلال وتعيد النص المولد. يضمن هذا النهج التوافق مع الأدوات والمكتبات الموجودة.

استجابات التدفق عبر أحداث الإرسال عبر الخادم (SSE)

تمكين التدفق لتلقي الرموز كما يتم إنشاؤها. يقلل هذا من زمن الاستجابة المُدرَك للمخرجات الطويلة. اضبط stream معامل إلى true في جسم الطلب. سيعيد الخادم سلسلة من أحداث سيرفر المرسلة. تحتوي كل حدث على جزء جزئي من الاستجابة. يمكنك معالجة هذه الرموز في الوقت الفعلي لواجهة دردشة. تتضمن القطعة النهائية إجمالي استخدام الرموز للطلب. يسمح لك ذلك بتتبع التكاليف بدقة أثناء تقدم المحادثة. التدفق مثالي للتطبيقات حيث يحسن التغذية الراجعة الفورية تجربة المستخدم.

استدعاء الوظائف ووضع JSON

هيكل مخرجاتك بشكل موثوق باستخدام المعلمات المدعومة لدينا. تمكين وضع JSON عن طريق تعيين response_format إلى {"type": "json_object"}. يفرض هذا على النموذج إرجاع JSON بدون علامات الاقتباس النصية (markdown fences). يمكنك أيضاً تعريف مخططات الوظائف لاستخدام الأدوات. سيتبع النموذج الهيكل المقدم بدقة. هذا مفيد لاستخراج البيانات الآلي أو تسلسل واجهات برمجة التطبيقات. استخدم tools معامل لتحديد الوظائف المتاحة. يمكن للنموذج اختيار الوظيفة التي يجب استدعاؤها بناءً على النص الأولي. هذه القدرة ضرورية لبناء سير عمل وكيلاَ دون حاجة إلى منطق تحليل إضافي.

المعلمات: درجة الحرارة وTop-p والبذلات

تحكّم في العشوائية والحتمية لمخرجاتك. اضبط temperature لتغيير الإبداع. تنتج القيم الأقل استجابات أكثر تركيزاً. تقدم القيم الأعلى تنوعاً أكبر. استخدم top_p لتقييد اختيار المفردات. يعمل هذا جنباً إلى جنب مع درجة الحرارة لتحسين جودة المخرجات. تعيين الـ seed المعامل لنتائج قابلة للتكرار. سيعطي المدخلات والبذور المتطابقة مخرجات متطابقة. هذا أمر حاسم لتصحيح الأخطاء واختبار التكامل الخاص بك. يمكنك أيضًا تعيين stop تسلسلات لإيقاف التوليد عند علامات محددة. تمنحك هذه المعلمات تحكماً دقيقاً في سلوك النموذج.

حدود، أخطاء، ونافذة السياق

راقب استخدامك مقابل حدودنا المحددة. تدعم نافذة السياق 100,000 رمز مميز مجتمعة. يسمح هذا بتحليل المستندات الموسعة أو المحادثات الطويلة. يمكن لكل طلب إخراج ما يصل إلى 16,000 رمز مميز. إذا لم تحدد max_tokens, يتجاوز الحد الافتراضي إلى 2,048. يُسمح لك بـ 300 طلب في الدقيقة لكل مفتاح. يمكن تشغيل ثمانية طلبات فقط بشكل متزامن لكل مفتاح. حجم جسم الطلب محدود بـ 8 ميجابايت. تشير الأخطاء مثل 402 إلى عدم كفاية الرصيد. تحدث حدود المعدل (429) إذا تجاوزت العتبة المحددة لكل دقيقة. لا تنتهي صلاحية الرصيد، لذا يمكنك إيقاف الاستخدام دون فقدان الأموال.

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"}]
  }'

Python

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)