مرجع الأوامر

استخدم cometapi -h أو cometapi <command> -h لفحص الوسائط والخيارات الدقيقة للإصدار المثبّت.

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

Command	Description	Auth
`chat [MESSAGE]`	إرسال رسالة دردشة أو بدء chat REPL	API key
`models`	عرض وتصفية بيانات تعريف فهرس النماذج	API key
`model info <id>`	فحص بيانات التعريف العامة لأحد النماذج	API key
`run [MODEL]`	إرسال طلب واحد عبر صيغ chat أو responses أو anthropic أو gemini	API key
`balance`	عرض رصيد الحساب أو رصيد API key الحالي	API key or access token
`account`	عرض ملف تعريف الحساب	Access token
`stats`	عرض إحصاءات الاستخدام	Access token
`tokens`	عرض API keys والبحث فيها	Access token
`logs`	تصفح سجلات الاستخدام باستخدام عوامل التصفية	Access token
`tasks`	عرض سجلات المهام غير المتزامنة	Access token
`init`	تشغيل معالج الإعداد	None
`doctor`	تشغيل التشخيصات	API key
`config`	إدارة الإعدادات المحلية	None
`repl`	بدء واجهة أوامر تفاعلية	يعتمد على الأمر المستخدم

تتطلب الأوامر المعلَّمة Access token متغير البيئة COMETAPI_ACCESS_TOKEN أو مفتاح الإعداد access_token. راجع دليل الإعدادات للحصول على التفاصيل.

Chat

أرسل رسالة واحدة أو ابدأ chat REPL متعدد الأدوار.

cometapi chat "Explain CometAPI in one sentence."
cometapi chat "Summarize this" --model your-model-id --system "Be concise."
cometapi chat "Hello" --no-stream
cometapi chat "Hello" --json
cometapi chat

Option	Short	Description
`--model`	`-m`	النموذج المراد استخدامه
`--system`	`-s`	System prompt
`--temperature`	`-t`	درجة حرارة أخذ العينات
`--max-tokens`		الحد الأقصى لرموز الاستجابة
`--stream/--no-stream`		تمكين أو تعطيل Streaming
`--format`	`-f`	تنسيق الإخراج
`--json`		الإخراج بصيغة JSON

Models

اعرض النماذج من الفهرس العام بشكل افتراضي. يتضمن إخراج الفهرس model ID، والموفر، ونوع النموذج، والميزات، ونقاط النهاية، والتسعير، وطول السياق، والحد الأقصى لرموز الإكمال.

cometapi models
cometapi models --search gpt --limit 10
cometapi models --provider openai --type chat --limit 10
cometapi models --feature image --endpoint responses --json
cometapi models --refresh
cometapi models --source openai --search gpt

Option	Short	Description
`--search`	`-s`	التصفية حسب ID أو code أو name أو description أو provider
`--provider`		التصفية حسب اسم الموفر أو code
`--type`, `--modality`		التصفية حسب نوع النموذج أو modality
`--feature`, `--capability`		التصفية حسب feature أو capability
`--endpoint`		التصفية حسب اسم نقطة النهاية أو method أو path
`--limit`	`-l`	الحد الأقصى لعدد النتائج
`--source`		استخدم بيانات تعريف `catalog` أو قائمة `openai` المتوافقة مع OpenAI
`--refresh`		تحديث ذاكرة التخزين المؤقت للفهرس لمدة ساعة واحدة
`--no-cache`		تجاوز ذاكرة التخزين المؤقت للفهرس لهذا الأمر
`--format`	`-f`	تنسيق الإخراج
`--json`		الإخراج بصيغة JSON

يتم تخزين ذاكرة التخزين المؤقت للفهرس في ~/.cache/cometapi/models.json.

معلومات النموذج

افحص البيانات الوصفية العامة لنموذج واحد. يحلّ الأمر النموذج عبر الفهرس العام، ثم يحمّل البيانات الوصفية التفصيلية لرمز الفهرس.

cometapi model info your-model-id
cometapi model info your-model-id --json
cometapi model info your-model-id --refresh

الخيار	المختصر	الوصف
`--refresh`		حدّث ذاكرة التخزين المؤقت للفهرس قبل البحث
`--no-cache`		تجاوز ذاكرة التخزين المؤقت للفهرس لهذا الأمر
`--format`	`-f`	تنسيق الإخراج
`--json`		إخراج JSON الخام لتفاصيل النموذج

يتضمن إخراج الجدول المزوّد، ونوع النموذج، والميزات، ونقاط النهاية، والتسعير، وطول السياق، والحد الأقصى لـ Tokens الإكمال، ورابط التوثيق، والنظرة العامة.

التشغيل

أرسل طلبًا واحدًا عبر تنسيق نقطة نهاية محدد. استخدم --input-file لتمرير جسم JSON، وقيم -i key=value المتكررة للاستبدال، و-p/--prompt كاختصار للـ Prompt.

cometapi run your-model-id -p "Write one sentence about CometAPI."
cometapi run your-model-id --endpoint responses -p "Reply with OK only." -i max_output_tokens=32 --json
cometapi run your-model-id --endpoint anthropic -p "Reply with OK only." -i max_tokens=32
cometapi run your-model-id --endpoint gemini -p "Reply with OK only." -i generationConfig.maxOutputTokens=32
cometapi run your-model-id --endpoint responses --input-file body.json -i temperature=0.2 --json

الخيار	المختصر	الوصف
`--endpoint`	`-e`	تنسيق نقطة النهاية: `chat` أو `responses` أو `anthropic` أو `gemini`
`--input-file`		جسم طلب من نوع JSON
`--input`	`-i`	مدخل الطلب بصيغة `key=value`؛ كرره لعدة قيم
`--prompt`	`-p`	اختصار Prompt
`--json`		إخراج استجابة JSON الخام

تعيين نقاط النهاية:

نقطة النهاية	مسار الطلب	المصادقة
`chat`	`POST /v1/chat/completions`	مفتاح API من نوع Bearer
`responses`	`POST /v1/responses`	مفتاح API من نوع Bearer
`anthropic`	`POST /v1/messages`	مفتاح API من نوع `x-api-key` وترويسة إصدار Anthropic
`gemini`	مسار نموذج Gemini Generate Content	مفتاح API من نوع `x-goog-api-key`

ترتيب دمج الجسم هو --input-file، ثم -i key=value المتكرر، ثم اختصار Prompt، ثم MODEL الموضعي. تُحلَّل القيم المضمنة كـ JSON عندما يكون ذلك ممكنًا. تنشئ المفاتيح المنقوطة كائنات متداخلة.

الرصيد

اعرض رصيد حساب CometAPI الخاص بك أو عرض الفوترة الحالي لمفتاح API.

cometapi balance
cometapi balance --source account
cometapi balance --source key
cometapi balance --json

الخيار	المختصر	الوصف
`--source`	`-s`	مصدر البيانات: `account` أو `key`
`--format`	`-f`	تنسيق الإخراج
`--json`		إخراج بصيغة JSON

الحساب

اعرض ملف تعريف حسابك. يتطلب access token.

cometapi account
cometapi account --json

الإحصاءات

اعرض إحصاءات الاستخدام. يتطلب access token.

cometapi stats
cometapi stats --json

Tokens

اعرض مفاتيح API وابحث فيها. يتطلب access token.

cometapi tokens
cometapi tokens --search project
cometapi tokens --json

الخيار	المختصر	الوصف
`--search`	`-s`	كلمة البحث
`--page`	`-p`	رقم الصفحة
`--limit`	`-l`	عدد النتائج في الصفحة
`--format`	`-f`	تنسيق الإخراج
`--json`		إخراج بصيغة JSON

السجلات

تصفّح سجلات الاستخدام باستخدام المرشحات. يتطلب token وصول.

cometapi logs
cometapi logs --model your-model-id
cometapi logs --start 2026-04-01 --end 2026-04-14
cometapi logs --type consume
cometapi logs --export > usage.csv
cometapi logs --limit 50 --json
cometapi logs --request-id 20260617165550885561292gJBlzjtp

الخيار	المختصر	الوصف
`--model`	`-m`	التصفية حسب model ID
`--token-name`	`-t`	التصفية حسب اسم API key
`--type`		نوع السجل
`--search`	`-s`	كلمة البحث
`--start`		تاريخ البدء
`--end`		تاريخ الانتهاء
`--group`	`-g`	التصفية حسب مجموعة API key
`--request-id`		البحث عن طلب واحد بواسطة `X-Cometapi-Request-Id`
`--page`	`-p`	رقم الصفحة
`--limit`	`-l`	عدد النتائج لكل صفحة
`--export`		إخراج CSV من جهة الخادم إلى stdout
`--format`	`-f`	تنسيق الإخراج
`--json`		الإخراج بصيغة JSON

ينفّذ logs --request-id عملية بحث مفهرسة واحدة على endpoint سجل المشغّل ولا يقبل إلا تطابقًا تامًا مع request_id. لا يقوم CLI بفحص صفحات السجل الاحتياطية، لأن endpoint السجل الذاتي لا يطبّق التصفية باستخدام request_id.

المهام

اعرض سجلات المهام غير المتزامنة. يتطلب token وصول.

cometapi tasks
cometapi tasks --platform kling
cometapi tasks --status SUCCESS
cometapi tasks --json

الخيار	المختصر	الوصف
`--platform`	`-p`	التصفية حسب المنصة
`--task-id`		التصفية حسب task ID
`--status`	`-s`	التصفية حسب الحالة
`--action`	`-a`	التصفية حسب نوع الإجراء
`--start`		تاريخ البدء
`--end`		تاريخ الانتهاء
`--page`		رقم الصفحة
`--limit`	`-l`	عدد النتائج لكل صفحة
`--format`	`-f`	تنسيق الإخراج
`--json`		الإخراج بصيغة JSON

Doctor

شغّل أدوات التشخيص للتحقق من الإعدادات واتصال API.

cometapi doctor
cometapi doctor --json

Config

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

cometapi config show
cometapi config set api_key "$COMETAPI_KEY"
cometapi config set default_model your-model-id
cometapi config unset api_key
cometapi config path

راجع دليل الإعدادات للاطلاع على جميع المفاتيح المتاحة.

Init

شغّل معالج الإعداد التفاعلي:

cometapi init

Repl

ابدأ صدفة أوامر تفاعلية كاملة:

cometapi repl

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

تدعم معظم أوامر البيانات --json أو --format:

cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown

التنسيق	الوصف
`table`	جدول منسّق داخل الطرفية
`json`	إخراج JSON
`yaml`	إخراج YAML
`csv`	قيم مفصولة بفواصل
`markdown`	جدول Markdown

ابدأ هنا

أدلة البدء السريع لواجهات برمجة تطبيقات النماذج

أدلة API الأساسية

المكتبات

الأخطاء

التسعير والفوترة

الدعم

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

Chat

Models

معلومات النموذج

التشغيل

الرصيد

الحساب

الإحصاءات

Tokens

السجلات

المهام

Doctor

Config

Init

Repl

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

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

​Chat

​Models

​معلومات النموذج

​التشغيل

​الرصيد

​الحساب

​الإحصاءات

​Tokens

​السجلات

​المهام

​Doctor

​Config

​Init

​Repl

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

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

Chat

Models

معلومات النموذج

التشغيل

الرصيد

الحساب

الإحصاءات

Tokens

السجلات

المهام

Doctor

Config

Init

Repl

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