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

> Installieren und verwenden Sie die CometAPI-Befehlszeilenschnittstelle, um mit Modellen zu chatten, Modellmetadaten zu durchsuchen, Multi-Protokoll-Anfragen auszuführen, das Guthaben zu prüfen und die Nutzung im Terminal einzusehen.

Die [CometAPI CLI](https://pypi.org/project/cometapi-cli/) ist das offizielle Befehlszeilentool für CometAPI. Damit können Sie mit Modellen chatten, den Modellkatalog einsehen, einmalige Anfragen senden, das Guthaben prüfen und die Kontonutzung im Terminal durchsuchen.

Verwenden Sie die [PyPI package page](https://pypi.org/project/cometapi-cli/) als öffentliche Startseite für Installation und Paketmetadaten. Diese Dokumentation erweitert die gleichen Befehle, ohne dass Zugriff auf das private Quell-Repository erforderlich ist.

<Note>
  Die CometAPI CLI befindet sich in der Beta. Befehlsnamen und Optionen können sich ändern, während sich die Schnittstelle stabilisiert.
</Note>

## Funktionen

* Mit Modellen per Streaming-Ausgabe oder in einer interaktiven REPL chatten
* Metadaten des Modellkatalogs durchsuchen, einschließlich Feldern für Provider, Modalität, Endpoint, Capability, Context und Preisgestaltung
* Ein Modell mit `cometapi model info <id>` prüfen
* Eine Anfrage über Chat Completions, Responses, Anthropic Messages oder Gemini Generate Content-Formate mit `cometapi run` senden
* Guthaben, Kontoprofil, Nutzungsstatistiken, API keys, Logs und den Verlauf asynchroner Aufgaben prüfen
* Tabellen-, JSON-, YAML-, CSV- oder Markdown-Daten ausgeben
* Lokale Konfiguration in `~/.config/cometapi/config.toml` speichern

## Voraussetzungen

* Python 3.10 oder höher
* Ein [CometAPI API-Schlüssel](https://www.cometapi.com/console/token)

## CLI installieren

Installieren Sie das Paket von 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>

Überprüfen Sie den installierten Befehl:

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

## Mit der CLI beginnen

<Steps>
  <Step title="Anmeldedaten konfigurieren">
    Führen Sie den Einrichtungsassistenten aus:

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

    Sie können den API-Schlüssel auch mit einer Umgebungsvariable konfigurieren:

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

    Der optionale Wert `COMETAPI_ACCESS_TOKEN` wird nur für die Befehle account, stats, tokens, logs und tasks benötigt.
  </Step>

  <Step title="Mit einem Modell chatten">
    Senden Sie eine einzelne Chat-Nachricht:

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

    Führen Sie `cometapi chat` ohne Nachricht aus, um die Chat-REPL zu starten.
  </Step>

  <Step title="Modelle durchsuchen">
    Durchsuchen Sie den öffentlichen Modellkatalog:

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

    Filtern Sie nach Katalogmetadaten:

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

  <Step title="Ein Modell prüfen">
    Detailmetadaten für ein Modell anzeigen:

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

    Die rohen Detaildaten ausgeben:

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

  <Step title="Eine Multi-Protokoll-Anfrage ausführen">
    Senden Sie eine einmalige Anfrage über den standardmäßigen Chat-Endpoint:

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

    Wählen Sie ein anderes Endpoint-Format, wenn Ihr Request-Body einem anderen Provider-Schema folgt:

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

## Befehlshilfe abrufen

Verwenden Sie `-h` beim Root-Befehl oder bei jedem Unterbefehl, um die Optionen der installierten Version zu prüfen:

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

## Hauptbefehle

| Befehl            | Beschreibung                                                                |
| ----------------- | --------------------------------------------------------------------------- |
| `chat [MESSAGE]`  | Eine Chat-Nachricht senden oder die Chat-REPL starten                       |
| `models`          | Metadaten des Modellkatalogs auflisten und filtern                          |
| `model info <id>` | Öffentliche Metadaten eines Modells anzeigen                                |
| `run [MODEL]`     | Eine Anfrage über die Formate chat, responses, anthropic oder gemini senden |
| `balance`         | Kontostand oder API-Key-Guthaben anzeigen                                   |
| `account`         | Kontoprofil anzeigen                                                        |
| `stats`           | Nutzungsstatistiken anzeigen                                                |
| `tokens`          | API-Keys auflisten und durchsuchen                                          |
| `logs`            | Nutzungsprotokolle durchsuchen und als CSV exportieren                      |
| `tasks`           | Asynchrone Aufgabenprotokolle durchsuchen                                   |
| `init`            | Den Einrichtungsassistenten ausführen                                       |
| `doctor`          | Konfigurationsdiagnosen ausführen                                           |
| `config`          | Lokale Konfiguration verwalten                                              |
| `repl`            | Eine interaktive Befehlszeile starten                                       |

## Links

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