Référence des commandes

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

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.

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.

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.

cometapi account
cometapi account --json

Statistiques

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

cometapi stats
cometapi stats --json

Tokens

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

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.

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.

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.

cometapi doctor
cometapi doctor --json

Config

Gérez la configuration de la 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 voir toutes les clés disponibles.

Init

Lancez l’assistant de configuration interactif :

cometapi init

Repl

Démarrez 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

Commencez ici

Démarrages rapides de l’API des modèles

Guides de l’API principale

Bibliothèques

Erreurs

Tarification et facturation

Assistance

Vue d’ensemble des commandes

Chat

Models

Informations sur le modèle

Exécuter

Solde

Compte

Statistiques

Tokens

Journaux

Tâches

Doctor

Config

Init

Repl

Formats de sortie

​Vue d’ensemble des commandes

​Chat

​Models

​Informations sur le modèle

​Exécuter

​Solde

​Compte

​Statistiques

​Tokens

​Journaux

​Tâches

​Doctor

​Config

​Init

​Repl

​Formats de sortie

Vue d’ensemble des commandes

Chat

Models

Informations sur le modèle

Exécuter

Solde

Compte

Statistiques

Tokens

Journaux

Tâches

Doctor

Config

Init

Repl

Formats de sortie