Skip to content

Ключи

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