Référence des commandes

Aperçu des commandes

Command	Description	Auth
`chat [MESSAGE]`	Envoyer un message ou démarrer un REPL interactif	Clé API
`models`	Lister et rechercher les modèles disponibles	Clé API
`balance`	Afficher le solde du compte	Clé API (ou access token)
`account`	Afficher le profil du compte	Access token
`stats`	Afficher les statistiques d’utilisation	Access token
`tokens`	Lister et rechercher vos clés API	Access token
`logs`	Parcourir les journaux d’utilisation avec des filtres	Access token
`tasks`	Afficher les journaux des tâches asynchrones	Access token
`init`	Assistant de configuration interactif	—
`doctor`	Exécuter des diagnostics et des vérifications d’état	Clé API
`config`	Gérer la configuration de la CLI	—
`repl`	Démarrer un shell de commande interactif	Clé API

Les commandes marquées Access token nécessitent la variable d’environnement COMETAPI_ACCESS_TOKEN ou la clé de configuration access_token. Consultez le guide de configuration pour plus de détails.

Chat

Envoyez un seul message ou démarrez le REPL interactif multi-tour.

# 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`	Modèle à utiliser (par défaut : depuis la configuration)
`--system`	`-s`	Prompt système
`--temperature`	`-t`	Température d’échantillonnage (0.0–2.0)
`--max-tokens`		Nombre maximal de tokens dans la réponse
`--stream/--no-stream`		Activer ou désactiver le Streaming (par défaut : stream)
`--format`	`-f`	Format de sortie
`--json`		Sortie en JSON

Models

Listez les modèles disponibles avec recherche et limite en option.

# 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`	Filtrer les modèles par mot-clé
`--limit`	`-l`	Nombre maximal de résultats
`--format`	`-f`	Format de sortie
`--json`		Sortie en JSON

Balance

Affichez le solde de votre compte 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`	Source des données : `account` (compte complet) ou `key` (clé API actuelle).
`--format`	`-f`	Format de sortie
`--json`		Sortie en JSON

Account

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

cometapi account
cometapi account --json

Option	Short	Description
`--format`	`-f`	Format de sortie
`--json`		Sortie en JSON

Stats

Affichez les statistiques d’utilisation du mois en cours. Nécessite un access token.

cometapi stats
cometapi stats --json

La sortie inclut : le nombre de requêtes, le montant d’utilisation, le taux de réussite et le nombre de jours restants de solde estimé.

Option	Short	Description
`--format`	`-f`	Format de sortie
`--json`		Sortie en JSON

Tokens

Listez et recherchez vos clés API. Nécessite un 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`	Mot-clé de recherche
`--page`	`-p`	Numéro de page
`--page-size`		Résultats par page
`--format`	`-f`	Format de sortie
`--json`		Sortie au format JSON

Logs

Parcourez les journaux d’utilisation avec des filtres. Nécessite un 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`	Filtrer par model ID
`--token-name`		Filtrer par nom de clé API
`--type`	`-t`	Type de journal : `consume`, `topup`, `error`, `refund`, `system`, `manage`
`--start`		Date de début (YYYY-MM-DD)
`--end`		Date de fin (YYYY-MM-DD)
`--group`	`-g`	Filtrer par groupe
`--limit`	`-l`	Nombre maximal d’entrées
`--page`	`-p`	Numéro de page
`--page-size`		Résultats par page
`--export`		Sortie en CSV vers stdout
`--format`	`-f`	Format de sortie
`--json`		Sortie au format JSON

Tasks

Affichez les journaux des tâches asynchrones pour des plateformes telles que Suno, Midjourney, Luma et Kling. Nécessite un 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

Option	Short	Description
`--platform`		Filtrer par nom de plateforme
`--status`		Filtrer par statut
`--limit`	`-l`	Nombre maximal d’entrées
`--format`	`-f`	Format de sortie
`--json`		Sortie au format JSON

Doctor

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

cometapi doctor
cometapi doctor --json

Le diagnostic vérifie :

L’existence et la lisibilité du fichier de configuration
La disponibilité de la clé API et sa source (config, env ou absente)
La disponibilité de l’access token
La connectivité réseau vers le point de terminaison CometAPI
La validité de l’authentification API

Option	Short	Description
`--format`	`-f`	Format de sortie
`--json`		Sortie au format JSON

Config

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

Consultez le guide de configuration pour connaître toutes les clés disponibles.

Init

Lancez l’assistant de configuration interactif pour configurer votre clé API et votre access token.

cometapi init

L’assistant écrit les paramètres dans ~/.config/cometapi/config.toml.

Repl

Démarrez un shell de commande interactif complet dans lequel vous pouvez exécuter n’importe quelle commande CLI sans le préfixe cometapi.

cometapi repl

Output formats

Toutes les commandes de données prennent en charge --json ou --format :

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

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

Définissez un format par défaut pour toutes les commandes via la configuration :

cometapi config set output_format json

Shell completion

Installez l’autocomplétion du shell pour la prise en charge de la complétion par tabulation :

cometapi --install-completion

Shells pris en charge : Bash, Zsh, Fish.

Codes de sortie

Code	Signification
`0`	Succès
`1`	Erreur générale
`2`	Arguments invalides
`64`	Configuration manquante
`69`	Service indisponible
`77`	Erreur d’authentification

Aperçu

Référence API

Guides d’intégration

Outils pour développeurs

Erreurs

Tarification et facturation

Assistance

Aperçu des commandes

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

Shell completion

Codes de sortie

Aperçu

Référence API

Guides d’intégration

Outils pour développeurs

Erreurs

Tarification et facturation

Assistance

​Aperçu des commandes

​Chat

​Models

​Balance

​Account

​Stats

​Tokens

​Logs

​Tasks

​Doctor

​Config

​Init

​Repl

​Output formats

​Shell completion

​Codes de sortie

Aperçu des commandes

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

Shell completion

Codes de sortie