Documentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
Aperçu des commandes
| Command | Description | Auth |
|---|
chat [MESSAGE] | Envoyer un message ou démarrer le REPL interactif | Clé API |
models | Lister et rechercher les modèles disponibles | Clé API |
balance | Afficher le solde du compte | Clé API (ou access token) |
account | Afficher le profil du compte | Access token |
stats | Afficher les statistiques d’utilisation | Access token |
tokens | Lister et rechercher vos clés API | Access token |
logs | Parcourir les journaux d’utilisation avec des filtres | Access token |
tasks | Afficher les journaux des tâches asynchrones | Access token |
init | Assistant de configuration interactif | — |
doctor | Exécuter des diagnostics et des vérifications d’état | Clé API |
config | Gérer la configuration de la CLI | — |
repl | Démarrer un shell de commande interactif | Clé API |
Les commandes marquées Access token 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 seul message ou démarrez le REPL interactif multi-tour.
# Single message (streaming by default)
cometapi chat "Explain quantum computing in one sentence"
# Override model and add a system prompt
cometapi chat "Summarize this" --model claude-sonnet-4-6 --system "Be concise"
# Disable streaming
cometapi chat "Hello" --no-stream
# JSON output (full API response)
cometapi chat "Hello" --json
# Interactive REPL (omit message)
cometapi chat
| Option | Short | Description |
|---|
--model | -m | Modèle à utiliser (par défaut : depuis la configuration) |
--system | -s | Prompt système |
--temperature | -t | Température d’échantillonnage (0.0–2.0) |
--max-tokens | | Nombre maximal de tokens dans la réponse |
--stream/--no-stream | | Activer ou désactiver le Streaming (par défaut : stream) |
--format | -f | Format de sortie |
--json | | Sortie en JSON |
Models
Listez les modèles disponibles avec recherche et limite facultatives.
# List all models
cometapi models
# Search by keyword
cometapi models --search gemini
# Limit results and output as JSON
cometapi models --search gpt --limit 10 --json
| Option | Short | Description |
|---|
--search | -s | Filtrer les modèles par mot-clé |
--limit | -l | Nombre maximal de résultats |
--format | -f | Format de sortie |
--json | | Sortie en JSON |
Balance
Affichez le solde de votre compte CometAPI.
# Default: account-level balance (falls back to per-key billing)
cometapi balance
# Force account-level view
cometapi balance --source account
# Force API key billing view
cometapi balance --source key
# JSON output
cometapi balance --json
| Option | Short | Description |
|---|
--source | -s | Source des données : account (compte complet) ou key (clé API actuelle). |
--format | -f | Format de sortie |
--json | | Sortie en JSON |
Account
Affichez le profil de votre compte. Nécessite un access token.
cometapi account
cometapi account --json
| Option | Short | Description |
|---|
--format | -f | Format de sortie |
--json | | Sortie en JSON |
Stats
Affichez les statistiques d’utilisation du mois en cours. Nécessite un access token.
cometapi stats
cometapi stats --json
La sortie inclut : le nombre de requêtes, le montant d’utilisation, le taux de réussite et le nombre prédit de jours de solde restants.
| Option | Short | Description |
|---|
--format | -f | Format de sortie |
--json | | Sortie en JSON |
Tokens
Listez et recherchez vos clés API. Nécessite un access token.
# List API keys (paginated)
cometapi tokens
# Search by keyword
cometapi tokens --search raycast
# JSON output
cometapi tokens --json
| Option | Short | Description |
|---|
--search | -s | Mot-clé de recherche |
--page | -p | Numéro de page |
--page-size | | Résultats par page |
--format | -f | Format de sortie |
--json | | Sortie en JSON |
Logs
Parcourez les journaux d’utilisation avec des filtres. Nécessite un access token.
# Recent logs
cometapi logs
# Filter by model
cometapi logs --model gpt-5.4
# Filter by date range
cometapi logs --start 2026-04-01 --end 2026-04-14
# Filter by log type
cometapi logs --type consume
# Export as CSV
cometapi logs --export > usage.csv
# JSON output with limit
cometapi logs --limit 50 --json
| Option | Short | Description |
|---|
--model | -m | Filtrer par model ID |
--token-name | | Filtrer par nom de clé API |
--type | -t | Type de journal : consume, topup, error, refund, system, manage |
--start | | Date de début (YYYY-MM-DD) |
--end | | Date de fin (YYYY-MM-DD) |
--group | -g | Filtrer par groupe |
--limit | -l | Nombre maximal d’entrées |
--page | -p | Numéro de page |
--page-size | | Résultats par page |
--export | | Sortie en CSV vers stdout |
--format | -f | Format de sortie |
--json | | Sortie en JSON |
Tasks
Affichez les journaux des tâches asynchrones pour des plateformes telles que Midjourney, Luma et Kling. Nécessite un access token.
# Recent tasks
cometapi tasks
# Filter by platform
cometapi tasks --platform kling
# Filter by status
cometapi tasks --status SUCCESS
# JSON output
cometapi tasks --json
| Option | Short | Description |
|---|
--platform | | Filtrer par nom de plateforme |
--status | | Filtrer par statut |
--limit | -l | Nombre maximal d’entrées |
--format | -f | Format de sortie |
--json | | Sortie en JSON |
Doctor
Exécutez des diagnostics pour vérifier la configuration de la CLI et la connectivité à l’API.
cometapi doctor
cometapi doctor --json
Le doctor vérifie :
- L’existence et la lisibilité du fichier de configuration
- La disponibilité et la source de la clé API (config, env ou manquante)
- La disponibilité de l’access token
- La connectivité réseau vers le endpoint CometAPI
- La validité de l’authentification API
| Option | Short | Description |
|---|
--format | -f | Format de sortie |
--json | | Sortie en JSON |
Config
Gérez la configuration de la CLI stockée dans ~/.config/cometapi/config.toml.
# Show current config
cometapi config show
# Set a value
cometapi config set api_key sk-...
cometapi config set default_model claude-sonnet-4-6
cometapi config set output_format json
# Remove a value
cometapi config unset api_key
# Show config file path
cometapi config path
Consultez le guide de configuration pour toutes les clés disponibles.
Init
Exécutez l’assistant de configuration interactif pour configurer votre clé API et votre access token.
L’assistant écrit les paramètres dans ~/.config/cometapi/config.toml.
Repl
Démarrez un shell de commande interactif complet où vous pouvez exécuter n’importe quelle commande CLI sans le préfixe cometapi.
Toutes les 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 riche dans le terminal (par défaut) |
json | Sortie JSON |
yaml | Sortie YAML |
csv | Valeurs séparées par des virgules |
markdown | Tableau Markdown |
Définissez un format par défaut pour toutes les commandes via la configuration :
cometapi config set output_format json
Complétion shell
Installez la complétion shell pour la prise en charge de la tabulation :
cometapi --install-completion
Shells pris en charge : Bash, Zsh, Fish.
Codes de sortie
| Code | Signification |
|---|
0 | Succès |
1 | Erreur générale |
2 | Arguments invalides |
64 | Configuration manquante |
69 | Service indisponible |
77 | Erreur d’authentification |