Skip to main content

​
簡潔な回答

npx apiyi@latest CLIをダウンロードして一度実行し、何も残さないため、マシンにapiyiコマンドは追加されません。以降のコマンドでは、キーを保存する場合など、毎回npx apiyi@latest …の完全なプレフィックスが必要です。
今後は通常のapiyiを入力したい場合は、一度グローバルにインストールしてください: npm i -g apiyi。

​
症状

最初のセルフチェックでキーがないと表示され、ヒントにあるコマンドも失敗します。
Windows では表現が異なります（例: 「用語 apiyi はコマンドレットの名前として認識されません」）。ただし、原因は同じです。

​
原因

npx は npm の一時キャッシュから CLI を実行し、apiyi を PATH に追加しません。バージョン 0.2.1 以前は、ヒントに短縮形の apiyi auth set-key が使われていたため、それをコピーするとこのエラーが発生していました。 0.2.2 以降では、CLI は npx 経由で実行されていることを検出し、ヒントに完全な形式の npx apiyi@latest auth set-key を表示します。--help にもこの説明があります。

​
修正

すべてのコマンドの先頭にnpx apiyi@latestを付けます。常に最新バージョンを使用でき、マシンには何も残りません。

​
初回セットアップを順番に進める

1

キーをコピーする

tokenページを開き、sk-で始まるtokenをコピーします。tokenがない場合は、先に作成してください。
2

キーを保存する

npx apiyi@latest auth set-keyを実行します。API key (input hidden):が表示されたら、キーを貼り付けてEnterキーを押します。 入力中や貼り付け中は、画面に何も表示されません。これは、後ろからキーを見られないようにするための仕様です。 Saved apiKey to ~/.config/apiyi/config.json (mode 0600)と表示されれば成功です。
3

もう一度確認する

npx apiyi@latest checkを実行します。okのstatusが表示されれば、キーが有効でノードに接続できています。
4

最初のメッセージを送信する

npx apiyi@latest chat "Hello" -m gpt-5.4-miniを実行します。返信とtoken使用量が表示されれば、すべて正常に動作しています。

​
よくある質問

入力は非表示です。貼り付けた後に Enter キーを押してください。保存されたキーがマスクされて表示される npx apiyi@latest auth show を実行すると、確認できます。
npm のグローバルディレクトリが PATH に含まれていません。npm prefix -g を実行して場所を確認し、その bin サブディレクトリを PATH に追加して（~/.zshrc 内で設定）、新しいターミナルを開いてください。nvm で Node を管理している場合、Node のバージョンを切り替えた後は、新しいバージョンでグローバルインストールも再度行う必要があります。
~/.config/apiyi/config.json に保存されています。ファイルモードは 0600 で、自分のユーザーのみが読み取れます。npx apiyi@latest auth clear で削除できます。
CLI の実行には Node 18.17 以降が必要です。node -v を実行してバージョンを確認し、古い場合は Node をアップグレードしてください。
通常の sk- キーでは残高を読み取れません。残高の確認には、nap_ で始まる個人用アクセストークンが必要です: npx apiyi@latest auth set-key --access-token。個人用アクセストークンとは？をご覧ください。

​
関連ドキュメント

AI開発キット · CLI

すべてのコマンド、キーの検索順序、終了コード

APIキーが無効な場合はどうすればよいですか？

checkがinvalid_keyを返す場合にお読みください