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

> Instal dan gunakan antarmuka baris perintah CometAPI untuk chat dengan model, menelusuri metadata model, menjalankan permintaan multi-protokol, memeriksa saldo, dan meninjau penggunaan dari terminal.

[CometAPI CLI](https://pypi.org/project/cometapi-cli/) adalah alat command-line resmi untuk CometAPI. Alat ini membantu Anda chat dengan model, memeriksa katalog model, mengirim permintaan satu kali, memeriksa saldo, dan menelusuri penggunaan akun dari terminal.

Gunakan [halaman paket PyPI](https://pypi.org/project/cometapi-cli/) sebagai beranda publik untuk instalasi dan metadata paket. Dokumentasi ini menjelaskan perintah yang sama secara lebih rinci tanpa memerlukan akses ke repositori sumber privat.

<Note>
  CometAPI CLI masih dalam beta. Nama perintah dan opsi dapat berubah selama antarmuka distabilkan.
</Note>

## Fitur

* Chat dengan model menggunakan output streaming atau REPL interaktif
* Menelusuri metadata katalog model, termasuk field provider, modality, endpoint, capability, context, dan pricing
* Memeriksa satu model dengan `cometapi model info <id>`
* Mengirim satu permintaan melalui format Chat Completions, Responses, Anthropic Messages, atau Gemini Generate Content dengan `cometapi run`
* Memeriksa saldo, profil akun, statistik penggunaan, API key, log, dan riwayat tugas async
* Menghasilkan data dalam format tabel, JSON, YAML, CSV, atau Markdown
* Menyimpan konfigurasi lokal di `~/.config/cometapi/config.toml`

## Prasyarat

* Python 3.10 atau versi lebih baru
* [CometAPI API key](https://www.cometapi.com/console/token)

## Instal CLI

Instal paket dari 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>

Verifikasi perintah yang terinstal:

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

## Mulai menggunakan CLI

<Steps>
  <Step title="Konfigurasikan kredensial">
    Jalankan wizard penyiapan:

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

    Anda juga dapat mengonfigurasi API key dengan environment variable:

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

    Nilai `COMETAPI_ACCESS_TOKEN` opsional hanya diperlukan untuk perintah account, stats, tokens, logs, dan tasks.
  </Step>

  <Step title="Chat dengan model">
    Kirim satu pesan chat:

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

    Jalankan `cometapi chat` tanpa pesan untuk memulai chat REPL.
  </Step>

  <Step title="Telusuri model">
    Cari katalog model publik:

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

    Filter berdasarkan metadata katalog:

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

  <Step title="Periksa satu model">
    Tampilkan metadata detail untuk satu model:

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

    Tampilkan payload detail mentah:

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

  <Step title="Jalankan permintaan multi-protokol">
    Kirim permintaan satu kali melalui endpoint chat default:

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

    Pilih format endpoint lain ketika request body Anda mengikuti skema provider yang berbeda:

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

## Dapatkan bantuan perintah

Gunakan `-h` pada perintah root atau subperintah apa pun untuk memeriksa opsi untuk versi yang terinstal:

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

## Perintah utama

| Command           | Description                                                                  |
| ----------------- | ---------------------------------------------------------------------------- |
| `chat [MESSAGE]`  | Kirim pesan chat atau mulai chat REPL                                        |
| `models`          | Daftar dan filter metadata katalog model                                     |
| `model info <id>` | Periksa metadata publik satu model                                           |
| `run [MODEL]`     | Kirim satu permintaan melalui format chat, responses, anthropic, atau gemini |
| `balance`         | Tampilkan saldo akun atau API key                                            |
| `account`         | Tampilkan profil akun                                                        |
| `stats`           | Tampilkan statistik penggunaan                                               |
| `tokens`          | Daftar dan cari API key                                                      |
| `logs`            | Jelajahi log penggunaan dan ekspor CSV                                       |
| `tasks`           | Jelajahi log tugas async                                                     |
| `init`            | Jalankan wizard penyiapan                                                    |
| `doctor`          | Jalankan diagnostik konfigurasi                                              |
| `config`          | Kelola konfigurasi lokal                                                     |
| `repl`            | Mulai shell perintah interaktif                                              |

## Tautan

* [Paket PyPI](https://pypi.org/project/cometapi-cli/)
* [Referensi perintah](/id/libraries/cli/commands)
* [Panduan konfigurasi](/id/libraries/cli/configuration)