CometAPI CLI

CometAPI CLI è lo strumento ufficiale a riga di comando per CometAPI. Ti aiuta a chattare con i modelli, ispezionare il catalogo dei modelli, inviare richieste una tantum, controllare il saldo e consultare l’utilizzo dell’account dal terminale. Usa la pagina del pacchetto PyPI come homepage pubblica per l’installazione e i metadati del pacchetto. Questa documentazione approfondisce gli stessi comandi senza richiedere l’accesso al repository sorgente privato.

Il CometAPI CLI è in beta. I nomi dei comandi e le opzioni possono cambiare mentre l’interfaccia si stabilizza.

Funzionalità

Chattare con i modelli usando output in streaming o una REPL interattiva
Consultare i metadati del catalogo dei modelli, inclusi provider, modality, endpoint, capability, Context Window e pricing fields
Ispezionare un modello con cometapi model info <id>
Inviare una richiesta tramite i formati Chat Completions, Responses, Anthropic Messages o Gemini Generate Content con cometapi run
Controllare saldo, profilo account, statistiche di utilizzo, API keys, log e cronologia dei task asincroni
Esportare dati in formato tabella, JSON, YAML, CSV o Markdown
Archiviare la configurazione locale in ~/.config/cometapi/config.toml

Prerequisiti

Python 3.10 o successivo
Una CometAPI API key

Installa la CLI

Installa il pacchetto da PyPI:

pip install cometapi-cli

pipx install cometapi-cli

uv tool install cometapi-cli

Verifica il comando installato:

cometapi --version
cometapi -h

Inizia a usare la CLI

Configura le credenziali

Esegui la procedura guidata di configurazione:

cometapi init

Puoi anche configurare la API key con una variabile d’ambiente:

export COMETAPI_KEY="your-api-key"

Il valore opzionale COMETAPI_ACCESS_TOKEN è necessario solo per i comandi account, stats, tokens, logs e tasks.

Chatta con un modello

Invia un singolo messaggio di chat:

cometapi chat "Explain CometAPI in one sentence."

Esegui cometapi chat senza un messaggio per avviare la REPL della chat.

Consulta i modelli

Cerca nel catalogo pubblico dei modelli:

cometapi models --search gpt --limit 10

Filtra per metadati del catalogo:

cometapi models --provider openai --type chat --limit 10
cometapi models --feature image --endpoint responses --json

Ispeziona un modello

Mostra i metadati dettagliati di un modello:

cometapi model info your-model-id

Esporta il payload raw dei dettagli:

cometapi model info your-model-id --json

Esegui una richiesta multi-protocollo

Invia una richiesta una tantum tramite l’endpoint chat predefinito:

cometapi run your-model-id -p "Reply with OK only."

Seleziona un altro formato di endpoint quando il corpo della richiesta segue uno schema diverso del provider:

cometapi run your-model-id --endpoint responses -p "Reply with OK only." --json
cometapi run your-model-id --endpoint anthropic -p "Reply with OK only." -i max_tokens=32
cometapi run your-model-id --endpoint gemini -p "Reply with OK only." -i generationConfig.maxOutputTokens=32

Ottieni aiuto sui comandi

Usa -h sul comando principale o su qualsiasi sottocomando per ispezionare le opzioni della versione installata:

cometapi -h
cometapi models -h
cometapi model info -h
cometapi run -h

Comandi principali

Command	Description
`chat [MESSAGE]`	Invia un messaggio di chat o avvia la REPL della chat
`models`	Elenca e filtra i metadati del catalogo dei modelli
`model info <id>`	Ispeziona i metadati pubblici di un modello
`run [MODEL]`	Invia una richiesta tramite i formati chat, responses, anthropic o gemini
`balance`	Mostra il saldo dell’account o della chiave API
`account`	Mostra il profilo dell’account
`stats`	Mostra le statistiche di utilizzo
`tokens`	Elenca e cerca le chiavi API
`logs`	Sfoglia i log di utilizzo ed esporta CSV
`tasks`	Sfoglia i log delle attività asincrone
`init`	Esegue la procedura guidata di configurazione
`doctor`	Esegue la diagnostica della configurazione
`config`	Gestisce la configurazione locale
`repl`	Avvia una shell di comando interattiva

Inizia qui

Guide rapide alle API dei modelli

Guide principali API

Librerie

Errori

Prezzi e fatturazione

Supporto

Funzionalità

Prerequisiti

Installa la CLI

Inizia a usare la CLI

Ottieni aiuto sui comandi

Comandi principali

Link

​Funzionalità

​Prerequisiti

​Installa la CLI

​Inizia a usare la CLI

​Ottieni aiuto sui comandi

​Comandi principali

​Link

Funzionalità

Prerequisiti

Installa la CLI

Inizia a usare la CLI

Ottieni aiuto sui comandi

Comandi principali

Link