コマンドリファレンス

コマンド概要

Command	Description	Auth
`chat [MESSAGE]`	メッセージを送信、または対話型 REPL を開始	API key
`models`	利用可能なモデルを一覧表示・検索	API key
`balance`	アカウント残高を表示	API key (or access token)
`account`	アカウントプロフィールを表示	Access token
`stats`	利用統計を表示	Access token
`tokens`	API キーを一覧表示・検索	Access token
`logs`	フィルター付きで利用ログを閲覧	Access token
`tasks`	非同期タスクログを表示	Access token
`init`	対話型セットアップウィザード	—
`doctor`	診断とヘルスチェックを実行	API key
`config`	CLI 設定を管理	—
`repl`	対話型コマンドシェルを開始	API key

Access token と記載されたコマンドでは、COMETAPI_ACCESS_TOKEN 環境変数または access_token config キーが必要です。詳細は設定ガイドを参照してください。

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

Option	Short	Description
`--model`	`-m`	使用するモデル（デフォルト: config から取得）
`--system`	`-s`	システムプロンプト
`--temperature`	`-t`	サンプリング温度（0.0–2.0）
`--max-tokens`		レスポンス内の最大トークン数
`--stream/--no-stream`		ストリーミング（Streaming）を有効または無効化（デフォルト: stream）
`--format`	`-f`	出力形式
`--json`		JSON として出力

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

Option	Short	Description
`--search`	`-s`	キーワードでモデルを絞り込み
`--limit`	`-l`	結果の最大件数
`--format`	`-f`	出力形式
`--json`		JSON として出力

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

Option	Short	Description
`--source`	`-s`	データソース: `account`（アカウント全体）または `key`（現在の API key）。
`--format`	`-f`	出力形式
`--json`		JSON として出力

Account

アカウントプロフィールを表示します。Access token が必要です。

cometapi account
cometapi account --json

Option	Short	Description
`--format`	`-f`	出力形式
`--json`		JSON として出力

Stats

当月の利用統計を表示します。Access token が必要です。

cometapi stats
cometapi stats --json

出力には次が含まれます: リクエスト数、利用金額、成功率、残高があと何日持つかの予測日数。

Option	Short	Description
`--format`	`-f`	出力形式
`--json`		JSON として出力

Tokens

API キーを一覧表示・検索します。Access token が必要です。

# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json

Option	Short	Description
`--search`	`-s`	検索キーワード
`--page`	`-p`	ページ番号
`--page-size`		1 ページあたりの結果件数
`--format`	`-f`	出力形式
`--json`		JSON として出力

Logs

フィルター付きで利用ログを閲覧します。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

Option	Short	Description
`--model`	`-m`	model ID で絞り込み
`--token-name`		API key 名で絞り込み
`--type`	`-t`	ログ種別: `consume`、`topup`、`error`、`refund`、`system`、`manage`
`--start`		開始日（YYYY-MM-DD）
`--end`		終了日（YYYY-MM-DD）
`--group`	`-g`	グループで絞り込み
`--limit`	`-l`	エントリの最大件数
`--page`	`-p`	ページ番号
`--page-size`		1 ページあたりの結果件数
`--export`		CSV として stdout に出力
`--format`	`-f`	出力形式
`--json`		JSON として出力

Tasks

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

Option	Short	Description
`--platform`		プラットフォーム名で絞り込み
`--status`		ステータスで絞り込み
`--limit`	`-l`	エントリの最大件数
`--format`	`-f`	出力形式
`--json`		JSON として出力

Doctor

CLI 設定と API 接続性を検証するための診断を実行します。

cometapi doctor
cometapi doctor --json

doctor では以下をチェックします:

config ファイルの存在と読み取り可否
API key の利用可否と取得元（config、env、または未設定）
Access token の利用可否
CometAPI エンドポイントへのネットワーク接続性
API 認証の有効性

Option	Short	Description
`--format`	`-f`	出力形式
`--json`		JSON として出力

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 key と 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

Format	Description
`table`	ターミナル内のリッチテーブル（デフォルト）
`json`	JSON 出力
`yaml`	YAML 出力
`csv`	カンマ区切り値
`markdown`	Markdown テーブル

config を通じて、すべてのコマンドのデフォルト形式を設定できます:

cometapi config set output_format json

Shell completion

タブ補完を有効にするシェル補完をインストールします:

cometapi --install-completion

対応シェル: Bash、Zsh、Fish。

Exit codes

Code	Meaning
`0`	成功
`1`	一般エラー
`2`	無効な引数
`64`	設定が不足
`69`	サービス利用不可
`77`	認証エラー

概要

APIリファレンス

統合ガイド

ライブラリ

エラー

料金・請求

サポート

コマンド概要

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

出力形式

Shell completion

Exit codes

概要

APIリファレンス

統合ガイド

ライブラリ

エラー

料金・請求

サポート

​コマンド概要

​Chat

​Models

​Balance

​Account

​Stats

​Tokens

​Logs

​Tasks

​Doctor

​Config

​Init

​Repl

​出力形式

​Shell completion

​Exit codes

コマンド概要

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

出力形式

Shell completion

Exit codes