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

> Installeer en gebruik de CometAPI command-line interface om met modellen te chatten, modelmetadata te bekijken, requests voor meerdere protocollen uit te voeren, je saldo te controleren en gebruik vanaf de terminal te inspecteren.

De [CometAPI CLI](https://pypi.org/project/cometapi-cli/) is de officiële command-line tool voor CometAPI. Hiermee kun je met modellen chatten, de modelcatalogus bekijken, losse requests verzenden, je saldo controleren en accountgebruik vanaf de terminal bekijken.

Gebruik de [PyPI-pagina van het pakket](https://pypi.org/project/cometapi-cli/) als de openbare homepage voor installatie en pakketmetadata. Deze documentatie licht dezelfde commands verder toe zonder toegang tot de privébronrepository te vereisen.

<Note>
  De CometAPI CLI bevindt zich in bèta. Commandnamen en opties kunnen wijzigen terwijl de interface stabiliseert.
</Note>

## Functies

* Chat met modellen met streaming output of een interactieve REPL
* Blader door metadata van de modelcatalogus, inclusief provider-, modality-, endpoint-, capability-, context- en pricing-velden
* Inspecteer één model met `cometapi model info <id>`
* Verzend één request via Chat Completions, Responses, Anthropic Messages of Gemini Generate Content-formaten met `cometapi run`
* Controleer saldo, accountprofiel, gebruiksstatistieken, API-sleutels, logs en async task-history
* Voer data uit als tabel, JSON, YAML, CSV of Markdown
* Sla lokale configuratie op in `~/.config/cometapi/config.toml`

## Vereisten

* Python 3.10 of later
* Een [CometAPI API key](https://www.cometapi.com/console/token)

## Installeer de CLI

Installeer het pakket vanaf 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>

Controleer het geïnstalleerde commando:

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

## Begin met het gebruik van de CLI

<Steps>
  <Step title="Credentials configureren">
    Voer de setup wizard uit:

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

    Je kunt de API key ook configureren met een environment variable:

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

    De optionele waarde `COMETAPI_ACCESS_TOKEN` is alleen nodig voor de commands account, stats, tokens, logs en tasks.
  </Step>

  <Step title="Chat met een model">
    Stuur één chatbericht:

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

    Voer `cometapi chat` uit zonder bericht om de chat REPL te starten.
  </Step>

  <Step title="Blader door modellen">
    Doorzoek de openbare modelcatalogus:

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

    Filter op metadata van de catalogus:

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

  <Step title="Inspecteer één model">
    Toon detailmetadata voor één model:

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

    Geef de onbewerkte detailpayload weer:

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

  <Step title="Voer een request voor meerdere protocollen uit">
    Verstuur een eenmalig request via het standaard chat endpoint:

    ```bash theme={null}
    cometapi run your-model-id -p "Reply with OK only."
    ```

    Selecteer een ander endpoint-formaat wanneer je request body een ander provider schema volgt:

    ```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>

## Help voor commands opvragen

Gebruik `-h` op het root command of een subcommand om de opties voor de geïnstalleerde versie te bekijken:

```bash theme={null}
cometapi -h
cometapi models -h
cometapi model info -h
cometapi run -h
```

## Hoofdcommando's

| Commando          | Beschrijving                                                            |
| ----------------- | ----------------------------------------------------------------------- |
| `chat [MESSAGE]`  | Verstuur een chatbericht of start de chat REPL                          |
| `models`          | Lijst weergeven en modelcatalogusmetadata filteren                      |
| `model info <id>` | De openbare metadata van één model inspecteren                          |
| `run [MODEL]`     | Verstuur één verzoek via chat-, responses-, anthropic- of gemini-opmaak |
| `balance`         | Het saldo van account of API-key weergeven                              |
| `account`         | Het accountprofiel weergeven                                            |
| `stats`           | Gebruikstatistieken weergeven                                           |
| `tokens`          | API-sleutels weergeven en doorzoeken                                    |
| `logs`            | Gebruiklogs doorbladeren en CSV exporteren                              |
| `tasks`           | Async task-logs doorbladeren                                            |
| `init`            | De setup-wizard uitvoeren                                               |
| `doctor`          | Configuratiediagnostiek uitvoeren                                       |
| `config`          | Lokale configuratie beheren                                             |
| `repl`            | Een interactieve commandoshell starten                                  |

## Links

* [PyPI package](https://pypi.org/project/cometapi-cli/)
* [Command reference](/nl/libraries/cli/commands)
* [Configuratiegids](/nl/libraries/cli/configuration)