دليل تكامل Mistral API
يستغرق نقل تكامل على طراز Mistral إلى عنوان URL الأساسي الجديد وقتاً أقل مما تتوقعه معظم الفرق. يغطي هذا الدليل تغيير عنوان URL الأساسي، ومعرف النموذج، والتدفق، والأدوات، وحدود الرموز المميزة، وإعادة المحاولة والأخطاء التي من المرجح أن تواجهها، مع رمز يمكنك تشغيله كما هو.
آخر تحديث
ملخص
- التغيير هو عنوان URL أساسي واحد ومفتاح واحد؛ يبقى تنسيق الطلب والاستجابة كما هو.
- استخدم معرف النموذج uncensored وتحقق منه بطلب اختبار واحد قبل تغيير أي شيء آخر.
- يعمل التدفق واستدعاء الوظائف عبر نقطة نهاية إكمال الدردشة نفسها، لذا تستمر المفسرات الموجودة في العمل.
- التكاليف هي $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج، تُخصم من الرصيد المدفوع مسبقاً.
فهم تغيير عنوان URL الأساسي
يرسل رمزك الطلبات إلى عنوان URL أساسي ويرفق مفتاحاً. للانتقال إلى نقطة نهاية متوافقة مع OpenAI أخرى، تقوم بتغيير هاتين القيمتين فقط دون أي تغييرات أخرى. المسار /v1/chat/completions يبقى كما هو، لذا تظل بنية جسم الطلب وبنية جسم الاستجابة كما هي.
احتفظ بعنوان URL الأساسي القديم في قيمة تكوين بدلاً من الكود. بهذه الطريقة يمكنك العودة إلى الخلف خطوة واحدة إذا ظهرت مشكلة في بيئة الإنتاج.
توافق SDK: عملاء OpenAI مقابل Mistral
تقبل معظم مكتبات العملاء عنوان URL أساسي مخصص. تقبل ذلك كل من SDK الرسمي لـ OpenAI وLangChain وLlamaIndex، كما يعمل العميل HTTP العادي أيضًا. اضبط عنوان URL الأساسي على https://mistralapibaseurl.com/v1 ونقل المفتاح الجديد.
- تحقق من إصدار SDK، لأن الإصدارات القديمة جداً تتجاهل إعداد عنوان URL الأساسي.
- تحقق من أن العميل يمرر المفتاح في
Authorizationقيمة التوكن كـ bearer token.
تكوين معرف النموذج
أرسل معرف النموذج uncensored. إنه النموذج الوحيد الذي تقدمه الخدمة، لذا فإن المعرف لا يتغير بين الطلبات ولا تحتاج إلى منطق اختيار النموذج.
قم بإرسال طلب واحد بنص قصير. الرد وكتلة الاستخدام تعني أن عنوان URL الأساسي والمفتاح ومعرف النموذج جميعها صحيحة.
تنفيذ استجابات التدفق
تعيين stream: true لتلقي الإجابة كأحداث Server-Sent. يحمل كل حدث قطعة صغيرة من النص، وتحمل الحدث الأخير أرقام الاستخدام.
اعرض القطع (chunks) عند وصولها واحتفظ بالنص الكامل في مخزن مؤقت (buffer)، بحيث يتم تخزين الرسالة بمجرد انتهاء التدفق. قس الوقت المستغرق للوصول إلى الرمز الأول؛ فهذا الرقم يوضح مدى استجابة الدردشة للمستخدم.
تمكين استدعاء الوظائف والأدوات
مرر مصفوفة الأدوات بنفس التنسيق الذي تستخدمه بالفعل. يُرجع النموذج استدعاء أداة مع اسم الدالة وحجج JSON. شغل الدالة في الكود الخاص بك، أرسل النتيجة مرة أخرى كرسالة أداة واقرأ الإجابة النهائية.
- عرّف أداة واحدة بحجتين مطلوبتين واختبرها بمفردها.
- اختبر حالة تتطلب استدعاء أداتين بالتتابع.
- التحقق من الحجج قبل تشغيل أي شيء يغير البيانات.
إدارة نوافذ السياق والتوكنات
نافذة السياق هي 100,000 رمز. تملأ المحادثات الطويلة النافذة، لذا قم بتقليص الدوران القديمة أو تلخيصها قبل الوصول إلى الحد. يمكن لكل طلب إرجاع ما يصل إلى 16,000 رمز إخراج، والافتراضي هو 2,048، لذا اضبط max_tokens للإجابات التي تتوقعها.
احسب الرموز من حقل الاستخدام في كل استجابة. تقديرات عدد الكلمات غالباً ما تكون بعيدة عن الدقة للكود والنصوص غير الإنجليزية.
معالجة حدود المعدل وإعادة المحاولة
يتيح كل مفتاح 300 طلب في الدقيقة و8 طلبات في نفس الوقت. عند تجاوز الحد، تحصل على استجابة 429. أعد المحاولة فقط لاستجابات 429 و5xx، مع زيادة الأثر الأسي وحد أقصى لوقت الانتظار الكلي.
لا تعيد المحاولة أبداً في حالة خطأ 400 أو 401، لأن الطلب نفسه سيفشل بنفس الطريقة مرة أخرى. أصلح الطلب أو المفتاح أولاً.
تصحيح أخطاء واجهة برمجة التطبيقات الشائعة
| الحالة | السبب المعتاد | ما الذي يجب فعله |
|---|---|---|
| 400 | JSON غير صالح أو حقل غير معروف | تحقق من جسم الطلب (Request Body) مقابل التنسيق الذي ترسله |
| 401 | مفتاح مفقود أو خطأ | انسخ المفتاح مرة أخرى وتحقق من رأس التفويض |
| 402 | الرصيد مستنفد | قم بإضافة الرصيد؛ تبدأ الإضافات من $20 |
| 429 | تم الوصول إلى حد معدل الطلبات | انسحب وحاول مرة أخرى لاحقًا |
سجّل رمز الحالة ومعرف الطلب لكل فشل، لتتبع المشكلة بسرعة.
الانتقال من واجهات برمجة التطبيقات للمنافسين
خطط للانتقال في ثلاث مراحل: بيئة اختبار، حصة صغيرة من حركة المرور المباشرة، ثم التبديل الكامل. احتفظ بكلا عناوين URL الأساسية في التكوين أثناء المرحلة الوسطى وقارن الإجابات وزمن الاستجابة على نفس الموجهات.
قارن التكلفة بناءً على استخدامك الفعلي، وليس الأسعار المعلنة. اضرب توكنات الإدخال والإخراج من حقل الاستخدام في $0.15 و $0.50 لكل مليون توكن، وقارن ذلك بفاتورتك الحالية.
الأسئلة الشائعة
هل أحتاج إلى تغيير تنسيق الطلب؟
لا. يتبع نقطة النهاية تنسيق إكمالات الدردشة، لذا تعمل هياكل الرسائل والأدوات نفسها. يتغير فقط عنوان URL الأساسي والمفتاح.
أي معرف نموذج يجب أن أستخدمه؟
استخدم غير الخاضع للرقابة. إنه النموذج الوحيد في الخدمة، لذا يبقى المعرف نفسه في كل طلب.
كيف يمكنني الحصول على مفتاح للاختبار؟
سجّل باستخدام Google أو بريدك الإلكتروني. يظهر المفتاح على الشاشة، ويبدأ الحساب برصيد تجريبي بقيمة $0.50 صالح لمدة 7 أيام. لا يلزم بطاقة.
كيف أدفع مقابل الاستخدام؟
أضف رصيدًا باستخدام USDT على TRC20 أو USDC على Base، بدءًا من $20. ينطبق رصيد المكافأة من $50، ولا ينتهي الرصيد.
الوصول إلى مفتاحك
سجّل، احصل على مفتاحك، وحدّث عنوان URL الأساسي. هذه هي العملية الكاملة.
