الانتقال إلى المحتوى الرئيسي

​
نظرة عامة على الأوامر

CommandDescriptionAuth
chat [MESSAGE]أرسل رسالة أو ابدأ REPL تفاعليمفتاح API
modelsاعرض النماذج المتاحة وابحث فيهامفتاح API
balanceاعرض رصيد الحسابمفتاح API (أو access token)
accountاعرض ملف الحساب الشخصيaccess token
statsاعرض إحصائيات الاستخدامaccess token
tokensاعرض مفاتيح API الخاصة بك وابحث فيهاaccess token
logsتصفح سجلات الاستخدام باستخدام عوامل التصفيةaccess token
tasksاعرض سجلات المهام غير المتزامنةaccess token
initمعالج إعداد تفاعلي—
doctorشغّل التشخيصات وفحوصات السلامةمفتاح API
configأدر إعدادات CLI—
replابدأ shell أوامر تفاعليمفتاح API
الأوامر المعلّمة Access token تتطلب متغير البيئة COMETAPI_ACCESS_TOKEN أو مفتاح الإعداد access_token. راجع دليل الإعداد للتفاصيل.

​
Chat

أرسل رسالة واحدة أو ابدأ REPL التفاعلي متعدد الأدوار. 
# Single message (streaming by default)
cometapi chat "Explain quantum computing in one sentence"

# Override model and add a system prompt
cometapi chat "Summarize this" --model claude-sonnet-4-6 --system "Be concise"

# Disable streaming
cometapi chat "Hello" --no-stream

# JSON output (full API response)
cometapi chat "Hello" --json

# Interactive REPL (omit message)
cometapi chat
OptionShortDescription
--model-mالنموذج المراد استخدامه (الافتراضي: من الإعدادات)
--system-ssystem prompt
--temperature-tدرجة حرارة أخذ العينات (0.0–2.0)
--max-tokensالحد الأقصى لعدد Tokens في الاستجابة
--stream/--no-streamتفعيل أو تعطيل Streaming (الافتراضي: stream)
--format-fتنسيق الإخراج
--jsonالإخراج بصيغة JSON

​
Models

اعرض النماذج المتاحة مع البحث والحد الاختياريين. 
# List all models
cometapi models

# Search by keyword
cometapi models --search gemini

# Limit results and output as JSON
cometapi models --search gpt --limit 10 --json
OptionShortDescription
--search-sتصفية النماذج حسب كلمة مفتاحية
--limit-lالحد الأقصى لعدد النتائج
--format-fتنسيق الإخراج
--jsonالإخراج بصيغة JSON

​
Balance

اعرض رصيد حسابك في CometAPI. 
# Default: account-level balance (falls back to per-key billing)
cometapi balance

# Force account-level view
cometapi balance --source account

# Force API key billing view
cometapi balance --source key

# JSON output
cometapi balance --json
OptionShortDescription
--source-sمصدر البيانات: account (الحساب بالكامل) أو key (مفتاح API الحالي).
--format-fتنسيق الإخراج
--jsonالإخراج بصيغة JSON

​
Account

اعرض ملف حسابك الشخصي. يتطلب access token. 
cometapi account
cometapi account --json
OptionShortDescription
--format-fتنسيق الإخراج
--jsonالإخراج بصيغة JSON

​
Stats

اعرض إحصائيات الاستخدام للشهر الحالي. يتطلب access token. 
cometapi stats
cometapi stats --json
يتضمن الإخراج: عدد الطلبات، ومقدار الاستخدام، ومعدل النجاح، والعدد المتوقع للأيام المتبقية من الرصيد.
OptionShortDescription
--format-fتنسيق الإخراج
--jsonالإخراج بصيغة JSON

​
Tokens

اعرض مفاتيح API الخاصة بك وابحث فيها. يتطلب access token. 
# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json
OptionShortDescription
--search-sكلمة مفتاحية للبحث
--page-pرقم الصفحة
--page-sizeعدد النتائج في كل صفحة
--format-fتنسيق الإخراج
--jsonالإخراج بصيغة JSON

​
Logs

تصفح سجلات الاستخدام باستخدام عوامل التصفية. يتطلب access token. 
# Recent logs
cometapi logs

# Filter by model
cometapi logs --model gpt-5.4

# Filter by date range
cometapi logs --start 2026-04-01 --end 2026-04-14

# Filter by log type
cometapi logs --type consume

# Export as CSV
cometapi logs --export > usage.csv

# JSON output with limit
cometapi logs --limit 50 --json
OptionShortDescription
--model-mالتصفية حسب model ID
--token-nameالتصفية حسب اسم مفتاح API
--type-tنوع السجل: consume، topup، error، refund، system، manage
--startتاريخ البدء (YYYY-MM-DD)
--endتاريخ الانتهاء (YYYY-MM-DD)
--group-gالتصفية حسب المجموعة
--limit-lالحد الأقصى لعدد الإدخالات
--page-pرقم الصفحة
--page-sizeعدد النتائج في كل صفحة
--exportالإخراج بصيغة CSV إلى stdout
--format-fتنسيق الإخراج
--jsonالإخراج بصيغة JSON

​
Tasks

اعرض سجلات المهام غير المتزامنة لمنصات مثل Suno وMidjourney وLuma وKling. يتطلب access token. 
# Recent tasks
cometapi tasks

# Filter by platform
cometapi tasks --platform suno

# Filter by status
cometapi tasks --status SUCCESS

# JSON output
cometapi tasks --json
OptionShortDescription
--platformالتصفية حسب اسم المنصة
--statusالتصفية حسب الحالة
--limit-lالحد الأقصى لعدد الإدخالات
--format-fتنسيق الإخراج
--jsonالإخراج بصيغة JSON

​
Doctor

شغّل أدوات التشخيص للتحقق من إعدادات CLI واتصال API. 
cometapi doctor
cometapi doctor --json
يتحقق doctor من:
  • وجود ملف الإعدادات وإمكانية قراءته
  • توفر مفتاح API ومصدره (الإعدادات أو env أو غير موجود)
  • توفر access token
  • اتصال الشبكة بنقطة نهاية CometAPI
  • صلاحية مصادقة API
OptionShortDescription
--format-fتنسيق الإخراج
--jsonالإخراج بصيغة JSON

​
Config

أدِر إعدادات CLI المخزنة في ~/.config/cometapi/config.toml. 
# Show current config
cometapi config show

# Set a value
cometapi config set api_key sk-...
cometapi config set default_model claude-sonnet-4-6
cometapi config set output_format json

# Remove a value
cometapi config unset api_key

# Show config file path
cometapi config path
راجع دليل الإعدادات للاطلاع على جميع المفاتيح المتاحة.

​
Init

شغّل معالج الإعداد التفاعلي لتهيئة مفتاح API وaccess token. 
cometapi init
يكتب المعالج الإعدادات إلى ~/.config/cometapi/config.toml.

​
Repl

ابدأ صدفة أوامر تفاعلية كاملة حيث يمكنك تشغيل أي أمر CLI بدون البادئة cometapi. 
cometapi repl

​
Output formats

تدعم جميع أوامر البيانات --json أو --format: 
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
FormatDescription
tableجدول منسق داخل الطرفية (الافتراضي)
jsonإخراج JSON
yamlإخراج YAML
csvقيم مفصولة بفواصل
markdownجدول Markdown
اضبط تنسيقًا افتراضيًا لجميع الأوامر عبر config: 
cometapi config set output_format json

​
Shell completion

ثبّت الإكمال التلقائي للصدفة لدعم الإكمال باستخدام Tab: 
cometapi --install-completion
الأصداف المدعومة: Bash وZsh وFish.

​
رموز الخروج

Codeالمعنى
0نجاح
1خطأ عام
2وسيطات غير صالحة
64التكوين مفقود
69الخدمة غير متاحة
77خطأ في المصادقة