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

​
기능

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

​
사전 요구 사항

​
설치

CLI 설치의 기본 참고 자료로 PyPI package page를 사용한 다음, 아래 방법 중 하나를 선택해 설치하세요: 
pip install cometapi-cli
설치가 완료되었는지 확인합니다: 
cometapi --version

​
빠른 시작

1

설정 마법사 실행

대화형 마법사는 API 키와 선택적 access token을 로컬 config 파일에 저장합니다:
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 key 과금 보기를 표시합니다:
cometapi balance --source key
5

진단 실행

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

​
대화형 채팅 세션

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

​
에이전트 통합

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

​
링크