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

> Cài đặt và sử dụng giao diện dòng lệnh CometAPI để chat với các model, duyệt metadata của model, chạy các yêu cầu đa giao thức, kiểm tra số dư và xem mức sử dụng từ terminal.

[CometAPI CLI](https://pypi.org/project/cometapi-cli/) là công cụ dòng lệnh chính thức của CometAPI. Nó giúp bạn chat với các model, xem danh mục model, gửi các yêu cầu một lần, kiểm tra số dư và duyệt mức sử dụng tài khoản từ terminal.

Hãy dùng [trang gói PyPI](https://pypi.org/project/cometapi-cli/) làm trang chủ công khai để cài đặt và xem metadata của gói. Tài liệu này mở rộng các lệnh đó mà không cần truy cập vào kho nguồn riêng tư.

<Note>
  CometAPI CLI đang ở giai đoạn beta. Tên lệnh và tùy chọn có thể thay đổi trong khi giao diện được ổn định.
</Note>

## Tính năng

* Chat với các model bằng đầu ra streaming hoặc REPL tương tác
* Duyệt metadata của danh mục model, bao gồm các trường provider, modality, endpoint, capability, context và pricing
* Xem chi tiết một model với `cometapi model info <id>`
* Gửi một yêu cầu qua các định dạng Chat Completions, Responses, Anthropic Messages hoặc Gemini Generate Content với `cometapi run`
* Kiểm tra số dư, hồ sơ tài khoản, thống kê mức sử dụng, API keys, logs và lịch sử tác vụ async
* Xuất dữ liệu dạng bảng, JSON, YAML, CSV hoặc Markdown
* Lưu cấu hình cục bộ trong `~/.config/cometapi/config.toml`

## Điều kiện tiên quyết

* Python 3.10 trở lên
* Một [CometAPI API key](https://www.cometapi.com/console/token)

## Cài đặt CLI

Cài đặt gói từ PyPI:

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

Xác minh lệnh đã được cài đặt:

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

## Bắt đầu sử dụng CLI

<Steps>
  <Step title="Cấu hình thông tin xác thực">
    Chạy trình hướng dẫn thiết lập:

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

    Bạn cũng có thể cấu hình API key bằng biến môi trường:

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

    Giá trị tùy chọn `COMETAPI_ACCESS_TOKEN` chỉ cần thiết cho các lệnh account, stats, tokens, logs và tasks.
  </Step>

  <Step title="Chat với một model">
    Gửi một tin nhắn chat:

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

    Chạy `cometapi chat` mà không có tin nhắn để bắt đầu chat REPL.
  </Step>

  <Step title="Duyệt model">
    Tìm kiếm trong danh mục model công khai:

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

    Lọc theo metadata của danh mục:

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

  <Step title="Xem chi tiết một model">
    Hiển thị metadata chi tiết cho một model:

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

    Xuất payload chi tiết thô:

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

  <Step title="Chạy một yêu cầu đa giao thức">
    Gửi một yêu cầu một lần qua endpoint chat mặc định:

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

    Chọn định dạng endpoint khác khi body của yêu cầu tuân theo schema của một provider khác:

    ```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>

## Xem trợ giúp cho lệnh

Dùng `-h` ở lệnh gốc hoặc bất kỳ lệnh con nào để xem các tùy chọn cho phiên bản đã cài đặt:

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

## Các lệnh chính

| Command           | Description                                                              |
| ----------------- | ------------------------------------------------------------------------ |
| `chat [MESSAGE]`  | Gửi một tin nhắn chat hoặc bắt đầu REPL chat                             |
| `models`          | Liệt kê và lọc metadata danh mục model                                   |
| `model info <id>` | Xem metadata công khai của một model                                     |
| `run [MODEL]`     | Gửi một request qua các định dạng chat, responses, anthropic hoặc gemini |
| `balance`         | Hiển thị số dư tài khoản hoặc API key                                    |
| `account`         | Hiển thị hồ sơ tài khoản                                                 |
| `stats`           | Hiển thị thống kê sử dụng                                                |
| `tokens`          | Liệt kê và tìm kiếm API keys                                             |
| `logs`            | Duyệt log sử dụng và xuất CSV                                            |
| `tasks`           | Duyệt log tác vụ bất đồng bộ                                             |
| `init`            | Chạy trình hướng dẫn thiết lập                                           |
| `doctor`          | Chạy chẩn đoán cấu hình                                                  |
| `config`          | Quản lý cấu hình cục bộ                                                  |
| `repl`            | Khởi động một shell lệnh tương tác                                       |

## Liên kết

* [Gói PyPI](https://pypi.org/project/cometapi-cli/)
* [Tham chiếu lệnh](/vi/libraries/cli/commands)
* [Hướng dẫn cấu hình](/vi/libraries/cli/configuration)