コマンドリファレンス

コマンド概要

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

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

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`	使用するモデル（デフォルト: 設定から取得）
`--system`	`-s`	システムプロンプト
`--temperature`	`-t`	サンプリング temperature（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 キー）。
`--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 として出力

トークン（Token）

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 として出力

ログ

フィルターを使って利用ログを参照します。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 キー名で絞り込み
`--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`		stdout に CSV として出力
`--format`	`-f`	出力形式
`--json`		JSON として出力

タスク

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 では次の項目を確認します:

設定ファイルの存在と読み取り可否
API キーの利用可否と取得元（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 キーと 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

シェル補完

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

cometapi --install-completion

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

終了コード

Code	意味
`0`	成功
`1`	一般エラー
`2`	無効な引数
`64`	設定がありません
`69`	サービスを利用できません
`77`	認証エラー

概要

APIリファレンス

統合ガイド

開発者ツール

エラー

料金・請求

サポート

コマンド概要

Chat

Models

Balance

Account

Stats

トークン（Token）

ログ

タスク

Doctor

Config

Init

Repl

出力形式

シェル補完

終了コード

概要

APIリファレンス

統合ガイド

開発者ツール

エラー

料金・請求

サポート

​コマンド概要

​Chat

​Models

​Balance

​Account

​Stats

​トークン（Token）

​ログ

​タスク

​Doctor

​Config

​Init

​Repl

​出力形式

​シェル補完

​終了コード

コマンド概要

Chat

Models

Balance

Account

Stats

トークン（Token）

ログ

タスク

Doctor

Config

Init

Repl

出力形式

シェル補完

終了コード