Chuyển đến nội dung chính
CometAPI CLI là một công cụ dòng lệnh chính thức để tương tác với nền tảng CometAPI. Công cụ này hỗ trợ chat đa mô hình (streaming và REPL), tìm kiếm mô hình, truy vấn số dư và mức sử dụng, duyệt log, và quản lý tài khoản — tất cả đều từ terminal. Hãy bắt đầu từ trang gói PyPI nếu bạn muốn có lệnh cài đặt mới nhất, metadata của gói và phiên bản phát hành trong cùng một nơi.
CometAPI CLI đang ở giai đoạn beta. Hãy chờ đợi những thay đổi nhỏ về lệnh và UX trong khi giao diện CLI được ổn định.

Tính năng

  • Chat đa mô hình với streaming và REPL tương tác
  • Tìm kiếm và liệt kê mô hình
  • Số dư tài khoản và thống kê sử dụng
  • Duyệt log sử dụng với bộ lọc và xuất CSV
  • Log tác vụ bất đồng bộ (Suno, Midjourney, Kling và các dịch vụ khác)
  • Đầu ra nhiều định dạng: bảng, JSON, YAML, CSV, Markdown
  • Cấu hình dựa trên TOML với trình hướng dẫn thiết lập
  • Shell completion cho Bash, Zsh và Fish
  • Thiết kế thân thiện với agent với đầu ra JSON có cấu trúc và exit code xác định

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

Cài đặt

Sử dụng trang gói PyPI làm tài liệu tham chiếu cài đặt chính, sau đó chọn một trong các cách sau để cài đặt CLI:
pip install cometapi-cli
Xác minh cài đặt:
cometapi --version

Bắt đầu nhanh

1

Chạy trình hướng dẫn thiết lập

Trình hướng dẫn tương tác sẽ lưu API key và access token tùy chọn của bạn trong một tệp cấu hình cục bộ:
cometapi init
Trình hướng dẫn sẽ nhắc bạn nhập:
2

Chat với một mô hình

Gửi một tin nhắn đơn với đầu ra streaming:
cometapi chat "Explain quantum computing in one sentence"
Ghi đè mô hình mặc định:
cometapi chat "Hello!" --model claude-sonnet-4-6
3

Tìm kiếm các mô hình có sẵn

Liệt kê các mô hình khớp với một từ khóa:
cometapi models --search gemini --limit 10
4

Kiểm tra số dư của bạn

Xem số dư tài khoản của bạn:
cometapi balance
Hiển thị chế độ xem thanh toán theo API key hiện tại:
cometapi balance --source key
5

Chạy chẩn đoán

Xác minh rằng CLI có thể kết nối với CometAPI:
cometapi doctor

Phiên chat tương tác

Chạy cometapi chat mà không có đối số để vào REPL chat nhiều lượt:
cometapi chat
Các lệnh REPL:
CommandDescription
/modelChuyển mô hình đang hoạt động
/systemĐặt hoặc thay đổi system prompt
/clearXóa lịch sử hội thoại
/historyHiển thị lịch sử hội thoại
/saveLưu hội thoại vào tệp
/tokensHiển thị mức sử dụng token cho phiên
/helpLiệt kê tất cả lệnh REPL
/exitThoát khỏi REPL

Tích hợp agent

CLI được thiết kế để sử dụng bởi các agent lập trình AI và script tự động hóa:
  • Tất cả các lệnh dữ liệu đều hỗ trợ --json để xuất đầu ra có cấu trúc, máy có thể đọc được
  • Mã thoát xác định: 0 (thành công), 64 (thiếu cấu hình), 77 (lỗi xác thực), 69 (dịch vụ không khả dụng)
  • Lỗi được ghi ra stderr, dữ liệu được ghi ra stdout
  • Xem tài liệu tham chiếu lệnh đầy đủ để biết các tùy chọn theo từng lệnh

Liên kết