> ## 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.

# CometAPI CLI

> Installa e usa l'interfaccia a riga di comando di CometAPI per chattare con i modelli, consultare i metadati dei modelli, eseguire richieste multi-protocollo, controllare il saldo e ispezionare l'utilizzo dal terminale.

[CometAPI CLI](https://pypi.org/project/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](https://pypi.org/project/cometapi-cli/) 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.

<Note>
  Il CometAPI CLI è in beta. I nomi dei comandi e le opzioni possono cambiare mentre l'interfaccia si stabilizza.
</Note>

## 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](https://www.cometapi.com/console/token)

## Installa la CLI

Installa il pacchetto da PyPI:

<CodeGroup>
  ```bash pip theme={null}
  pip install cometapi-cli
  ```

  ```bash pipx theme={null}
  pipx install cometapi-cli
  ```

  ```bash uv theme={null}
  uv tool install cometapi-cli
  ```
</CodeGroup>

Verifica il comando installato:

```bash theme={null}
cometapi --version
cometapi -h
```

## Inizia a usare la CLI

<Steps>
  <Step title="Configura le credenziali">
    Esegui la procedura guidata di configurazione:

    ```bash theme={null}
    cometapi init
    ```

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

    ```bash theme={null}
    export COMETAPI_KEY="your-api-key"
    ```

    Il valore opzionale `COMETAPI_ACCESS_TOKEN` è necessario solo per i comandi account, stats, tokens, logs e tasks.
  </Step>

  <Step title="Chatta con un modello">
    Invia un singolo messaggio di chat:

    ```bash theme={null}
    cometapi chat "Explain CometAPI in one sentence."
    ```

    Esegui `cometapi chat` senza un messaggio per avviare la REPL della chat.
  </Step>

  <Step title="Consulta i modelli">
    Cerca nel catalogo pubblico dei modelli:

    ```bash theme={null}
    cometapi models --search gpt --limit 10
    ```

    Filtra per metadati del catalogo:

    ```bash theme={null}
    cometapi models --provider openai --type chat --limit 10
    cometapi models --feature image --endpoint responses --json
    ```
  </Step>

  <Step title="Ispeziona un modello">
    Mostra i metadati dettagliati di un modello:

    ```bash theme={null}
    cometapi model info your-model-id
    ```

    Esporta il payload raw dei dettagli:

    ```bash theme={null}
    cometapi model info your-model-id --json
    ```
  </Step>

  <Step title="Esegui una richiesta multi-protocollo">
    Invia una richiesta una tantum tramite l'endpoint chat predefinito:

    ```bash theme={null}
    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:

    ```bash theme={null}
    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
    ```
  </Step>
</Steps>

## Ottieni aiuto sui comandi

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

```bash theme={null}
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                                    |

## Link

* [Pacchetto PyPI](https://pypi.org/project/cometapi-cli/)
* [Riferimento dei comandi](/it/libraries/cli/commands)
* [Guida alla configurazione](/it/libraries/cli/configuration)