Documentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
نظرة عامة على الأوامر
| Command | Description | Auth |
|---|
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 |
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
| Option | Short | Description |
|---|
--model | -m | النموذج المراد استخدامه (الافتراضي: من الإعدادات) |
--system | -s | 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
| Option | Short | Description |
|---|
--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
| Option | Short | Description |
|---|
--source | -s | مصدر البيانات: account (الحساب بالكامل) أو key (مفتاح API الحالي). |
--format | -f | تنسيق الإخراج |
--json | | الإخراج بصيغة JSON |
Account
اعرض ملف حسابك الشخصي. يتطلب access token.
cometapi account
cometapi account --json
| Option | Short | Description |
|---|
--format | -f | تنسيق الإخراج |
--json | | الإخراج بصيغة JSON |
Stats
اعرض إحصاءات الاستخدام للشهر الحالي. يتطلب access token.
cometapi stats
cometapi stats --json
| Option | Short | Description |
|---|
--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
| Option | Short | Description |
|---|
--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
| Option | Short | Description |
|---|
--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
اعرض سجلات المهام غير المتزامنة لمنصات مثل Midjourney و Luma و Kling. يتطلب access token.
# Recent tasks
cometapi tasks
# Filter by platform
cometapi tasks --platform kling
# Filter by status
cometapi tasks --status SUCCESS
# JSON output
cometapi tasks --json
| Option | Short | Description |
|---|
--platform | | التصفية حسب اسم المنصة |
--status | | التصفية حسب الحالة |
--limit | -l | الحد الأقصى لعدد السجلات |
--format | -f | تنسيق الإخراج |
--json | | الإخراج بصيغة JSON |
Doctor
شغّل التشخيصات للتحقق من إعدادات CLI واتصال API.
cometapi doctor
cometapi doctor --json
- وجود ملف الإعدادات وإمكانية قراءته
- توفر مفتاح API ومصدره (الإعدادات أو env أو غير موجود)
- توفر access token
- اتصال الشبكة بنقطة نهاية CometAPI
- صلاحية مصادقة API
| Option | Short | Description |
|---|
--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 الخاصين بك.
يقوم المعالج بكتابة الإعدادات إلى ~/.config/cometapi/config.toml.
Repl
ابدأ واجهة أوامر تفاعلية كاملة حيث يمكنك تشغيل أي أمر CLI بدون البادئة cometapi.
تنسيقات الإخراج
تدعم جميع أوامر البيانات --json أو --format:
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
| Format | Description |
|---|
table | جدول منسق داخل الطرفية (الافتراضي) |
json | إخراج JSON |
yaml | إخراج YAML |
csv | قيم مفصولة بفواصل |
markdown | جدول Markdown |
cometapi config set output_format json
إكمال shell
ثبّت الإكمال التلقائي لـ shell لدعم الإكمال باستخدام Tab:
cometapi --install-completion
رموز الخروج
| Code | Meaning |
|---|
0 | نجاح |
1 | خطأ عام |
2 | وسائط غير صالحة |
64 | الإعدادات مفقودة |
69 | الخدمة غير متاحة |
77 | خطأ في المصادقة |
