كيف أحصل على مفتاح API الخاص بـ Mimo؟

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

هل مفتاح API مجاني؟

المفتاح نفسه مجاني. يحصل المستخدمون الجدد على رصيد تجريب بقيمة $0.50 صالح لمدة 7 أيام، واحد لكل شخص. بعد ذلك تدفع مقابل الرموز من رصيد مسبق الدفع، بدءاً بشحن بقيمة $20.

كم تستمر مدة رصيد التجربة المجاني؟

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

أين أضع المفتاح في الطلب؟

في رأس Authorization، كـ Bearer متبوعاً بالمفتاح. تقوم مكتبات OpenAI بذلك تلقائياً عند تمرير المفتاح كـ api_key.

مفتاح API الخاص بـ Mimo: أنشئ واحدًا وأرسل طلبًا

أنشئ المفتاح في خمس خطوات

للحصول على مفتاح API الخاص بـ Mimo لهذه الخدمة، اتبع هذه الخطوات. لا يحتاج أي شيء هنا إلى بطاقة أو مكالمة هاتفية.

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

الخدمة عبارة عن واجهة برمجة تطبيقات نصية مستضافة ومتوافقة مع OpenAI. تعمل بنموذج مفتوح الأوزان من مزود مستقل، ومُضبط للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. ليست الواجهة الرسمية لأي مورد للنماذج. يعمل مفتاحك مع هذا النموذج الوحيد، الذي يحمل المعرف uncensored، على عنوان URL الأساسي https://api.mimoapi.top/v1.

اختبار المفتاح بطلب واحد

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

export LLM_API_KEY="paste-your-key-here"

curl -i https://api.mimoapi.top/v1/chat/completions \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write one sentence about keys."}],
    "max_tokens": 60
  }'

النتيجة الجيدة هي حالة 200 وجسم JSON يحتوي على مصفوفة choices. تحمل الرؤوس (headers) القيم X-Request-Id، X-Balance-USD، X-RateLimit-Limit-Requests و X-RateLimit-Limit-Concurrency. رأس الرصيد طريقة سريعة لمعرفة تكلفة الطلب: قم بتشغيله مرتين وقارن. إذا كنت تريد فقط تأكيد المفتاح دون إنفاق أي شيء، اتصل بـ GET /v1/models بنفس الرأس.

نفس الطلب في Python، باستخدام حزمة OpenAI الرسمية:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.mimoapi.top/v1",
    api_key=os.environ["LLM_API_KEY"],
)
resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write one sentence about keys."}],
    max_tokens=60,
)
print(resp.choices[0].message.content)

ما يمكن لمفتاح التجربة القيام به وما لا يمكنه القيام به

الفترة التجريبية مخصصة للاختبار، وليس للإنتاج. يسمح المفتاح التجريبي بـ 2 طلب متزامن و 60 طلبًا في الدقيقة، لمدة 7 أيام. يسمح المفتاح الكامل، الذي تحصل عليه بعد إضافة رصيد، بـ 8 طلبات متزامنة و 300 طلب في الدقيقة. يشارك كلاهما نفس النموذج، ونفس نافذة السياق بـ 100,000 رمز، ونفس الميزات: البث المتدفق عبر SSE، استدعاء الدوال، وضع JSON ومعاملات أخذ العينات المعتادة.

إلى أي مدى يصل $0.50؟ بسعر $0.15 لكل مليون رمز مدخل و $0.50 لكل مليون رمز مخرج، فإن الطلب الذي يحتوي على 1,000 رمز مدخل و 300 رمز مخرج يكلف 1,000 × $0.15 / 1,000,000 = $0.00015 للمدخلات بالإضافة إلى 300 × $0.50 / 1,000,000 = $0.00015 للمخرجات، وهو ما مجموعه $0.0003. تغطي الفترة التجريبية حوالي 1,666 طلبًا بهذا الحجم ($0.50 / $0.0003). هذا كافٍ لاختبار الموجّهات (prompts)، وبناء نموذج أولي ومحاولة البث المتدفق أو الأدوات.

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

حافظ على سرية المفتاح

مفتاح API هو كلمة مرور تنفق المال أيضًا. يمكن لأي شخص يملكه تشغيل الطلبات ضد رصيدك. تمنع بعض القواعد معظم التسريبات:

متغيرات البيئة، وليس ملفات المصدر. اقرأ المفتاح باستخدام os.environ أو process.env. بالنسبة للعمل المحلي، ملف .env المدرج في .gitignore يكفي.
من جانب الخادم فقط. لا تستدعِ الـ API من جافا سكريبت المتصفح أو تطبيق الهاتف المحمول، لأن أي شخص يمكنه قراءة المفتاح من الصفحة أو حزمة التطبيق. ضع خادمًا صغيرًا بين واجهة المستخدم والـ API.
مكان واحد لكل مفتاح. احتفظ بالمفتاح في مستودع أسرار واحد وانسخه إلى كل بيئة نشر منه، بحيث تعرف دائمًا مكان وجوده.
لا تضع المفاتيح في الدردشات أو التذاكر أو لقطات الشاشة. عند طلب المساعدة، شارك الـ X-Request-Id من الاستجابة، وليس المفتاح.
استبدل عند الشك. إذا ظننت أن المفتاح قد تعرض للاختراق، أوقف استخدامه واتصل بالدعم الفني لاستبداله.

راقب أيضًا رأس الـ X-Balance-USD. انخفاض الرصيد عندما يكون تطبيقك في وضع الخمول هو العلامة الأولى على أن شخصًا آخر يستخدم مفتاحك.

تجاوز الفترة التجريبية: شحن الرصيد والدفع

عند انتهاء الفترة التجريبية، أضف رصيدًا. يعمل أي مبلغ صحيح يتراوح بين $20 و $500. تُضاف المكافآت تلقائيًا: 5% من $50، و 10% من $100 و 15% من $200. لذا فإن شحن بمبلغ $100 يمنح رصيدًا بقيمة $110، و $200 يمنح $230. يمكنك الدفع بالعملات المشفرة (USDT على TRC20، USDC على Base).

لا توجد اشتراكات. تدفع مقابل كل رمز من رصيدك، ولا ينتهي الرصيد أبدًا، وهو ما يناسب المشاريع ذات حركة المرور غير المنتظمة. قائمة الأسعار الكاملة موجودة في صفحة الأسعار. لا تُستخدم الموجّهات المرسلة عبر الـ API في التدريب.

أول شحن معقول هو $20. بالنسبة لطلب بحجم الدردشة المستخدم سابقًا في هذه الصفحة ($0.0003 لكل طلب)، يغطي ذلك حوالي 66,000 طلب. تحقق من متوسطك الخاص بعد بضعة أيام وعدّل.

استكشاف أخطاء مفتاح لا يعمل

معظم مشاكل المفاتيح لها أسباب بسيطة.

خطأ مصادقة فورًا. فقدت حرفًا أو أُضيف حرف عند النسخ. ابحث عن مسافة بادئة أو لاحقة، أو سطر جديد. تأكد من أن الرأس هو Authorization: Bearer متبوعًا بالمفتاح.
تعمل في curl ولا تعمل في تطبيقك. على الأرجح لا يقرأ التطبيق متغير البيئة. اطبع أول أربعة أحرف من القيمة التي يراها، وليس المفتاح كاملاً.
غير موجود. عنوان URL الأساسي غير صحيح. يجب أن يكون https://api.mimoapi.top/v1، على النطاق الفرعي api. يحتوي دليل البدء السريع على قائمة حسب العميل.
HTTP 429. تعني قيمة concurrency إرسال طلبات متزامنة أكثر من اللازم؛ وتعني rate_limited إرسال طلبات أكثر من الحد المسموح به في الدقيقة. تصل مفاتيح التجربة إلى هذا الحد بسرعة (2 طلب في آن واحد، 60 طلب في الدقيقة). يعني 429 مع Retry-After: 5 حملاً زائداً مؤقتاً؛ انتظر خمس ثوانٍ.
رصيد التجربة مفقود. يُسترد رصيد التجربة بنقرة واحدة في صفحة المفتاح، وهو متاح مرة واحدة لكل شخص. تنتهي صلاحيته بعد 7 أيام.

إذا لم تُحل المشكلة، اجمع قيمة X-Request-Id من الاستجابة الفاشلة وتواصل مع الدعم الفني بها. يتيح هذا المعرف تتبع المشكلة دون إرسال المفتاح.

ما الذي يجب بناؤه أولاً

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

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