메인 콘텐츠로 건너뛰기

​
명령어 개요

CommandDescriptionAuth
chat [MESSAGE]메시지를 보내거나 대화형 REPL 시작API key
models사용 가능한 모델 목록 조회 및 검색API key
balance계정 잔액 표시API key (or access token)
account계정 프로필 표시Access token
stats사용 통계 표시Access token
tokensAPI 키 목록 조회 및 검색Access token
logs필터와 함께 사용 로그 탐색Access token
tasks비동기 작업 로그 표시Access token
init대화형 설정 마법사—
doctor진단 및 상태 점검 실행API key
configCLI 설정 관리—
repl대화형 명령 셸 시작API key
Access token으로 표시된 명령어는 COMETAPI_ACCESS_TOKEN 환경 변수 또는 access_token config 키가 필요합니다. 자세한 내용은 configuration guide를 참고하세요.

​
Chat

단일 메시지를 보내거나 여러 턴의 대화형 REPL을 시작합니다. 
# 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
OptionShortDescription
--model-m사용할 모델(기본값: config에서 가져옴)
--system-s시스템 프롬프트(Prompt)
--temperature-t샘플링 temperature (0.0–2.0)
--max-tokens응답의 최대 tokens
--stream/--no-stream스트리밍(Streaming) 활성화 또는 비활성화(기본값: stream)
--format-f출력 형식
--jsonJSON으로 출력

​
Models

선택적으로 검색 및 개수 제한을 적용해 사용 가능한 모델 목록을 표시합니다. 
# 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
OptionShortDescription
--search-s키워드로 모델 필터링
--limit-l최대 결과 수
--format-f출력 형식
--jsonJSON으로 출력

​
Balance

CometAPI 계정 잔액을 표시합니다. 
# 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
OptionShortDescription
--source-s데이터 소스: account(전체 계정) 또는 key(현재 API key)
--format-f출력 형식
--jsonJSON으로 출력

​
Account

계정 프로필을 표시합니다. access token이 필요합니다. 
cometapi account
cometapi account --json
OptionShortDescription
--format-f출력 형식
--jsonJSON으로 출력

​
Stats

현재 월의 사용 통계를 표시합니다. access token이 필요합니다. 
cometapi stats
cometapi stats --json
출력에는 요청 수, 사용 금액, 성공률, 잔액이 유지될 것으로 예측되는 일수가 포함됩니다.
OptionShortDescription
--format-f출력 형식
--jsonJSON으로 출력

​
토큰(Token)

API 키를 나열하고 검색합니다. access token이 필요합니다. 
# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json
OptionShortDescription
--search-s검색 키워드
--page-p페이지 번호
--page-size페이지당 결과 수
--format-f출력 형식
--jsonJSON으로 출력

​
로그

필터를 사용해 사용량 로그를 조회합니다. 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
OptionShortDescription
--model-mmodel ID로 필터링
--token-nameAPI 키 이름으로 필터링
--type-t로그 유형: consume, topup, error, refund, system, manage
--start시작 날짜 (YYYY-MM-DD)
--end종료 날짜 (YYYY-MM-DD)
--group-g그룹으로 필터링
--limit-l최대 항목 수
--page-p페이지 번호
--page-size페이지당 결과 수
--exportstdout으로 CSV 출력
--format-f출력 형식
--jsonJSON으로 출력

​
작업

Suno, Midjourney, Luma, Kling 등의 플랫폼에 대한 비동기 작업 로그를 표시합니다. access token이 필요합니다. 
# Recent tasks
cometapi tasks

# Filter by platform
cometapi tasks --platform suno

# Filter by status
cometapi tasks --status SUCCESS

# JSON output
cometapi tasks --json
OptionShortDescription
--platform플랫폼 이름으로 필터링
--status상태로 필터링
--limit-l최대 항목 수
--format-f출력 형식
--jsonJSON으로 출력

​
Doctor

CLI 구성과 API 연결성을 확인하기 위해 진단을 실행합니다. 
cometapi doctor
cometapi doctor --json
Doctor는 다음을 확인합니다:
  • 구성 파일 존재 여부 및 읽기 가능 여부
  • API 키 사용 가능 여부 및 출처(config, env 또는 없음)
  • access token 사용 가능 여부
  • CometAPI 엔드포인트에 대한 네트워크 연결성
  • API 인증 유효성
OptionShortDescription
--format-f출력 형식
--jsonJSON으로 출력

​
Config

~/.config/cometapi/config.toml에 저장된 CLI 구성을 관리합니다. 
# 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

대화형 설정 마법사를 실행하여 API 키와 access token을 구성합니다. 
cometapi init
이 마법사는 설정을 ~/.config/cometapi/config.toml에 기록합니다.

​
Repl

cometapi 접두사 없이 모든 CLI 명령을 실행할 수 있는 완전한 대화형 명령 셸을 시작합니다. 
cometapi repl

​
출력 형식

모든 데이터 명령은 --json 또는 --format을 지원합니다: 
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
FormatDescription
table터미널의 리치 테이블(기본값)
jsonJSON 출력
yamlYAML 출력
csv쉼표로 구분된 값
markdownMarkdown 테이블
config를 통해 모든 명령의 기본 형식을 설정할 수 있습니다: 
cometapi config set output_format json

​
셸 자동 완성

탭 완성 지원을 위해 셸 자동 완성을 설치합니다: 
cometapi --install-completion
지원되는 셸: Bash, Zsh, Fish.

​
종료 코드

코드의미
0성공
1일반 오류
2잘못된 인수
64구성 누락
69서비스를 사용할 수 없음
77인증 오류