Référence des commandes - CometAPI Documentation

Utilisez cometapi -h ou cometapi <command> -h pour vérifier 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>`	Examiner 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 jeton d’accès
`account`	Afficher le profil du compte	Jeton d’accès
`stats`	Afficher les statistiques d’utilisation	Jeton d’accès
`tokens`	Lister et rechercher des clés API	Jeton d’accès
`logs`	Parcourir les journaux d’utilisation avec des filtres	Jeton d’accès
`tasks`	Afficher les journaux des tâches asynchrones	Jeton d’accès
`init`	Exécuter l’assistant de configuration	Aucun
`doctor`	Exécuter des 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 Jeton d’accès 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 message unique ou démarrez le REPL de chat multi-tour.

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.

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 `openai` compatible 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.

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

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

Option	Raccourci	Description
`--refresh`		Actualiser le cache du catalogue avant la recherche
`--no-cache`		Contourner 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 du contexte, le nombre maximal de tokens de completion, l’URL de la documentation et un aperçu.

Exécution

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 pour un raccourci de 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

Option	Raccourci	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 sous forme de `key=value` ; répéter pour plusieurs valeurs
`--prompt`	`-p`	Raccourci de prompt
`--json`		Afficher la réponse JSON brute

Correspondance des endpoints :

Endpoint	Chemin de requête	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, les paires -i key=value répétées, le raccourci de prompt, puis le MODEL positionnel. Les valeurs en ligne 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.

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

Option	Raccourci	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.

cometapi account
cometapi account --json

Statistiques

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

cometapi stats
cometapi stats --json

Tokens

Listez et recherchez des clés API. Nécessite un access token.

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

Option	Raccourci	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.

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

Option	Court	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é API
`--page`	`-p`	Numéro de page
`--limit`	`-l`	Résultats par page
`--export`		Sortie CSV côté serveur vers stdout
`--format`	`-f`	Format de sortie
`--json`		Sortie au format JSON

Tâches

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

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

Option	Court	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é API.

cometapi doctor
cometapi doctor --json

Config

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

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

Init

Lance l’assistant de configuration interactif :

cometapi init

Repl

Démarre un shell de commande interactif complet :

cometapi repl

Formats de sortie

La plupart des 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
`json`	Sortie JSON
`yaml`	Sortie YAML
`csv`	Valeurs séparées par des virgules
`markdown`	Tableau Markdown

​Vue d’ensemble des commandes

​Chat

​Models

​Infos sur le modèle

​Exécution

​Solde

​Compte

​Statistiques

​Tokens

​Journaux

​Tâches

​Doctor

​Config

​Init

​Repl

​Formats de sortie