> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Komut başvurusu

> chat, models, model info, run, balance, account, stats, tokens, logs, tasks, doctor, config ve repl dahil olmak üzere CometAPI CLI komutları için başvuru.

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](/tr/libraries/cli/configuration) bakın.

## Chat

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

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
cometapi account
cometapi account --json
```

## İstatistikler

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

```bash theme={null}
cometapi stats
cometapi stats --json
```

## Tokens

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

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
cometapi doctor
cometapi doctor --json
```

## Config

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

```bash theme={null}
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](/tr/libraries/cli/configuration) bakın.

## Init

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

```bash theme={null}
cometapi init
```

## Repl

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

```bash theme={null}
cometapi repl
```

## Output formats

Çoğu veri komutu `--json` veya `--format` destekler:

```bash theme={null}
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           |
