Vai al contenuto principale
Il CometAPI CLI è uno strumento ufficiale a riga di comando per interagire con la piattaforma CometAPI. Supporta chat multi-model (streaming e REPL), ricerca dei modelli, query su saldo e utilizzo, consultazione dei log e gestione dell’account — tutto dal terminale. Parti dalla pagina del pacchetto PyPI se vuoi trovare in un unico posto l’ultimo comando di installazione, i metadati del pacchetto e la versione di rilascio.
Il CometAPI CLI è in beta. Aspettati piccoli cambiamenti nei comandi e nella UX mentre l’interfaccia della CLI si stabilizza.

​
Funzionalità

  • Chat multi-model con streaming e REPL interattivo
  • Ricerca ed elenco dei modelli
  • Saldo dell’account e statistiche di utilizzo
  • Consultazione dei log di utilizzo con filtri ed esportazione CSV
  • Log delle attività asincrone (Suno, Midjourney, Kling e altri)
  • Output in più formati: table, JSON, YAML, CSV, Markdown
  • Configurazione basata su TOML con procedura guidata di setup
  • Completamento della shell per Bash, Zsh e Fish
  • Design pensato per agent con output JSON strutturato e codici di uscita deterministici

​
Prerequisiti

​
Installazione

Usa la pagina del pacchetto PyPI come riferimento principale per l’installazione, poi scegli uno dei seguenti metodi per installare la CLI: 
pip install cometapi-cli
Verifica l’installazione: 
cometapi --version

​
Avvio rapido

1

Esegui la procedura guidata di setup

La procedura guidata interattiva salva la tua chiave API e il token di accesso opzionale in un file di configurazione locale:
cometapi init
La procedura guidata richiede:
2

Chatta con un modello

Invia un singolo messaggio con output in streaming:
cometapi chat "Explain quantum computing in one sentence"
Sovrascrivi il modello predefinito:
cometapi chat "Hello!" --model claude-sonnet-4-6
3

Cerca i modelli disponibili

Elenca i modelli che corrispondono a una parola chiave:
cometapi models --search gemini --limit 10
4

Controlla il tuo saldo

Visualizza il saldo del tuo account:
cometapi balance
Mostra la vista di fatturazione della chiave API corrente:
cometapi balance --source key
5

Esegui la diagnostica

Verifica che la CLI possa connettersi a CometAPI:
cometapi doctor

​
Sessione di chat interattiva

Esegui cometapi chat senza argomenti per entrare nel REPL di chat multi-turno: 
cometapi chat
Comandi REPL:
CommandDescription
/modelCambia il modello attivo
/systemImposta o modifica il prompt di sistema
/clearCancella la cronologia della conversazione
/historyMostra la cronologia della conversazione
/saveSalva la conversazione in un file
/tokensMostra l’utilizzo dei token per la sessione
/helpElenca tutti i comandi REPL
/exitEsci dal REPL

​
Integrazione con agent

La CLI è progettata per l’uso da parte di agent di coding AI e script di automazione:
  • Tutti i comandi relativi ai dati supportano --json per un output strutturato e leggibile dalle macchine
  • Codici di uscita deterministici: 0 (successo), 64 (configurazione mancante), 77 (errore di autenticazione), 69 (servizio non disponibile)
  • Gli errori vengono inviati a stderr, i dati a stdout
  • Consulta il riferimento completo dei comandi per le opzioni disponibili per ciascun comando