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

# Referensi perintah

> Referensi untuk perintah CLI CometAPI, termasuk chat, models, model info, run, balance, account, stats, tokens, logs, tasks, doctor, config, dan repl.

Gunakan `cometapi -h` atau `cometapi <command> -h` untuk memeriksa argumen dan opsi yang tepat untuk versi yang terpasang.

## Ikhtisar perintah

| Command           | Description                                                               | Auth                                    |
| ----------------- | ------------------------------------------------------------------------- | --------------------------------------- |
| `chat [MESSAGE]`  | Kirim pesan chat atau mulai chat REPL                                     | API key                                 |
| `models`          | Daftar dan filter metadata katalog model                                  | API key                                 |
| `model info <id>` | Periksa metadata publik satu model                                        | API key                                 |
| `run [MODEL]`     | Kirim satu request melalui format chat, responses, anthropic, atau gemini | API key                                 |
| `balance`         | Tampilkan saldo akun atau API key saat ini                                | API key or access token                 |
| `account`         | Tampilkan profil akun                                                     | Access token                            |
| `stats`           | Tampilkan statistik penggunaan                                            | Access token                            |
| `tokens`          | Daftar dan cari API key                                                   | Access token                            |
| `logs`            | Jelajahi log penggunaan dengan filter                                     | Access token                            |
| `tasks`           | Tampilkan log task async                                                  | Access token                            |
| `init`            | Jalankan wizard pengaturan                                                | None                                    |
| `doctor`          | Jalankan diagnostik                                                       | API key                                 |
| `config`          | Kelola konfigurasi lokal                                                  | None                                    |
| `repl`            | Mulai shell perintah interaktif                                           | Tergantung pada perintah yang digunakan |

Perintah yang ditandai **Access token** memerlukan variabel lingkungan `COMETAPI_ACCESS_TOKEN` atau kunci konfigurasi `access_token`. Lihat [panduan konfigurasi](/id/libraries/cli/configuration) untuk detail.

## Chat

Kirim satu pesan atau mulai chat REPL multi-turn.

```bash theme={null}
cometapi chat "Explain CometAPI in one sentence."
cometapi chat "Summarize this" --model your-model-id --system "Be concise."
cometapi chat "Hello" --no-stream
cometapi chat "Hello" --json
cometapi chat
```

| Option                 | Short | Description                         |
| ---------------------- | ----- | ----------------------------------- |
| `--model`              | `-m`  | Model yang akan digunakan           |
| `--system`             | `-s`  | System prompt                       |
| `--temperature`        | `-t`  | Temperatur sampling                 |
| `--max-tokens`         |       | Maksimum token respons              |
| `--stream/--no-stream` |       | Aktifkan atau nonaktifkan streaming |
| `--format`             | `-f`  | Format output                       |
| `--json`               |       | Output sebagai JSON                 |

## Models

Secara default, tampilkan model dari katalog publik. Output katalog mencakup model ID, provider, jenis model, fitur, endpoint, harga, panjang konteks, dan token completion maksimum.

```bash theme={null}
cometapi models
cometapi models --search gpt --limit 10
cometapi models --provider openai --type chat --limit 10
cometapi models --feature image --endpoint responses --json
cometapi models --refresh
cometapi models --source openai --search gpt
```

| Option                      | Short | Description                                                                    |
| --------------------------- | ----- | ------------------------------------------------------------------------------ |
| `--search`                  | `-s`  | Filter berdasarkan ID, code, name, description, atau provider                  |
| `--provider`                |       | Filter berdasarkan nama atau code provider                                     |
| `--type`, `--modality`      |       | Filter berdasarkan jenis model atau modality                                   |
| `--feature`, `--capability` |       | Filter berdasarkan feature atau capability                                     |
| `--endpoint`                |       | Filter berdasarkan nama endpoint, method, atau path                            |
| `--limit`                   | `-l`  | Jumlah maksimum hasil                                                          |
| `--source`                  |       | Gunakan metadata `catalog` atau listing `openai` yang kompatibel dengan OpenAI |
| `--refresh`                 |       | Segarkan cache katalog satu jam                                                |
| `--no-cache`                |       | Lewati cache katalog untuk perintah ini                                        |
| `--format`                  | `-f`  | Format output                                                                  |
| `--json`                    |       | Output sebagai JSON                                                            |

Cache katalog disimpan di `~/.cache/cometapi/models.json`.

## Info model

Periksa metadata publik untuk satu model. Perintah ini me-resolve model melalui katalog publik, lalu memuat metadata detail untuk kode katalog tersebut.

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

| Option       | Short | Description                              |
| ------------ | ----- | ---------------------------------------- |
| `--refresh`  |       | Segarkan cache katalog sebelum pencarian |
| `--no-cache` |       | Lewati cache katalog untuk perintah ini  |
| `--format`   | `-f`  | Format output                            |
| `--json`     |       | Keluarkan JSON detail model mentah       |

Output tabel mencakup provider, jenis model, fitur, endpoint, harga, panjang context, token completion maksimum, URL dokumentasi, dan ringkasan.

## Jalankan

Kirim satu request melalui format endpoint yang dipilih. Gunakan `--input-file` untuk body JSON, nilai `-i key=value` berulang untuk override, dan `-p/--prompt` untuk shortcut prompt.

```bash theme={null}
cometapi run your-model-id -p "Write one sentence about CometAPI."
cometapi run your-model-id --endpoint responses -p "Reply with OK only." -i max_output_tokens=32 --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
cometapi run your-model-id --endpoint responses --input-file body.json -i temperature=0.2 --json
```

| Option         | Short | Description                                                      |
| -------------- | ----- | ---------------------------------------------------------------- |
| `--endpoint`   | `-e`  | Format endpoint: `chat`, `responses`, `anthropic`, atau `gemini` |
| `--input-file` |       | Body request objek JSON                                          |
| `--input`      | `-i`  | Input request sebagai `key=value`; ulangi untuk beberapa nilai   |
| `--prompt`     | `-p`  | Shortcut prompt                                                  |
| `--json`       |       | Keluarkan respons JSON mentah                                    |

Pemetaan endpoint:

| Endpoint    | Request path                       | Auth                                           |
| ----------- | ---------------------------------- | ---------------------------------------------- |
| `chat`      | `POST /v1/chat/completions`        | API key Bearer                                 |
| `responses` | `POST /v1/responses`               | API key Bearer                                 |
| `anthropic` | `POST /v1/messages`                | API key `x-api-key` dan header versi Anthropic |
| `gemini`    | Path model Gemini Generate Content | API key `x-goog-api-key`                       |

Urutan penggabungan body adalah `--input-file`, `-i key=value` berulang, shortcut prompt, lalu `MODEL` posisional. Nilai inline akan di-parse sebagai JSON jika memungkinkan. Key bertitik membuat objek bertingkat.

## Saldo

Tampilkan saldo akun CometAPI Anda atau tampilan penagihan API key saat ini.

```bash theme={null}
cometapi balance
cometapi balance --source account
cometapi balance --source key
cometapi balance --json
```

| Option     | Short | Description                       |
| ---------- | ----- | --------------------------------- |
| `--source` | `-s`  | Sumber data: `account` atau `key` |
| `--format` | `-f`  | Format output                     |
| `--json`   |       | Keluarkan sebagai JSON            |

## Akun

Tampilkan profil akun Anda. Memerlukan access token.

```bash theme={null}
cometapi account
cometapi account --json
```

## Statistik

Tampilkan statistik penggunaan. Memerlukan access token.

```bash theme={null}
cometapi stats
cometapi stats --json
```

## Tokens

Daftar dan cari API key. Memerlukan access token.

```bash theme={null}
cometapi tokens
cometapi tokens --search project
cometapi tokens --json
```

| Option     | Short | Description            |
| ---------- | ----- | ---------------------- |
| `--search` | `-s`  | Kata kunci pencarian   |
| `--page`   | `-p`  | Nomor halaman          |
| `--limit`  | `-l`  | Hasil per halaman      |
| `--format` | `-f`  | Format output          |
| `--json`   |       | Keluarkan sebagai JSON |

## Log

Telusuri log penggunaan dengan filter. Memerlukan access token.

```bash theme={null}
cometapi logs
cometapi logs --model your-model-id
cometapi logs --start 2026-04-01 --end 2026-04-14
cometapi logs --type consume
cometapi logs --export > usage.csv
cometapi logs --limit 50 --json
cometapi logs --request-id 20260617165550885561292gJBlzjtp
```

| Option         | Short | Description                                           |
| -------------- | ----- | ----------------------------------------------------- |
| `--model`      | `-m`  | Filter berdasarkan model ID                           |
| `--token-name` | `-t`  | Filter berdasarkan nama API key                       |
| `--type`       |       | Jenis log                                             |
| `--search`     | `-s`  | Kata kunci pencarian                                  |
| `--start`      |       | Tanggal mulai                                         |
| `--end`        |       | Tanggal akhir                                         |
| `--group`      | `-g`  | Filter berdasarkan grup API key                       |
| `--request-id` |       | Cari satu request berdasarkan `X-Cometapi-Request-Id` |
| `--page`       | `-p`  | Nomor halaman                                         |
| `--limit`      | `-l`  | Hasil per halaman                                     |
| `--export`     |       | Keluarkan CSV sisi server ke stdout                   |
| `--format`     | `-f`  | Format keluaran                                       |
| `--json`       |       | Keluarkan sebagai JSON                                |

`logs --request-id` melakukan satu pencarian terindeks terhadap endpoint log operator dan
hanya menerima kecocokan `request_id` yang persis. CLI tidak memindai halaman log fallback,
karena endpoint self-log tidak menerapkan pemfilteran `request_id`.

## Tugas

Tampilkan log task async. Memerlukan access token.

```bash theme={null}
cometapi tasks
cometapi tasks --platform kling
cometapi tasks --status SUCCESS
cometapi tasks --json
```

| Option       | Short | Description                     |
| ------------ | ----- | ------------------------------- |
| `--platform` | `-p`  | Filter berdasarkan platform     |
| `--task-id`  |       | Filter berdasarkan task ID      |
| `--status`   | `-s`  | Filter berdasarkan status       |
| `--action`   | `-a`  | Filter berdasarkan jenis action |
| `--start`    |       | Tanggal mulai                   |
| `--end`      |       | Tanggal akhir                   |
| `--page`     |       | Nomor halaman                   |
| `--limit`    | `-l`  | Hasil per halaman               |
| `--format`   | `-f`  | Format keluaran                 |
| `--json`     |       | Keluarkan sebagai JSON          |

## Doctor

Jalankan diagnostik untuk memverifikasi konfigurasi dan konektivitas API.

```bash theme={null}
cometapi doctor
cometapi doctor --json
```

## Config

Kelola konfigurasi CLI yang disimpan di `~/.config/cometapi/config.toml`.

```bash theme={null}
cometapi config show
cometapi config set api_key "$COMETAPI_KEY"
cometapi config set default_model your-model-id
cometapi config unset api_key
cometapi config path
```

Lihat [panduan konfigurasi](/id/libraries/cli/configuration) untuk semua key yang tersedia.

## Init

Jalankan wizard penyiapan interaktif:

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

## Repl

Mulai shell perintah interaktif lengkap:

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

## Format output

Sebagian besar perintah data mendukung `--json` atau `--format`:

```bash theme={null}
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
```

| Format     | Description            |
| ---------- | ---------------------- |
| `table`    | Tabel kaya di terminal |
| `json`     | Output JSON            |
| `yaml`     | Output YAML            |
| `csv`      | Nilai dipisahkan koma  |
| `markdown` | Tabel Markdown         |
