المستوى المجاني لواجهة برمجة تطبيقات Mistral: الحدود وبديل مسبق الدفع

ما يمكن توقعه من الطبقة المجانية لواجهة برمجة التطبيقات (API) الخاصة بـ Mistral

يبحث معظم الأشخاص عن الطبقة المجانية لواجهة برمجة التطبيقات (API) الخاصة بـ Mistral لمعرفة ثلاثة أشياء: عدد الطلبات الممنوحة، النماذج المشمولة، وما يحدث عندما تتجاوز حدودها. تقرر Mistral هذه الأمور الثلاثة، والأرقام قابلة للتعديل، لذا فإن أي رقم يُنسخ إلى مقال مثل هذا سيصبح قديماً بسرعة. افتح وثائقها وصفحات الفواتير واقرأ الحدود الحالية مباشرة.

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

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

قائمة مراجعة لقراءة شروط أي طبقة مجانية

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

1. ما هو حدّ الطلب؟ ابحث عن الطلبات في الدقيقة، الرموز في الدقيقة وأي حد شهري، كأرقام منفصلة.
2. ما هي النماذج المشمولة؟ قد ينطبق الوصول المجاني على بعض النماذج فقط.
3. هل يمكن استخدام البيانات للتدريب؟ يأتي الاستخدام المجاني في بعض الخدمات بشروط بيانات مختلفة عن الاستخدام المدفوع. اقرأ قسم الخصوصية، وليس قسم التسعير.
4. هل يُسمح بالاستخدام التجاري؟ بعض الخطط المجانية للتقييم فقط.
5. ما هو مسار الترقية؟ اكتشف تكلفة الحساب المدفوع وما إذا كانت الحدود ترتفع على الفور.
6. ما هي قواعد المحتوى؟ إذا كان استخدامك يتعلق بالخيال، أو لعب الأدوار، أو الكتابة الموجهة للبالغين والتي تكون قانونية، تحقق من كيفية تعامل النموذج معها قبل استثمار الوقت في الموجّهات.

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

التجربة هنا، بالأرقام

هذه واجهة برمجة التطبيقات (API) مستقلة عن Mistral وتقدم تجربة صغيرة بدلاً من طبقة مجانية دائمة. يسجل المستخدمون الجدد الدخول باستخدام Google أو عبر البريد الإلكتروني وكلمة المرور، ثم ينقرون مرة واحدة على صفحة مفتاح API للاستحواذ على رصيد بقيمة $0.50. لا توجد خطوة لإدخال بطاقة. الصلاحية لمدة 7 أيام ومحدودة لشخص واحد.

يعمل مفتاح التجربة تحت حدود أقل من المفتاح الممول: طلبين متزامنين و60 طلباً في الدقيقة. هذا كافٍ جداً لاختبار نص برمجي، أو عميل دردشة على غرار SillyTavern، أو مهمة دفعية صغيرة، لكنه غير كافٍ لتطبيق عام.

ما الذي يشتريه $0.50

أسعار الرموز هي $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج. بعض الميزانيات الواقعية:

• مدخلات فقط، بدون مخرجات: $0.50 / $0.15 لكل مليون هي حوالي 3.33 مليون رمز من الموجّه.
• مخرجات فقط: $0.50 / $0.50 لكل مليون هي بالضبط 1 مليون رمز من النص المولد.
• طلب صغير نموذجي بحجم 1000 رمز مدخل و300 مخرج يكلف 0.00015 + 0.00015 = $0.0003. لذا فإن $0.50 تغطي حوالي 1666 منها.
• طلب مستند طويل بحجم 20000 رمز مدخل و1000 مخرج يكلف 0.003 + 0.0005 = $0.0035، لذا حوالي 142 منها.

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

الانتقال من التجربة إلى الإنتاج

عندما يعمل الاختبار التجريبي، فإن الخطوة التالية هي شحن رصيد مسبق الدفع بمبلغ صحيح من $20 إلى $500. لا توجد اشتراكات ولا ينتهي الرصيد، لذا فإن شحن الحد الأدنى وتركه دون لمس لمدة شهر لا يكلف أي شيء إضافي. المبالغ الأكبر تضيف مكافأة: +5% من $50، +10% من $100، +15% من $200. لذلك، يمنحك شحن $200 رصيدًا بقيمة $230.

يرفع المفتاح الممول الحدود إلى 8 طلبات متزامنة و300 طلب في الدقيقة. بالنسبة لحجم الطلبات الصغيرة المذكورة أعلاه ($0.0003 لكل طلب)، يغطي شحن $20 حوالي 66,000 طلب: 20 / 0.0003 يساوي 66,666. للاطلاع على بطاقة الأسعار الكاملة، انظر إلى صفحة الأسعار.

الدفع يتم بالعملات المشفرة فقط (USDT على TRC20، USDC على Base). لا تقبل البطاقات.

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

الكود: تشغيل التجربة ومراقبة الرصيد

تتبع واجهة برمجة التطبيقات تنسيق دردشة OpenAI، لذا فإن مكتبة SDK الحالية الخاصة بك تعمل مع عنوان URL أساسي ومفتاح جديد. يرسل هذا النص طلبًا واحدًا، ويطبع الإجابة ويقرأ الرصيد المتبقي من رأس X-Balance-USD.

Copyfrom openai import OpenAI

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

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a fantasy tavern."}],
    max_tokens=200,
)
resp = raw.parse()

print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)
print("balance left: $", raw.headers.get("X-Balance-USD"))

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

Copycurl -i https://api.mistralapi.com/v1/chat/completions   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello."}],"max_tokens":20}'

يطبع العلم -i عناوين الاستجابة، بما في ذلك X-Request-Id، X-Balance-USD وعنواني X-RateLimit-Limit. احتفظ بمعرف الطلب إذا تواصلت مع الدعم.

التعامل مع حدود المعدل دون فقدان الطلبات

الحدود موجودة في كل الخطط، المجانية والمدفوعة، لذا اكتب منطق إعادة المحاولة مرة واحدة. يجيب هذا الـ API بـ HTTP 429 في ثلاث حالات. رمز الخطأ rate_limited يعني تجاوزت طلبات في الدقيقة. الرمز concurrency يعني وجود طلبات كثيرة قيد التنفيذ في آن واحد. 429 مع رأس Retry-After: 5 يعني حمل زائد مؤقت. في جميع الحالات الثلاث، الاستجابة الصحيحة هي الانتظار وإعادة إرسال الطلب.

Copyimport time
from openai import OpenAI, RateLimitError

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

def ask(prompt, tries=5):
    for attempt in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (attempt + 1))
    raise RuntimeError("still rate limited after retries")

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

خطة تقييم واقعية للتجربة

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

1. جمع 100 إلى 200 موجّه حقيقي. استخدم رسائل المستخدمين الفعلية، أو تذاكر الدعم، أو بدايات القصص من مشروعك، وليس أمثلة مخترعة. قم بتضمين تلك المحرجة التي قد يرفضها نموذج آخر.
2. تشغيلها مرة واحدة بإعدادات ثابتة. استخدم درجة حرارة منخفضة حتى تكون تقيّم النموذج بدلاً من النرد.
3. قراءة عينة يدوياً. عشرين ردًا كافية لاكتشاف نمط. لاحظ أياً منها لن ترسله.
4. قياس الرموز. احسب متوسط عددي الموجّه والإكمال من usage.
5. توقع الفاتورة الشهرية. اضرب تكلفة الطلب الواحد في الحجم المتوقع لديك.

للقياس: تستخدم 200 موجّه بـ 800 رمز إدخال و400 رمز إخراج 160,000 رمز إدخال ($0.024) و80,000 رمز إخراج ($0.04)، لذا فإن دورة كاملة واحدة تكلف $0.064. يمكنك تشغيل مجموعة الاختبار هذه حوالي سبع مرات داخل تجربة بقيمة $0.50، ونفاذ الصلاحية لمدة 7 أيام نادرًا ما يكون هو الحد. تغيير موجّه النظام بين المراحل هو أرخص ضبط ستقوم به على الإطلاق.

أوقف التجربة مبكراً إذا لم تكن الردود جيدة بما يكفي لمهمتك. لا شيء يتجدد، ولم يتم إدخال أي بطاقة، لذا لا يوجد شيء لإلغائه.

أي مسار يناسبك

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

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

المزيد من الأدلة

• أسعار Mistral AI API مقابل API للدفع حسب الرمز بدون رقابة
• واجهة Mistral البرمجية بدون رقابة: الدفع حسب الرمز