Vai al contenuto principale

​
Panoramica dei comandi

CommandDescriptionAuth
chat [MESSAGE]Invia un messaggio o avvia la REPL interattivaAPI key
modelsElenca e cerca i modelli disponibiliAPI key
balanceMostra il saldo dell’accountAPI key (o access token)
accountMostra il profilo dell’accountAccess token
statsMostra le statistiche di utilizzoAccess token
tokensElenca e cerca le tue API keyAccess token
logsSfoglia i log di utilizzo con filtriAccess token
tasksMostra i log delle attività asincroneAccess token
initProcedura guidata di configurazione interattiva—
doctorEsegue diagnostica e controlli di integritàAPI key
configGestisce la configurazione della CLI—
replAvvia una shell di comando interattivaAPI key
I comandi contrassegnati con Access token richiedono la variabile d’ambiente COMETAPI_ACCESS_TOKEN o la chiave di configurazione access_token. Consulta la guida alla configurazione per i dettagli.

​
Chat

Invia un singolo messaggio o avvia la REPL interattiva multi-turn. 
# 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
OptionShortDescription
--model-mModello da usare (predefinito: dalla configurazione)
--system-sPrompt di sistema
--temperature-tTemperatura di campionamento (0.0–2.0)
--max-tokensNumero massimo di token nella risposta
--stream/--no-streamAbilita o disabilita lo Streaming (predefinito: stream)
--format-fFormato di output
--jsonOutput come JSON

​
Models

Elenca i modelli disponibili con ricerca e limite opzionali. 
# 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
OptionShortDescription
--search-sFiltra i modelli per parola chiave
--limit-lNumero massimo di risultati
--format-fFormato di output
--jsonOutput come JSON

​
Balance

Mostra il saldo del tuo account 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
OptionShortDescription
--source-sOrigine dei dati: account (intero account) o key (API key corrente).
--format-fFormato di output
--jsonOutput come JSON

​
Account

Mostra il profilo del tuo account. Richiede un access token. 
cometapi account
cometapi account --json
OptionShortDescription
--format-fFormato di output
--jsonOutput come JSON

​
Stats

Mostra le statistiche di utilizzo per il mese corrente. Richiede un access token. 
cometapi stats
cometapi stats --json
L’output include: numero di richieste, quantità di utilizzo, tasso di successo e giorni previsti di saldo rimanente.
OptionShortDescription
--format-fFormato di output
--jsonOutput come JSON

​
Tokens

Elenca e cerca le tue chiavi API. Richiede un token di accesso. 
# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json
OptionShortDescription
--search-sParola chiave di ricerca
--page-pNumero di pagina
--page-sizeRisultati per pagina
--format-fFormato di output
--jsonOutput in JSON

​
Logs

Sfoglia i log di utilizzo con filtri. Richiede un token di accesso. 
# 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
OptionShortDescription
--model-mFiltra per model ID
--token-nameFiltra per nome della chiave API
--type-tTipo di log: consume, topup, error, refund, system, manage
--startData di inizio (YYYY-MM-DD)
--endData di fine (YYYY-MM-DD)
--group-gFiltra per gruppo
--limit-lNumero massimo di voci
--page-pNumero di pagina
--page-sizeRisultati per pagina
--exportOutput come CSV su stdout
--format-fFormato di output
--jsonOutput in JSON

​
Tasks

Mostra i log delle attività asincrone per piattaforme come Suno, Midjourney, Luma e Kling. Richiede un token di accesso. 
# Recent tasks
cometapi tasks

# Filter by platform
cometapi tasks --platform suno

# Filter by status
cometapi tasks --status SUCCESS

# JSON output
cometapi tasks --json
OptionShortDescription
--platformFiltra per nome della piattaforma
--statusFiltra per stato
--limit-lNumero massimo di voci
--format-fFormato di output
--jsonOutput in JSON

​
Doctor

Esegui una diagnostica per verificare la configurazione della CLI e la connettività API. 
cometapi doctor
cometapi doctor --json
Il comando doctor controlla:
  • Esistenza e leggibilità del file di configurazione
  • Disponibilità della chiave API e origine (config, env o mancante)
  • Disponibilità del token di accesso
  • Connettività di rete verso l’endpoint CometAPI
  • Validità dell’autenticazione API
OptionShortDescription
--format-fFormato di output
--jsonOutput in JSON

​
Config

Gestisci la configurazione della CLI memorizzata in ~/.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
Vedi la guida alla configurazione per tutte le chiavi disponibili.

​
Init

Esegui la procedura guidata di configurazione interattiva per configurare la tua chiave API e il token di accesso. 
cometapi init
La procedura guidata scrive le impostazioni in ~/.config/cometapi/config.toml.

​
Repl

Avvia una shell di comando interattiva completa in cui puoi eseguire qualsiasi comando CLI senza il prefisso cometapi. 
cometapi repl

​
Output formats

Tutti i comandi relativi ai dati supportano --json o --format: 
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
FormatDescription
tableTabella avanzata nel terminale (predefinito)
jsonOutput JSON
yamlOutput YAML
csvValori separati da virgole
markdownTabella Markdown
Imposta un formato predefinito per tutti i comandi tramite config: 
cometapi config set output_format json

​
Shell completion

Installa il completamento della shell per il supporto al completamento tramite tabulazione: 
cometapi --install-completion
Shell supportate: Bash, Zsh, Fish.

​
Codici di uscita

CodiceSignificato
0Successo
1Errore generale
2Argomenti non validi
64Configurazione mancante
69Servizio non disponibile
77Errore di autenticazione