Higgsfield CLI: как делать ролики из терминала и запускать ночной батч

Ролики обычно делают руками: открыл браузер, выбрал модель, ввёл промпт, подождал, скачал. Когда таких роликов нужно пятьдесят, браузер становится узким местом. Higgsfield CLI убирает интерфейс и оставляет команды.

Что такое Higgsfield CLI

Открытый клиент Higgsfield для терминала. Он ставится одной командой, логинится через браузер и работает с теми же моделями, что веб-приложение: Seedance 2.5, Kling v3.0, Veo 3.1, Wan 3.0, Nano Banana Pro, GPT Image 2.5, FLUX.2. Всего в каталоге больше тридцати пяти моделей и инструментов, включая апскейлеры и анализ видео.

Ключевое отличие от API: не нужен ключ. Вы входите под своим аккаунтом, и генерации списываются с того же баланса кредитов, что и в вебе. Код и релизы лежат на GitHub, разбор возможностей есть в блоге Higgsfield.

Одна оговорка, которая многих удивляет: безлимит веб-тарифа на CLI не распространяется. Каждая генерация из терминала тарифицируется по обычным ставкам.

Установка и вход

Три способа поставить, выбирайте под свою систему.

# macOS и Linux
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
brew install higgsfield-ai/tap/higgsfield

# любая платформа, включая Windows
npm install -g @higgsfield/cli

Дальше проверка версии и вход.

higgsfield version
higgsfield auth login
higgsfield account status

auth login открывает браузер, вы подтверждаете доступ и возвращаетесь в терминал. account status показывает почту, тариф и остаток кредитов. Токен хранится локально и живёт недолго: если появилось «Session expired», просто войдите заново.

Один ролик: сначала цена, потом генерация

Правильный порядок такой: посчитать стоимость, потом запускать. Команда cost принимает те же параметры, что create, и денег не списывает.

higgsfield generate cost seedance_2_5 \
  --prompt "drone shot over a mountain valley at sunrise" \
  --duration 5 --resolution 1080p

higgsfield generate create seedance_2_5 \
  --prompt "drone shot over a mountain valley at sunrise" \
  --aspect_ratio 16:9 --duration 5 --resolution 1080p --mode t2v \
  --wait --wait-timeout 20m --json

Флаг --wait держит терминал до результата и печатает ссылку. Таймаут по умолчанию десять минут, для тяжёлых рендеров его поднимают до двадцати. Если рендер не успел, команда отвалится по таймауту, но задача продолжит считаться на сервере: id останется, результат можно забрать позже через generate get.

Ночной батч

Батч строится на простой механике: без --wait команда сразу возвращает id задачи, а не ждёт рендера. Значит, можно запустить очередь и уйти спать.

Файл prompts.txt, по одному промпту в строке. Скрипт создаёт задачи и складывает id.

while IFS= read -r prompt; do
  higgsfield generate create seedance_2_5 \
    --prompt "$prompt" --duration 5 --resolution 1080p --json \
    | jq -r '.[]' >> job_ids.txt
done < prompts.txt

Утром второй проход ждёт каждую задачу и вытаскивает ссылки.

while IFS= read -r id; do
  higgsfield generate wait "$id" --json \
    | jq -r '.result_url' >> result_urls.txt
done < job_ids.txt

Дальше wget или curl складывают файлы в папку, а generate list --json показывает, что упало и на каком статусе. Всё это ставится в cron на два часа ночи, и к завтраку у вас пятьдесят готовых клипов.

Три правила, без которых батч превращается в лотерею. Ставьте --wait-timeout с запасом. Сохраняйте id сразу, а не после рендера. И проверяйте account status перед запуском: если кредитов не хватит на середину очереди, половина задач упадёт с ошибкой.

Сколько это стоит

Официальный пример: пятисекундный клип Seedance 2.5 в 1080p стоит 80 кредитов. Тот же клип в черновом режиме --draft true обходится в 15 кредитов.

Отсюда рабочая стратегия. Ночью гоняете дешёвые черновики по всем пятидесяти промптам, утром отбираете десять удачных и перегоняете их в полное качество. Бюджет: 50 × 15 плюс 10 × 80, то есть 1 550 кредитов вместо 4 000, если рендерить всё сразу.

Проверять расходы удобно командой account transactions --size 5: она показывает последние списания с моделью и суммой. Цены зависят от модели, длительности и разрешения, поэтому generate cost остаётся главным инструментом планирования.

Что ещё умеет CLI

Кроме генерации с нуля есть готовые workflow. reframe пересобирает горизонтальный ролик в вертикаль под рилс. dubbing переводит озвучку на другой язык. voice-change меняет голос. draw_to_video правит видео по наброску кадра. explainer_video собирает объясняющий ролик из блоков с озвучкой.

Отдельно стоит Soul ID: персонаж обучается по фотографиям, до двадцати штук, и потом вызывается в любом совместимом Image-модели. Для серии роликов с одним героем это экономит часы.

Где ломается

Первое: безлимит не работает, о нём забывают и удивляются счёту.

Второе: таймауты. Длинные рендеры не успевают в десять минут, а задача при этом жива. Лечится --wait-timeout и привычкой сохранять id.

Третье: часть workflow не умеет считать стоимость заранее. Для voice-change и dubbing команда cost не поддерживается, цену видно только по факту.

Четвёртое: идентификаторы моделей меняются между релизами. Если появилось «Unknown model», смотрите higgsfield model list, а не старые примеры из статей.

Пятое: токен доступа это секрет. Не вставляйте его в промпты, логи и скриншоты.

С чего начать

Возьмите пять промптов, прогоните cost на каждом и сравните с балансом. Запустите ночью в черновом режиме, утром посмотрите, сколько задач дошло и сколько пришлось переделывать.

Если из пяти черновиков получился один пригодный, значит промпты надо чинить, а не увеличивать батч. Если четыре из пяти, можно масштабировать до пятидесяти и ставить в cron.