Komut referansı

Komutlara genel bakış

Command	Description	Auth
`chat [MESSAGE]`	Mesaj gönderin veya etkileşimli REPL başlatın	API key
`models`	Kullanılabilir modelleri listeleyin ve arayın	API key
`balance`	Hesap bakiyesini gösterin	API key (veya access token)
`account`	Hesap profilini gösterin	Access token
`stats`	Kullanım istatistiklerini gösterin	Access token
`tokens`	API anahtarlarınızı listeleyin ve arayın	Access token
`logs`	Filtrelerle kullanım loglarını görüntüleyin	Access token
`tasks`	Asenkron görev loglarını gösterin	Access token
`init`	Etkileşimli kurulum sihirbazı	—
`doctor`	Tanılama ve sağlık kontrollerini çalıştırın	API key
`config`	CLI yapılandırmasını yönetin	—
`repl`	Etkileşimli komut kabuğunu başlatın	API key

Access token ile işaretlenen komutlar COMETAPI_ACCESS_TOKEN ortam değişkenini veya access_token yapılandırma anahtarını gerektirir. Ayrıntılar için yapılandırma kılavuzu sayfasına bakın.

Chat

Tek bir mesaj gönderin veya çok turlu etkileşimli REPL’i başlatın.

# 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`	Kullanılacak model (varsayılan: config’ten)
`--system`	`-s`	Sistem prompt’u
`--temperature`	`-t`	Örnekleme sıcaklığı (0.0–2.0)
`--max-tokens`		Yanıttaki maksimum token sayısı
`--stream/--no-stream`		Streaming’i etkinleştirin veya devre dışı bırakın (varsayılan: stream)
`--format`	`-f`	Çıktı biçimi
`--json`		JSON olarak çıktı ver

Models

İsteğe bağlı arama ve limit ile kullanılabilir modelleri listeleyin.

# 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`	Modelleri anahtar kelimeye göre filtreleyin
`--limit`	`-l`	Maksimum sonuç sayısı
`--format`	`-f`	Çıktı biçimi
`--json`		JSON olarak çıktı ver

Balance

CometAPI hesap bakiyenizi gösterin.

# 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`	Veri kaynağı: `account` (tam hesap) veya `key` (mevcut API key).
`--format`	`-f`	Çıktı biçimi
`--json`		JSON olarak çıktı ver

Account

Hesap profilinizi gösterin. Bir access token gerektirir.

cometapi account
cometapi account --json

Option	Short	Description
`--format`	`-f`	Çıktı biçimi
`--json`		JSON olarak çıktı ver

Stats

Geçerli ayın kullanım istatistiklerini gösterin. Bir access token gerektirir.

cometapi stats
cometapi stats --json

Çıktıya şunlar dahildir: istek sayısı, kullanım tutarı, başarı oranı ve bakiyenin tahmini kaç gün daha yeteceği.

Option	Short	Description
`--format`	`-f`	Çıktı biçimi
`--json`		JSON olarak çıktı ver

Tokens

API anahtarlarınızı listeleyin ve arayın. Bir access token gerektirir.

# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json

Option	Short	Description
`--search`	`-s`	Arama anahtar kelimesi
`--page`	`-p`	Sayfa numarası
`--page-size`		Sayfa başına sonuç sayısı
`--format`	`-f`	Çıktı biçimi
`--json`		JSON olarak çıktı ver

Logs

Filtrelerle kullanım loglarını görüntüleyin. Bir access token gerektirir.

# 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`	model ID’ye göre filtrele
`--token-name`		API key adına göre filtrele
`--type`	`-t`	Log türü: `consume`, `topup`, `error`, `refund`, `system`, `manage`
`--start`		Başlangıç tarihi (YYYY-MM-DD)
`--end`		Bitiş tarihi (YYYY-MM-DD)
`--group`	`-g`	Gruba göre filtrele
`--limit`	`-l`	Maksimum kayıt sayısı
`--page`	`-p`	Sayfa numarası
`--page-size`		Sayfa başına sonuç sayısı
`--export`		stdout’a CSV olarak çıktı ver
`--format`	`-f`	Çıktı biçimi
`--json`		JSON olarak çıktı ver

Tasks

Suno, Midjourney, Luma ve Kling gibi platformlar için asenkron görev loglarını gösterin. Bir access token gerektirir.

# 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`		Platform adına göre filtrele
`--status`		Duruma göre filtrele
`--limit`	`-l`	Maksimum kayıt sayısı
`--format`	`-f`	Çıktı biçimi
`--json`		JSON olarak çıktı ver

Doctor

CLI yapılandırmasını ve API bağlantısını doğrulamak için tanılama çalıştırın.

cometapi doctor
cometapi doctor --json

Doctor şunları kontrol eder:

Config dosyasının varlığı ve okunabilirliği
API key kullanılabilirliği ve kaynağı (config, env veya eksik)
Access token kullanılabilirliği
CometAPI endpoint’ine ağ bağlantısı
API kimlik doğrulamasının geçerliliği

Option	Short	Description
`--format`	`-f`	Çıktı biçimi
`--json`		JSON olarak çıktı ver

Config

~/.config/cometapi/config.toml içinde saklanan CLI yapılandırmasını yönetin.

# 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

Kullanılabilir tüm anahtarlar için yapılandırma kılavuzu sayfasına bakın.

Init

API key ve access token’ınızı yapılandırmak için etkileşimli kurulum sihirbazını çalıştırın.

cometapi init

Sihirbaz ayarları ~/.config/cometapi/config.toml dosyasına yazar.

Repl

cometapi öneki olmadan herhangi bir CLI komutunu çalıştırabileceğiniz tam etkileşimli bir komut kabuğu başlatın.

cometapi repl

Çıktı biçimleri

Tüm veri komutları --json veya --format destekler:

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

Format	Description
`table`	Terminalde zengin tablo (varsayılan)
`json`	JSON çıktısı
`yaml`	YAML çıktısı
`csv`	Virgülle ayrılmış değerler
`markdown`	Markdown tablosu

Config üzerinden tüm komutlar için varsayılan bir biçim ayarlayın:

cometapi config set output_format json

Shell completion

Sekmeyle tamamlama desteği için shell completion yükleyin:

cometapi --install-completion

Desteklenen shell’ler: Bash, Zsh, Fish.

Çıkış kodları

Code	Meaning
`0`	Başarılı
`1`	Genel hata
`2`	Geçersiz argümanlar
`64`	Yapılandırma eksik
`69`	Hizmet kullanılamıyor
`77`	Kimlik doğrulama hatası

Genel Bakış

API Referansı

Entegrasyon Kılavuzları

Kütüphaneler

Hatalar

Fiyatlandırma ve Faturalandırma

Destek

Komutlara genel bakış

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Çıktı biçimleri

Shell completion

Çıkış kodları

Genel Bakış

API Referansı

Entegrasyon Kılavuzları

Kütüphaneler

Hatalar

Fiyatlandırma ve Faturalandırma

Destek

​Komutlara genel bakış

​Chat

​Models

​Balance

​Account

​Stats

​Tokens

​Logs

​Tasks

​Doctor

​Config

​Init

​Repl

​Çıktı biçimleri

​Shell completion

​Çıkış kodları

Komutlara genel bakış

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Çıktı biçimleri

Shell completion

Çıkış kodları