Passer au contenu principal
La CLI CometAPI lit les paramètres depuis un fichier de configuration TOML, des variables d’environnement et des options de ligne de commande. Lorsqu’un même paramètre est disponible depuis plusieurs sources, l’ordre de priorité est le suivant : options CLI > fichier de configuration > variables d’environnement > valeurs par défaut

Fichier de configuration

Emplacement : ~/.config/cometapi/config.toml Exécutez l’assistant de configuration pour créer le fichier de configuration de manière interactive :
cometapi init
Ou gérez des paramètres individuels avec la sous-commande config :
# View current configuration
cometapi config show

# Set a value
cometapi config set api_key sk-...

# Remove a value
cometapi config unset api_key

# Show the config file path
cometapi config path

Paramètres disponibles

Clé de configurationVariable d’environnementDescription
api_keyCOMETAPI_KEYAPI key (obligatoire pour toutes les commandes)
access_tokenCOMETAPI_ACCESS_TOKENAccess token pour les commandes au niveau du compte
base_urlCOMETAPI_BASE_URLURL de base de l’API (par défaut : https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELModèle par défaut pour chat (secours : gpt-5.4)
output_formatFormat de sortie par défaut : table, json, yaml, csv ou markdown

Identifiants

La CLI utilise deux types d’identifiants :

API key

Obligatoire pour toutes les commandes. L’API key authentifie les requêtes vers les endpoints de modèles CometAPI. Créez une API key dans CometAPI Console → API Keys. Définissez-la de l’une des manières suivantes :
export COMETAPI_KEY="<COMETAPI_KEY>"

Access token

Optionnel. L’Access token est requis pour les commandes au niveau du compte : account, stats, tokens, logs et tasks. Générez un Access token dans CometAPI Console → Personal Settings. Définissez-le de l’une des manières suivantes :
export COMETAPI_ACCESS_TOKEN="your-access-token"

Sécurité

La CLI applique les pratiques de sécurité suivantes :
  • Les API keys et Access tokens ne sont jamais journalisés ni affichés en entier. Seuls les 4 derniers caractères sont affichés dans la sortie de diagnostic.
  • Le fichier de configuration est créé avec des permissions restrictives (0600) — lisible uniquement par le propriétaire du fichier.
  • Les identifiants ne doivent jamais être validés dans le contrôle de version. Ajoutez le chemin du fichier de configuration à votre .gitignore le cas échéant.
Vous êtes responsable de toute utilisation et de tous les frais engagés avec vos API keys. Gardez vos clés en sécurité et renouvelez-les si vous soupçonnez un accès non autorisé.

Dépannage

ErreurSolution
API key not configuredExécutez cometapi init ou définissez la variable d’environnement COMETAPI_KEY
Connection failedExécutez cometapi doctor pour diagnostiquer la connectivité
Access token not configuredNécessaire uniquement pour account/stats/tokens/logs/tasks. Exécutez cometapi init pour en ajouter un