Langsung ke konten utama
CometAPI CLI membaca pengaturan dari file config TOML, environment variable, dan flag command-line. Saat pengaturan yang sama tersedia dari beberapa sumber, urutan prioritasnya adalah: Flag CLI > file config > environment variable > default

​
File config

Lokasi: ~/.config/cometapi/config.toml Jalankan setup wizard untuk membuat file config secara interaktif: 
cometapi init
Atau kelola pengaturan individual dengan subcommand config: 
# View current configuration
cometapi config show

# Set a value
cometapi config set api_key sk-...

# Remove a value
cometapi config unset api_key

# Show the config file path
cometapi config path

​
Pengaturan yang tersedia

Config keyEnvironment variableDeskripsi
api_keyCOMETAPI_KEYAPI key (wajib untuk semua command)
access_tokenCOMETAPI_ACCESS_TOKENAccess token untuk command tingkat akun
base_urlCOMETAPI_BASE_URLURL dasar API (default: https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELModel default untuk chat (fallback: gpt-5.4)
output_format—Format output default: table, json, yaml, csv, atau markdown

​
Kredensial

CLI menggunakan dua jenis kredensial:

​
API key

Wajib untuk semua command. API key mengautentikasi request ke endpoint model CometAPI. Buat API key di CometAPI Console → API Keys. Tetapkan dengan salah satu cara berikut: 
export COMETAPI_KEY="<COMETAPI_KEY>"

​
Access token

Opsional. Access token diperlukan untuk command tingkat akun: account, stats, tokens, logs, dan tasks. Buat access token di CometAPI Console → Personal Settings. Tetapkan dengan salah satu cara berikut: 
export COMETAPI_ACCESS_TOKEN="your-access-token"

​
Keamanan

CLI menerapkan praktik keamanan berikut:
  • API key dan access token tidak pernah dicatat ke log atau ditampilkan secara penuh. Hanya 4 karakter terakhir yang ditampilkan dalam output diagnostik.
  • File config dibuat dengan izin yang ketat (0600) — hanya dapat dibaca oleh pemilik file.
  • Kredensial tidak boleh di-commit ke version control. Tambahkan path file config ke .gitignore Anda jika berlaku.
Anda bertanggung jawab atas semua penggunaan dan biaya yang timbul dari API key Anda. Jaga keamanan key Anda dan lakukan rotasi jika Anda mencurigai adanya akses yang tidak sah.

​
Pemecahan masalah

ErrorSolusi
API key not configuredJalankan cometapi init atau tetapkan environment variable COMETAPI_KEY
Connection failedJalankan cometapi doctor untuk mendiagnosis konektivitas
Access token not configuredHanya diperlukan untuk account/stats/tokens/logs/tasks. Jalankan cometapi init untuk menambahkan satu