بدء التشغيل السريع لواجهة برمجة التطبيقات
انتقل من مفتاح API إلى طلبك الأول في دقائق. اتبع الإرشادات خطوة بخطوة لدمج نماذج الذكاء الاصطناعي من Ninja في منتجك - مع أمثلة التعليمات البرمجية ومجموعات SDK وكل ما تحتاجه لبدء البناء.
التسجيل
قم بالتسجيل في النينجا الخارق لبدء استخدام واجهات برمجة التطبيقات الخاصة بنا.
يمكنك التسجيل مجانًا أو الاشتراك في إحدى خطط Ninja المدفوعة. تمنحك Ultra and Business حدًا أعلى من الوصول إلى الملعب لتجربة برامج LLMs الرائدة والمنطقية والبحثية العميقة،
عندما تكون مستعدًا للانتقال من الاستكشاف إلى التنفيذ، قم بشراء أرصدة لبدء إنشاء منتجات وتجارب الذكاء الاصطناعي للترميز والكتابة وغير ذلك الكثير.
قروض الشراء
قم بالتسجيل أو تسجيل الدخول على النينجا الخارق
انتقل إلى إعدادات وانقر تمكين في قسم «حسب الطلب»
اختر المبلغ الذي تريده (الحد الأدنى للشراء هو 50 دولارًا أمريكيًا)
انقر التأكيد والدفع
أرصدتك في حسابك على الفور وجاهزة للاستخدام.
قم بإنشاء مفتاح API
بعد شراء ائتماناتك، انتقل إلى «إدارة مفاتيح API الخاصة بك» القسم الخاص بـ صفحة مفاتيح API والائتمانات.
انقر فوق «إنشاء مفتاح جديد» زر.
في «الاسم» الحقل، أدخل اسمًا لمفتاحك (على سبيل المثال، مفتاح الإنتاج) ثم انقر «إنشاء مفتاح».
بمجرد إنشاء مفتاحك، انسخها واحفظه في مكان آمن، حيث يمكن لأي شخص لديه حق الوصول استخدامه. إذا لزم الأمر، يمكنك تجدد مفتاح جديد.
استخدام واجهات برمجة تطبيقات النينجا
نظرة عامة
عنوان URL الأساسي:
https://api.myninja.ai/v1
المصادقة:
تتطلب جميع الطلبات مفتاح API الذي تم تمريره في العنوان كما يلي <token-key>أين رمز المصادقة الخاص بك:
التفويض: حامل <token-key>
نقطة النهاية:
بريد /الدردشة/الإكمالات
تقبل نقطة النهاية هذه طلبات الدردشة وتدفق الردود بناءً على النموذج المحدد.
الموديلات:
تشمل النماذج المتوفرة حاليًا:
البحث العميق للنينجا
وكيل النينجا الخارق: توربو
وكيل النينجا الخارق: أبيك
وكيل النينجا الخارق: التفكير
يمكن اختيار هذه النماذج من خلال توفير نموذج المعلمة في نص الطلب الخاص بك.
صيغة الطلب
تتبع واجهة برمجة تطبيقات النينجا مواصفات واجهة برمجة تطبيقات OpenAI عن كثب. يحتوي كائن JSON للطلب على:
نموذج (سلسلة):
معرف النموذج المراد استخدامه (على سبيل المثال، «البحث العميق للنينجا»).
الرسائل (المصفوفة):
مجموعة من كائنات الرسائل. يتبع كل كائن التنسيق:
تيار (منطقي):
عند الضبط على صحيح، تستجيب واجهة برمجة التطبيقات باستجابة متدفقة.
خيارات التدفق (الكائن):
خيارات إضافية للبث، مثل «include_usage»: صحيح لتضمين تفاصيل استخدام الرمز المميز.
رؤوس إضافية (كائن):
أي عناوين إضافية تتطلبها Ninja API (لا شيء في هذه المرحلة)
مثال الطلب (جسون)
الاستجابة
تقوم واجهة برمجة التطبيقات بإرجاع دفق من مقطع إكمال الدردشة الكائنات. قد تحتوي كل قطعة على:
المحتوى:
نص الإكمال، والذي قد يتضمن خطوات منطقية مغلفة بـ XML.
اقتباسات:
قائمة بعناوين URL التي تدعم المنطق المقدم.
معلومات الاستخدام:
إحصائيات استخدام الرمز المميز إذا «include_usage»: صحيح تم تحديده.
يمكن لرمز العميل معالجة هذه الأجزاء لعرض استجابة غنية تتضمن:
خطوات التفكير: تم استخراجه وتنسيقه من مقاطع XML.
اقتباسات: يتم عرضها كقائمة مرقمة.
إحصائيات الاستخدام: عرض رموز الإدخال والإخراج.
أمثلة التعليمات البرمجية النموذجية
التسعير
الوضع
سعر الإدخال/ لكل رموز M
سعر الإخراج/ لكل رموز M
السعر/ مهمة
كوين 3 كودر 480B (المخ)
—
—
1.50 دولار
الوضع القياسي
—
—
1.00 دولار
الوضع المعقد
—
—
1.50 دولار
الوضع السريع
—
—
1.50 دولار
الوضع
سعر الإدخال/ لكل رموز M
سعر الإخراج/ لكل رموز M
السعر/ مهمة
كوين 3 كودر 480B (المخ)
3.75 دولار
3.75 دولار
—
الوضع القياسي
1.50 دولار
1.50 دولار
—
الوضع المعقد
4.50 دولار
22.50 دولارًا
—
الوضع السريع
3.75 دولار
3.75 دولار
—
نموذج
سعر الإدخال/ لكل رموز M
سعر الإخراج/ لكل رموز M
توربو 1.0
0.11 دولار
0.42 دولار
أبيX 1.0
0.88 دولار
7.00 دولار
المنطق 2.0
0.38 دولار
1.53 دولار
ديب ريسيرش 2.0
1.40 دولار
5.60 دولار
حدود الأسعار
يفرض Ninja AI قيودًا على معدلات طلبات الاستدلال لكل نموذج لضمان قدرة المطورين على تجربة الاستدلال الأسرع.
نموذج
طلب لكل دقيقة (دورة في الدقيقة)
توربو 1.0
50
أبيX 1.0
20
المنطق 2.0
30
ديب ريسيرش 2.0
5
Describe the task. Ninja turns it into an app that runs step by step for you. No credit card required.

FAQ
Frequently Asked Questions
Everything you need to know about Ninja API.
How can I increase my auto-pay thresholds and amount?
How can I cancel my auto-payment agreement?
How do I delete an API key?
How can I view the usage of each API request?