AR ▾
mistralapikey.com

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

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

واجهة برمجة تطبيقات Mistral في Python باستخدام OpenAI SDK

يمكن لبرنامج نصي بلغة Python لواجهة Mistral API العمل مع نقطة النهاية هذه المتوافقة مع OpenAI باستخدام الحزمة القياسية openai: اضبط عنوان URL الأساسي، مرر مفتاحك واستخدم النموذج uncensored. يحتوي هذا الدليل على الكود الخاص بالدردشة، البث المتدفق، JSON، الأدوات والدفعات.

تم التحديث

شريط من الضوء يتسلل عبر كتل كود زجاجية نحو بوابة، يمثل Python يستدعي واجهة API

النسخة المختصرة

لاستخدام سير عمل واجهة برمجة تطبيقات Mistral في Python مع هذه الخدمة، لا تحتاج إلى مكتبة العميل الخاصة بـ Mistral. تتحدث نقطة النهاية هذه بتنسيق إكمال الدردشة الخاص بـ OpenAI، لذا تعمل الحزمة القياسية openai: قم بتثبيتها، اضبط عنوان URL الأساسي إلى https://api.mistralapikey.com/v1، مرر مفتاحك واستخدم معرف النموذج uncensored.

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

pip install openai
from openai import OpenAI

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

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a haiku about retries."}],
)
print(r.choices[0].message.content)

ترجمة كود بأسلوب Mistral سطراً بسطر

إذا كان لديك كود مكتوب باستخدام عميل Mistral لـ Python، فإن عملية التعيين قصيرة. تحقق من الأسماء الدقيقة مقابل وثائق العميل الخاصة به للإصدار المثبت لديك، حيث تتغير المكتبات.

عميل على نمط Mistralاستخدام OpenAI SDK مع نقطة النهاية هذه
Mistral(api_key=key)OpenAI(base_url=URL, api_key=key)
client.chat.complete(...)client.chat.completions.create(...)
client.chat.stream(...)client.chat.completions.create(..., stream=True)
model="some-model-name"model="uncensored"
res.choices[0].message.contentr.choices[0].message.content (نفس الشيء)

تبقى الرسائل قائمة من القواميس تحتوي على role و content. شكل الاستجابة للحقول الشائعة، بما في ذلك choices، و usage و finish_reason، هو نفسه أيضاً، لذا فإن الكود الذي يقرأ فقط هذه الحقول لا يحتاج إلى تغيير.

بالمقارنة الجانبية، يبدو التغيير كالتالي:

# before (Mistral-style)
# from mistralai import Mistral
# client = Mistral(api_key=KEY)
# res = client.chat.complete(model="...", messages=msgs)

# after
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralapikey.com/v1", api_key=KEY)
res = client.chat.completions.create(model="uncensored", messages=msgs)
text = res.choices[0].message.content

احتفظ بالمفتاح خارج الكود

اقرأ المفتاح وURL من البيئة، واحتفظ بهما خارج نظام التحكم في الإصدارات.

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ.get("LLM_BASE_URL", "https://api.mistralapikey.com/v1"),
    api_key=os.environ["LLM_API_KEY"],
)

عبر الـ shell: export LLM_API_KEY=.... يقرأ OpenAI SDK أيضًا OPENAI_API_KEY و OPENAI_BASE_URL عندما لا تمررها صراحةً، وهو أمر مفيد للأدوات التي تنشئ العميل لك، ولكنه أيضًا مصدر كلاسيكي لأخطاء "المفتاح الخاطئ" عندما توجد قيمة قديمة في الـ shell. عندما يفشل شيء ما بـ 401، اطبع المتغيرات المحددة قبل أن تفعل أي شيء آخر.

احصل على مفتاح من صفحة مفتاح API. يمكن للحسابات الجديدة المطالبة بـ $0.50 من رصيد تجريبي بنقرة واحدة. لا يحتاج إلى بطاقة، وهو صالح لمدة 7 أيام ومحدود لشخص واحد.

البث المتدفق، JSON والأدوات

يُرجع البث المتدفق الرموز بمجرد إنشائها. اضبط stream=True وقم بالتكرار. تصل بيانات الاستخدام في النهاية.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Explain list comprehensions in 3 sentences."}],
    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 يطلب كائن JSON صالح. اذكر كلمة JSON في الموجّه الخاص بك أيضاً، وقم دائماً بالتحليل الدفاعي.

import json

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Return JSON with keys name and tags for a blog post about retries."}],
    response_format={"type": "json_object"},
)
data = json.loads(r.choices[0].message.content)

استدعاء الدوال يستخدم المعاملين tools و tool_choice. عندما يُرجع النموذج tool_calls، قم بتشغيل الدالة وأرسل النتيجة مرة أخرى كرسالة مع role: "tool" ومع tool_call_id المطابق.

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Weather in Oslo?"}],
    tools=tools,
)
print(r.choices[0].message.tool_calls)

الاستدعاءات غير المتزامنة والمتوازية

للدفعات، استخدم العميل غير المتزامن. احتفظ بعدد الطلبات قيد التنفيذ تحت الحد: المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 في الدقيقة، بينما المفتاح التجريبي يسمح بـ 2 و60.

import asyncio
from openai import AsyncOpenAI

client = AsyncOpenAI(base_url="https://api.mistralapikey.com/v1", api_key="YOUR_KEY")
sem = asyncio.Semaphore(6)

async def one(prompt):
    async with sem:
        r = await client.chat.completions.create(
            model="uncensored",
            messages=[{"role": "user", "content": prompt}],
            max_tokens=200,
        )
        return r.choices[0].message.content

async def main():
    prompts = [f"Give a one-line tip number {i} about Python." for i in range(20)]
    results = await asyncio.gather(*(one(p) for p in prompts))
    print(len(results))

asyncio.run(main())

يسمح السيمافور بقيمة 6 هامشًا تحت 8. بدونه، ستؤدي 20 استدعاءً متزامنًا إلى تلقي خطأ HTTP 429 مع الرمز concurrency. تذكر أن التدفقات تحتفظ بمكانها حتى تنتهي.

المزالق عند الترحيل

تأتي معظم المشاكل من الافتراضات المنقولة من الإعداد القديم بدلاً من نقطة النهاية الجديدة.

  • أسماء النماذج ثابتة في الكود. ابحث في الكود الخاص بك عن سلسلة النموذج القديمة. معرف النموذج الوحيد الصحيح هنا هو uncensored، ويمكنك تأكيد ذلك باستخدام client.models.list().
  • الموجّهات المكتوبة لنموذج آخر. يقرأ النموذج المختلف التعليمات بشكل مختلف قليلاً. إذا كان موجّه النظام يعتمد على صياغة محددة، فاختبره. عادةً ما تنتقل التعليمات القصيرة والمباشرة مع مثال على تنسيق الإخراج بشكل أفضل.
  • معلمات خاصة بمزود الخدمة. يمكن تجاهل المعلمات الموجودة فقط في عميل مورد واحد أو رفضها. التزم بالمعلمات القياسية: temperature و top_p و stop و seed و max_tokens، بينما تُمرر الغرامات كما هي.
  • علامات نمط الوضع الآمن. إذا كان كودك القديم يفعّل خيار الرقابة أو الأمان الخاص بمزود معين، فلا يوجد زر مكافئ هنا. إذا كان منتجك يحتاج إلى تصفية، أضفها من جانبك قبل الاتصال وبعده.
  • تقديرات الرموز. تحسب النماذج المختلفة الرموز بشكل مختلف، لذا قم بتخطيط الميزانية من حقل usage الذي تعيده الواجهة البرمجية، وليس من تخمين محلي.

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

الأخطاء وما تعنيه

  • 401. مفتاح خاطئ أو مفقود، أو مفتاح من خدمة أخرى.
  • 404. عنوان URL الأساسي يفتقد /v1.
  • 429 مع rate_limited. أكثر من الحد لكل دقيقة. انتظر وأبطئ.
  • 429 مع concurrency. عدد كبير جدًا من الطلبات في وقت واحد. قلل من التوازي.
  • 429 مع Retry-After: 5. حمل زائد مؤقت. انتظر خمس ثوانٍ وحاول مرة أخرى.
import time
from openai import RateLimitError

def safe(prompt):
    for _ in range(4):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5)
    return None

احفظ رأس X-Request-Id من المكالمات الفاشلة. الطلبات الفاشلة أو المرفوضة لا تُحسب عليها التكلفة.

التكلفة، الحدود، وما لا يشمله

الفوترة حسب الاستخدام: $0.15 لكل مليون رمز مدخل و $0.50 لكل مليون رمز مخرج، مسبق الدفع، بدون اشتراك وبدون انتهاء. سكريبت يرسل 1,000 طلب من 1,500 رمز مدخل و 400 رمز مخرج يكلف 1.5M x $0.15 = $0.225 بالإضافة إلى 0.4M x $0.50 = $0.20، أي $0.425. عمليات الشحن تبدأ من $20 إلى $500، مع مكافأة من $50، وتفاصيل ذلك مدرجة في صفحة التسعير.

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

أسئلة وأجوبة

هل أحتاج إلى عميل Python الخاص بـ Mistral؟

لا. حزمة openai القياسية تعمل مع عنوان URL الأساسي https://api.mistralapikey.com/v1. استدعاءات نمط Mistral تتطابق مع chat.completions.create.

هل هذه هي واجهة برمجة التطبيقات الرسمية الخاصة بـ Mistral؟

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

كيف أتجنب أخطاء 429 في الدفعات؟

حدد الطلبات المتوازية دون 8 باستخدام semaphor، وتحت 300 طلب في الدقيقة وانتظر بعد استجابة 429.

هل هناك طريقة مجانية للاختبار؟

نعم. بعد التسجيل يمكنك المطالبة بـ $0.50 من رصيد تجريبي في صفحة مفتاح API. لا يتطلب بطاقة وهو صالح لمدة 7 أيام.

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

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