Documentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
コマンド概要
| 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 |
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
Midjourney、Luma、Kling などのプラットフォーム向け非同期タスクログを表示します。Access token が必要です。
# Recent tasks
cometapi tasks
# Filter by platform
cometapi tasks --platform kling
# 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
- 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 を設定します。
ウィザードは設定を ~/.config/cometapi/config.toml に書き込みます。
Repl
cometapi プレフィックスなしで任意の CLI コマンドを実行できる、完全な対話型コマンドシェルを開始します。
出力形式
すべてのデータコマンドは --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 テーブル |
cometapi config set output_format json
Shell completion
タブ補完を有効にするシェル補完をインストールします:
cometapi --install-completion
Exit codes
| Code | Meaning |
|---|
0 | 成功 |
1 | 一般エラー |
2 | 無効な引数 |
64 | 設定が不足 |
69 | サービス利用不可 |
77 | 認証エラー |
