آخر تحديث
دليل تكامل Mistral API
يمكنك استبدال واجهة برمجة تطبيقات Mistral القياسية ببديلنا غير الخاضع للرقبة من خلال تحديث عنوان URL الأساسي ومفتاح واجهة برمجة التطبيقات فقط. يشرح هذا الدليل كيفية ترحيل الكود المتوافق مع OpenAI الحالي لتشغيل النموذج غير الخاضع للرقبة دون تغيير المنطق الخاص بك.
لماذا تستبدل واجهة Mistral القياسية؟
يصطدم المطورون غالبًا بمرشحات المحتوى التي تعطل سير عملهم. ترفض APIs القياسية مواضيع محددة. نموذجنا غير الخاضع للرقابة يجيب مباشرة. تحتفظ بالتحكم الكامل في مخرجاتك.
واجهة برمجة التطبيقات القياسية لـ Mistral موثوقة. فهي تقدم نماذج شائعة. ومع ذلك، تطبق طبقات الرقابة الخاصة بها. قد ترى رفضات للكتابة الإبداعية أو المواضيع البالغة. تزيل واجهة برمجة التطبيقات لدينا هذه الحواجز. إنها تشغل نموذج مفتوح المصدر مُعدد لقيود أقل. تحصل على نفس نقطة نهاية التوافق مع OpenAI.
التكلفة عامل آخر. غالباً ما تعلقك الخطط القياسية في الاشتراكات. نستخدم نظام رصيد مدفوع مسبقاً. تدفع فقط مقابل ما تستخدمه. الأخطاء لا تكلفك توكنات. هذه الشفافية تساعدك على الميزانية بدقة.
الانتقال سهل جداً. الكود الخاص بك يعمل. أنت تغير فقط عنوان URL الأساسي. لا حاجة لإعادة الكتابة المعقدة. هذه المرونة تناسب المطورين الذين يريدون توليداً غير مقيد دون إدارة النماذج المحلية.
الخطوة 1: الحصول على مفتاح API الخاص بك
ابدأ بإنشاء حساب على منصتنا. يمكنك تسجيل الدخول باستخدام Google أو استخدام بريد إلكتروني وكلمة مرور. لا يلزم رقم هاتف. هذا يبقي هويتك خاصة.
بمجرد تسجيل الدخول، انتقل إلى لوحة التحكم. أنشئ مفتاح API الخاص بك على الفور. يظهر المفتاح مرة واحدة فقط. انسخه واحفظه بأمان. ستحتاجه في كل طلب.
تتلقى رصيد تجربة تلقائيًا. تحصل الحسابات الجديدة على 0.50 دولار صالحة لمدة 7 أيام. يتيح لك ذلك اختبار التكامل قبل الالتزام بالأموال.
لديك حدود محددة. يمكنك إجراء 300 طلب في الدقيقة. يعمل ثمانية طلبات فقط في وقت واحد. كل مفتاح فريد لحسابك. إذا قمت بتوليد مفتاح جديد، سيتوقف المفتاح القديم عن العمل. يضمن ذلك وصولاً آمناً إلى أرصدةك.
الخطوة 2: تكوين عنوان URL الأساسي الخاص بك
يُعد عنوان URL الأساسي التغيير الأكثر أهمية. وجه مكتبة SDK الخاصة بك إلى نقطة النهاية الخاصة بنا. استخدم التنسيق القياسي لـ OpenAI. يضمن ذلك التوافق مع المكتبات الموجودة لديك.
قم بتعيين عنوان URL الأساسي إلى HTTPS://api.mistralbaseurl.com/v1. يعكس هذا المسار هيكل مزودي الخدمات الكبار. سيتعرف الكود الخاص بك على نقاط النهاية بشكل صحيح. لا تحتاج إلى برامج تشغيل أو عملاء جدد.
تحديث متغير مفتاح API في الكود الخاص بك. استبدل مفتاح المزود القديم بالجديد. تأكد من صحة سلسلة المفتاح. تسبب الأخطاء المطبعية أخطاء مصادقة فورية.
اختبر الاتصال بنقرة بسيطة. اطلب قائمة النماذج المتاحة. يجب أن ترى نموذجنا غير المقيد مدرجًا. يؤكد ذلك أن تكوينك صحيح. أنت الآن جاهز لإرسال النصوص.
الخطوة 3: تنفيذ إكمال الدردشة
أرسل طلب POST إلى نقطة نهاية إكمال الدردشة. استخدم معرف النموذج "uncensored". هذا يُشغّل نموذج اللغة الكبير المحدد لدينا. يعالج مدخلاتك ويولد النص.
هيكل رسائلك كمصفوفة. قم بتضمين أدوار النظام والمستخدم والمساعد. يتبع النموذج هذه التعليمات عن كثب. يمكنك تعيين معلمات مثل temperature و top_p. هذه تتحكم في إبداع المخرجات.
نافذة السياق هي 100,000 رمز. هذا يسمح بوثائق طويلة. يمكنك تمرير سياق واسع في طلب واحد. يحافظ النموذج على الاتساق عبر التسلسلات الطويلة. هذا مفيد لتحليل الكود أو التلخيص.
الحد الأقصى للإخراج هو 16,000 رمز مميز. إذا لم تقم بتعيين max_tokens، فإن الحد هو 2,048. اضبط هذا المعلمة بناءً على احتياجاتك. تتطلب الردود الأطول رصيدًا أكثر. خطط لميزانية الرموز الخاصة بك وفقًا لذلك.
معالجة التدفق والرموز
يحسّن البثّ تجربة المستخدم. يرسل الرموز المميزة بمجرد توليدها. يقلل هذا من زمن الاستجابة المُدرَك. فعّل البثّ في إعدادات SDK الخاصة بك.
نستخدم أحداث Server-Sent Events (SSE). يوفر البث شرائح من النص. تحتوي كل شريحة على جزء من الرد. يمكنك عرض الرموز في الوقت الفعلي.
يتم الإبلاغ عن استهلاك الرمز في الشريحة الأخيرة. يضمن ذلك دقة الفوترة. ترى بالضبط ما تم استهلاكه. الأخطاء لا تكلفك. الرفض مجاني. يحمي هذا ميزانيتك من الطلبات المهدرة.
راقب رصيدك من العملات المشفرة بانتظام. يمكنك الشحن عبر العملات المشفرة في أي وقت. الرصيد لا ينتهي. يتيح لك ذلك إيقاف الاستخدام دون عقوبة. تحتفظ برصيدك إلى الأبد.
استدعاء الوظائف ووضع JSON
تدعم واجهة برمجة التطبيقات الخاصة بنا المخرجات المنظمة. يمكنك فرض وضع JSON. اضبط response_format على json_object. يعيد النموذج JSON صالحًا فقط. هذا حاسم للتكاملات.
يعمل استدعاء الوظائف بسلاسة. عرّف أدواتك في الطلب. يحدد النموذج الأداة المناسبة. يمرر الحجوزات بشكل صحيح. يمكنك تحليل النتيجة في شيفرتك.
عيّن tool_choice إلى auto أو محدد. هذا يمنحك التحكم في السلوك. يعطي النموذج الأولوية لاستخدام الأدوات عند الحاجة. هذا يعزز الموثوقية في سير العمل المعقد.
استخدم هذه الميزات لاستخراج البيانات. قم بأتمتة النماذج أو استدعاءات واجهة برمجة التطبيقات. يتعامل النموذج غير الخاضع للرقابة مع الحالات الحدية بشكل جيد. لا يرفض الاستعلامات المعقدة. هذا يجعله مناسباً لمهام الإنتاج.
الأخطاء الشائعة: شرح أخطاء 404 و 422
تشير الأخطاء عادةً إلى مشكلات في التكوين. خطأ 404 Not Found شائع. يعني ذلك أن الرابط غير صحيح. تحقق من عنوان URL الأساسي الخاص بك بعناية. تأكد من تضمين /v1 في المسار.
يحدث خطأ 422 Unprocessable Entity. يحدث هذا غالباً مع JSON غير صالح. تحقق من بنية جسم الطلب. تأكد من وجود جميع الحقول المطلوبة. تحقق من صحة معرف النموذج.
تعيد حدود المعدل أخطاء 429. تجاوزت 300 طلب في الدقيقة. انتظر لفترة وجيزة قبل إعادة المحاولة. نفذ التراجع الأسي في الكود الخاص بك. يمنع ذلك إجهاد واجهة برمجة التطبيقات.
تحقق من صحة مفتاح واجهتك البرمجية. تأكد من عدم انتهائه. يتم استبدال المفاتيح تلقائياً إذا تم إعادة توليدها. استخدم المفتاح الصحيح لكل طلب. يقلل هذا من وقت التوقف.
مقارنة التكلفة: Mistral مقابل واجهة برمجة غير الخاضعة للرقابة لدينا
أسعارنا بسيطة. تدفع 0.15 دولار لكل مليون رمز مدخل. تكلفة الرموز المخرجة 0.50 دولار لكل مليون. هذا شفاف وقابل للتنبؤ.
غالباً ما تتقاضى واجهات برمجة التطبيقات (API) القياسية المزيد. تتضمن رسوم المنصة. يعمل نموذجنا على خوادمنا. تدفع مقابل الحوسبة مباشرة. هذا يخفض التكلفة الأساسية.
الأخطاء مجانية. لا تدفع مقابل الطلبات الفاشلة. يوفر هذا المال في تصحيح الأخطاء. تدفع فقط للمخرجات الصالحة.
تبدأ الشحنات من $20. تدفع بالعملة الرقمية. تتوفر رصيد إضافي. أضف $50 للحصول على 5% إضافية. أضف $100 للحصول على 10% إضافية. أضف $200 للحصول على 15% إضافية. هذا يكافئ الاستخدام الأعلى.
قائمة التحقق النهائية للهجرة السلسة
تحقق من صحة عنوان URL الأساسي. قم بتحديث مفتاح API الخاص بك في البيئة. اختبره بمطالبة بسيطة. تأكد من أن البث يعمل إذا لزم الأمر.
تحقق من معالجة حد المعدل الخاص بك. نفذ عمليات إعادة المحاولة لأخطاء 429. راقب استخدام الرموز. عدل max_tokens حسب الحاجة.
تفعيل وضع JSON للبيانات المهيكلة. اختبر استدعاء الوظائف مع أدواتك. تأكد من استجابة النموذج بشكل صحيح. تحقق من مطابقة تنسيق المخرجات لتوقعاتك.
خصص معلماتك. اضبط درجة الحرارة للإبداع. استخدم top_p للتنوع. تؤثر هذه الإعدادات على جودة المخرجات. جرب للوصول إلى أفضل توازن. يجب أن يبقى الكود الخاص بك دون تغيير باستثناء عنوان URL والمفتاح.
