Vai al contenuto principale
La CometAPI CLI è uno strumento ufficiale a riga di comando per interagire con la piattaforma CometAPI. Supporta chat multi-modello (Streaming e REPL), ricerca dei modelli, query su saldo e utilizzo, consultazione dei log e gestione dell’account, il tutto dal terminale. Inizia dalla pagina del pacchetto PyPI se vuoi avere in un unico posto l’ultimo comando di installazione, i metadati del pacchetto e la versione di rilascio.
La CometAPI CLI è in beta. Sono previste piccole modifiche ai comandi e alla UX mentre l’interfaccia della CLI si stabilizza.

​
Funzionalità

  • Chat multi-modello con Streaming e REPL interattiva
  • Ricerca e 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: tabella, JSON, YAML, CSV, Markdown
  • Configurazione basata su TOML con procedura guidata di setup
  • Completamento della shell per Bash, Zsh e Fish
  • Design adatto agli agenti con output JSON strutturato e codici di uscita deterministici

​
Prerequisiti

​
Installazione

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

​
Guida rapida

1

Esegui la procedura guidata di setup

La procedura guidata interattiva memorizza la tua chiave API e l’eventuale access token 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 nella REPL di chat multi-turno: 
cometapi chat
Comandi della REPL:
CommandDescription
/modelCambia il modello attivo
/systemImposta o modifica il system prompt
/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 della REPL
/exitEsci dalla REPL

​
Integrazione con agenti

La CLI è progettata per l’uso da parte di agenti 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 specifiche di ciascun comando