> ## 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. # Tham chiếu lệnh > Tài liệu tham chiếu cho các lệnh CLI của CometAPI, bao gồm chat, models, model info, run, balance, account, stats, tokens, logs, tasks, doctor, config và repl. Sử dụng `cometapi -h` hoặc `cometapi -h` để xem chính xác các đối số và tùy chọn cho phiên bản đã cài đặt. ## Tổng quan các lệnh | Command | Description | Auth | | ----------------- | -------------------------------------------------------------------------- | ---------------------------- | | `chat [MESSAGE]` | Gửi một tin nhắn chat hoặc khởi động chat REPL | API key | | `models` | Liệt kê và lọc metadata của danh mục model | API key | | `model info ` | Kiểm tra metadata công khai của một model | API key | | `run [MODEL]` | Gửi một request thông qua định dạng chat, responses, anthropic hoặc gemini | API key | | `balance` | Hiển thị số dư tài khoản hoặc số dư của API key hiện tại | API key hoặc access token | | `account` | Hiển thị hồ sơ tài khoản | Access token | | `stats` | Hiển thị thống kê mức sử dụng | Access token | | `tokens` | Liệt kê và tìm kiếm API key | Access token | | `logs` | Duyệt nhật ký sử dụng với bộ lọc | Access token | | `tasks` | Hiển thị nhật ký tác vụ bất đồng bộ | Access token | | `init` | Chạy trình hướng dẫn thiết lập | Không có | | `doctor` | Chạy chẩn đoán | API key | | `config` | Quản lý cấu hình cục bộ | Không có | | `repl` | Khởi động shell lệnh tương tác | Phụ thuộc vào lệnh được dùng | Các lệnh được đánh dấu **Access token** yêu cầu biến môi trường `COMETAPI_ACCESS_TOKEN` hoặc khóa cấu hình `access_token`. Xem [hướng dẫn cấu hình](/vi/libraries/cli/configuration) để biết chi tiết. ## Chat Gửi một tin nhắn đơn lẻ hoặc khởi động chat REPL nhiều lượt. ```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` | Model sẽ sử dụng | | `--system` | `-s` | System prompt | | `--temperature` | `-t` | Nhiệt độ lấy mẫu | | `--max-tokens` | | Số lượng token phản hồi tối đa | | `--stream/--no-stream` | | Bật hoặc tắt Streaming | | `--format` | `-f` | Định dạng đầu ra | | `--json` | | Xuất dưới dạng JSON | ## Models Theo mặc định, liệt kê các model từ danh mục công khai. Kết quả danh mục bao gồm model ID, nhà cung cấp, loại model, tính năng, endpoint, giá, độ dài ngữ cảnh và số lượng token completion tối đa. ```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` | Lọc theo ID, mã, tên, mô tả hoặc nhà cung cấp | | `--provider` | | Lọc theo tên hoặc mã nhà cung cấp | | `--type`, `--modality` | | Lọc theo loại model hoặc modality | | `--feature`, `--capability` | | Lọc theo tính năng hoặc capability | | `--endpoint` | | Lọc theo tên endpoint, phương thức hoặc đường dẫn | | `--limit` | `-l` | Số lượng kết quả tối đa | | `--source` | | Sử dụng metadata `catalog` hoặc danh sách `openai` tương thích OpenAI | | `--refresh` | | Làm mới bộ nhớ đệm danh mục một giờ | | `--no-cache` | | Bỏ qua bộ nhớ đệm danh mục cho lệnh này | | `--format` | `-f` | Định dạng đầu ra | | `--json` | | Xuất dưới dạng JSON | Bộ nhớ đệm danh mục được lưu tại `~/.cache/cometapi/models.json`. ## Thông tin model Kiểm tra siêu dữ liệu công khai của một model. Lệnh sẽ phân giải model thông qua catalog công khai, sau đó tải siêu dữ liệu chi tiết cho mã catalog. ```bash theme={null} cometapi model info your-model-id cometapi model info your-model-id --json cometapi model info your-model-id --refresh ``` | Tùy chọn | Viết tắt | Mô tả | | ------------ | -------- | -------------------------------------------- | | `--refresh` | | Làm mới bộ nhớ đệm catalog trước khi tra cứu | | `--no-cache` | | Bỏ qua bộ nhớ đệm catalog cho lệnh này | | `--format` | `-f` | Định dạng đầu ra | | `--json` | | Xuất JSON chi tiết model thô | Đầu ra bảng bao gồm nhà cung cấp, loại model, tính năng, endpoint, giá, độ dài ngữ cảnh, số completion token tối đa, URL tài liệu và phần tổng quan. ## Chạy Gửi một request thông qua định dạng endpoint đã chọn. Dùng `--input-file` cho phần thân JSON, các giá trị `-i key=value` lặp lại để ghi đè, và `-p/--prompt` làm lối tắt cho prompt. ```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 ``` | Tùy chọn | Viết tắt | Mô tả | | -------------- | -------- | ------------------------------------------------------------------------ | | `--endpoint` | `-e` | Định dạng endpoint: `chat`, `responses`, `anthropic`, hoặc `gemini` | | `--input-file` | | Phần thân request là đối tượng JSON | | `--input` | `-i` | Dữ liệu đầu vào request dưới dạng `key=value`; lặp lại cho nhiều giá trị | | `--prompt` | `-p` | Lối tắt prompt | | `--json` | | Xuất phản hồi JSON thô | Ánh xạ endpoint: | Endpoint | Đường dẫn request | Xác thực | | ----------- | --------------------------------------- | ------------------------------------------------- | | `chat` | `POST /v1/chat/completions` | API key Bearer | | `responses` | `POST /v1/responses` | API key Bearer | | `anthropic` | `POST /v1/messages` | API key `x-api-key` và header phiên bản Anthropic | | `gemini` | Đường dẫn model Gemini Generate Content | API key `x-goog-api-key` | Thứ tự hợp nhất phần thân là `--input-file`, các `-i key=value` lặp lại, lối tắt prompt, rồi `MODEL` theo vị trí. Giá trị nội tuyến sẽ được phân tích như JSON khi có thể. Khóa có dấu chấm sẽ tạo đối tượng lồng nhau. ## Số dư Hiển thị số dư tài khoản CometAPI của bạn hoặc chế độ xem thanh toán của API key hiện tại. ```bash theme={null} cometapi balance cometapi balance --source account cometapi balance --source key cometapi balance --json ``` | Tùy chọn | Viết tắt | Mô tả | | ---------- | -------- | ----------------------------------- | | `--source` | `-s` | Nguồn dữ liệu: `account` hoặc `key` | | `--format` | `-f` | Định dạng đầu ra | | `--json` | | Xuất dưới dạng JSON | ## Tài khoản Hiển thị hồ sơ tài khoản của bạn. Yêu cầu access token. ```bash theme={null} cometapi account cometapi account --json ``` ## Thống kê Hiển thị thống kê sử dụng. Yêu cầu access token. ```bash theme={null} cometapi stats cometapi stats --json ``` ## Token Liệt kê và tìm kiếm API key. Yêu cầu access token. ```bash theme={null} cometapi tokens cometapi tokens --search project cometapi tokens --json ``` | Tùy chọn | Viết tắt | Mô tả | | ---------- | -------- | -------------------- | | `--search` | `-s` | Từ khóa tìm kiếm | | `--page` | `-p` | Số trang | | `--limit` | `-l` | Số kết quả mỗi trang | | `--format` | `-f` | Định dạng đầu ra | | `--json` | | Xuất dưới dạng JSON | ## Nhật ký Duyệt nhật ký sử dụng với bộ lọc. Yêu cầu access token. ```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` | Lọc theo model ID | | `--token-name` | `-t` | Lọc theo tên API key | | `--type` | | Loại nhật ký | | `--search` | `-s` | Từ khóa tìm kiếm | | `--start` | | Ngày bắt đầu | | `--end` | | Ngày kết thúc | | `--group` | `-g` | Lọc theo nhóm API key | | `--request-id` | | Tra cứu một request bằng `X-Cometapi-Request-Id` | | `--page` | `-p` | Số trang | | `--limit` | `-l` | Số kết quả mỗi trang | | `--export` | | Xuất CSV phía máy chủ ra stdout | | `--format` | `-f` | Định dạng đầu ra | | `--json` | | Xuất dưới dạng JSON | `logs --request-id` thực hiện một lần tra cứu có chỉ mục đối với endpoint nhật ký operator và chỉ chấp nhận khớp chính xác `request_id`. CLI không quét các trang nhật ký dự phòng, vì endpoint self-log không áp dụng lọc `request_id`. ## Tác vụ Hiển thị nhật ký tác vụ bất đồng bộ. Yêu cầu access token. ```bash theme={null} cometapi tasks cometapi tasks --platform kling cometapi tasks --status SUCCESS cometapi tasks --json ``` | Option | Short | Description | | ------------ | ----- | ----------------------- | | `--platform` | `-p` | Lọc theo nền tảng | | `--task-id` | | Lọc theo ID tác vụ | | `--status` | `-s` | Lọc theo trạng thái | | `--action` | `-a` | Lọc theo loại hành động | | `--start` | | Ngày bắt đầu | | `--end` | | Ngày kết thúc | | `--page` | | Số trang | | `--limit` | `-l` | Số kết quả mỗi trang | | `--format` | `-f` | Định dạng đầu ra | | `--json` | | Xuất dưới dạng JSON | ## Doctor Chạy chẩn đoán để xác minh cấu hình và khả năng kết nối API. ```bash theme={null} cometapi doctor cometapi doctor --json ``` ## Config Quản lý cấu hình CLI được lưu trong `~/.config/cometapi/config.toml`. ```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 ``` Xem [hướng dẫn cấu hình](/vi/libraries/cli/configuration) để biết tất cả các khóa khả dụng. ## Init Chạy trình hướng dẫn thiết lập tương tác: ```bash theme={null} cometapi init ``` ## Repl Khởi động một command shell tương tác đầy đủ: ```bash theme={null} cometapi repl ``` ## Định dạng đầu ra Hầu hết các lệnh dữ liệu đều hỗ trợ `--json` hoặc `--format`: ```bash theme={null} cometapi models --json cometapi models --format yaml cometapi stats --format csv cometapi account --format markdown ``` | Format | Description | | ---------- | ------------------------------- | | `table` | Bảng phong phú trong terminal | | `json` | Đầu ra JSON | | `yaml` | Đầu ra YAML | | `csv` | Giá trị phân tách bằng dấu phẩy | | `markdown` | Bảng Markdown |