PixVerse CLI: генерация ИИ-видео и изображений из терминала

Введение

У каждого творческого рабочего процесса есть узкое место — момент, когда вам нужно выйти из редактора кода, открыть браузер и вручную щелкнуть веб-интерфейс, чтобы создать медиафайл. Для разработчиков, агентов ИИ и всех, кто создает автоматизированные конвейеры контента, такое переключение контекста — это быстро накапливающееся препятствие.

PixVerse CLI устраняет это узкое место. Это официальный интерфейс командной строки для PixVerse, предоставляющий вам доступ к каждой модели, каждой функции и всем возможностям платформы PixVerse — прямо с вашего терминала. Преобразование текста в видео, изображение в видео, преобразование текста в изображение, синхронизация речи, звуковые эффекты, масштабирование — все это можно использовать в сценариях, все можно передавать по каналам, и все это доступно, не касаясь браузера.

Что делает PixVerse CLI особенно мощным, так это его философия дизайна: он был создан с учетом агентов искусственного интеллекта. Каждая команда выводит структурированный JSON, каждый код выхода является детерминированным, а каждый шаг конвейера является компонуемым. Это означает, что вы можете научить Claude Code, Cursor, Codex или любой другой агент генерировать изображения и видео от вашего имени — и они каждый раз будут делать это правильно.

Это руководство проведет вас через весь путь: от установки до первого поколения, а затем к многоэтапным конвейерам автоматизации и собственным рабочим процессам агента.

Предварительные условия

Прежде чем начать, вам необходимо:

• Node.js 20 или выше — проверьте с помощью node --version.
• Аккаунт PixVerse — зарегистрируйтесь на pixverse.ai
• Активная подписка PixVerse — CLI использует ту же кредитную систему, что и веб-сайт; только подписанные пользователи могут создавать контент

PixVerse CLI не требует ручного копирования ключей API. Аутентификация осуществляется через поток OAuth на основе браузера, в котором ваш токен хранится локально.

Шаг 1. Установите интерфейс командной строки

Установите глобально с помощью npm:

npm install -g pixverse

Проверьте установку:

pixverse --version

Если вы предпочитаете не устанавливать глобально, вы также можете запускать команды через npx:

npx pixverse create video --prompt "A cat walking on Mars"

Шаг 2: Аутентификация

Запустите команду входа:

pixverse auth login

CLI открывает браузер для авторизации устройства OAuth. Вы также можете скопировать URL-адрес и завершить авторизацию из любого браузера на любом устройстве, что полезно для SSH и автономных сред. Ваш токен автоматически сохраняется в ~/.pixverse/ и действителен в течение 30 дней.

Чтобы подтвердить, что вы вошли в систему, и проверить доступные кредиты:

pixverse auth status
pixverse account info

Команда account info показывает уровень вашей подписки, оставшиеся кредиты и график ежедневного сброса кредитов. Всегда проверяйте свой баланс перед запуском пакетных заданий.

Шаг 3: Создайте первое изображение

Преобразование текста в изображение — это самый быстрый способ протестировать вашу настройку. Бегать:

pixverse create image --prompt "A photorealistic forest path at golden hour" --json

Флаг --json возвращает структурированный вывод:

{
  "image_id": 789012,
  "status": "completed",
  "image_url": "https://...",
  "prompt": "A photorealistic forest path at golden hour",
  "model": "qwen-image",
  "width": 1024,
  "height": 1024
}

Для вывода с более высоким разрешением укажите модель, которая его поддерживает:

pixverse create image \
  --prompt "A photorealistic forest path at golden hour" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json

PixVerse поддерживает несколько моделей изображений, каждая из которых имеет разное максимальное разрешение и сильные стороны:

Чтобы загрузить сгенерированное изображение:

pixverse asset download 789012

Шаг 4: Создайте свое первое видео

Преобразование текста в видео работает таким же образом. Создайте 5-секундный клип:

pixverse create video --prompt "A sunset over ocean waves" --json

Для полностью кастомизированного поколения:

pixverse create video \
  --prompt "A cinematic drone shot over a misty mountain valley at dawn" \
  --model v6 \
  --quality 1080p \
  --aspect-ratio 16:9 \
  --duration 8 \
  --audio \
  --json

Флаг --audio включает окружающий звук, создаваемый искусственным интеллектом, который соответствует вашему видеоконтенту. Флаг --json по завершении возвращает video_url, который можно передать непосредственно команде загрузки или следующему шагу конвейера.

PixVerse предоставляет несколько видеомоделей с различными возможностями:

Анимация статического изображения

Чтобы превратить фотографию или созданное изображение в видео, укажите флаг --image:

pixverse create video \
  --prompt "Gentle wind moves through the scene" \
  --image ./product-photo.jpg \
  --model v6 \
  --quality 1080p \
  --json

Вы можете передать путь к локальному файлу или URL-адрес. Локальные файлы загружаются автоматически — загрузка вручную не требуется.

Шаг 5. Запустите интерактивный мастер

Если вы исследуете впервые и еще не знакомы со всеми доступными флагами, запустите любую команду создания без аргументов, чтобы войти в управляемый мастер:

pixverse create video
pixverse create image

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

Beyond Generation: управляйте своими активами и рабочим пространством

Последняя версия интерфейса командной строки PixVerse также включает команды управления, которые помогут вам построить комплексные рабочие процессы терминала:

• pixverse task status <id> и pixverse task wait <id> для опроса задач
• pixverse asset list|upload|info|download|delete для операций жизненного цикла актива.
• pixverse saved list|items|new|rename|add|remove|delete для сохраненных папок.
• pixverse workspace list|status|switch|manage для операций с несколькими рабочими пространствами

Это упрощает автоматизацию не только создания, но и организации, загрузки и доставки с помощью одного сценария.

Обучение вашего ИИ-агента созданию медиафайлов

Именно здесь PixVerse CLI становится по-настоящему преобразующим. Поскольку каждая команда возвращает структурированный JSON и использует детерминированные коды завершения, любой ИИ-агент, который может запускать команды оболочки, можно научить генерировать изображения и видео по запросу.

Установка навыков PixVerse

PixVerse Skills — это структурированная библиотека навыков, которая учит агентов правильно использовать интерфейс командной строки: флаги команд, ограничения модели, многоэтапные конвейеры и надежную обработку ошибок.

Для Claude Code и других агентов, поддерживающих формат навыков, добавьте навыки PixVerse напрямую:

npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-and-video-generator

Для Cursor, Claude Code, Codex и других платформ агентов этот навык повышает надежность, предоставляя агенту явные ограничения вместо того, чтобы заставлять его выводить их с нуля.

Как только ваш агент загрузит навыки PixVerse, вы можете давать ему инструкции на естественном языке, например:

• «Создайте 10-секундное демонстрационное видео продукта на основе этого скриншота»
• «Создайте четыре варианта обложки этого блога в формате 16:9».
• «Анимируйте эту диаграмму в 5-секундный поясняющий ролик с окружающим звуком»
• «Создать три 8-секундных промо-ролика 16:9 с разными движениями камеры»

Агент преобразует эти инструкции в правильные команды CLI, анализирует выходные данные JSON, а также обрабатывает опросы и загрузки — ручное вмешательство не требуется.

Клод Код

В Claude Code PixVerse CLI становится встроенным инструментом, который агент использует автономно. После загрузки навыков PixVerse вы можете включить генерацию медиа прямо в любую задачу:

Generate a cover image for this blog post about machine learning,
use the seedream-5.0-lite model at 1800p in 16:9 format,
download it to ./assets/cover.webp

Claude Code вызовет правильные команды CLI, проанализирует URL-адрес изображения из ответа JSON и загрузит файл по указанному вами пути — и все это в рамках того же сеанса, где он также пишет ваш код.

Типичный рабочий процесс Claude Code:

# Claude Code runs this autonomously based on your instruction
IMG=$(pixverse create image \
  --prompt "Abstract visualization of neural network layers, dark background, blue and purple tones" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json | jq -r '.image_url')
 
# Then animates it
pixverse create video \
  --prompt "Slow pan across glowing neural connections" \
  --image "$IMG" \
  --model v6 \
  --quality 1080p \
  --duration 6 \
  --json

Курсор

Пользователи курсора могут загружать навыки PixVerse как файл контекста проекта. Поместите соответствующие файлы навыков в свой каталог .cursor/ или добавьте их в правила своего рабочего пространства. После загрузки Cursor полностью осведомлен о каждой команде PixVerse CLI и может создавать медиафайлы как часть любой задачи кодирования.

Типичный рабочий процесс Cursor: попросите агента создать изображение макета на основе создаваемого вами дизайна, а затем используйте его в качестве ссылки непосредственно в сеансе IDE, даже не выходя из редактора.

Кодекс и другие агенты

PixVerse CLI совместим с любым агентом, который может выполнять команды оболочки и анализировать JSON. Структурированный формат вывода — согласованные имена полей, предсказуемые коды ошибок и сообщения об ошибках, разделенные стандартным кодом stderr, — гарантирует, что даже простые агенты сценариев могут надежно интегрировать генерацию.

Контракт кода выхода упрощает обработку ошибок:

Конвейеры автоматизации

Как только вы поймете отдельные команды, PixVerse CLI откроет мощные многоэтапные рабочие процессы, которые выполняются полностью без взаимодействия с пользователем.

Преобразование текста в изображение в видео

Один из наиболее полезных конвейеров: сгенерируйте изображение с высоким разрешением из текстовой подсказки, а затем анимируйте его в видео.

# Step 1: Generate a base image
IMG_RESULT=$(pixverse create image \
  --prompt "A cyberpunk cityscape at night, neon lights reflecting on wet pavement" \
  --model gemini-3.1-flash \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json)
 
IMAGE_URL=$(echo "$IMG_RESULT" | jq -r '.image_url')
 
# Step 2: Animate it into a video
VID_RESULT=$(pixverse create video \
  --prompt "Camera slowly pans across the neon-lit streets" \
  --image "$IMAGE_URL" \
  --model v6 \
  --quality 1080p \
  --duration 8 \
  --json)
 
VIDEO_ID=$(echo "$VID_RESULT" | jq -r '.video_id')
 
# Step 3: Download the final video
pixverse asset download "$VIDEO_ID" --json

Полный конвейер видеопроизводства

Для идеального результата создайте цепочку с этапами постобработки:

# Step 1: Create the base video
RESULT=$(pixverse create video \
  --prompt "A product being assembled in slow motion" \
  --model v6 \
  --quality 720p \
  --duration 5 \
  --json)
 
VID=$(echo "$RESULT" | jq -r '.video_id')
 
# Step 2: Extend duration
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --prompt "Continue the assembly sequence" \
  --duration 5 \
  --json | jq -r '.video_id')
 
pixverse task wait "$EXTENDED" --json
 
# Step 3: Add ambient sound
WITH_SOUND=$(pixverse create sound \
  --video "$EXTENDED" \
  --prompt "Industrial workshop ambience, soft mechanical sounds" \
  --json | jq -r '.video_id')
 
pixverse task wait "$WITH_SOUND" --json
 
# Step 4: Upscale to 1080p
FINAL=$(pixverse create upscale \
  --video "$WITH_SOUND" \
  --quality 1080p \
  --json | jq -r '.video_id')
 
pixverse task wait "$FINAL" --json
 
# Step 5: Download
pixverse asset download "$FINAL" --json

Пакетная генерация

Для конвейеров контента, требующих нескольких вариантов, запускайте задания параллельно:

# Check credits first
CREDITS=$(pixverse account info --json | jq -r '.credits.total')
echo "Available credits: $CREDITS"
 
# Submit four parallel generations
pixverse create video --prompt "Sunrise over mountains" --no-wait --json > /tmp/v1.json &
pixverse create video --prompt "Sunset over ocean" --no-wait --json > /tmp/v2.json &
pixverse create video --prompt "Stars over a desert" --no-wait --json > /tmp/v3.json &
pixverse create video --prompt "Aurora over a frozen lake" --no-wait --json > /tmp/v4.json &
wait
 
# Wait for each and download
for f in /tmp/v1.json /tmp/v2.json /tmp/v3.json /tmp/v4.json; do
  ID=$(jq -r '.video_id' "$f")
  pixverse task wait "$ID" --json
  pixverse asset download "$ID" --json
done

Флаг --no-wait отправляет задание и немедленно возвращает его с идентификатором задачи, что позволяет вам отправить несколько заданий перед опросом. Команда pixverse task wait выполняет адаптивный опрос за вас — ручные циклы ожидания не требуются.

Настройка значений по умолчанию

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

pixverse config defaults set video model v6
pixverse config defaults set video quality 1080p
pixverse config defaults set image model seedream-5.0-lite
pixverse config set output-dir ~/Downloads/pixverse
pixverse config defaults show

Флаги командной строки всегда переопределяют настроенные вами значения по умолчанию, поэтому вы сохраняете полную гибкость, сокращая при этом повторение.

Что вы можете построить

Благодаря интеграции CLI PixVerse в рабочий процесс вашего агента спектр автоматизируемых задач значительно расширяется:

• Документация – автоматическое создание демонстрационных видеороликов и снимков экрана продукта в рамках процесса создания документа.
• Маркетинг — ночные пакетные задания, которые создают варианты контента для социальных сетей из единой библиотеки подсказок.
• Разработка приложений — позвольте вашему агенту кодирования создавать визуальные элементы-заполнители, анимацию макета или видео экрана загрузки во время создания пользовательского интерфейса.
• Конвейеры контента — объединяйте вызовы CLI с другими инструментами (ffmpeg, ImageMagick, облачное хранилище) для создания полностью автоматизированных рабочих процессов производства мультимедиа.
• Прототипирование — создавайте концепции быстрого движения за считанные секунды для проверки идей перед переходом к полному производству.

Интерфейс командной строки спроектирован таким образом, чтобы естественным образом вписаться в любой рабочий процесс на основе оболочки. Если ваша существующая система автоматизации работает на bash, Python, Node или конвейере CI/CD, PixVerse CLI подключается без каких-либо дополнительных затрат на интеграцию.

Контрольный список для начала работы

• Установите Node.js 20 или выше.
• Запустить npm install -g pixverse
• Запустите pixverse auth login и авторизуйтесь в браузере.
• Запустите pixverse account info для проверки кредитов.
• Создайте первое изображение: pixverse create image --prompt "..." --json
• Создайте свое первое видео: pixverse create video --prompt "..." --json
• Установите навыки PixVerse для вашего агента (Код Клода, Курсор или Кодекс)
• Установите предпочтительные значения по умолчанию с помощью pixverse config defaults set
• Создайте свой первый конвейер автоматизации

Поддержание CLI в актуальном состоянии

Используйте npm для обновления локального CLI:

npm update -g pixverse

Чтобы узнать об изменениях на уровне выпуска и новых поддерживаемых моделях, проверьте официальный журнал изменений CLI:

• Журнал изменений интерфейса командной строки PixVerse

Следующие шаги

Интерфейс командной строки PixVerse на npm (npm install -g pixverse) предоставляет вам немедленный доступ к генерации, опросу задач, управлению активами, сохраненным папкам и элементам управления рабочим пространством из единого интерфейса. В репозиторий PixVerse Skills добавлены готовые для агентов руководства, благодаря которым Claude Code, Cursor, Codex и другие инструменты могут выполнять эти рабочие процессы с большей надежностью.

Сочетание надежного интерфейса командной строки и библиотеки навыков, готовой к работе с агентами, означает, что создание изображений и видео может осуществляться в том же рабочем процессе, что и ваш код, — под управлением того же агента, в том же терминале, без переключения инструментов.

Начните с одной команды. Стройте оттуда.