Referensi perintah

Ringkasan perintah

Command	Description	Auth
`chat [MESSAGE]`	Kirim pesan atau mulai REPL interaktif	API key
`models`	Daftarkan dan cari model yang tersedia	API key
`balance`	Tampilkan saldo akun	API key (atau access token)
`account`	Tampilkan profil akun	Access token
`stats`	Tampilkan statistik penggunaan	Access token
`tokens`	Daftarkan dan cari API key Anda	Access token
`logs`	Jelajahi log penggunaan dengan filter	Access token
`tasks`	Tampilkan log task async	Access token
`init`	Wizard penyiapan interaktif	—
`doctor`	Jalankan diagnostik dan pemeriksaan kesehatan	API key
`config`	Kelola konfigurasi CLI	—
`repl`	Mulai shell perintah interaktif	API key

Perintah yang ditandai Access token memerlukan environment variable COMETAPI_ACCESS_TOKEN atau kunci config access_token. Lihat panduan konfigurasi untuk detail.

Chat

Kirim satu pesan atau mulai REPL interaktif multi-turn.

# Single message (streaming by default)
cometapi chat "Explain quantum computing in one sentence"

# Override model and add a system prompt
cometapi chat "Summarize this" --model claude-sonnet-4-6 --system "Be concise"

# Disable streaming
cometapi chat "Hello" --no-stream

# JSON output (full API response)
cometapi chat "Hello" --json

# Interactive REPL (omit message)
cometapi chat

Option	Short	Description
`--model`	`-m`	Model yang akan digunakan (default: dari config)
`--system`	`-s`	System prompt
`--temperature`	`-t`	Temperature sampling (0.0–2.0)
`--max-tokens`		Max tokens dalam respons
`--stream/--no-stream`		Aktifkan atau nonaktifkan streaming (default: stream)
`--format`	`-f`	Format output
`--json`		Output sebagai JSON

Models

Daftarkan model yang tersedia dengan opsi pencarian dan batas hasil.

# List all models
cometapi models

# Search by keyword
cometapi models --search gemini

# Limit results and output as JSON
cometapi models --search gpt --limit 10 --json

Option	Short	Description
`--search`	`-s`	Filter model berdasarkan kata kunci
`--limit`	`-l`	Jumlah maksimum hasil
`--format`	`-f`	Format output
`--json`		Output sebagai JSON

Balance

Tampilkan saldo akun CometAPI Anda.

# Default: account-level balance (falls back to per-key billing)
cometapi balance

# Force account-level view
cometapi balance --source account

# Force API key billing view
cometapi balance --source key

# JSON output
cometapi balance --json

Option	Short	Description
`--source`	`-s`	Sumber data: `account` (seluruh akun) atau `key` (API key saat ini).
`--format`	`-f`	Format output
`--json`		Output sebagai JSON

Account

Tampilkan profil akun Anda. Memerlukan access token.

cometapi account
cometapi account --json

Option	Short	Description
`--format`	`-f`	Format output
`--json`		Output sebagai JSON

Stats

Tampilkan statistik penggunaan untuk bulan berjalan. Memerlukan access token.

cometapi stats
cometapi stats --json

Output mencakup: jumlah request, jumlah penggunaan, tingkat keberhasilan, dan perkiraan sisa hari saldo.

Option	Short	Description
`--format`	`-f`	Format output
`--json`		Output sebagai JSON

Tokens

Daftar dan cari API key Anda. Membutuhkan access token.

# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json

Option	Short	Description
`--search`	`-s`	Kata kunci pencarian
`--page`	`-p`	Nomor halaman
`--page-size`		Hasil per halaman
`--format`	`-f`	Format output
`--json`		Output sebagai JSON

Logs

Telusuri log penggunaan dengan filter. Membutuhkan access token.

# Recent logs
cometapi logs

# Filter by model
cometapi logs --model gpt-5.4

# Filter by date range
cometapi logs --start 2026-04-01 --end 2026-04-14

# Filter by log type
cometapi logs --type consume

# Export as CSV
cometapi logs --export > usage.csv

# JSON output with limit
cometapi logs --limit 50 --json

Option	Short	Description
`--model`	`-m`	Filter berdasarkan model ID
`--token-name`		Filter berdasarkan nama API key
`--type`	`-t`	Jenis log: `consume`, `topup`, `error`, `refund`, `system`, `manage`
`--start`		Tanggal mulai (YYYY-MM-DD)
`--end`		Tanggal akhir (YYYY-MM-DD)
`--group`	`-g`	Filter berdasarkan grup
`--limit`	`-l`	Jumlah entri maksimum
`--page`	`-p`	Nomor halaman
`--page-size`		Hasil per halaman
`--export`		Output sebagai CSV ke stdout
`--format`	`-f`	Format output
`--json`		Output sebagai JSON

Tasks

Tampilkan log tugas async untuk platform seperti Suno, Midjourney, Luma, dan Kling. Membutuhkan access token.

# Recent tasks
cometapi tasks

# Filter by platform
cometapi tasks --platform suno

# Filter by status
cometapi tasks --status SUCCESS

# JSON output
cometapi tasks --json

Option	Short	Description
`--platform`		Filter berdasarkan nama platform
`--status`		Filter berdasarkan status
`--limit`	`-l`	Jumlah entri maksimum
`--format`	`-f`	Format output
`--json`		Output sebagai JSON

Doctor

Jalankan diagnostik untuk memverifikasi konfigurasi CLI dan konektivitas API.

cometapi doctor
cometapi doctor --json

Doctor memeriksa:

Keberadaan dan keterbacaan file konfigurasi
Ketersediaan API key dan sumbernya (config, env, atau tidak ada)
Ketersediaan access token
Konektivitas jaringan ke endpoint CometAPI
Validitas autentikasi API

Option	Short	Description
`--format`	`-f`	Format output
`--json`		Output sebagai JSON

Config

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

# Show current config
cometapi config show

# Set a value
cometapi config set api_key sk-...
cometapi config set default_model claude-sonnet-4-6
cometapi config set output_format json

# Remove a value
cometapi config unset api_key

# Show config file path
cometapi config path

Lihat panduan konfigurasi untuk semua key yang tersedia.

Init

Jalankan wizard penyiapan interaktif untuk mengonfigurasi API key dan access token Anda.

cometapi init

Wizard akan menulis pengaturan ke ~/.config/cometapi/config.toml.

Repl

Mulai shell perintah interaktif lengkap tempat Anda dapat menjalankan perintah CLI apa pun tanpa awalan cometapi.

cometapi repl

Output formats

Semua perintah data mendukung --json atau --format:

cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown

Format	Description
`table`	Tabel kaya di terminal (default)
`json`	Output JSON
`yaml`	Output YAML
`csv`	Nilai yang dipisahkan koma
`markdown`	Tabel Markdown

Tetapkan format default untuk semua perintah melalui config:

cometapi config set output_format json

Shell completion

Instal shell completion untuk dukungan tab-complete:

cometapi --install-completion

Shell yang didukung: Bash, Zsh, Fish.

Kode keluar

Code	Arti
`0`	Berhasil
`1`	Kesalahan umum
`2`	Argumen tidak valid
`64`	Konfigurasi tidak ada
`69`	Layanan tidak tersedia
`77`	Kesalahan autentikasi

Ikhtisar

Referensi API

Panduan Integrasi

Alat Pengembang

Kesalahan

Harga & Penagihan

Dukungan

Ringkasan perintah

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

Shell completion

Kode keluar

Ikhtisar

Referensi API

Panduan Integrasi

Alat Pengembang

Kesalahan

Harga & Penagihan

Dukungan

​Ringkasan perintah

​Chat

​Models

​Balance

​Account

​Stats

​Tokens

​Logs

​Tasks

​Doctor

​Config

​Init

​Repl

​Output formats

​Shell completion

​Kode keluar

Ringkasan perintah

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

Shell completion

Kode keluar