CometAPI CLI は、TOML の config ファイル、環境変数、コマンドラインフラグから設定を読み取ります。同じ設定を複数のソースから利用できる場合、優先順位は次のとおりです:
CLI flags > config file > environment variables > defaults
Config ファイル
場所: ~/.config/cometapi/config.toml
対話形式で config ファイルを作成するには、セットアップウィザードを実行します:
または、config サブコマンドで個別の設定を管理します:
利用可能な設定
認証情報
CLI は 2 種類の認証情報を使用します:
API key
すべてのコマンドで必須です。API key は、CometAPI の model エンドポイントへのリクエストを認証します。
API key は CometAPI Console → API Keys で作成します。
次のいずれかの方法で設定します:
Access token
任意です。access token は、アカウントレベルのコマンド account、stats、tokens、logs、tasks に必要です。
access token は CometAPI Console → Personal Settings で生成します。
次のいずれかの方法で設定します:
セキュリティ
CLI では、次のセキュリティプラクティスが適用されます:
- API key と access token がログに記録されたり、完全な形で表示されたりすることはありません。診断出力では末尾 4 文字のみが表示されます。
- config ファイルは制限された権限(
0600)で作成されます。読み取り可能なのはファイル所有者のみです。
- 認証情報は絶対にバージョン管理へコミットしないでください。必要に応じて、config ファイルのパスを
.gitignore に追加してください。
API key によって発生するすべての利用および料金については、利用者が責任を負います。不正アクセスが疑われる場合は、キーを安全に保管し、ローテーションしてください。
トラブルシューティング