Artillect CLI

Генерация картинок и видео из терминала. Тот же аккаунт и баланс, что в студии.

Установка

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

npm

npm install -g @artillect/cli

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

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

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

Quickstart

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

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

Примеры

Картинка

seedream-5-pro

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

Картинка — Meta Muse Image

muse-image

artillect generate image \
  --model muse-image \
  --prompt "poster for a futuristic concert" \
  --aspect-ratio 16:9 \
  --num-images 3 \
  --output-format webp \
  --wait --open

Для edit добавьте до 10 значений --input; доступны --num-images 1..10, --aspect-ratio, --output-format jpeg|png|webp и --sync-mode.

Картинка — примерка одежды

google-virtual-try-on

artillect generate image \
  --model google-virtual-try-on \
  --input ./person.jpg \
  --input ./jacket.jpg \
  --num-images 2 \
  --wait --open

Ровно два --input: сначала фото человека, затем фото вещи. Доступны --num-images 1..4; промпт и формат вывода не нужны.

Видео — FLUX Video Upscale

flux-video-upscale

artillect generate upscale\n  --model flux-video-upscale\n  --video ./clip.mp4\n  --upscale-factor 2\n  --creativity 0\n  --wait --open

3D-модель — Meshy 7

meshy-v7-multi-i2m

artillect generate mesh \
  --model meshy-v7-multi-i2m \
  --image ./front.png \
  --image ./side.png \
  --target-polycount 30000 \
  --should-texture true \
  --enable-pbr true \
  --wait --open

Для multi-image повторяйте --image от 1 до 4 раз. Для text-to-3D используйте --prompt; дополнительные параметры Meshy 7 доступны через флаги команды и --extra.

Видео — Grok

grok-imagine-video

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

Видео — Kling 3 со стартовым кадром

kling-3

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

Видео — Seedance 2.5 с референсом

seedance-2.5

artillect generate video seedance-2.5 \
  -p "герой идёт по улице, спокойный план" \
  --duration 10 \
  --resolution 1080p \
  --output-format mov \
  --ref-image ./sheet.png \
  --project 12 \
  --wait

--output-format доступен здесь как mp4 (по умолчанию, компактнее и совместимее) или mov (выше битрейт для монтажа, файл больше). Параметр относится только к Seedance 2.5.

Видео — Wan 3 Prime с документом

wan-30-prime

artillect generate video wan-30-prime \
  --prompt "сделай ролик по материалам продукта" \
  --ref-file https://example.com/product.pdf \
  --resolution 720P \
  --duration 8 \
  --audio true \
  --seed 12345 \
  --wait

--ref-file принимает один публичный URL документа. --ref-link — один публичный URL веб-страницы; документ и веб-страницу нельзя передавать одновременно. Для локального файла сначала загрузите его в доступное публичное хранилище.

Видео — MiniMax H3 Max

minimax-h3-max

artillect generate video minimax-h3-max
  --prompt "камера плавно облетает стеклянный павильон"
  --ref-image ./subject.png
  --ref-video ./motion.mp4
  --ref-audio ./voice.mp3
  --resolution 480P
  --duration 8
  --aspect-ratio 16:9
  --prompt-expansion-mode quality
  --enable-safety-checker true
  --wait

Доступны --start-image и --end-image для i2v/first-last; --prompt-expansion-mode принимает disabled|balanced|quality. --sync-mode нужен только если результат должен прийти base64.

Цена до сабмита

estimate

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

Каталог

models

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

models list и models get показывают лимиты из Public API. Для генераторов это prompt ≤ N символов; для chat — контекст OpenRouter и максимум вывода провайдера. У seedance-2.5 лимит prompt — около 40 000 символов (лимит провайдера — 10 000 токенов, оценка 4 символа/токен). Вход Public API для chat — до 200 000 символов, max_tokens — 1–8 192.

Элементы и storage

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

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

storage

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

kling-3 — нативный элемент

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

не Kling — @Name как реф

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

Задачи

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

get / wait

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

Команды

Команда	Зачем
artillect auth	login / logout / status
artillect balance	баланс токенов
artillect health	проверка доступности Public API
artillect feedback	отправить JSON feedback
artillect models	list / get — каталог и схема параметров с сервера
artillect generate	image / mesh / video / audio / switchx / upscale / get / wait / cancel / list
artillect estimate	цена до генерации, без списания
artillect upload	загрузить файл, получить ast_…
artillect assets	list / get / copy — storage ast_…
artillect projects	CRUD / roles / members / invite / generations / analytics / billing
artillect folders / folder-create	list / create папок сайдбара
artillect elements	list / create — @Name в проекте
artillect element	update / delete / reorder — @Name в проекте
artillect generation	tags / like / copy / move / delete
artillect tags	list / create / delete тегов проекта
artillect favorites	список избранных генераций проекта
artillect chat	completion и server-side chat threads
artillect webhook / media	webhooks; media trim/concat пока WIP и отключены в production

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

artillect generate cancel <task_id> возвращает токены только в первые 4 секунды, до отправки провайдеру. После этого сервер отвечает 409 GENERATION_NOT_CANCELLABLE.

Флаги

Флаг	Зачем
--wait	ждать готовности и скачать файл
--wait-timeout	лимит ожидания, по умолчанию 20m (ещё 90s, 10m)
--out	папка для файлов, по умолчанию текущая
--open	открыть скачанный файл (macOS Preview / плеер)
--json	сырой JSON для скриптов
--project	id проекта: лента, storage, @элементы
--cursor	следующая страница list
--duration	длительность видео, секунды
--resolution	720p / 1080p / 4k / размер картинки
--aspect-ratio	например 16:9, 1:1
--quality / --size	параметры image-моделей, если поддерживаются каталогом
--num-images	количество изображений, если поддерживается моделью
--output-format / --sync-mode	формат и режим выдачи, если поддерживаются моделью
--ref-image	референс-картинки (повторяемый)
--input / --image / --video	входной файл, URL или ast_… для image/mesh/upscale
--start-image / --end-image	первый и последний кадр видео
--source-video / --motion-video	исходное и motion-reference видео
--audio-url / --generate-audio	аудио-вход и генерация аудиодорожки видео
--ref-file	один публичный URL документа для Wan 3 / Prime
--ref-link	одна публичная веб-страница для Wan 3 / Prime
--audio / --seed	аудиодорожка и воспроизводимый seed Wan 3 / Prime
--nsfw-checker	проверка контента для Wan 3 / Prime
--extra	JSON-объект, дополнительные поля тела API
--billing-source / --tag-id	источник баланса и destination tags для project submit
--idempotency-key	безопасный retry платной операции после сетевого таймаута

Результат

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

Media operations (artillect media) пока WIP: в production команда возвращает 503 MEDIA_OPERATIONS_WIP до включения feature flag.

Обновление

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

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

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

npm: @artillect/cli · markdown: /docs/artillect-cli.md · API: /docs · MCP: /docs/mcp