AR ▾
mistralapikey.com

بديل واجهة Mistral API بدون رقابة

احصل على مفتاح API
عنوان URL الأساسي
https://api.mistralapikey.com/v1
النموذج
بدون رقابة

محادثة API متوافق مع OpenAI: Python وNode وcurl

مكالمة API chat متوافقة مع openai هي طلب POST واحد مع قائمة رسائل ورد واحد من النموذج. يوضح هذا الدليل الطلب، والمحادثات متعددة الأدوار، والبث المتدفق والأخطاء التي قد تواجهها، باستخدام نقطة نهاية uncensored كمثال.

تم التحديث

فقاعات محادثة تتبادل مكعبات خفيفة بين جهاز وبرج خادم، توضح طلب محادثة API

الطلب في دقيقة واحدة

يمكن لأي عميل يتعامل مع نموذج دردشة OpenAI التحدث مع هذه الخدمة. عليك تغيير شيئين فقط، وهي عنوان URL الأساسي ومفتاح API، مع الإبقاء على كل شيء آخر كما هو. هنا يكون عنوان URL الأساسي هو https://api.mistralapikey.com/v1 ومعرف النموذج هو uncensored. يتم المصادقة باستخدام رأس Authorization: Bearer القياسي.

يبدو الطلب الأول كالتالي:

curl https://api.mistralapikey.com/v1/chat/completions   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Explain what an API key is in two sentences."}
    ]
  }'

هذه خدمة مستقلة تشغّل نموذجًا واحدًا مفتوح الأوزان، مُضبط للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. ليست واجهة برمجة التطبيقات الرسمية لـ Meta أو Mistral أو OpenAI أو أي مورد آخر. تُعرّض طريقتين، POST /v1/chat/completions و GET /v1/models، وهي تتعامل مع النصوص فقط. إذا كنت لا تزال بحاجة إلى مفتاح، يشرح صفحة مفتاح API التسجيل ورصيد التجربة المجانية.

قراءة الاستجابة

الرد الناجح هو كائن JSON بالشكل المعتاد. يوجد النص في choices[0].message.content، وسبب التوقف في choices[0].finish_reason، وتوجد عدادات الرموز في usage.

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "uncensored",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "An API key is a secret string..."},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 31, "completion_tokens": 48, "total_tokens": 79}
}

يعني finish_reason بقيمة stop أن النموذج أنهى إجابته. تعني القيمة length أنه وصل إلى حدّ الرموز، لذا قم بزيادة max_tokens أو اتركه غير مضبوط. الرؤوس مهمة أيضًا: يحدد X-Request-Id المكالمة لدعم العملاء، ويظهر X-Balance-USD رصيدك المتبقي، ويبلغ X-RateLimit-Limit-Requests وX-RateLimit-Limit-Concurrency عن حدودك.

الرسائل والأدوار

مصفوفة messages هي المحادثة بأكملها، بالترتيب. يحتوي كل عنصر على role وcontent.

  • يحدد system السلوك والنبرة والقواعد. ضعها في البداية.
  • user هو ما كتبه المستخدم.
  • assistant هو ما قاله النموذج سابقًا في المحادثة.
  • tool يحمل نتيجة استدعاء الدالة، إذا كنت تستخدم استدعاء الدوال.

يعرف النموذج فقط ما هو موجود في المصفوفة. لا يتم تذكر أي شيء بين الطلبات، لذا لا يحتفظ الخادم بجلسة لك. هذا هو أهم شيء يجب فهمه حول نقاط النهاية للدردشة، ويشرح سبب تكلفة "الدردشة" التي تزيد مع كل دور: يتم احتساب التاريخ الذي ترسله كمدخلات في كل مرة.

دردشة متعددة الأدوار في Python

للحفاظ على المحادثة، احتفظ بقائمة، وأضف رسالة المستخدم، واستدعِ واجهة برمجة التطبيقات، وأضف رد المساعد، وكرر العملية. هذه دردشة طرفية كاملة.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.mistralapikey.com/v1",
    api_key="YOUR_API_KEY",
)

history = [{"role": "system", "content": "You are a friendly, direct assistant."}]

while True:
    text = input("you> ").strip()
    if not text:
        break
    history.append({"role": "user", "content": text})

    resp = client.chat.completions.create(
        model="uncensored",
        messages=history,
        temperature=0.7,
    )
    answer = resp.choices[0].message.content
    history.append({"role": "assistant", "content": answer})

    print("bot>", answer)
    print(f"   [{resp.usage.prompt_tokens} in / {resp.usage.completion_tokens} out]")

راقب الأرقام بين الأقواس أثناء الدردشة. يرتفع عدد "المدخلات" مع كل دور لأنه يشمل كل ما قيل حتى الآن. هذا النمو طبيعي وهو أيضًا ذراعك الرئيسي للتحكم في التكلفة، كما هو موضح أدناه.

ردود البث المتدفق في Node

لواجهة دردشة تريد أن يظهر النص أثناء توليده. اضبط stream: true وترسل واجهة برمجة التطبيقات أحداثًا يرسلها الخادم. يلتف Node SDK الخاص بـ OpenAI هذا في مكرر غير متزامن.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.mistralapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a four-line poem about debugging." }],
  stream: true,
});

for await (const chunk of stream) {
  const piece = chunk.choices[0]?.delta?.content ?? "";
  process.stdout.write(piece);
}
process.stdout.write("\n");

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

المعلمات التي يمكنك استخدامها

تُمرر عناصر التحكم القياسية في أخذ العينات إلى النموذج. هذه هي العناصر التي ستعدلها أكثر من غيرها.

الحقلما يفعلهنصيحة عملية
temperatureعشوائية اختيار الكلمات0 إلى 0.3 للاستخراج، 0.7 إلى 1.0 للنصوص الإبداعية
top_pيحدّ من أخذ العينات إلى الكلمات الأكثر احتمالاًغيّر هذا أو درجة الحرارة، نادرًا ما يغير الاثنين
max_tokensالحد الأعلى لطول الرداختياري؛ اضبطه لوضع سقف للتكلفة في الموجّهات مفتوحة النهاية
stopتسلسلات تُنهي التوليدمفيدة للتنسيقات القائمة على الأسطر
seedعينة قابلة للتكرارمفيد للاختبارات
frequency_penalty، presence_penaltyتثبيط التكرارالقيم الصغيرة لها تأثير كبير
response_formatوضع JSONاستخدم {"type":"json_object"} ووصف المفاتيح في الموجّه

استدعاء الدوال متاح عبر tools و tool_choice أيضاً. يغطي البدء السريع إعدادات مكتبات SDK الشائعة.

تكلفة المحادثة

الأسعار هي $0.15 لكل 1M رمز مدخل و $0.50 لكل 1M رمز مخرج، من رصيد مسبق الدفع. نافذة السياق هي 100,000 رمز للموجه والرد معاً. لأن السجل يُعاد إرساله، فإن تكلفة الدردشة تنمو أسرع من عدد الرسائل.

خذ محادثة حيث تكون كل رسالة مستخدم حوالي 100 رمز وكل رد حوالي 200 رمز، بالإضافة إلى رسالة نظام بحجم 200 رمز. الدور 1 يرسل 300 رمز مدخل. الدور 10 يرسل حوالي 200 + 10 x 100 + 9 x 200 = 3,000 رمز مدخل. الدور 30 يرسل حوالي 200 + 30 x 100 + 29 x 200 = 9,000.

اجمع كل الأدوار الـ 30 من المدخلات: المجموع هو 30 x 200 + 100 x (1 + 2 + ... + 30) + 200 x (0 + 1 + ... + 29) = 6,000 + 46,500 + 87,000 = 139,500 رمز مدخل. المخرجات هي 30 x 200 = 6,000 رمز. التكلفة: 139,500 / 1M x $0.15 = $0.020925، زائد 6,000 / 1M x $0.50 = $0.003. إجمالي الدردشة المكونة من 30 دوراً يصل إلى حوالي $0.024. رخيص، لكن لاحظ أن المدخلات أكبر 23 مرة من المخرجات، وسينمو بمربع الطول إذا لم تقم بالتقطيع.

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

تقطيع السجل دون كسر المحادثة

عندما تصبح المحادثة طويلة، لديك خياران: الدفع مقابل السجل الكامل في كل دور، أو قطعه. قاعدة بسيطة هي الاحتفاظ برسالة النظام والأدوار الأخيرة. هذه الوظيفة تفعل ذلك وتترك باقي حلقة العمل دون تغيير.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.mistralapikey.com/v1",
    api_key="YOUR_API_KEY",
)

def trimmed(history, keep=8):
    system = history[:1]
    rest = history[1:]
    return system + rest[-keep:]

resp = client.chat.completions.create(
    model="uncensored",
    messages=trimmed(history),
)

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

كتابة رسالة نظام مفيدة

اجعلها قصيرة ومحددة: من هو المساعد، كم يجب أن تكون الإجابات، وأي قواعد تنسيق. "أنت وكيل دعم لمتجر دراجات. أجب في ثلاث جمل كحد أقصى واسأل سؤالاً إذا كان الطلب غير واضح" يفعل أكثر من صفحة من الفضائل العامة. كل كلمة منه تُحسب كمدخل في كل دور، لذا فإن رسالة نظام بحجم 1,000 رمز تضيف $0.00015 إلى كل طلب.

الأخطاء والحدود

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و 300 طلب في الدقيقة؛ المفتاح التجريبي يسمح بـ 2 و 60. الحد الأقصى لحجم جسم الطلب هو 8 MB. تجاوز أي حد وتلقي HTTP 429، مع أحد المعاني التالية:

  • رمز الخطأ rate_limited: طلبات كثيرة جداً في الدقيقة. وزّعها.
  • رمز الخطأ concurrency: طلبات كثيرة جداً في نفس الوقت. صفها في الطابور.
  • رأس Retry-After: 5: حمل زائد مؤقت. انتظر 5 ثوانٍ وأعد المحاولة.

تعني 401 أن المفتاح مفقود أو غير صحيح. أبعد المفاتيح عن أكواد الواجهة الأمامية؛ استدعِ واجهة برمجة التطبيقات من خادمك. إذا كنت تنتقل من إعداد Mistral، فإن صفحة مفتاح API الخاص بـ Mistral تغطي الوصول مع هذه الخدمة.

للشيفرة الإنتاجية، غلّف الاستدعاءات في إعادة محاولة مع انتظار قصير، كما تفعل مكتبات OpenAI بالفعل لبعض حالات الفشل، وسجّل قيمة X-Request-Id بجانب كل خطأ. عندما يبدو شيء ما خاطئاً، يكون هذا المعرف أسرع طريقة لتوجيه الدعم إلى الطلب المحدد. قم أيضاً بتعيين مهلة زمنية على جانب العميل: يمكن أن يستغرق إكمال طويل لموجّه كبير وقتاً طويلاً، ولا تريد أن يؤدي اتصال عالق إلى حجز أحد منافذ الـ 8 للتزامن.

لا ينتج الخدمة محتوى جنسياً يتضمن القاصرين، ولا تُستخدم الموجّهات للتدريب.

أسئلة وأجوبة

ماذا يعني متوافق مع OpenAI؟

يعني ذلك أن نقطة النهاية تقبل نفس تنسيق الطلب الخاص بواجهة برمجة التطبيقات لإكمال المحادثات من OpenAI، لذا تعمل حزم SDK الخاصة بـ OpenAI والأدوات بعد تغيير عنوان URL الأساسي والمفتاح.

هل يتذكر الخادم المحادثة؟

لا. أرسل سجل الرسائل الكامل مع كل طلب. لا يحتفظ الخادم بأي جلسة بين الاستدعاءات.

ما هي نقاط النهاية المتاحة؟

POST /v1/chat/completions و GET /v1/models. الخدمة للنصوص فقط، بدون نقاط النهاية للصور أو الصوت أو التضمينات.

كيف يمكنني بث الرد؟

اضبط stream إلى true. ترسل الـ API أحداثاً مرسلة من الخادم (SSE) وتبلغ عن الاستخدام في نهاية البث.

ما اسم النموذج الذي أستخدمه؟

استخدم uncensored كمعرّف النموذج في كل طلب.

مفتاحك على بُعد نموذج تعبئة واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذا هو الإعداد الكامل.