메인 콘텐츠로 건너뛰기
CometAPI CLI는 CometAPI 플랫폼과 상호작용하기 위한 공식 명령줄 도구입니다. 이 도구는 터미널에서 멀티 모델 채팅(스트리밍 및 REPL), 모델 검색, 잔액 및 사용량 조회, 로그 탐색, 계정 관리 기능을 모두 지원합니다. 최신 설치 명령, 패키지 메타데이터, 릴리스 버전을 한곳에서 확인하려면 PyPI 패키지 페이지에서 시작하세요.
CometAPI CLI는 베타 버전입니다. CLI 인터페이스가 안정화되는 동안 명령어와 UX에 소규모 변경이 있을 수 있습니다.

​
기능

  • 스트리밍 및 대화형 REPL을 지원하는 멀티 모델 채팅
  • 모델 검색 및 목록 조회
  • 계정 잔액 및 사용 통계
  • 필터 및 CSV 내보내기를 지원하는 사용 로그 탐색
  • 비동기 작업 로그(Suno, Midjourney, Kling 등)
  • 다중 형식 출력: table, JSON, YAML, CSV, Markdown
  • 설정 마법사를 포함한 TOML 기반 구성
  • Bash, Zsh, Fish용 셸 자동 완성
  • 구조화된 JSON 출력과 결정적 종료 코드를 갖춘 에이전트 친화적 설계

​
사전 요구 사항

​
설치

CLI 설치의 기본 참조로 PyPI 패키지 페이지를 사용한 다음, 아래 방법 중 하나를 선택해 설치하세요: 
pip install cometapi-cli
설치 확인: 
cometapi --version

​
빠른 시작

1

설정 마법사 실행

대화형 마법사는 API 키와 선택적 액세스 토큰을 로컬 구성 파일에 저장합니다:
cometapi init
마법사는 다음 정보를 묻습니다:
2

모델과 채팅

스트리밍 출력으로 단일 메시지를 전송합니다:
cometapi chat "Explain quantum computing in one sentence"
기본 model을 재정의합니다:
cometapi chat "Hello!" --model claude-sonnet-4-6
3

사용 가능한 모델 검색

키워드와 일치하는 모델을 나열합니다:
cometapi models --search gemini --limit 10
4

잔액 확인

계정 잔액을 확인합니다:
cometapi balance
현재 API 키 과금 보기를 표시합니다:
cometapi balance --source key
5

진단 실행

CLI가 CometAPI에 연결할 수 있는지 확인합니다:
cometapi doctor

​
대화형 채팅 세션

인자 없이 cometapi chat를 실행하면 멀티턴 채팅 REPL에 진입합니다: 
cometapi chat
REPL 명령어:
CommandDescription
/model활성 model 전환
/system시스템 프롬프트(Prompt) 설정 또는 변경
/clear대화 기록 지우기
/history대화 기록 표시
/save대화를 파일로 저장
/tokens세션의 토큰 사용량 표시
/help모든 REPL 명령어 나열
/exitREPL 종료

​
에이전트 통합

이 CLI는 AI 코딩 에이전트와 자동화 스크립트에서 사용할 수 있도록 설계되었습니다:
  • 모든 데이터 명령은 구조화되고 기계가 읽을 수 있는 출력을 위해 --json을 지원합니다
  • 결정적 종료 코드: 0 (성공), 64 (구성 누락), 77 (인증 오류), 69 (서비스 사용 불가)
  • 오류는 stderr로, 데이터는 stdout으로 출력됩니다
  • 명령별 옵션은 전체 명령어 참조에서 확인하세요

​
링크