Artillect CLI

Установка

Node.js 20 или новее.

npm install -g @artillect/cli

Без глобальной установки: npx @artillect/cli@latest --help

Быстрый старт

Войти через браузер, сгенерировать картинку, дождаться файла и открыть его.

artillect auth login
artillect generate image --prompt "кот в космосе" --wait --open

Ключ также можно задать через ARTILLECT_API_KEY.

Примеры

artillect generate image \
  --model seedream-5-pro \
  --prompt "современная архитектура, золотой час" \
  --wait --open

artillect generate video grok-imagine-video \
  --prompt "кот идёт по комнате, простой план" \
  --wait --open

artillect generate video kling-3 \
  --prompt "медленный проезд камеры через лес на рассвете" \
  --start-image ./first.png \
  --wait

artillect estimate image -m seedream-5-pro -p "кот в космосе"
artillect estimate video -m grok-imagine-video -p "кот идёт"

artillect models list
artillect models list -k video
artillect models get grok-imagine-video --json

Элементы и storage

Файл в storage — стабильный ast_…. Список страницами: если в конце есть дальше --cursor …, повторите команду с этим флагом.

Элемент — запись в библиотеке проекта: в промпте @Hero. Хранится в Kling-shape. Как уходит в модель, решает сервер: у kling-3 / kling-o3 это нативные элементы провайдера (не turbo); у остальных моделей @Hero парсится и frontal подставляется как референс. Нужен --project.

artillect projects list
artillect upload ./hero.png --project 12
artillect assets list --project 12
artillect assets list --project 12 --cursor ast_01ARZ3NDEKTSV4RRFFQ69G5FAV

artillect elements create --project 12 --name Hero --file ./hero.png
artillect generate video kling-3 \
  --project 12 \
  --prompt "@Hero идёт по улице" \
  --start-image ast_01ARZ3NDEKTSV4RRFFQ69G5FAV \
  --wait

artillect generate video seedance-2 \
  --project 12 \
  --prompt "@Hero идёт по улице" \
  --wait

Задачи

Без --wait команда сразу печатает task_id. Дальше можно смотреть статус, ждать файл или отменить.

artillect generate image --prompt "кот" 
artillect generate get <task_id>
artillect generate wait <task_id> --open
artillect generate cancel <task_id>

Команды

Подсказки по флагам: artillect --help, artillect generate image --help.

Флаги

Результат

С --wait CLI печатает путь к файлу в текущей папке. С --open сразу открывает его. Без флага — open ./artillect-….png на macOS или клик по пути в Terminal.

Обновление

npm сам пакет на компьютере не обновляет. Когда выйдет версия, CLI подскажет в терминале. Поставить новую: npm i -g @artillect/cli@latest

Если не работает

• Нет входа — artillect auth login или ARTILLECT_API_KEY.
• Каталог всегда с сервера: artillect models list. Слаги вроде kling-3, не kie-vp-….
• Для скриптов: --json. Прогресс идёт в stderr, результат — в stdout.