Le CometAPI CLI est en bêta. Attendez-vous à de petits changements de commandes et d’expérience utilisateur pendant que l’interface CLI se stabilise.
Fonctionnalités
- Chat multi-modèle avec streaming et REPL interactif
- Recherche et liste des modèles
- Solde du compte et statistiques d’utilisation
- Consultation des journaux d’utilisation avec filtres et export CSV
- Journaux des tâches asynchrones (Suno, Midjourney, Kling, et autres)
- Sortie multi-format : table, JSON, YAML, CSV, Markdown
- Configuration basée sur TOML avec assistant de configuration
- Auto-complétion shell pour Bash, Zsh et Fish
- Conception adaptée aux agents avec sortie JSON structurée et codes de sortie déterministes
Prérequis
- Python 3.10 ou version ultérieure
- Une clé API CometAPI
Installation
Utilisez la page du package PyPI comme référence principale d’installation, puis choisissez l’une des méthodes suivantes pour installer la CLI :Démarrage rapide
Lancer l’assistant de configuration
L’assistant interactif enregistre votre clé API et votre access token facultatif dans un fichier de configuration local :L’assistant demande :
- API key — requise pour toutes les commandes. Créez-en une dans CometAPI Console → API Keys.
- Access token — facultatif, nécessaire pour les commandes
account,stats,tokens,logsettasks. Générez-en un dans Console → Personal Settings.
Discuter avec un modèle
Envoyez un message unique avec une sortie en streaming :Remplacez le modèle par défaut :
Vérifier votre solde
Affichez le solde de votre compte :Affichez la vue de facturation de la clé API actuelle :
Session de chat interactive
Exécutezcometapi chat sans argument pour entrer dans le REPL de chat multi-tour :
| Command | Description |
|---|---|
/model | Changer le modèle actif |
/system | Définir ou modifier le prompt système |
/clear | Effacer l’historique de la conversation |
/history | Afficher l’historique de la conversation |
/save | Enregistrer la conversation dans un fichier |
/tokens | Afficher l’utilisation des tokens pour la session |
/help | Lister toutes les commandes REPL |
/exit | Quitter le REPL |
Intégration d’agent
La CLI est conçue pour être utilisée par des agents de codage IA et des scripts d’automatisation :- Toutes les commandes de données prennent en charge
--jsonpour une sortie structurée et lisible par machine - Codes de sortie déterministes :
0(succès),64(configuration manquante),77(erreur d’authentification),69(service indisponible) - Les erreurs sont envoyées vers stderr, les données vers stdout
- Consultez la référence complète des commandes pour les options propres à chaque commande