Le CometAPI CLI est en bêta. Attendez-vous à de petites modifications des commandes et de l’expérience utilisateur pendant que l’interface de la CLI se stabilise.
Fonctionnalités
- Chat multi-modèles avec streaming et REPL interactif
- Recherche et liste de modèles
- Solde du compte et statistiques d’utilisation
- Consultation des journaux d’utilisation avec filtres et export CSV
- Journaux de 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
- Complétion de 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 stocke votre clé API et votre jeton d’accès facultatif dans un fichier de configuration local :L’assistant vous demande :
- Clé API — requise pour toutes les commandes. Créez-en une dans CometAPI Console → API Keys.
- Jeton d’accès — 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 arguments 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 du 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