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

# Référence des commandes

> Référence des commandes CLI de CometAPI, y compris chat, models, model info, run, balance, account, stats, tokens, logs, tasks, doctor, config et repl.

Utilisez `cometapi -h` ou `cometapi <command> -h` pour consulter les arguments et options exacts de la version installée.

## Vue d’ensemble des commandes

| Command           | Description                                                              | Auth                           |
| ----------------- | ------------------------------------------------------------------------ | ------------------------------ |
| `chat [MESSAGE]`  | Envoyer un message de chat ou démarrer le REPL de chat                   | Clé API                        |
| `models`          | Lister et filtrer les métadonnées du catalogue de modèles                | Clé API                        |
| `model info <id>` | Consulter les métadonnées publiques d’un modèle                          | Clé API                        |
| `run [MODEL]`     | Envoyer une requête via les formats chat, responses, anthropic ou gemini | Clé API                        |
| `balance`         | Afficher le solde du compte ou de la clé API actuelle                    | Clé API ou token d’accès       |
| `account`         | Afficher le profil du compte                                             | Token d’accès                  |
| `stats`           | Afficher les statistiques d’utilisation                                  | Token d’accès                  |
| `tokens`          | Lister et rechercher des clés API                                        | Token d’accès                  |
| `logs`            | Parcourir les journaux d’utilisation avec des filtres                    | Token d’accès                  |
| `tasks`           | Afficher les journaux des tâches asynchrones                             | Token d’accès                  |
| `init`            | Exécuter l’assistant de configuration                                    | Aucun                          |
| `doctor`          | Exécuter les diagnostics                                                 | Clé API                        |
| `config`          | Gérer la configuration locale                                            | Aucun                          |
| `repl`            | Démarrer un shell de commande interactif                                 | Dépend de la commande utilisée |

Les commandes marquées **Token d’accès** nécessitent la variable d’environnement `COMETAPI_ACCESS_TOKEN` ou la clé de configuration `access_token`. Consultez le [guide de configuration](/fr/libraries/cli/configuration) pour plus de détails.

## Chat

Envoyez un message unique ou démarrez le REPL de chat multi-tour.

```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`  | Modèle à utiliser                   |
| `--system`             | `-s`  | Prompt système                      |
| `--temperature`        | `-t`  | Température d’échantillonnage       |
| `--max-tokens`         |       | Nombre maximal de Tokens de réponse |
| `--stream/--no-stream` |       | Activer ou désactiver le Streaming  |
| `--format`             | `-f`  | Format de sortie                    |
| `--json`               |       | Sortie au format JSON               |

## Models

Liste les modèles du catalogue public par défaut. La sortie du catalogue inclut le model ID, le fournisseur, le type de modèle, les fonctionnalités, les endpoints, la tarification, la longueur de contexte et le nombre maximal de Tokens de complétion.

```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`  | Filtrer par ID, code, nom, description ou fournisseur                       |
| `--provider`                |       | Filtrer par nom ou code du fournisseur                                      |
| `--type`, `--modality`      |       | Filtrer par type de modèle ou modalité                                      |
| `--feature`, `--capability` |       | Filtrer par fonctionnalité ou capacité                                      |
| `--endpoint`                |       | Filtrer par nom d’endpoint, méthode ou chemin                               |
| `--limit`                   | `-l`  | Nombre maximal de résultats                                                 |
| `--source`                  |       | Utiliser les métadonnées `catalog` ou le listing compatible OpenAI `openai` |
| `--refresh`                 |       | Actualiser le cache du catalogue d’une heure                                |
| `--no-cache`                |       | Ignorer le cache du catalogue pour cette commande                           |
| `--format`                  | `-f`  | Format de sortie                                                            |
| `--json`                    |       | Sortie au format JSON                                                       |

Le cache du catalogue est stocké dans `~/.cache/cometapi/models.json`.

## Informations sur le modèle

Inspectez les métadonnées publiques d’un modèle. La commande résout le modèle via le catalogue public, puis charge les métadonnées détaillées pour le code du catalogue.

```bash theme={null}
cometapi model info your-model-id
cometapi model info your-model-id --json
cometapi model info your-model-id --refresh
```

| Option       | Short | Description                                         |
| ------------ | ----- | --------------------------------------------------- |
| `--refresh`  |       | Actualiser le cache du catalogue avant la recherche |
| `--no-cache` |       | Ignorer le cache du catalogue pour cette commande   |
| `--format`   | `-f`  | Format de sortie                                    |
| `--json`     |       | Afficher le JSON brut des détails du modèle         |

La sortie du tableau inclut le fournisseur, le type de modèle, les fonctionnalités, les endpoints, la tarification, la longueur de contexte, le nombre maximal de completion tokens, l’URL de la documentation et une vue d’ensemble.

## Exécuter

Envoyez une requête via un format d’endpoint sélectionné. Utilisez `--input-file` pour un corps JSON, des valeurs `-i key=value` répétées pour les remplacements, et `-p/--prompt` comme raccourci de 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
```

| Option         | Short | Description                                                              |
| -------------- | ----- | ------------------------------------------------------------------------ |
| `--endpoint`   | `-e`  | Format d’endpoint : `chat`, `responses`, `anthropic` ou `gemini`         |
| `--input-file` |       | Corps de requête sous forme d’objet JSON                                 |
| `--input`      | `-i`  | Entrée de requête au format `key=value` ; répétez pour plusieurs valeurs |
| `--prompt`     | `-p`  | Raccourci de prompt                                                      |
| `--json`       |       | Afficher la réponse JSON brute                                           |

Correspondance des endpoints :

| Endpoint    | Request path                             | Auth                                                |
| ----------- | ---------------------------------------- | --------------------------------------------------- |
| `chat`      | `POST /v1/chat/completions`              | Clé API Bearer                                      |
| `responses` | `POST /v1/responses`                     | Clé API Bearer                                      |
| `anthropic` | `POST /v1/messages`                      | Clé API `x-api-key` et en-tête de version Anthropic |
| `gemini`    | Chemin du modèle Gemini Generate Content | Clé API `x-goog-api-key`                            |

L’ordre de fusion du corps est `--input-file`, `-i key=value` répété, le raccourci de prompt, puis `MODEL` en position. Les valeurs inline sont analysées comme JSON lorsque c’est possible. Les clés avec points créent des objets imbriqués.

## Solde

Affichez le solde de votre compte CometAPI ou la vue de facturation de la clé API actuelle.

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

| Option     | Short | Description                             |
| ---------- | ----- | --------------------------------------- |
| `--source` | `-s`  | Source des données : `account` ou `key` |
| `--format` | `-f`  | Format de sortie                        |
| `--json`   |       | Afficher au format JSON                 |

## Compte

Affichez le profil de votre compte. Nécessite un access token.

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

## Statistiques

Affichez les statistiques d’utilisation. Nécessite un access token.

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

## Tokens

Lister et rechercher des clés API. Nécessite un access token.

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

| Option     | Short | Description             |
| ---------- | ----- | ----------------------- |
| `--search` | `-s`  | Mot-clé de recherche    |
| `--page`   | `-p`  | Numéro de page          |
| `--limit`  | `-l`  | Résultats par page      |
| `--format` | `-f`  | Format de sortie        |
| `--json`   |       | Afficher au format JSON |

## Journaux

Parcourez les journaux d’utilisation avec des filtres. Nécessite un jeton d’accès.

```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
```

| Option         | Short | Description                                        |
| -------------- | ----- | -------------------------------------------------- |
| `--model`      | `-m`  | Filtrer par model ID                               |
| `--token-name` | `-t`  | Filtrer par nom de clé API                         |
| `--type`       |       | Type de journal                                    |
| `--search`     | `-s`  | Mot-clé de recherche                               |
| `--start`      |       | Date de début                                      |
| `--end`        |       | Date de fin                                        |
| `--group`      | `-g`  | Filtrer par groupe de clés API                     |
| `--request-id` |       | Rechercher une requête par `X-Cometapi-Request-Id` |
| `--page`       | `-p`  | Numéro de page                                     |
| `--limit`      | `-l`  | Résultats par page                                 |
| `--export`     |       | Exporter le CSV côté serveur vers stdout           |
| `--format`     | `-f`  | Format de sortie                                   |
| `--json`       |       | Sortie au format JSON                              |

`logs --request-id` effectue une recherche indexée unique sur le endpoint de journal opérateur et
n’accepte qu’une correspondance exacte de `request_id`. La CLI n’analyse pas les pages de journaux de secours,
car le endpoint self-log n’applique pas de filtrage sur `request_id`.

## Tâches

Affiche les journaux des tâches asynchrones. Nécessite un jeton d’accès.

```bash theme={null}
cometapi tasks
cometapi tasks --platform kling
cometapi tasks --status SUCCESS
cometapi tasks --json
```

| Option       | Short | Description               |
| ------------ | ----- | ------------------------- |
| `--platform` | `-p`  | Filtrer par plateforme    |
| `--task-id`  |       | Filtrer par ID de tâche   |
| `--status`   | `-s`  | Filtrer par statut        |
| `--action`   | `-a`  | Filtrer par type d’action |
| `--start`    |       | Date de début             |
| `--end`      |       | Date de fin               |
| `--page`     |       | Numéro de page            |
| `--limit`    | `-l`  | Résultats par page        |
| `--format`   | `-f`  | Format de sortie          |
| `--json`     |       | Sortie au format JSON     |

## Doctor

Exécute des diagnostics pour vérifier la configuration et la connectivité à l’API.

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

## Config

Gérez la configuration de la CLI stockée dans `~/.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
```

Consultez le [guide de configuration](/fr/libraries/cli/configuration) pour voir toutes les clés disponibles.

## Init

Lancez l’assistant de configuration interactif :

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

## Repl

Démarrez un shell de commande interactif complet :

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

## Formats de sortie

La plupart des commandes de données prennent en charge `--json` ou `--format` :

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

| Format     | Description                       |
| ---------- | --------------------------------- |
| `table`    | Tableau enrichi dans le terminal  |
| `json`     | Sortie JSON                       |
| `yaml`     | Sortie YAML                       |
| `csv`      | Valeurs séparées par des virgules |
| `markdown` | Tableau Markdown                  |
