Referensi perintah

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 untuk detail.

Chat

Kirim satu pesan atau mulai chat REPL multi-turn.

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.

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.

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.

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.

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.

cometapi account
cometapi account --json

Statistik

Tampilkan statistik penggunaan. Memerlukan access token.

cometapi stats
cometapi stats --json

Tokens

Daftar dan cari API key. Memerlukan access token.

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.

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.

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.

cometapi doctor
cometapi doctor --json

Config

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

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 untuk semua key yang tersedia.

Init

Jalankan wizard penyiapan interaktif:

cometapi init

Repl

Mulai shell perintah interaktif lengkap:

cometapi repl

Format output

Sebagian besar 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
`json`	Output JSON
`yaml`	Output YAML
`csv`	Nilai dipisahkan koma
`markdown`	Tabel Markdown

Mulai di sini

Panduan cepat API model

Panduan inti API

Pustaka

Kesalahan

Harga dan penagihan

Dukungan

Ikhtisar perintah

Chat

Models

Info model

Jalankan

Saldo

Akun

Statistik

Tokens

Log

Tugas

Doctor

Config

Init

Repl

Format output

​Ikhtisar perintah

​Chat

​Models

​Info model

​Jalankan

​Saldo

​Akun

​Statistik

​Tokens

​Log

​Tugas

​Doctor

​Config

​Init

​Repl

​Format output

Ikhtisar perintah

Chat

Models

Info model

Jalankan

Saldo

Akun

Statistik

Tokens

Log

Tugas

Doctor

Config

Init

Repl

Format output