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

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

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ابدأ واجهة أوامر تفاعليةمفتاح 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-sPrompt النظام
--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

​
تنسيقات الإخراج

تدعم جميع أوامر البيانات --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
عيّن تنسيقًا افتراضيًا لجميع الأوامر عبر الإعدادات: 
cometapi config set output_format json

​
إكمال shell

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

​
رموز الخروج

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