Komut başvurusu

Yüklü sürüm için tam argümanları ve seçenekleri incelemek üzere cometapi -h veya cometapi <command> -h kullanın.

Komutlara genel bakış

Command	Description	Auth
`chat [MESSAGE]`	Bir chat mesajı gönderin veya chat REPL’ini başlatın	API key
`models`	Model katalog metadata’sını listeleyin ve filtreleyin	API key
`model info <id>`	Bir modelin herkese açık metadata’sını inceleyin	API key
`run [MODEL]`	chat, responses, anthropic veya gemini formatları üzerinden bir istek gönderin	API key
`balance`	Hesap veya geçerli API key bakiyesini gösterin	API key or access token
`account`	Hesap profilini gösterin	Access token
`stats`	Kullanım istatistiklerini gösterin	Access token
`tokens`	API key’leri listeleyin ve arayın	Access token
`logs`	Kullanım günlüklerine filtrelerle göz atın	Access token
`tasks`	Asenkron görev günlüklerini gösterin	Access token
`init`	Kurulum sihirbazını çalıştırın	None
`doctor`	Tanılamayı çalıştırın	API key
`config`	Yerel yapılandırmayı yönetin	None
`repl`	Etkileşimli bir komut kabuğu başlatın	Kullanılan komuta bağlıdır

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

Chat

Tek bir mesaj gönderin veya çok turlu chat REPL’ini başlatın.

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`	Kullanılacak model
`--system`	`-s`	Sistem prompt’u
`--temperature`	`-t`	Örnekleme sıcaklığı
`--max-tokens`		Maksimum yanıt token sayısı
`--stream/--no-stream`		Streaming’i etkinleştirin veya devre dışı bırakın
`--format`	`-f`	Çıktı formatı
`--json`		JSON olarak çıktı verin

Models

Varsayılan olarak herkese açık katalogdan modelleri listeleyin. Katalog çıktısı model ID, sağlayıcı, model türü, özellikler, endpoint’ler, fiyatlandırma, bağlam uzunluğu ve maksimum tamamlama token sayısını içerir.

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`	ID, code, name, description veya provider’a göre filtreleyin
`--provider`		Sağlayıcı adı veya code’a göre filtreleyin
`--type`, `--modality`		Model türü veya modality’ye göre filtreleyin
`--feature`, `--capability`		Özellik veya capability’ye göre filtreleyin
`--endpoint`		Endpoint adı, method veya path’e göre filtreleyin
`--limit`	`-l`	Maksimum sonuç sayısı
`--source`		`catalog` metadata’sını veya OpenAI uyumlu `openai` listesini kullanın
`--refresh`		Bir saatlik katalog önbelleğini yenileyin
`--no-cache`		Bu komut için katalog önbelleğini atlayın
`--format`	`-f`	Çıktı formatı
`--json`		JSON olarak çıktı verin

Katalog önbelleği ~/.cache/cometapi/models.json konumunda saklanır.

Model bilgileri

Bir modelin genel metadata bilgilerini inceleyin. Komut, modeli genel katalog üzerinden çözümler, ardından katalog kodu için ayrıntılı metadata bilgilerini yükler.

cometapi model info your-model-id
cometapi model info your-model-id --json
cometapi model info your-model-id --refresh

Option	Short	Description
`--refresh`		Aramadan önce katalog önbelleğini yenile
`--no-cache`		Bu komut için katalog önbelleğini atla
`--format`	`-f`	Çıktı biçimi
`--json`		Ham model ayrıntı JSON çıktısı ver

Tablo çıktısı sağlayıcı, model türü, özellikler, endpoint’ler, fiyatlandırma, context length, maksimum completion token sayısı, dokümantasyon URL’si ve genel bakışı içerir.

Çalıştır

Seçilen bir endpoint biçimi üzerinden bir istek gönderin. JSON gövdesi için --input-file, geçersiz kılmalar için tekrarlanan -i key=value değerleri ve Prompt kısayolu için -p/--prompt kullanın.

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`	Endpoint biçimi: `chat`, `responses`, `anthropic` veya `gemini`
`--input-file`		JSON nesnesi istek gövdesi
`--input`	`-i`	İstek girdisi `key=value` olarak; birden fazla değer için tekrarlayın
`--prompt`	`-p`	Prompt kısayolu
`--json`		Ham JSON yanıtı ver

Endpoint eşlemesi:

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

Gövde birleştirme sırası --input-file, tekrarlanan -i key=value, Prompt kısayolu ve ardından konumsal MODEL şeklindedir. Satır içi değerler mümkün olduğunda JSON olarak ayrıştırılır. Noktalı anahtarlar iç içe nesneler oluşturur.

Bakiye

CometAPI hesap bakiyenizi veya mevcut API anahtarı faturalandırma görünümünü gösterin.

cometapi balance
cometapi balance --source account
cometapi balance --source key
cometapi balance --json

Option	Short	Description
`--source`	`-s`	Veri kaynağı: `account` veya `key`
`--format`	`-f`	Çıktı biçimi
`--json`		JSON olarak çıktı ver

Hesap

Hesap profilinizi gösterin. Bir erişim token’ı gerektirir.

cometapi account
cometapi account --json

İstatistikler

Kullanım istatistiklerini gösterin. Bir erişim token’ı gerektirir.

cometapi stats
cometapi stats --json

Tokens

API anahtarlarını listeleyin ve arayın. Bir erişim token’ı gerektirir.

cometapi tokens
cometapi tokens --search project
cometapi tokens --json

Option	Short	Description
`--search`	`-s`	Arama anahtar sözcüğü
`--page`	`-p`	Sayfa numarası
`--limit`	`-l`	Sayfa başına sonuç sayısı
`--format`	`-f`	Çıktı biçimi
`--json`		JSON olarak çıktı ver

Logs

Filtrelerle kullanım loglarına göz atın. Bir access token gerektirir.

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`	model ID’ye göre filtrele
`--token-name`	`-t`	API key adına göre filtrele
`--type`		Log türü
`--search`	`-s`	Anahtar kelime ara
`--start`		Başlangıç tarihi
`--end`		Bitiş tarihi
`--group`	`-g`	API key grubuna göre filtrele
`--request-id`		`X-Cometapi-Request-Id` ile tek bir isteği bul
`--page`	`-p`	Sayfa numarası
`--limit`	`-l`	Sayfa başına sonuç
`--export`		Sunucu taraflı CSV çıktısını stdout’a ver
`--format`	`-f`	Çıktı formatı
`--json`		JSON olarak çıktı ver

logs --request-id, operatör log endpoint’ine karşı tek bir indeksli arama gerçekleştirir ve yalnızca tam request_id eşleşmesini kabul eder. CLI, yedek log sayfalarını taramaz, çünkü self-log endpoint’i request_id filtrelemesi uygulamaz.

Tasks

Asenkron görev loglarını gösterin. Bir access token gerektirir.

cometapi tasks
cometapi tasks --platform kling
cometapi tasks --status SUCCESS
cometapi tasks --json

Option	Short	Description
`--platform`	`-p`	Platforma göre filtrele
`--task-id`		Görev ID’sine göre filtrele
`--status`	`-s`	Duruma göre filtrele
`--action`	`-a`	Eylem türüne göre filtrele
`--start`		Başlangıç tarihi
`--end`		Bitiş tarihi
`--page`		Sayfa numarası
`--limit`	`-l`	Sayfa başına sonuç
`--format`	`-f`	Çıktı formatı
`--json`		JSON olarak çıktı ver

Doctor

Yapılandırmayı ve API bağlantısını doğrulamak için tanılamayı çalıştırın.

cometapi doctor
cometapi doctor --json

Config

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

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

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

Init

Etkileşimli kurulum sihirbazını çalıştırın:

cometapi init

Repl

Tam etkileşimli bir komut kabuğu başlatın:

cometapi repl

Output formats

Çoğu veri komutu --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
`json`	JSON çıktısı
`yaml`	YAML çıktısı
`csv`	Virgülle ayrılmış değerler
`markdown`	Markdown tablosu

Buradan başlayın

Model API hızlı başlangıçları

Temel API kılavuzları

Kütüphaneler

Hatalar

Fiyatlandırma ve faturalandırma

Destek

Komutlara genel bakış

Chat

Models

Model bilgileri

Çalıştır

Bakiye

Hesap

İstatistikler

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

​Komutlara genel bakış

​Chat

​Models

​Model bilgileri

​Çalıştır

​Bakiye

​Hesap

​İstatistikler

​Tokens

​Logs

​Tasks

​Doctor

​Config

​Init

​Repl

​Output formats

Komutlara genel bakış

Chat

Models

Model bilgileri

Çalıştır

Bakiye

Hesap

İstatistikler

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats