Tham chiếu lệnh

Sử dụng cometapi -h hoặc cometapi <command> -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 <id>`	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 để 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.

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.

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.

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.

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.

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.

cometapi account
cometapi account --json

Thống kê

Hiển thị thống kê sử dụng. Yêu cầu access token.

cometapi stats
cometapi stats --json

Token

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

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.

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.

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.

cometapi doctor
cometapi doctor --json

Config

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

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 để 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:

cometapi init

Repl

Khởi động một command shell tương tác đầy đủ:

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:

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

Bắt đầu tại đây

Hướng dẫn nhanh về API mô hình

Hướng dẫn API cốt lõi

Thư viện

Lỗi

Giá cả và thanh toán

Hỗ trợ

Tổng quan các lệnh

Chat

Models

Thông tin model

Chạy

Số dư

Tài khoản

Thống kê

Token

Nhật ký

Tác vụ

Doctor

Config

Init

Repl

Định dạng đầu ra

​Tổng quan các lệnh

​Chat

​Models

​Thông tin model

​Chạy

​Số dư

​Tài khoản

​Thống kê

​Token

​Nhật ký

​Tác vụ

​Doctor

​Config

​Init

​Repl

​Định dạng đầu ra

Tổng quan các lệnh

Chat

Models

Thông tin model

Chạy

Số dư

Tài khoản

Thống kê

Token

Nhật ký

Tác vụ

Doctor

Config

Init

Repl

Định dạng đầu ra