كيفية استخدام واجهة برمجة التطبيقات لموديل مسترال (دليل خطوة بخطوة)

أصبحت Mistral AI بسرعة ذات سمعة جيدة بنماذجها اللغوية عالية الأداء. سواء كنت تبحث عن بناء دردشة آلية، أو توليد نص إبداعي، أو تحليل البيانات، أو كتابة الشفرة، أو تضمين نص بحث دلالي، فإن واجهة برمجة التطبيقات (API) من Mistral توفر الأدوات التي تحتاجها. لكن مثل أي أداة قوية، هناك بوابة: مفتاح واجهة برمجة التطبيقات.

فكر في مفتاح واجهة برمجة التطبيقات كمفتاح سري أو معرف فريد. إنه يخبر Mistral، "مرحبًا، أنا هنا! لدي إذن لاستخدام خدماتك." بدونها، لن تعرف خوادم واجهة برمجة التطبيقات من يقوم بعمل الطلب أو ما إذا كانت هذه الطلبات مصرح بها.

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

الوقت المتوقع: قد يستغرق القراءة والمتابعة من 30 إلى 45 دقيقة.
المتطلبات: فهم أساسي لما هي واجهة برمجة التطبيقات مفيد، لكن ليس شرطًا صارمًا. سنشرح المفاهيم أثناء التقدم. ستحتاج أيضًا إلى اتصال بالإنترنت ومتصفح ويب.

هل أنت جاهز؟ دعنا نحصل على مفتاح واجهة برمجة التطبيقات!

💡

هل تريد أداة اختبار واجهة برمجة التطبيقات رائعة تقوم بتوليد وثائق واجهة برمجة التطبيقات الجميلة?

هل ترغب في منصة متكاملة لكل شيء في واحد لفريق المطورين لديك للعمل مع أقصى إنتاجية؟

APidog يلبي جميع احتياجاتك، ويعوض Postman بسعر أكثر قابلية للتحمل بكثير!

زر

الخطوة 1: إعداد حسابك على Mistral AI

أول شيء أولاً، تحتاج إلى حساب على منصة Mistral المعروفة باسم "La Plateforme".

انتقل إلى وحدة التحكم: افتح متصفح الويب الخاص بك وانتقل إلى console.mistral.ai.
التسجيل أو تسجيل الدخول:

إذا كنت جديدًا، انقر على خيار التسجيل. قد تحتاج إلى تقديم عنوان بريد إلكتروني وإنشاء كلمة مرور، أو يمكنك التسجيل باستخدام حساب Google أو GitHub قائم. اتبع التعليمات على الشاشة، التي قد تتضمن التحقق من عنوان بريدك الإلكتروني.
إذا كان لديك حساب بالفعل، ما عليك سوى تسجيل الدخول باستخدام بيانات الاعتماد الخاصة بك.

3. معلومات الفوترة (مهم!): هذه خطوة حاسمة غالبًا ما تُعرقل الناس. لاستخدام واجهة برمجة التطبيقات فعليًا (حتى إذا كنت تخطط لاستخدام نماذج النطاق المجاني في البداية، فإن النظام الأساسي غالبًا ما يتطلب تفاصيل الفوترة لتنشيط المفاتيح)، تحتاج إلى إعداد الفوترة.

بمجرد تسجيل الدخول، ابحث عن قسم عادة ما يسمى "Workspace" أو اسم حسابك في الشريط الجانبي أو قائمة التنقل.
داخل هذا القسم، ابحث عن "الفوترة".
انقر عليه واتبع التعليمات لإضافة معلومات الدفع الخاصة بك (عادةً بطاقة ائتمان). لا تقلق، عادة ما يتم تحصيل الرسوم فقط مقابل ما تستخدمه، والعديد من النماذج قد تحتوي على مستويات مجانية أو ائتمانات أولية، لكن تنشيط المدفوعات غالبًا ما يكون ضروريًا لتفعيل مفاتيح واجهة برمجة التطبيقات للاستخدام العام. تحتوي صفحة تسعير Mistral (التي سيتم ربطها لاحقًا) على التفاصيل.
تأكد من أن المدفوعات الخاصة بك مدرجة على أنها "نشطة" أو "مفعلة". قد يستغرق الأمر بضع لحظات بعد إضافة التفاصيل لتحديث الحالة.

لديك الآن حساب Mistral AI جاهز للاستخدام! الخطوة التالية هي إنشاء المفتاح المهم جداً.

الخطوة 2: توليد مفتاح واجهة برمجة التطبيقات السري الخاص بك

مع إعداد حسابك وتنشيط الفوترة، دعنا ننشئ المفتاح نفسه.

انتقل إلى مفاتيح واجهة برمجة التطبيقات: أثناء تسجيل الدخول إلى وحدة تحكم Mistral (console.mistral.ai)، ابحث عن قسم يسمى "مفاتيح واجهة برمجة التطبيقات" في الشريط الجانبي أو قائمة التنقل. انقر فوقه.
إنشاء مفتاح جديد: يجب أن ترى زرًا مثل "إنشاء مفتاح جديد" أو "+ مفتاح جديد". انقر عليه.
سمِّ مفتاحك (اختياري ولكنه مُوصى به): قد يتم مطالبتك بإعطاء مفتاحك اسمًا. سيكون هذا مفيد جدًا لتنظيم المفاتيح، خاصة إذا كنت تخطط لإنشاء مفاتيح متعددة لاحقًا (مثل واحد لمشروع "دردشتي الآلية"، وآخر لبرنامج "تحليل البيانات"). اختر اسمًا وصفياً.
توليد ونسخ مفتاحك: انقر على زر التأكيد النهائي (مثل "إنشاء"، "توليد"). ستقوم Mistral الآن بإنشاء مفتاح واجهة برمجة التطبيقات الفريد لك. سيبدو مثل سلسلة طويلة من الحروف العشوائية، شيء مثل sk-aBcDeFgHiJkLmNoPqRsTuVwXyZ1234567890.......
!!! خطوة حاسمة: احفظ مفتاحك بأمان !!!

ستعرض Mistral لك هذا المفتاح مرة واحدة فقط. إذا قمت بإغلاق النافذة أو انتقلت بعيدًا دون نسخه، فلن تراه أبدًا مرة أخرى. سيتعين عليك إنشاء مفتاح جديد.
انسخ المفتاح على الفور. انقر على أيقونة النسخ أو حدد يدويًا وانسخ السلسلة بالكامل.
احتفظ به بأمان. استخدم مدير كلمات مرور (مثل 1Password أو Bitwarden أو Dashlane) أو تطبيق ملاحظات آمن. لا تقم بحفظه في ملف نصي عادي على سطح المكتب الخاص بك، أو إرساله إلى نفسك عبر البريد الإلكتروني غير المضمون، أو تضمينه مباشرة في الشفرة الخاصة بك (المزيد عن ذلك لاحقًا). تعامل مع هذا المفتاح مثل كلمة مرور لحسابك البنكي – أي شخص لديه هذا المفتاح يمكنه إجراء مكالمات واجهة برمجة التطبيقات على حسابك.
لا تشاركه. بجدية.

لقد فعلت ذلك! لديك الآن مفتاح واجهة برمجة التطبيقات لـ Mistral AI. احتفظ به بأمان ودعنا نكتشف كيفية استخدامه.

الخطوة 3: فهم مشهد نماذج Mistral

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

يمكنك العثور على نظرة عامة مفصلة عن النماذج هنا: نظرة عامة على نماذج Mistral

إليك ملخص سريع بأنواع النماذج التي ستواجهها:

النماذج الرئيسية: هذه هي أفضل نماذج Mistral أداءً، وغالبًا ما تتطلب الدفع.

Mistral Large: نموذجهم الرائد، مصمم لمهام التفكير المعقدة. لديها نافذة سياق كبيرة (يمكنها التعامل مع الكثير من النصوص) وأداء قوي عبر معايير متعددة.
Codestral: نماذج متخصصة تم ضبطها لتوليد الشفرات وإكمالها وشرحها. ممتازة للمطورين.
Pixtral Large: نموذج قوي متعدد الوسائط قادر على فهم النصوص والصور.
Mistral Embed: نموذج فعال للغاية مصمم خصيصًا لإنشاء تمثيلات عددية (تمثيلات) للنصوص لمهام مثل البحث الدلالي، التجميع، والتصنيف.
Mistral Moderation: أداة لكشف المحتوى الضار أو غير المرغوب فيه في النصوص.
Mistral OCR: خدمة لاستخراج النصوص المدمجة مع الصور من المستندات.
نماذج متخصصة مثل Mistral Saba (لللغات الشرق الأوسط/الجنوب آسيوية) أو Ministral (نماذج حافة فعالة).

نماذج مجانية (غالبًا مع أوزان مفتوحة): قد تحتوي هذه النماذج على أوزان متاحة بموجب تراخيص مرنة (مثل Apache 2.0)، مما يعني أن مجتمع الذكاء الاصطناعي يمكن أن يدرسها ويبني عليها. وغالبًا ما تكون متاحة عبر واجهة برمجة التطبيقات أيضًا، أحيانًا بمستويات مجانية أكثر سخاءً أو تكاليف أقل.

Mistral Small: نموذج أصغر عالي القدرة، يوازن بين الأداء والفعالية. غالبًا ما يكون نقطة انطلاق رائعة.
النماذج القديمة مثل Mistral 7B أو Mixtral 8x7B قد لا زالت مدرجة ولكن قد تكون transitioning إلى وضعية الإرث (انظر أدناه).

النسخة وتاج latest:

ستلاحظ أن النماذج غالبًا ما تحتوي على أسماء مثل mistral-large-latest أو mistral-large-2411.

*-latest: يشير هذا التاج دائمًا إلى أحدث إصدار مستقر من هذا النموذج (على سبيل المثال، mistral-large-latest يشير حاليًا إلى mistral-large-2411). استخدام latest يجعل الأمور مريحة للحصول على أحدث الميزات، لكن كن على علم بأن النموذج الأساسي يمكن أن يتغير، مما قد يغير سلوك أو مخرجات النموذج قليلًا على مر الوقت.
*-YYYYMM (على سبيل المثال، mistral-large-2411): تشير هذه إلى إصدار معين ومؤرخ من النموذج (صدر في نوفمبر 2024 في هذا المثال). استخدام إصدار مؤرخ يضمن الاتساق. سيصل تطبيقك دائمًا إلى نفس إصدار النموذج بالضبط، وهو أمر بالغ الأهمية في بيئات الإنتاج حيث يكون السلوك القابل للتنبؤ أمرًا حيويًا.

التوصية: للتطوير والاستطلاع، latest جيدة. للتطبيقات الإنتاجية، افكر بشدة في استخدام إصدار مؤرخ للحفاظ على الاستقرار.

توقف النموذج:

الذكاء الاصطناعي يتحرك بسرعة! تواصل Mistral إصدار نماذج جديدة وأفضل. كجزء من هذه الدورة، يتم في النهاية إيقاف النماذج القديمة وإحضارها. تتضمن صفحة نظرة عامة على النماذج قسمًا حول النماذج القديمة، يوضح تواريخ الإيقاف والتقاعد الخاصة بها. تحقق من هذا دائمًا إذا كنت تعتمد على نموذج قديم، وخطط لهجرتك إلى البدائل الجديدة مسبقًا.

اختيار نموذج:

المهمة: ماذا تحتاج لتفعله؟ (دردشة، كود، تمثيلات، تحليل الصور؟)
الصعوبة: ما مدى صعوبة المهمة؟ (سؤال وجواب بسيط مقابل تفكير دقيق؟)
التكلفة: تحقق من صفحة التسعير! عادةً ما تكلف النماذج الأكبر أكثر.
السرعة: النماذج الأصغر عادةً ما تكون أسرع.

ابدأ بنموذج أصغر وأرخص (مثل mistral-small-latest) وانظر ما إذا كان يلبي احتياجاتك. إذا لم يكن الأمر كذلك، قم بالترقية إلى نماذج أكبر أو أكثر تخصصًا.

الخطوة 4: إجراء أول مكالمة واجهة برمجة تطبيقات لك (إكمال الدردشة) باستخدام بايثون

دعنا نجعل شيئًا يحدث! الاستخدام الأكثر شيوعًا هو إكمال الدردشة - إعطاء النموذج موجهًا أو تاريخ محادثة والحصول على رد. نقطة النهاية الأساسية لـ Mistral لذلك هي /v1/chat/completions.

سنستخدم نموذج mistral-large-latest لهذا المثال، ولكن يمكنك استبداله بأي اسم نموذج دردشة مناسب.

ملاحظة أمان مهمة: في الأمثلة أدناه، غالبًا ما نستخدم os.environ["MISTRAL_API_KEY"] (بايثون) أو process.env.MISTRAL_API_KEY (TypeScript). هذا يفترض أنك ضبطت مفتاح واجهة برمجة التطبيقات الخاص بك كمتغير بيئة باسم MISTRAL_API_KEY. وهذه ممارسة موصى بها بشدة بدلاً من لصق المفتاح مباشرة في الشفرة.

كيف تضبط متغير بيئة (مؤقت لجلسة الطرفية):
ماك/لينيكس: export MISTRAL_API_KEY='your_actual_api_key_here'
ويندوز (موجه الأوامر): set MISTRAL_API_KEY=your_actual_api_key_here
ويندوز (PowerShell): $env:MISTRAL_API_KEY='your_actual_api_key_here'
استبدل your_actual_api_key_here بالمفتاح الذي حفظته. تذكر شطب الاقتباسات إذا كنت تستخدم موجه الأوامر في ويندوز. للحصول على إعداد أكثر دائمه، ابحث عن كيفية تعيين متغيرات البيئة بشكل دائم على نظام التشغيل الخاص بك.

تثبيت المكتبة:

pip install mistralai

إنشاء ملف بايثون (على سبيل المثال، mistral_test.py):

import os
from mistralai.client import MistralClient
from mistralai.models.chat_completion import ChatMessage

# Load the API key from environment variables
api_key = os.environ.get("MISTRAL_API_KEY")
if not api_key:
    raise ValueError("MISTRAL_API_KEY environment variable not set!")

# Define the model you want to use
model_name = "mistral-large-latest" # Or choose another model

# Initialize the Mistral client
client = MistralClient(api_key=api_key)

print(f"Sending request to model: {model_name}")

# Define the conversation messages
# The 'messages' list contains chat history or a single user prompt
messages = [
    ChatMessage(role="user", content="ما هو أفضل جبن فرنسي؟")
    # You can add more messages for conversation history:
    # ChatMessage(role="assistant", content="هناك العديد من أنواع الجبن الفرنسي الرائعة! يعتمد ذلك على ذوقك. هل تفضل الجبن الطري، أو الصلب، أو الأزرق؟"),
    # ChatMessage(role="user", content="أنا أفضل الجبن الطري.")
]

try:
    # Make the API call to the chat completions endpoint
    chat_response = client.chat(
        model=model_name,
        messages=messages,
        # Optional parameters:
        # temperature=0.7, # Controls randomness (0.0 = deterministic, 1.0 = more random)
        # max_tokens=150   # Limits the length of the response
    )

    # Print the response from the model
    if chat_response.choices:
        print("رد النموذج:")
        print(chat_response.choices[0].message.content)
    else:
        print("لم يتم استلام أي رد.")

    # You can also print the full response object to see usage details, etc.
    # print("\nكائن الاستجابة الكامل:")
    # print(chat_response)

except Exception as e:
    print(f"حدث خطأ: {e}")

تشغيل البرنامج النصي:

python mistral_test.py

يجب أن ترى إجابة النموذج مطبوعة في طرفيتك!

الخطوة 5: اختبار تمثيلات Mistral AI باستخدام واجهة برمجة التطبيقات

لا تتعلق Mistral فقط بالدردشة! دعونا نلقي نظرة على قدرة رئيسية أخرى: التمثيلات. تقوم التمثيلات بتحويل النصوص إلى متجهات عددية تلتقط المعنى الدلالي. النصوص ذات المعاني المتشابهة ستمتلك متجهات قريبة من بعضها في فضاء المتجهات. هذه أساسية للجيل المعزز بالاسترجاع (RAG)، البحث الدلالي، أنظمة التوصية، وما إلى ذلك.

يتم الوصول إلى نموذج التمثيل من Mistral عبر نقطة النهاية /v1/embeddings، وعادةً ما يستخدم معرف نموذج mistral-embed.

دعونا نرى كيف نحصل على التمثيلات لعدد من الجمل باستخدام بايثون:

import os
from mistralai.client import MistralClient

api_key = os.environ.get("MISTRAL_API_KEY")
if not api_key:
    raise ValueError("MISTRAL_API_KEY environment variable not set!")

model_name = "mistral-embed"
client = MistralClient(api_key=api_key)

print(f"طلب التمثيلات باستخدام النموذج: {model_name}")

texts_to_embed = [
    "توفر Mistral AI نماذج لغوية قوية.",
    "التمثيلات هي تمثيلات عددية للنصوص.",
    "كيف يكون الطقس اليوم؟"
]

try:
    embeddings_response = client.embeddings(
        model=model_name,
        input=texts_to_embed
    )

    # تحتوي الاستجابة على قائمة من كائنات التمثيل، كل منها مع المتجه
    print(f"تم استلام {len(embeddings_response.data)} تمثيلًا.")

    # طباعة الأبعاد الأولى من أول تمثيل كمثال
    if embeddings_response.data:
        first_embedding_vector = embeddings_response.data[0].embedding
        print(f"أبعاد كل تمثيل: {len(first_embedding_vector)}")
        print(f"أول 5 أبعاد من أول تمثيل: {first_embedding_vector[:5]}")

    # عادة ما تقوم بتخزين هذه المتجهات للاستخدام لاحقًا
    # print("\nاستجابة التمثيلات الكاملة:")
    # print(embeddings_response)

except Exception as e:
    print(f"حدث خطأ: {e}")

قم بتشغيل هذا البرنامج النصي بلغة بايثون، وسترى أبعاد التمثيلات وقطعة صغيرة من الأول.

قدرات أخرى:

تقدم Mistral المزيد! في حين أننا لن نتطرق إلى الكود هنا، تأكد من استكشاف الوثائق الرسمية لـ:

الإكمال (وراثي): بينما تكون الدردشة غالبًا مفضلة، قد تكون هناك نقاط نهاية إكمال أبسط تتم مناقشتها هنا: قدرات إكمال Mistral
فهم المستندات (OCR): استخراج النصوص من المستندات، مع احتمالية التعامل مع التخطيطات والصور: قدرات المستندات من Mistral
استدعاء الوظائف: السماح للنماذج بالتفاعل مع الأدوات الخارجية وواجهات برمجة التطبيقات.
التدريب الدقيق: تخصيص النماذج على بياناتك الخاصة (غالبًا ما تكون سمة مؤسسية).

ارجع دائمًا إلى الوثائق الرسمية لـ Mistral AI للحصول على أحدث المعلومات حول نقاط النهاية والمعلمات والقدرات.

الخطوة 6: فهم التسعير ومراقبة الاستخدام

غالبًا ما تأتي استخدام نماذج الذكاء الاصطناعي القوية بتكلفة. من الضروري أن نفهم كيف تقوم Mistral بالتسعير لاستخدام واجهة برمجة التطبيقات.

يختلف التسعير حسب النموذج: عادةً ما تكلف النماذج الأكبر والأكثر قدرة أكثر لكل توكن (المدخلات والمخرجات) من النماذج الأصغر. وتحتوي نماذج التمثيل على تسعير خاص بها، عادة ما يعتمد على عدد التوكونات المعالجة.
التوكنات: تقوم نماذج الذكاء الاصطناعي بمعالجة النصوص في قطع تسمى توكنات. لا يُعتبر التوكن كلمةً بالضبط؛ يمكن أن يكون كلمة، أو جزء من كلمة، أو علامات ترقيم. تقريبًا، 1000 توكن تعني حوالي 750 كلمة، لكن هذا يختلف. يحدد التسعير عادةً كـ "تكلفة لكل مليون توكن مدخل" و "تكلفة لكل مليون توكن مخرج".
تحقق من الصفحة الرسمية للتسعير: قد يتغير التسعير. ارجع دائمًا إلى الصفحة الرسمية لتسعير Mistral AI للحصول على أحدث التفاصيل. يمكنك عادة العثور على رابط إلى ذلك على موقعهم الرئيسي أو ضمن وثائق نظرة عامة على النماذج.
مراقبة الاستخدام الخاص بك: عادةً ما تحتوي وحدة تحكم Mistral AI (console.mistral.ai) على قسم (غالبًا تحت "الفوترة" أو "الاستخدام") حيث يمكنك تتبع مكالمات واجهة برمجة التطبيقات والتكاليف المرتبطة بها. تحقق من ذلك بانتظام لتجنب المفاجآت.
تحديد الميزانيات/التنبيهات: إذا كان النظام الأساسي يسمح بذلك، حدد حدود الإنفاق أو التنبيهات لإعلامك إذا تجاوز استخدامك عتبات معينة.

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

الخطوة 7: إجراء مكالمات واجهة برمجة التطبيقات باستخدام APidog

بينما يكون الترميز شائعًا، أحيانًا ترغب في وجود واجهة رسومية لاختبار نقاط النهاية بسرعة. أدوات مثل Postman و Insomnia و APidog رائعة لذلك. دعنا نمر عبر استخدام APidog لإجراء نفس مكالمة الإكمال للدردشة كما كان من قبل.

تحميل وتثبيت APidog: إذا لم تكن قد فعلت ذلك بالفعل، قم بتحميل APidog من موقعهم الرسمي وتثبيته على جهاز الكمبيوتر الخاص بك.

إطلاق APidog: افتح التطبيق.

إنشاء طلب جديد: سترى على الأرجح زر "+" أو خيار لإنشاء "طلب جديد". انقر عليه.

تعيين طريقة HTTP وURL:

في منطقة الطلب، ابحث عن القائمة المنسدلة لطريقة HTTP (تكون عادةً افتراضيًا على GET). غيرها إلى POST.
في حقل إدخال URL بجوار ذلك، أدخل نقطة نهاية إكمالات الدردشة من Mistral: https://api.mistral.ai/v1/chat/completions

تهيئة التفويض:

ابحث عن علامات التبويب أسفل شريط عنوان URL مثل "Params"، "Authorization"، "Headers"، "Body". انقر على علامة التبويب "Authorization".
في القائمة المنسدلة "Type" ضمن هذه العلامة، اختر "Bearer Token".
سيظهر حقل يحمل اسم "Token" إلى اليمين. الصق مفتاح واجهة برمجة التطبيقات المحفوظ لديك في هذا الحقل.

تعيين رؤوس الطلب:

انقر على علامة التبويب "Headers".
تحتاج إلى إضافة رأسين:
في الصف الأول الفارغ تحت "Key"، اكتب Content-Type. في عمود "Value" بجانبه، اكتب application/json.
في الصف الفارغ التالي، اكتب Accept لـ "Key"، وapplication/json لـ "Value".
قم أيضًا بتعيين Authorization: Bearer $MISTRAL_API_KEY

توفير جسم الطلب:

انقر على علامة التبويب "Body".
اختر زر "raw".
في الجهة اليمنى من "raw"، توجد غالبًا قائمة منسدلة تظهر التنسيق (مثل "نص"). غير هذه القائمة إلى "JSON".
في منطقة النص الكبيرة الموجودة أدناه، ألصق الحمولة JSON لطلبك:

{
    "model": "mistral-large-latest",
    "messages": [{"role": "user", "content": "من هو أكثر رسام فرنسي شهرة؟"}]
}

إرسال الطلب: ابحث عن زر "إرسال" (يكون عادةً بارزًا بالقرب من شريط عنوان URL) وانقر عليه.

عرض الرد: سيقوم APidog بعمل الاتصال إلى واجهة برمجة التطبيقات من Mistral. ستظهر الاستجابة من الخادم في القسم السفلي من نافذة APidog، عادةً تحت علامة "الاستجابة" أو "الجسم". يجب أن ترى الاستجابة JSON، بما في ذلك جواب النموذج ضمن choices[0].message.content. يمكنك أيضًا فحص رؤوس الاستجابة وأكواد الحالة (نأمل 200 OK!).

يعد استخدام أداة مثل APidog رائعًا لتجربة نماذج وموجهات ومعلمات مختلفة دون كتابة أي كود.

الخطوة 8: أفضل الممارسات & الأمان (ملخص سريع)

يتطلب العمل مع مفاتيح واجهة برمجة التطبيقات مسؤولية. دعونا نكرر بعض النقاط الأساسية:

لا تقم أبدًا بإدخال المفاتيح في الشيفرة: لا تقم بلصق مفتاح واجهة برمجة التطبيقات الخاص بك مباشرةً في الشيفرة المصدرية الخاصة بك (my_key = "sk-..."). إذا قمت بإيداع هذه الشيفرة في مستودع عام (مثل GitHub)، سيتم كشف مفتاحك وسيتمكن الآخرون من استخدامه، مما سيتسبب في تراكم الرسوم على حسابك.
استخدم متغيرات البيئة: كما هو موضح في أمثلة الشيفرة، فإن تحميل المفاتيح من متغيرات البيئة (os.environ، process.env) هو ممارسة قياسية أكثر أمانًا.
أدوات إدارة الأسرار: للحصول على تطبيقات أكثر قوة، خاصة في بيئات العمل أو النشر على السحابة، استخدم خدمات إدارة الأسرار الخاصة (مثل AWS Secrets Manager، Google Secret Manager، HashiCorp Vault).
أقل الامتيازات: إذا كانت Mistral تسمح بإنشاء مفاتيح بأذونات محددة (هذا ليس متاحًا دائمًا)، قم بإنشاء مفاتيح تملك فقط الأذونات اللازمة لتطبيق معين.
تدوير المفاتيح: من أجل تعزيز الأمان، ضع في اعتبارك توليد مفاتيح جديدة بشكل دوري وإحالة المفاتيح القديمة (على سبيل المثال، كل بضعة أشهر)، على الرغم من أن ذلك يتطلب تحديث تطبيقاتك.
المراقبة بانتظام: تابع لوحة المعلومات الخاصة بك في وحدة التحكم لمراقبة الاستخدام. يمكن أن تشير الأنشطة الغير عادية إلى أن المفتاح قد تم اختراقه.

الخاتمة: تقدم وابدأ بالبناء!

لقد تمكنت بنجاح من التنقل في عملية الحصول على واستخدام مفتاح واجهة برمجة التطبيقات لـ Mistral AI! لقد قمنا بتغطية:

إعداد حسابك على Mistral وتنشيط نظام الفوترة.
توليد وتخزين مفتاح واجهة البرمجة الخاص بك بشكل آمن.
فهم نماذج Mistral المختلفة وكيفية اختيار واحدة.
إجراء مكالمات واجهة برمجة التطبيقات باستخدام بايثون وTypeScript وcURL لإكمال الدردشات والتمثيلات.
تحقق من التسعير ومراقبة استخدامك.
استخدام أداة واجهة رسومية مثل APidog للاختبار السهل لواجهة برمجة التطبيقات.
تعزيز أفضل ممارسات الأمان الأساسية.

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

لا تتردد في استكشاف الوثائق الرسمية لمزيد من المعلومات – فهي المصدر النهائي للحقيقة بشأن جميع المعلمات والنماذج والميزات المتقدمة المتاحة.

نتمنى لك تجربة بناء ممتعة!

💡

زر