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

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

استخدم مفتاح API الخاص بك مع عنوان URL الأساسي HTTPS://api.mistralllmapi.com/v1. أنشئه فوراً عبر Google أو البريد الإلكتروني في صفحة الحصول على مفتاح API. أرسل المفتاح في رأس Authorization كرمز Bearer. يعمل هذا مع أي عميل قياسي لمكتلات OpenAI.

• سجّل بدون رقم هاتف.
• احتفظ بمفتاح نشط واحد لكل حساب.
• استبدل المفاتيح القديمة عند تدويرها.

Copycurl https://api.mistralllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check if port 8080 is open on 10.0.0.5"}]
  }'

نقطة نهاية إكمال الدردشة

أرسل طلبات POST إلى /v1/chat/completions. مرر معرف النموذج كـ "uncensored". قدم الرسائل في مصفوفة مع حقول الدور والمحتوى. يعيد النموذج النص بدون فلاتر المحتوى القياسية للاستخدام القانوني للبالغين. تبلغ مساحة نافذة السياق الإجمالية 100,000 رمز بما في ذلك الإدخال والإخراج.

Copyfrom openai import OpenAI

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

Models Endpoint

أرسل طلب GET على المسار /v1/models لعرض النماذج المتاحة. تحقق من تطابق معرّف النموذج مع "uncensored". يؤكد هذا المسار أن اتصالك يعمل. استخدمه لتصحيح أخطاء المصادقة قبل إرسال حمولات البيانات الثقيلة. تقدم الواجهة البرمجية نموذجًا واحدًا فقط غير مقيد.

استجابات البث

فعّل التدفق عن طريق تعيين 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)

استدعاء الوظائف ووضع JSON

عرّف الأدوات في جسم الطلب لاستدعاء الدوال. اضبط tool_choice لفرض دوال محددة. استخدم response_format مع json_object لمخرجات JSON صارمة. تضبط المعاملات مثل درجة الحرارة و top_p العشوائية. تدعم هذه الميزات استخراج البيانات المهيكلة.

Copyimport OpenAI from "openai";

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

حدود المعدلات والأخطاء

تتوقع 300 طلب في الدقيقة لكل مفتاح. حد الطلبات المتزامنة إلى 8. تجاوز الطلبات لحجم جسم أكبر من 8 ميجابايت. إرجاع 401 للمفاتيح غير الصالحة. إرجاع 402 إذا كان الرصيد غير كافٍ. إرجاع 429 عند تجاوز حدود المعدل. الأخطاء لا تستهلك رموزاً. الرصيد لا ينتهي.