API Mistral AI: دليل البدء السريع

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

الخطوة الأولى هي تكوين عميلك للإشارة إلى بنيتنا التحتية. استبدل عنوان URL الأساسي القياسي لـ OpenAI بـ HTTPS://api.apimistralai.com/v1 وأدرج مفتاح API الفريد الخاص بك في رأس المصادقة. يؤدي هذا التبديل البسيط إلى إعادة توجيه جميع الطلبات إلى نموذجنا غير الخاضع للرقابة مع الحفاظ على منطق التكامل الحالي سليمًا.

• عنوان URL الأساسي: HTTPS://api.apimistralai.com/v1
• المصادقة: رمز حامل عبر Authorization رأس الصفحة

تأكد من أن مفتاحك نشط في لوحة حسابك قبل اختبار الاتصالات.

الطلب الأول

أرسل طلب إكمال محادثة قياسي للتحقق من الاتصال واستجابة النموذج. التالي curl يستهدف الأمر uncensored بمطالبة أساسية.

هذا يؤكد أن نقطة النهاية يمكن الوصول إليها وتعيد النص بدون مرشحات المحتوى القياسية.

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

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

تكامل واجهة برمجة تطبيقات Python

استخدم مكتبة بايثون الرسمية الخاصة بـ OpenAI للتفاعل مع واجهة برمجة التطبيقات الخاصة بنا دون تعديل هيكل الطلب الأساسي. قم بتهيئة العميل بعنوان URL الأساسي الجديد ومفتاح واجهة برمجة التطبيقات الخاص بك، ثم اتصل chat.completions.create.

تُتيح لك هذه الطريقة الاحتفاظ بمنطق Python الحالي مع الحصول على إمكانية الوصول إلى قدرات النموذج غير الخاضع للرقابة.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apimistralai.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 القياسية، مما يجعل الانتقال سلسًا لمطوري Python.

تكامل Node SDK

لبيئات JavaScript أو TypeScript، قم بتهيئة حزمة OpenAI مع base URL المخصص. اضبط apiKey و baseURL الخصائص قبل الاتصال chat.completions.create.

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

Copyimport OpenAI from "openai";

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

يبقى هيكل الرد متسقًا مع معايير OpenAI، مما يسمح بالتكامل بسهولة في عمليات Node.js الحالية.

استجابات البث عبر SSE

فعّل توليد الرمز الفوري عن طريق تعيين stream: true في طلبك. تُعيد واجهة برمجة التطبيقات تدفق أحداث الإرسال الخادم (SSE)، مما يتيح لك معالجة الرموز المميزة أثناء توليدها.

هذا يقلل من زمن الاستجابة المُدرَك للمستخدمين ويوفر ملاحظات فورية أثناء الإكمالات الطويلة.

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)

تحليل تدفق بيانات SSE لعرض الرموز تدريجيًا. تحتوي الشظية النهائية على إجمالي استخدام الرموز للطلب.

حدود، أخطاء، والسياق

راقب استخدامك مقابل حدود معدل الطلب الصارمة وتعامل مع أخطاء HTTP الشائعة بسلاسة. يُسمح لك بـ 300 طلب في الدقيقة و 8 طلبات متزامنة لكل مفتاح.

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

نوافذ السياق الخاصة بك تدعم 100,000 رمز توكن إجماليًا، مع حد أقصى للمخرجات يبلغ 16,000 رمز توكن لكل طلب. الأخطاء والرفضات لا تستهلك رصيدك، مما يضمن دفعك فقط مقابل المحتوى المُولّد فعليًا.