Краткий ответ
npx apiyi@latest загружает CLI, запускает его один раз и не оставляет после себя никаких файлов, поэтому команда apiyi не добавляется в вашу систему. Для каждой последующей команды требуется полный префикс npx apiyi@latest …, например, чтобы сохранить свой ключ:
apiyi, установите его глобально один раз: npm i -g apiyi.
Симптом
При первой самопроверке сообщается, что ключ отсутствует, а команда из подсказки завершается с ошибкой:Причина
npx запускает CLI из временного кэша npm и не добавляет apiyi в ваш PATH. В версии 0.2.1 и более ранних версиях в подсказке использовалась краткая форма apiyi auth set-key, поэтому её копирование приводило непосредственно к этой ошибке.
Начиная с 0.2.2, CLI определяет, когда он запускается через npx, и выводит в подсказках полную форму npx apiyi@latest auth set-key; --help также содержит это объяснение.
Исправление
- Продолжайте использовать npx (рекомендуется, ничего устанавливать не нужно)
- Установите глобально один раз
- Используйте переменную окружения
Добавляйте
npx apiyi@latest перед каждой командой. Вы всегда получаете последнюю версию, и на вашем компьютере ничего не остаётся:Первоначальная настройка: пошаговая инструкция
1
Скопируйте ключ
Откройте страницу токенов и скопируйте token, начинающийся с
sk-; если у вас его нет, сначала создайте.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. status со значением ok означает, что ключ действителен и узел доступен.4
Отправьте первое сообщение
Выполните
npx apiyi@latest chat "Hello" -m gpt-5.4-mini. Если вы получили ответ и видите расход tokens, значит, всё работает.Частые вопросы
После вставки ключа на экране ничего не происходит. Он вставился?
После вставки ключа на экране ничего не происходит. Он вставился?
Ввод скрыт; после вставки просто нажмите Enter. Чтобы убедиться, выполните
npx apiyi@latest auth show — команда выведет сохранённый ключ в замаскированном виде.Я выполнил npm i -g apiyi, но команда всё равно не найдена
Я выполнил npm i -g apiyi, но команда всё равно не найдена
Глобальный каталог npm не добавлен в PATH. Выполните
npm prefix -g, чтобы узнать его расположение, добавьте его подкаталог bin в PATH (в ~/.zshrc), затем откройте новый терминал. Если вы управляете Node с помощью nvm, при смене версии Node также потребуется повторно выполнить глобальную установку для новой версии.Где хранится ключ и как его удалить?
Где хранится ключ и как его удалить?
В
~/.config/apiyi/config.json, с правами доступа к файлу 0600, поэтому прочитать его можете только вы. Удалите его с помощью npx apiyi@latest auth clear.Сообщение говорит, что моя версия Node устарела
Сообщение говорит, что моя версия Node устарела
Для CLI требуется Node версии 18.17 или новее. Выполните
node -v, чтобы проверить версию, и обновите Node, если она старше.При проверке баланса также появляется сообщение no_key или permission denied
При проверке баланса также появляется сообщение no_key или permission denied
Обычный ключ
sk- не может читать данные о балансе. Для просмотра баланса нужен персональный токен доступа (начинается с nap_): npx apiyi@latest auth set-key --access-token. См. раздел Что такое персональный токен доступа?Связанные документы
Набор разработчика AI · CLI
Все команды, порядок поиска ключа и коды завершения
Что делать, если мой API-ключ недействителен?
Прочитайте это, если
check возвращает invalid_key