البدء السريع لمستخدمي Mistral

عنوان URL الأساسي والمصادقة

واجهة برمجة التطبيقات الخاصة بنا متوافقة تماماً مع مكتبات OpenAI. تحتاج فقط إلى تحديث عنوان URL الأساسي وتقديم مفتاح API الخاص بك. عنوان URL الأساسي لهذه الخدمة هو https://api.mistralapi.com/v1. تتم المصادقة عبر رأس Authorization باستخدام رمز Bearer. على عكس بعض المزودين، لا نطلب توجيهًا معقداً أو رؤوس خاصة بالبائع؛ فقط مرر مفتاحك كما تفعل عادةً.

• عنوان URL الأساسي: https://api.mistralapi.com/v1
• الرأس: Authorization: Bearer YOUR_API_KEY

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

نقطة النهاية لإكمال المحادثة

جوهر واجهة برمجة التطبيقات هو نقطة النهاية POST /v1/chat/completions. تقبل قائمة بالرسائل وتعيد استجابة مولدة. تدعم هذه النقطة تنسيق الرسائل القياسي المستخدم من قبل معظم عملاء LLM. يجب أن تحدد معرف النموذج كـ "uncensored". هذا النموذج هو نموذج لغة كبير مفتوح الأوزان مستضاف على خوادمنا، ومضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين.

• نقطة النهاية: POST /v1/chat/completions
• معرف النموذج: uncensored

تعيد واجهة برمجة التطبيقات استجابات نصية فقط. لا تدعم الصور أو الصوت أو الفيديو أو التضمينات. لمعظم المطورين، تحل هذه النقطة محل نقطة نهاية المحادثة القياسية في OpenAI بدون تغييرات في الكود سوى عنوان URL الأساسي ومعرف النموذج.

تكامل SDK لـ Python

استخدام مكتبة Python الرسمية لـ OpenAI هو أسرع طريقة للتكامل. اضبط عنوان URL الأساسي على نقطة النهاية الخاصة بنا وقدم مفتاح API الخاص بك. يوضح الكود أدناه طلب إكمال نصي بسيط.

• قم بتثبيت المكتبة: pip install openai
• اضبط base_url على https://api.mistralapi.com/v1
• استخدم model="uncensored"

يعمل هذا النهج لأن واجهة برمجة التطبيقات الخاصة بنا تعكس هيكل استجابة OpenAI. يمكنك استخدام المكتبات الموجودة للبث المتدفق، استدعاء الدوال، ووضع JSON بدون تعديل.

تكامل SDK لـ Node.js

لمطوري JavaScript/TypeScript، تعمل حزمة npm openai بسلاسة. قم بتكوين العميل بعنوان URL الأساسي الخاص بنا ومفتاح API الخاص بك. هذا يسمح لك باستخدام نفس قاعدة الشفرة لكل من OpenAI والنموذج الخاص بنا بدون رقابة.

• قم بتثبيت المكتبة: npm install openai
• قم بتكوين baseUrl إلى https://api.mistralapi.com/v1
• حدد model: "uncensored"

يمتد هذا التوافق إلى جميع المعلمات القياسية مثل temperature، top_p، وتسلسلات stop. يمكنك التبديل بين المزودين بسهولة عن طريق تغيير تكوين العميل.

استجابات البث المتدفق

ندعم استجابات البث المتدفق عبر أحداث الموجه من الخادم (SSE). هذا يسمح لك باستلام الرموز بمجرد توليدها، مما يقلل من زمن الاستجابة المدرك للمستخدمين. الشريحة الأخيرة من البث تتضمن إحصائيات استخدام الرموز للفواتير.

• اضبط stream: true في طلبك
• اقرأ الشرائح من الاستجابة
• قم بتحليل الشريحة الأخيرة لبيانات الاستخدام

البث المتدفق مثالي لواجهات الدردشة والتطبيقات في الوقت الفعلي. تنسيق الاستجابة يطابق معيار البث المتدفق في OpenAI، لذا فإن منطق البث المتدفق الحالي سيعمل بدون تغييرات.

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

لدينا حدود محددة لضمان الاستقرار. يدعم كل مفتاح API 300 طلب في الدقيقة و8 طلبات متزامنة. الحد الأقصى لحجم جسم الطلب هو 8 MB. نافذة السياق هي 100,000 رمز إجمالاً (الموجّه + الإكمال). إذا لم تضبط max_tokens، فإن الإخراج الافتراضي هو 2,048 رمز؛ وإلا، فإن الحد الأقصى للإخراج هو 32,000 رمز.

• 401: مفتاح API غير صالح
• 402: رصيد غير كافٍ
• 429: تجاوز حد المعدل

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

cURL

نسخcurl https://api.mistralapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

نسخfrom openai import OpenAI

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

نسخimport OpenAI from "openai";

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

البث المتدفق

نسخstream = 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)