> ## 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.

# CometAPI CLI

> CometAPI komut satırı arayüzünü kurun ve kullanın; modellerle sohbet edin, model meta verilerine göz atın, çoklu protokol istekleri çalıştırın, bakiyeyi kontrol edin ve terminalden kullanım bilgilerini inceleyin.

[CometAPI CLI](https://pypi.org/project/cometapi-cli/), CometAPI için resmi komut satırı aracıdır. Modellerle sohbet etmenize, model kataloğunu incelemenize, tek seferlik istekler göndermenize, bakiyeyi kontrol etmenize ve terminalden hesap kullanımını gözden geçirmenize yardımcı olur.

Kurulum ve paket meta verileri için [PyPI paket sayfasını](https://pypi.org/project/cometapi-cli/) herkese açık ana sayfa olarak kullanın. Bu dokümantasyon, özel kaynak deposuna erişim gerektirmeden aynı komutları ayrıntılandırır.

<Note>
  CometAPI CLI beta sürümündedir. Arayüz kararlılık kazanırken komut adları ve seçenekler değişebilir.
</Note>

## Özellikler

* Streaming çıktı veya etkileşimli bir REPL kullanarak modellerle sohbet edin
* Sağlayıcı, modalite, endpoint, capability, context ve fiyatlandırma alanları dahil olmak üzere model kataloğu meta verilerine göz atın
* `cometapi model info <id>` ile tek bir modeli inceleyin
* `cometapi run` ile Chat Completions, Responses, Anthropic Messages veya Gemini Generate Content biçimleri üzerinden tek bir istek gönderin
* Bakiye, hesap profili, kullanım istatistikleri, API keys, loglar ve asenkron görev geçmişini kontrol edin
* Tablo, JSON, YAML, CSV veya Markdown verisi çıktısı alın
* Yerel yapılandırmayı `~/.config/cometapi/config.toml` içinde saklayın

## Ön koşullar

* Python 3.10 veya daha yeni bir sürüm
* Bir [CometAPI API key](https://www.cometapi.com/console/token)

## CLI'yi kurun

Paketi PyPI üzerinden kurun:

<CodeGroup>
  ```bash pip theme={null}
  pip install cometapi-cli
  ```

  ```bash pipx theme={null}
  pipx install cometapi-cli
  ```

  ```bash uv theme={null}
  uv tool install cometapi-cli
  ```
</CodeGroup>

Kurulan komutu doğrulayın:

```bash theme={null}
cometapi --version
cometapi -h
```

## CLI'yi kullanmaya başlayın

<Steps>
  <Step title="Kimlik bilgilerini yapılandırın">
    Kurulum sihirbazını çalıştırın:

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

    API key'i bir ortam değişkeniyle de yapılandırabilirsiniz:

    ```bash theme={null}
    export COMETAPI_KEY="your-api-key"
    ```

    İsteğe bağlı `COMETAPI_ACCESS_TOKEN` değeri yalnızca account, stats, tokens, logs ve tasks komutları için gereklidir.
  </Step>

  <Step title="Bir modelle sohbet edin">
    Tek bir chat mesajı gönderin:

    ```bash theme={null}
    cometapi chat "Explain CometAPI in one sentence."
    ```

    chat REPL'ini başlatmak için mesaj olmadan `cometapi chat` çalıştırın.
  </Step>

  <Step title="Modellere göz atın">
    Genel model kataloğunda arama yapın:

    ```bash theme={null}
    cometapi models --search gpt --limit 10
    ```

    Katalog meta verilerine göre filtreleyin:

    ```bash theme={null}
    cometapi models --provider openai --type chat --limit 10
    cometapi models --feature image --endpoint responses --json
    ```
  </Step>

  <Step title="Bir modeli inceleyin">
    Bir model için ayrıntılı meta verileri gösterin:

    ```bash theme={null}
    cometapi model info your-model-id
    ```

    Ham ayrıntı yükünü çıktılayın:

    ```bash theme={null}
    cometapi model info your-model-id --json
    ```
  </Step>

  <Step title="Çoklu protokol isteği çalıştırın">
    Varsayılan chat endpoint'i üzerinden tek seferlik bir istek gönderin:

    ```bash theme={null}
    cometapi run your-model-id -p "Reply with OK only."
    ```

    İstek gövdeniz farklı bir sağlayıcı şemasını takip ettiğinde başka bir endpoint biçimi seçin:

    ```bash theme={null}
    cometapi run your-model-id --endpoint responses -p "Reply with OK only." --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
    ```
  </Step>
</Steps>

## Komut yardımını alın

Yüklü sürümün seçeneklerini incelemek için kök komutta veya herhangi bir alt komutta `-h` kullanın:

```bash theme={null}
cometapi -h
cometapi models -h
cometapi model info -h
cometapi run -h
```

## Ana komutlar

| Command           | Description                                                                        |
| ----------------- | ---------------------------------------------------------------------------------- |
| `chat [MESSAGE]`  | Bir sohbet mesajı gönderin veya chat REPL'i başlatın                               |
| `models`          | model katalog metadatasını listeleyin ve filtreleyin                               |
| `model info <id>` | Bir modelin herkese açık metadatasını inceleyin                                    |
| `run [MODEL]`     | chat, responses, anthropic veya gemini formatları üzerinden tek bir istek gönderin |
| `balance`         | Hesap veya API anahtarı bakiyesini gösterin                                        |
| `account`         | Hesap profilini gösterin                                                           |
| `stats`           | Kullanım istatistiklerini gösterin                                                 |
| `tokens`          | API anahtarlarını listeleyin ve arayın                                             |
| `logs`            | Kullanım günlüklerine göz atın ve CSV dışa aktarın                                 |
| `tasks`           | Eşzamansız görev günlüklerine göz atın                                             |
| `init`            | Kurulum sihirbazını çalıştırın                                                     |
| `doctor`          | Yapılandırma tanılarını çalıştırın                                                 |
| `config`          | Yerel yapılandırmayı yönetin                                                       |
| `repl`            | Etkileşimli bir komut kabuğu başlatın                                              |

## Bağlantılar

* [PyPI paketi](https://pypi.org/project/cometapi-cli/)
* [Komut başvurusu](/tr/libraries/cli/commands)
* [Yapılandırma kılavuzu](/tr/libraries/cli/configuration)