البدء السريع لمستخدمي Mistral
انتقل إلى بديل واجهة برمجة التطبيقات غير الخاضعة للرقابة من Mistral عن طريق تحديث عنوان URL الأساسي والمفتاح. شغّل كود العميل المتطابق مع نموذج نافذة السياق الخاص بنا الذي يتسع لـ 100 ألف رمز مع تسعير شفاف حسب الاستخدام.
تثبيت مكتبة SDK المتوافقة مع OpenAI
بما أن واجهة برمجة التطبيقات الخاصة بنا تطبق معيار chat-completions الخاص بـ OpenAI، يمكنك استخدام أي مكتبة SDK موجودة. بالنسبة لـ Python، قم بتثبيت الحزمة الرسمية openai عبر pip. يجب على مطوري Node.js تثبيت حزمة npm openai. تتعامل هذه المكتبات مع التسلسل، وإعادة المحاولة، والبث المتدفق تلقائياً.
لا تحتاج إلى مكتبة SDK خاصة بـ Mistral. استخدام عملاء متوافقين مع OpenAI يضمن قدرتك على التبديل بين المزودين بسهولة. تأكد من تثبيت Python 3.8+ أو Node.js 16+ قبل المتابعة.
تكوين عنوان URL الأساسي ومفتاح API
يتطلب المصادقة مفتاح API صالح وعنوان URL الأساسي الصحيح. احصل على مفتاحك من صفحة الحصول على مفتاح API بعد التسجيل ببريدك الإلكتروني. لا تحتاج إلى بطاقة ائتمان للتجربة.
قم بتعيين متغيرات البيئة الخاصة بك أو مررها مباشرة في تهيئة العميل. عنوان URL الأساسي لهذه الخدمة هو https://api.mistralapikey.com/v1. هذا يسمح لك باستبدال تكوين Mistral أو OpenAI الحالي بتغييرات قليلة في الكود. يمكنك إعادة إنشاء مفتاحك في أي وقت، مما يلغي السابق.
إرسال طلبك الأول
أرسل طلب إكمال دردشة قياسي لاختبار الاتصال. استخدم معرف النموذج uncensored للوصول إلى نموذج اللغة الكبير الخاص بنا. تقبل نقطة النهاية طلبات POST مع حمولات JSON تحتوي على messages وmodel.
يجيب نموذجنا بدون رفضات محتوى للاستخدام القانوني للبالغين. يدعم نافذة سياق من 100,000 رمز لكل من الإدخال والإخراج. تأكد من أن حجم طلبك يبقى أقل من 8 MB.
curl https://api.mistralapikey.com/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."}]
}'
تمكين الردود المتدفقة
للحصول على توليد الرموز في الوقت الفعلي، قم بتعيين المعلمة stream إلى true. تُرجع واجهة برمجة التطبيقات أحداثاً مرسلة من الخادم (SSE) بدلاً من كائن JSON واحد. هذا مثالي لواجهات الدردشة أو مخرجات الطرفية المباشرة.
عالج التدفق عن طريق التكرار عبر القطع. يحتوي كل جزء على أجزاء جزئية من الاستجابة. هذا يقلل من زمن الاستجابة المدرك للمستخدمين مقارنة بالانتظار لإكمال الرد الكامل. يدعم النموذج غير الخاضع للرقابة البث المتدفق بشكل أصلي.
stream = 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)
استخدام استدعاء الأدوات/الدوال
تدعم واجهة برمجة التطبيقات الخاصة بنا استدعاء الأدوات المهيكلة عبر التنسيق المتوافق مع OpenAI. عرّف الدوال في مصفوفة tools واترك النموذج يقرر متى يستدعيها. مرر اسم الدالة والحجج كما أرجعها النموذج.
هذا يمكّن سير العمل المعقد حيث يتفاعل LLM مع واجهات برمجة التطبيقات الخارجية أو قواعد البيانات. تأكد من أن تعريفات الدوال الخاصة بك هي مخططات JSON صالحة. سيجيب النموذج باستدعاءات الأدوات عند الاقتضاء، مما يسمح لك بتنفيذ المنطق وإرجاع النتائج إلى المحادثة.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mistralapikey.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);
فحص النماذج المتاحة
استعلم عن نقطة النهاية GET /v1/models لسرد النماذج المتاحة. هذا يُرجع بيانات وصفية بما في ذلك معرف النموذج، ونوع الكائن، والمالك. تخدم خدمتنا حالياً فقط نموذج uncensored.
هذه نقطة النهاية مفيدة لتصحيح الأخطاء أو تكوين العميل الديناميكي. تؤكد أن مفتاح API الخاص بك صالح وأن الخدمة يمكن الوصول إليها. قد تسرد البائعون الآخرون نماذج متعددة؛ نحن نركز على تقديم خيار واحد عالي الجودة وغير خاضع للرقابة دون تعقيدات التوجيه.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralapikey.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)المواصفات التقنية
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| المصادقة | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.mistralapikey.com/v1 |
| معرّف النموذج | uncensored |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| وضع JSON | response_format: {"type": "json_object"} |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| حجم الطلب | حتى 8 MB |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $20 إلى $500 |
| مكافأة | +5% من $50، +10% من $100، +15% من $200 |
| السعر | $0.15 لكل مليون رمز مدخلات · $0.50 لكل مليون رمز مخرجات |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
| تسجيل الدخول | Google أو البريد الإلكتروني وكلمة المرور |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
رموز الأخطاء
تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.
| HTTP | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
كم يكلف بديل واجهة برمجة التطبيقات غير الخاضعة للرقابة من Mistral؟
السعر هو $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. لا توجد رسوم شهرية أو اشتراكات. يمكنك شحن الرصيد من $20 بالعملات المشفرة فقط (USDT على شبكة TRC20، USDC على شبكة Base)، مع وجود رصيد إضافي متاح للإيداعات الأكبر.
ماذا يحدث إذا تجاوزت حدّ المعدل؟
ستتلقى خطأ 429 Too Many Requests. الحد هو 300 طلب في الدقيقة لكل مفتاح API. إذا وصلت إلى هذا الحد، انتظر لحظة أو أعد إنشاء مفتاحك. يجب أن تبقى أحجام الطلبات أقل من 8 MB.
هل رصيد التجربة صالح للأبد؟
لا. تحصل الحسابات الجديدة على $0.50 كرصيد تجريبي صالح لمدة 7 أيام. احصل على هذا الرصيد بنقرة واحدة في صفحة مفتاح API الخاص بك. لا حاجة لبطاقة ائتمان للبدء. ومع ذلك، فإن رصيد مسبق الدفع المدفوع لا ينتهي صلاحيته أبداً.
مفتاحك على بُعد نموذج واحد
أنشئ حساباً، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد بأكمله.