Tham chiếu lệnh

Tổng quan các lệnh

Command	Description	Auth
`chat [MESSAGE]`	Gửi một tin nhắn hoặc khởi động REPL tương tác	API key
`models`	Liệt kê và tìm kiếm các model khả dụng	API key
`balance`	Hiển thị số dư tài khoản	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ê sử dụng	Access token
`tokens`	Liệt kê và tìm kiếm API key của bạn	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ụ async	Access token
`init`	Trình hướng dẫn thiết lập tương tác	—
`doctor`	Chạy chẩn đoán và kiểm tra tình trạng	API key
`config`	Quản lý cấu hình CLI	—
`repl`	Khởi động shell lệnh tương tác	API key

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 để biết chi tiết.

Chat

Gửi một tin nhắn đơn hoặc khởi động REPL tương tác nhiều lượt.

# Single message (streaming by default)
cometapi chat "Explain quantum computing in one sentence"

# Override model and add a system prompt
cometapi chat "Summarize this" --model claude-sonnet-4-6 --system "Be concise"

# Disable streaming
cometapi chat "Hello" --no-stream

# JSON output (full API response)
cometapi chat "Hello" --json

# Interactive REPL (omit message)
cometapi chat

Option	Short	Description
`--model`	`-m`	Model sẽ sử dụng (mặc định: lấy từ config)
`--system`	`-s`	System prompt
`--temperature`	`-t`	Nhiệt độ lấy mẫu (0.0–2.0)
`--max-tokens`		Số token tối đa trong phản hồi
`--stream/--no-stream`		Bật hoặc tắt Streaming (mặc định: stream)
`--format`	`-f`	Định dạng đầu ra
`--json`		Xuất dưới dạng JSON

Models

Liệt kê các model khả dụng với tùy chọn tìm kiếm và giới hạn kết quả.

# List all models
cometapi models

# Search by keyword
cometapi models --search gemini

# Limit results and output as JSON
cometapi models --search gpt --limit 10 --json

Option	Short	Description
`--search`	`-s`	Lọc model theo từ khóa
`--limit`	`-l`	Số lượng kết quả tối đa
`--format`	`-f`	Định dạng đầu ra
`--json`		Xuất dưới dạng JSON

Balance

Hiển thị số dư tài khoản CometAPI của bạn.

# Default: account-level balance (falls back to per-key billing)
cometapi balance

# Force account-level view
cometapi balance --source account

# Force API key billing view
cometapi balance --source key

# JSON output
cometapi balance --json

Option	Short	Description
`--source`	`-s`	Nguồn dữ liệu: `account` (toàn bộ tài khoản) hoặc `key` (API key hiện tại).
`--format`	`-f`	Định dạng đầu ra
`--json`		Xuất dưới dạng JSON

Account

Hiển thị hồ sơ tài khoản của bạn. Yêu cầu access token.

cometapi account
cometapi account --json

Option	Short	Description
`--format`	`-f`	Định dạng đầu ra
`--json`		Xuất dưới dạng JSON

Stats

Hiển thị thống kê sử dụng của tháng hiện tại. Yêu cầu access token.

cometapi stats
cometapi stats --json

Đầu ra bao gồm: số lượng request, mức sử dụng, tỷ lệ thành công và số ngày số dư còn lại được dự đoán.

Option	Short	Description
`--format`	`-f`	Định dạng đầu ra
`--json`		Xuất dưới dạng JSON

Tokens

Liệt kê và tìm kiếm API key của bạn. Yêu cầu access token.

# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json

Option	Short	Description
`--search`	`-s`	Từ khóa tìm kiếm
`--page`	`-p`	Số trang
`--page-size`		Số kết quả mỗi trang
`--format`	`-f`	Định dạng đầu ra
`--json`		Xuất dưới dạng JSON

Logs

Duyệt nhật ký sử dụng với các bộ lọc. Yêu cầu access token.

# Recent logs
cometapi logs

# Filter by model
cometapi logs --model gpt-5.4

# Filter by date range
cometapi logs --start 2026-04-01 --end 2026-04-14

# Filter by log type
cometapi logs --type consume

# Export as CSV
cometapi logs --export > usage.csv

# JSON output with limit
cometapi logs --limit 50 --json

Option	Short	Description
`--model`	`-m`	Lọc theo model ID
`--token-name`		Lọc theo tên API key
`--type`	`-t`	Loại nhật ký: `consume`, `topup`, `error`, `refund`, `system`, `manage`
`--start`		Ngày bắt đầu (YYYY-MM-DD)
`--end`		Ngày kết thúc (YYYY-MM-DD)
`--group`	`-g`	Lọc theo nhóm
`--limit`	`-l`	Số mục tối đa
`--page`	`-p`	Số trang
`--page-size`		Số kết quả mỗi trang
`--export`		Xuất dưới dạng CSV ra stdout
`--format`	`-f`	Định dạng đầu ra
`--json`		Xuất dưới dạng JSON

Tasks

Hiển thị nhật ký tác vụ async cho các nền tảng như Suno, Midjourney, Luma và Kling. Yêu cầu access token.

# Recent tasks
cometapi tasks

# Filter by platform
cometapi tasks --platform suno

# Filter by status
cometapi tasks --status SUCCESS

# JSON output
cometapi tasks --json

Option	Short	Description
`--platform`		Lọc theo tên nền tảng
`--status`		Lọc theo trạng thái
`--limit`	`-l`	Số mục tối đa
`--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 CLI và khả năng kết nối API.

cometapi doctor
cometapi doctor --json

Doctor sẽ kiểm tra:

Sự tồn tại và khả năng đọc của tệp cấu hình
Tính khả dụng và nguồn của API key (config, env hoặc thiếu)
Tính khả dụng của access token
Khả năng kết nối mạng tới endpoint CometAPI
Tính hợp lệ của xác thực API

Option	Short	Description
`--format`	`-f`	Định dạng đầu ra
`--json`		Xuất dưới dạng JSON

Config

Quản lý cấu hình CLI được lưu trong ~/.config/cometapi/config.toml.

# Show current config
cometapi config show

# Set a value
cometapi config set api_key sk-...
cometapi config set default_model claude-sonnet-4-6
cometapi config set output_format json

# Remove a value
cometapi config unset api_key

# Show config file path
cometapi config path

Xem hướng dẫn cấu hình để 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 để cấu hình API key và access token của bạn.

cometapi init

Trình hướng dẫn sẽ ghi các thiết lập vào ~/.config/cometapi/config.toml.

Repl

Khởi động một shell lệnh tương tác đầy đủ, nơi bạn có thể chạy bất kỳ lệnh CLI nào mà không cần tiền tố cometapi.

cometapi repl

Định dạng đầu ra

Tất cả các lệnh dữ liệu đều hỗ trợ --json hoặc --format:

cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown

Format	Description
`table`	Bảng hiển thị phong phú trong terminal (mặc định)
`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

Đặt định dạng mặc định cho tất cả các lệnh thông qua config:

cometapi config set output_format json

Hoàn tất lệnh cho shell

Cài đặt hoàn tất lệnh cho shell để hỗ trợ tab-complete:

cometapi --install-completion

Các shell được hỗ trợ: Bash, Zsh, Fish.

Mã thoát

Code	Meaning
`0`	Thành công
`1`	Lỗi chung
`2`	Đối số không hợp lệ
`64`	Thiếu cấu hình
`69`	Dịch vụ không khả dụng
`77`	Lỗi xác thực

Tổng quan

Tài liệu tham khảo API

Hướng dẫn tích hợp

Thư viện

Lỗi

Giá & Thanh toán

Hỗ trợ

Tổng quan các lệnh

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Định dạng đầu ra

Hoàn tất lệnh cho shell

Mã thoát

Tổng quan

Tài liệu tham khảo API

Hướng dẫn tích hợp

Thư viện

Lỗi

Giá & Thanh toán

Hỗ trợ

​Tổng quan các lệnh

​Chat

​Models

​Balance

​Account

​Stats

​Tokens

​Logs

​Tasks

​Doctor

​Config

​Init

​Repl

​Định dạng đầu ra

​Hoàn tất lệnh cho shell

​Mã thoát

Tổng quan các lệnh

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Định dạng đầu ra

Hoàn tất lệnh cho shell

Mã thoát