> ## 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.

# مرجع الأوامر

> مرجع لأوامر CometAPI CLI، بما في ذلك chat وmodels وmodel info وrun وbalance وaccount وstats وtokens وlogs وtasks وdoctor وconfig وrepl.

استخدم `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`. راجع [دليل الإعدادات](/ar/libraries/cli/configuration) للحصول على التفاصيل.

## Chat

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

```bash theme={null}
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، والموفر، ونوع النموذج، والميزات، ونقاط النهاية، والتسعير، وطول السياق، والحد الأقصى لرموز الإكمال.

```bash theme={null}
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`.

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

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

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
cometapi balance
cometapi balance --source account
cometapi balance --source key
cometapi balance --json
```

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

## الحساب

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

```bash theme={null}
cometapi account
cometapi account --json
```

## الإحصاءات

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

```bash theme={null}
cometapi stats
cometapi stats --json
```

## Tokens

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

```bash theme={null}
cometapi tokens
cometapi tokens --search project
cometapi tokens --json
```

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

## السجلات

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

```bash theme={null}
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 وصول.

```bash theme={null}
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.

```bash theme={null}
cometapi doctor
cometapi doctor --json
```

## Config

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

```bash theme={null}
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
```

راجع [دليل الإعدادات](/ar/libraries/cli/configuration) للاطلاع على جميع المفاتيح المتاحة.

## Init

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

```bash theme={null}
cometapi init
```

## Repl

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

```bash theme={null}
cometapi repl
```

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

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

```bash theme={null}
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
```

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