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.
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 |
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
| 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ư Midjourney, Luma và Kling. Yêu cầu access token.
# Recent tasks
cometapi tasks
# Filter by platform
cometapi tasks --platform kling
# 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
- 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
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.
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.
Đị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 |
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
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 |
