قم بتغيير العميل في ثلاثة أسطر

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

لاستخدام واجهة برمجة التطبيقات، وجه عميلك إلى https://api.mistralapi.top/v1. تعتمد المصادقة على رمز حامل (bearer token) مدرج في رأس Authorization. يمكنك إنشاء هذا المفتاح عبر صفحة الحصول على مفتاح API باستخدام حساب Google أو إعداد البريد الإلكتروني/كلمة المرور القياسي. يظهر المفتاح فورًا عند الإنشاء. احتفظ بهذا الرمز آمنًا، لأنه يمنحك الوصول الكامل إلى رصيدك المسبق الدفع. على عكس المزودين القياسيين، لا نحتاج إلى رقم هاتف أو بطاقة ائتمان لتفعيل رصيد التجربة الأولية.

تم تصميم خدمتنا لتناسب مباشرة تكوينات عميل Mistral أو OpenAI الموجودة. قم ببساطة بتحديث خاصية base_url في مثيل المكتبة (SDK). يتطابق هيكل نقطة النهاية مع التنسيق القياسي /v1/chat/completions، مما يضمن عمل الكود الموجود لديك دون تعديل. ندعم معرف نموذج واحد، uncensored، الذي يتعامل مع جميع مهام توليد النصوص.

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

يحدث التفاعل الأساسي عبر نقطة النهاية POST /v1/chat/completions. ترسل جسم JSON يحتوي على معرف model، ومصفوفة messages، ومعلمات اختيارية. تُرجع واجهة برمجة التطبيقات استجابة نصية أو بيانات هيكلية إذا حددت وضع JSON. هذه النقطة هي الطريقة الأساسية للتفاعل مع نموذج اللغوي الكبير (LLM). تدعم كل من الطلبات المتزامنة القياسية واستجابات البث المتدفق. يستهلك كل طلب رموزًا من رصيدك المسبق الدفع بناءً على حجم الإدخال والإخراج.

يتم التعامل مع الأخطاء عبر أكواد حالة HTTP القياسية. إذا كان مفتاحك غير صالح، تتلقى 401. إذا نفد رصيدك، تتلقى 402. يتم فرض حدّ المعدل عند 300 طلب في الدقيقة و8 اتصالات متزامنة لكل مفتاح. استخدم المثال التالي للتحقق من اتصالك وصحة المفتاح.

Copycurl https://api.mistralapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

الاستجابات المتدفقة (SSE)

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

عند استخدام البث المتدفق، تأكد من أن عميلك يقوم بتحليل تنسيق SSE بشكل صحيح. ستحتوي مصفوفة choices في كل جزء على محتوى تفاضلي (delta). يجب عليك تراكم هذه التفاضلات لبناء الاستجابة الكاملة. يتوفر استخدام الرموز فقط في الحدث الأخير من الدفق. استخدم هذه الطريقة لإبقاء مستخدميك في حالة تفاعل بينما يعالج النموذج الموجّهات المعقدة.

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)

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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