البدء السريع في واجهة برمجة التطبيقات

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

تستخدم واجهة برمجة التطبيقات مصادقة متوافقة مع OpenAI القياسية. تحصل على مفتاح واجهة برمجة التطبيقات فورًا بعد التسجيل باستخدام Google أو البريد الإلكتروني. استخدم هذا المفتاح في Authorization الرأس لجميع الطلبات. عنوان URL الأساسي ثابت عند https://api.mistralabliterated.com/v1. لا حاجة لإعداد إضافي لمسار نقطة النهاية.

Copycurl https://api.mistralabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the first five prime numbers"}]
  }'

يحدد مفتاحك حسابك ويتتبع الاستخدام. إذا فقدت مفتاحك، فقم بتوليد مفتاح جديد؛ سيصبح المفتاح القديم غير صالح.

POST /v1/chat/completions

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

Copyfrom openai import OpenAI

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

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

GET /v1/models

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

Copyimport OpenAI from "openai";

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

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

التدفق و  الأدوات

فعّل البث عن طريق تعيين stream: true في طلبك. ترسل واجهة برمجة التطبيقات (API) أجزاءً من النص عبر أحداث خادم المراسلة (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 للمخرجات المهيكلة عندما تضبط response_format إلى {"type": "json_object"}. خيارات الأدوات مرنة، مما يسمح بالاختيار المحدد أو التلقائي.

المعاملات & الحدود

يدعم نافذة السياق 100,000 رمز للنص البرمجي والإكمال المجمع. الحد الأقصى للإخراج لكل طلب هو 16,000 رمز، أو 2,048 إذا لم تحدد max_tokens. يمكنك التحكم في التوليد باستخدام temperature, top_p, stop، و seed المعلمات. تتوفر أيضًا عقوبات التكرار والحضور لضبط المخرجات بدقة.

تسمح حدود معدل الطلبات بـ 300 طلب في الدقيقة لكل مفتاح و8 طلبات متزامنة. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. تضمن هذه الحدود أداءً مستقراً لتطبيقات معدل النقل العالي. اضبط استراتيجية التجميع للبقاء ضمن هذه الحدود.

الأخطاء والتسعير

HTTP 401 يشير إلى مفتاح API غير صالح أو مفقود. HTTP 402 يعني أن رصيدك المدفوع مسبقاً قد استنفد؛ قم بإضافة رصيد بالعملات المشفرة للمتابعة. HTTP 429 يشير إلى استنفاد حد معدل الطلبات؛ انتظر أو قلل من التزامن. الأخطاء لا تستهلك الرصيد، لذا لن يتم تحصيل رسوم منك عن الطلبات الفاشلة.

السعر هو $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج. الرصيد لا ينتهي، ولا توجد رسوم شهرية. تبدأ الإضافات من $20 مع مكافآت للمبالغ الأكبر. لا تتوفر استرداد الأموال، لكن الدعم يمكنه إصلاح الشحنات المزدوجة.