Ключи
echo-words берёт ключи из одного файла, .deploy/.env в вашей копии
репозитория, где бы ни работал его сервер. Создайте его из шаблона:
mkdir -p .deploy
cp .deploy.example/.env .deploy/.env
На Oracle Cloud каждое развёртывание копирует его на виртуалку, а на вашем компьютере приложение читает его прямо на месте.
Gemini: единственный обязательный ключ
GEMINI_API_KEY=...
Создайте его бесплатно в Google AI Studio. Gemini — основная модель бесплатного пула, она делает большую часть работы: в замерах, где были заполнены все ключи, она написала примерно четыре ответа из пяти. Одного этого ключа приложению достаточно.
Ещё бесплатные ключи: подстраховка, по желанию
GROQ_API_KEY=...
OPENROUTER_API_KEY=...
ZAI_API_KEY=...
Все бесплатные: Groq, OpenRouter, Z.AI. Каждый добавленный ключ приводит в пул новые модели. Они соревнуются с Gemini за каждый ответ и подхватывают работу, когда Gemini медлит, исчерпал бесплатную квоту или недоступен.
OpenAI: по желанию, платный
OPENAI_API_KEY=...
Создайте его в OpenAI. Он оплачивает три вещи: подробную статью, которую вы просите одним нажатием, карточку, на которую не смог ответить бесплатный пул, и поиск слова по написанному вами на своём языке, когда на него не ответил Gemini. Без него подробная статья сообщает, что недоступна, карточка, на которой пул не справился, показывает ошибку, а при поиске слова остаётся ответ той бесплатной модели, которая его дала.
Стоит это немного. Подробная статья обходится примерно в $0,036, так что на
доллар их выходит около 28, а платная карточка или платный поиск слова стоят
доли цента. Карточка уходит к платной модели, только когда бесплатный пул не
смог на неё ответить или когда вы сами просите платную модель для неудавшейся
карточки. Слово или фраза на вашем языке — после ! или буквами, которых нет в
изучаемом языке, — уходят к ней, когда бесплатный пул не ответил, а также когда
вместо Gemini ответила другая модель пула: такие модели гораздо чаще подбирают
не то слово, а на сервере автора они пишут примерно каждый седьмой ответ. При
собственном использовании автора за 30 дней до 2 октября 2026 года 14 подробных
статей и 12 платных карточек обошлись всего примерно в $0,53. Кроме того,
приложение останавливается после 100 платных вызовов в день; это меняет
ECHOWORDS_API_DAILY_CAP. ECHOWORDS_API_MODEL= выключает платные вызовы
совсем, даже если ключ задан.
Логин AnkiWeb
ECHOWORDS_ANKIWEB_USER=...
ECHOWORDS_ANKIWEB_PASSWORD=...
Серверу нужен ваш логин AnkiWeb, чтобы карточки попадали в ваши колоды; см.
Настройку. uv run inv dev на своём компьютере не
синхронизируется с AnkiWeb, поэтому логин ему не нужен.
Проверка
Экран Состояние в приложении показывает, каких ключей не хватает. Список ключей бесплатного пула принадлежит llmbroker, библиотеке, которая и ведёт пул, и эта команда печатает его для установленной версии с теми же ссылками на регистрацию:
uv run python -m llmbroker env freetier