CLI
Генерация картинок, видео и музыки из терминала, скриптов и AI-агентов
geckogen — клиент GeckoGen для командной строки. У него те же модели, цены, баланс и история генераций, что и на сайте.
Установка
curl -fsSL https://api.geckogen.app/cli/install.sh | sh
Установщик скачивает один самодостаточный файл под вашу платформу и до установки проверяет подписанный манифест выпуска. Node.js не нужен.
Вход
geckogen auth login
Вход открывается в браузере и подтверждается вашей сессией GeckoGen — копировать ключ не нужно. На машине без браузера: geckogen auth login --manual.
Выбрать модель и прочитать её параметры
У каждой модели свои параметры. Выведите список моделей, затем схему параметров выбранной:
geckogen list_models
geckogen get_model google/nano-banana-pro
Генерация
geckogen generate google/nano-banana-pro \
'{"prompt":"app icon, a jar with a scan frame"}' \
--wait --output-dir ./out
Сервер проверяет параметры по схеме модели и отвечает понятной ошибкой, если значение неверное. --wait ждёт окончания генерации, --output-dir скачивает результат.
Полезные команды
| Команда | Что делает |
|---|---|
geckogen quote_generation | Показывает цену генерации в токенах до запуска |
geckogen get_me | Показывает баланс токенов |
geckogen list_generations | Выводит историю генераций |
geckogen wait_generation <id> | Ждёт окончания запущенной генерации |
geckogen artifact download <id> <dir> | Скачивает все результаты готовой генерации |
geckogen batch | Запускает пакет генераций из JSONL с докачкой |
geckogen update | Обновляет CLI до последнего выпуска |
Флаги любой команды: geckogen <команда> --help.
Если генерация не удалась, токены возвращаются на баланс. Остановка CLI не останавливает уже запущенную генерацию.