مفتاح API لـ Mistral: دليل البدء السريع

المتطلبات الأساسية: حزمة التطوير (SDK) والبيئة

ابدأ بتثبيت حزمة SDK المتوافقة مع OpenAI المفضلة لديك. لا تحتاج سوى إلى مفتاح API صالح وعنوان URL الأساسي لخدمتنا.

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

تأكد من أن بيئتك تدعم مكتبات HTTP القياسية. يتوقع الواجهة البرمجية (API) حمولات JSON قياسية لجميع الطلبات. لا تحتاج إلى تثبيت برامج تشغيل خاصة بالبائع.

ضبط عنوان URL الأساسي

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

استخدم HTTPS://api.apikeymistral.com/v1 كعنوان URL الأساسي. يضمن ذلك توجيه جميع الطلبات عبر خوادمنا عالية الإنتاجية. لا تحتاج إلى تغيير مسار نقطة النهاية إذا كان SDK الخاص بك يستخدم افتراضياً /chat/completions.

احتفظ بمفتاح API الخاص بك في الذاكرة أو في مخزن آمن. يقوم المفتاح بمصادقة كل طلب ترسله إلى هذا العنوان URL.

إجراء أول طلب POST

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

حدد درجة الحرارة والمعلمات الأخرى للتحكم في الإبداع. تقبل نقطة النهاية أجسام JSON القياسية مع مصفوفة الرسائل.

إليك أمر curl أساسي لاختبار الاتصال:

Copycurl https://api.apikeymistral.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json object with keys name age"}]
  }'

تحقق من أن الاستجابة تحتوي على النص المولد. تحقق من أن رمز الحالة هو 200 للنجاح.

تكامل مكتبة Python

قم بتكوين عميل Python لاستخدام عنوان URL الأساسي الخاص بنا. قم بتهيئة العميل بمفتاح API الخاص بك ونقطة النهاية المخصصة.

استدعاء طريقة chat.completions.create مع النص المطلوب. يحتوي كائن الاستجابة على النص المُولّد في choices[0].message.content.

تعامل مع الأخطاء المحتملة مثل حدود المعدل أو المفاتيح غير الصالحة بسلاسة. قم بتسجيل استخدام الرموز إذا لزم الأمر لتتبع التكاليف.

Copyfrom openai import OpenAI

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

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

تكامل Node SDK

قم تهيئة عميل Node.js باستخدام عنوان URL الأساسي المخصص. مرر مفتاح واجهة برمجة التطبيقات في كائن التكوين.

استدعِ دالة chat.completions.create بالمعلمات التي تريدها. تتبع الاستجابة تنسيق OpenAI القياسي.

معالجة التدفق أو الاستجابة النهائية حسب الحاجة. يجب أن يلتقط التعامل مع الأخطاء مشكلات الشبكة أو فشل المصادقة.

Copyimport OpenAI from "openai";

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

يتيح لك هذا الإعداد تكامل الاستنتاج غير المقيد في تطبيقات Node الخاصة بك بسرعة.

معالجة استجابات التدفق

فعّل التدفق عن طريق تعيين stream=true في طلبك. تُرجع واجهة برمجة التطبيقات البيانات في أجزاء بمجرد توليدها.

معالجة كل قطعة لعرض المخرجات في الوقت الفعلي للمستخدمين. اجمع المحتوى للحصول على الاستجابة الكاملة.

راقب استهلاك الرمز المميز في الشريحة النهائية من التدفق. يساعدك ذلك على تتبع التكاليف بدقة.

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)

يقلل التدفق من زمن الاستجابة المُدرَك للاستجابات الطويلة. إنه مثالي لواجهات الدردشة والتطبيقات التفاعلية.

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

فهم الحدود التقنية لتجنب انقطاع الخدمة. تدعم نافذة السياق 100,000 رمز للطلب والإكمال معًا.

الحد الأقصى للإخراج هو 16,000 رمز مميز لكل طلب. اضبط max_tokens صراحة لتجنب الوصول إلى الافتراضي 2,048.

تسمح حدود معدل الطلبات بـ 300 طلب في الدقيقة لكل مفتاح. يمكنك إجراء 8 طلبات متزامنة في وقت واحد.

عالج أخطاء 401 بالتحقق من صلاحية المفتاح. تشير أخطاء 402 إلى عدم كفاية الرصيد. تعني أخطاء 429 أنك وصلت إلى حد معدل الطلبات.

ستفشل الطلبات التي تتجاوز حد حجم الجسم البالغ 8 ميجابايت. خطط لحجم الحمولة الخاص بك وفقًا لذلك.