بدء التشغيل السريع لواجهة برمجة التطبيقات
ابدأ باستخدام واجهات برمجة تطبيقات Ninja وقم بتشغيل منتجات الذكاء الاصطناعي الخاصة بك بسرعة وقابلية تطوير وموثوقية لا مثيل لها.
التسجيل
قم بالتسجيل في النينجا الخارق لبدء استخدام واجهات برمجة التطبيقات الخاصة بنا.
يمكنك التسجيل مجانًا أو الاشتراك في فئة Ultra أو Business. تمنحك Ultra and Business وصولاً غير محدود إلى الملعب لتجربة برامج LLM الرائدة والمنطقية والبحثية العميقة*.
عندما تكون مستعدًا للانتقال من الاستكشاف إلى التنفيذ، قم بشراء أرصدة لبدء إنشاء منتجات وتجارب الذكاء الاصطناعي للترميز والكتابة وغير ذلك الكثير.
* تخضع لعتبات إساءة الاستخدام
قروض الشراء
بعد الاشتراك في النينجا الخارق، انتقل إلى اللوحة اليسرى وانقر على رمز API.

ثم انتقل إلى «الاشتراك والائتمانات».

تحت «ائتماناتك» انقر «قروض الشراء».

في «مبلغ الدفع التلقائي» الحقل، أدخل المبلغ الذي ترغب في شرائه للحصول على ائتمانات (الحد الأدنى 30 دولارًا).

في «حد الدفع التلقائي» في الحقل، حدد الحد الأدنى للمبلغ الذي عندما ينخفض رصيدك عن هذا المبلغ سنقوم بإعادة تحميل «مبلغ الدفع التلقائي». هذا يضمن عدم نفاد الاعتمادات أو توقف مفتاح API الخاص بك عن العمل (25 دولارًا كحد أدنى).

حدد طريقة الدفع المفضلة لديك وانقر «التأكيد والدفع». ستتم إعادة توجيهك بعد ذلك إلى شاشة فواتير Stripe لإكمال الدفع.

قم بإنشاء مفتاح 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
أسئلة متكررة
إليك ما تحتاج إلى معرفته حول واجهة برمجة تطبيقات Ninja استنادًا إلى أكثر ما يُطلب منا.
كيف يمكنني زيادة حد الدفع التلقائي والمبلغ؟
في Ninja، انتقل إلى اللوحة اليسرى وانقر على رمز إدارة API.
تحت «ائتماناتك» انقر «إدارة الاعتمادات».
في «مبلغ الدفع التلقائي» الحقل، أدخل المبلغ الذي ترغب في زيادته للائتمانات (الحد الأدنى 30 دولارًا).
في «حد الدفع التلقائي» في الحقل، قم بتحرير الحد الأدنى للمبلغ الذي عندما ينخفض رصيدك إلى أقل من هذا المبلغ، سنقوم بإعادة تحميل «مبلغ الدفع التلقائي». هذا يضمن عدم نفاد الاعتمادات أو توقف مفتاح API الخاص بك عن العمل (بحد أدنى 25 دولارًا).
انقر «حفظ التغييرات» للتأكيد.
كيف يمكنني إلغاء اتفاقية الدفع التلقائي الخاصة بي؟
في Ninja، انتقل إلى اللوحة اليسرى وانقر على رمز إدارة API.
حدد «مفاتيح API والاعتمادات» ثم انتقل إلى «ائتماناتك» قسم.
تحت «ائتماناتك» انقر «المزيد من الخيارات».
حدد «إلغاء الدفع التلقائي للائتمانات»(الحد الأدنى 30 دولارًا).
انقر «حذف الدفع التلقائي» للتأكيد.
كيف أحذف مفتاح API؟
في Ninja، انتقل إلى اللوحة اليسرى وانقر على رمز إدارة API.
حدد «مفاتيح API والاعتمادات،» ثم انتقل إلى «مفاتيح API».
ابحث عن مفتاح API الخاص بك وحدد رمز سلة المهملات على اليمين.
انقر «حذف مفتاح API» للتأكيد.
كيف يمكنني عرض استخدام كل طلب API؟
في Ninja، انتقل إلى اللوحة اليسرى وانقر على رمز إدارة API.
ثم انقر «استخدام واجهة برمجة التطبيقات».
على «استخدام واجهة برمجة التطبيقات» في الصفحة، سترى جدولًا يعرض التفاصيل التالية لكل واجهة برمجة تطبيقات:
اسم المفتاح
نموذج
رموز الإدخال والإخراج
تكلفة المدخلات والمخرجات
طابع زمني للطلب
التكلفة الإجمالية