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.
Panoramica dei comandi
| Command | Description | Auth |
|---|
chat [MESSAGE] | Invia un messaggio o avvia la REPL interattiva | Chiave API |
models | Elenca e cerca i modelli disponibili | Chiave API |
balance | Mostra il saldo dell’account | Chiave API (o access token) |
account | Mostra il profilo dell’account | Access token |
stats | Mostra le statistiche di utilizzo | Access token |
tokens | Elenca e cerca le tue chiavi API | Access token |
logs | Esplora i log di utilizzo con filtri | Access token |
tasks | Mostra i log delle attività asincrone | Access token |
init | Procedura guidata di configurazione interattiva | — |
doctor | Esegue diagnostica e controlli di integrità | Chiave API |
config | Gestisce la configurazione della CLI | — |
repl | Avvia una shell di comandi interattiva | Chiave API |
COMETAPI_ACCESS_TOKEN oppure la chiave di configurazione access_token. Per i dettagli, consulta la guida alla configurazione.
Chat
Invia un singolo messaggio o avvia la REPL interattiva multi-turno.
# 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 | Modello da usare (predefinito: dalla configurazione) |
--system | -s | Prompt di sistema |
--temperature | -t | Temperatura di campionamento (0.0–2.0) |
--max-tokens | | Numero massimo di token nella risposta |
--stream/--no-stream | | Abilita o disabilita lo Streaming (predefinito: stream) |
--format | -f | Formato di output |
--json | | Output 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
| Option | Short | Description |
|---|
--search | -s | Filtra i modelli per parola chiave |
--limit | -l | Numero massimo di risultati |
--format | -f | Formato di output |
--json | | Output 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
| Option | Short | Description |
|---|
--source | -s | Origine dei dati: account (intero account) oppure key (chiave API corrente). |
--format | -f | Formato di output |
--json | | Output come JSON |
Account
Mostra il profilo del tuo account. Richiede un access token.
cometapi account
cometapi account --json
| Option | Short | Description |
|---|
--format | -f | Formato di output |
--json | | Output come JSON |
Stats
Mostra le statistiche di utilizzo per il mese corrente. Richiede un access token.
cometapi stats
cometapi stats --json
| Option | Short | Description |
|---|
--format | -f | Formato di output |
--json | | Output come JSON |
Tokens
Elenca e cerca le tue chiavi API. Richiede 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 | Parola chiave di ricerca |
--page | -p | Numero di pagina |
--page-size | | Risultati per pagina |
--format | -f | Formato di output |
--json | | Output come JSON |
Logs
Esplora i log di utilizzo con filtri. Richiede 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 | Filtra per model ID |
--token-name | | Filtra per nome della chiave API |
--type | -t | Tipo di log: consume, topup, error, refund, system, manage |
--start | | Data di inizio (YYYY-MM-DD) |
--end | | Data di fine (YYYY-MM-DD) |
--group | -g | Filtra per gruppo |
--limit | -l | Numero massimo di voci |
--page | -p | Numero di pagina |
--page-size | | Risultati per pagina |
--export | | Output come CSV su stdout |
--format | -f | Formato di output |
--json | | Output come JSON |
Tasks
Mostra i log delle attività asincrone per piattaforme come Midjourney, Luma e Kling. Richiede 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 | | Filtra per nome della piattaforma |
--status | | Filtra per stato |
--limit | -l | Numero massimo di voci |
--format | -f | Formato di output |
--json | | Output come JSON |
Doctor
Esegue la diagnostica per verificare la configurazione della CLI e la connettività API.
cometapi doctor
cometapi doctor --json
- Esistenza e leggibilità del file di configurazione
- Disponibilità della chiave API e origine (configurazione, env o assente)
- Disponibilità dell’access token
- Connettività di rete verso l’endpoint CometAPI
- Validità dell’autenticazione API
| Option | Short | Description |
|---|
--format | -f | Formato di output |
--json | | Output come JSON |
Config
Gestisce 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
Init
Esegui la procedura guidata di configurazione interattiva per configurare la tua chiave API e l’access token.
La procedura guidata scrive le impostazioni in ~/.config/cometapi/config.toml.
Repl
Avvia una shell di comandi interattiva completa in cui puoi eseguire qualsiasi comando CLI senza il prefisso cometapi.
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
| Format | Description |
|---|
table | Tabella avanzata nel terminale (predefinita) |
json | Output JSON |
yaml | Output YAML |
csv | Valori separati da virgole |
markdown | Tabella Markdown |
cometapi config set output_format json
Completamento della shell
Installa il completamento della shell per il supporto al completamento tramite tabulazione:
cometapi --install-completion
Codici di uscita
| Code | Meaning |
|---|
0 | Successo |
1 | Errore generale |
2 | Argomenti non validi |
64 | Configurazione mancante |
69 | Servizio non disponibile |
77 | Errore di autenticazione |
