الانتقال إلى المحتوى الرئيسي
تُعد CometAPI CLI أداة رسمية لسطر الأوامر للتفاعل مع منصة CometAPI. وهي تدعم الدردشة متعددة النماذج (Streaming وREPL)، والبحث عن النماذج، والاستعلام عن الرصيد والاستخدام، واستعراض السجلات، وإدارة الحساب — وكل ذلك من الطرفية. ابدأ من صفحة حزمة PyPI إذا كنت تريد أحدث أمر تثبيت، وبيانات الحزمة، وإصدار النسخة في مكان واحد.
لا تزال CometAPI CLI في المرحلة التجريبية. توقّع تغييرات صغيرة في الأوامر وتجربة الاستخدام بينما تستقر واجهة CLI.

​
الميزات

  • دردشة متعددة النماذج مع Streaming وREPL تفاعلي
  • البحث عن النماذج وعرضها
  • رصيد الحساب وإحصاءات الاستخدام
  • استعراض سجلات الاستخدام مع عوامل تصفية وتصدير CSV
  • سجلات المهام غير المتزامنة (Suno وMidjourney وKling وغيرها)
  • إخراج متعدد التنسيقات: table وJSON وYAML وCSV وMarkdown
  • إعدادات قائمة على TOML مع معالج إعداد
  • إكمال الأوامر لـ Bash وZsh وFish
  • تصميم مناسب للوكلاء مع إخراج JSON منظّم ورموز خروج حتمية

​
المتطلبات الأساسية

​
التثبيت

استخدم صفحة حزمة PyPI كمرجع التثبيت الأساسي، ثم اختر إحدى الطرق التالية لتثبيت CLI: 
pip install cometapi-cli
تحقق من التثبيت: 
cometapi --version

​
البدء السريع

1

تشغيل معالج الإعداد

يخزّن المعالج التفاعلي مفتاح API ورمز الوصول الاختياري في ملف إعداد محلي:
cometapi init
سيطلب المعالج ما يلي:
2

الدردشة مع نموذج

أرسل رسالة واحدة مع إخراج Streaming:
cometapi chat "Explain quantum computing in one sentence"
تجاوز النموذج الافتراضي:
cometapi chat "Hello!" --model claude-sonnet-4-6
3

البحث في النماذج المتاحة

اعرض النماذج المطابقة لكلمة مفتاحية:
cometapi models --search gemini --limit 10
4

التحقق من رصيدك

اعرض رصيد حسابك:
cometapi balance
اعرض طريقة الفوترة الحالية لمفتاح API:
cometapi balance --source key
5

تشغيل التشخيصات

تحقّق من أن CLI يمكنه الاتصال بـ CometAPI:
cometapi doctor

​
جلسة دردشة تفاعلية

شغّل cometapi chat بدون معاملات للدخول إلى REPL دردشة متعدد الأدوار: 
cometapi chat
أوامر REPL:
الأمرالوصف
/modelتبديل النموذج النشط
/systemتعيين system prompt أو تغييره
/clearمسح سجل المحادثة
/historyعرض سجل المحادثة
/saveحفظ المحادثة في ملف
/tokensعرض استخدام Token للجلسة
/helpعرض جميع أوامر REPL
/exitالخروج من REPL

​
التكامل مع الوكلاء

تم تصميم CLI للاستخدام من قِبل وكلاء البرمجة المعتمدين على AI ونصوص الأتمتة:
  • تدعم جميع أوامر البيانات الخيار --json للحصول على إخراج منظّم قابل للقراءة آليًا
  • رموز خروج حتمية: 0 (نجاح)، 64 (الإعدادات مفقودة)، 77 (خطأ مصادقة)، 69 (الخدمة غير متاحة)
  • تنتقل الأخطاء إلى stderr، وتنتقل البيانات إلى stdout
  • راجع مرجع الأوامر الكامل لمعرفة الخيارات الخاصة بكل أمر

​
الروابط