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: Установка CLI

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

npm install -g pixverse

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

pixverse --version

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

npx pixverse create video --prompt "Кот, идущий по Марсу"

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

Выполните команду входа:

pixverse auth login

CLI выведет короткий URL и код. Откройте URL в браузере, введите код и авторизуйтесь с помощью вашего аккаунта PixVerse. Токен автоматически сохраняется в ~/.pixverse/ и действителен 30 дней.

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

pixverse auth status
pixverse account info

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

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

Генерация текста в изображение — самый быстрый способ проверить настройку. Выполните:

pixverse create image --prompt "Фотореалистичная лесная тропинка в золотой час" --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 "Фотореалистичная лесная тропинка в золотой час" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json

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

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

pixverse asset download 789012

Шаг 4: Создание первого видео

Генерация текста в видео работает аналогично. Создайте 5-секундный клип:

pixverse create video --prompt "Закат над волнами океана" --json

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

pixverse create video \
  --prompt "Кинематографический дрон-шот над туманной горной долиной на рассвете" \
  --model v5.6 \
  --quality 1080p \
  --aspect-ratio 16:9 \
  --duration 8 \
  --audio \
  --json

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

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

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

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

pixverse create video \
  --prompt "Лёгкий ветер двигается по сцене" \
  --image ./product-photo.jpg \
  --model v5.6 \
  --quality 1080p \
  --json

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

Шаг 5: Запуск интерактивного мастера

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

pixverse create video
pixverse create image

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

Обучение ИИ-агента генерации медиаконтента

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

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

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

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

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

Для Cursor навыки расположены в skills/ репозитория PixVerse Skills на GitHub и могут быть загружены как контекст непосредственно в редактор. Для агентов на основе Codex и LangChain каждый файл навыка представляет собой самодостаточный markdown, который можно внедрить в системный запрос агента.

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

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

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

Claude Code

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

Создай обложку для этой статьи блога о машинном обучении,
используй модель seedream-5.0-lite при 1800p в формате 16:9,
скачай в ./assets/cover.webp

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

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

# Claude Code выполняет это автономно на основе вашей инструкции
IMG=$(pixverse create image \
  --prompt "Абстрактная визуализация слоёв нейронной сети, тёмный фон, синие и фиолетовые тона" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json | jq -r '.image_url')
 
# Затем анимирует его
pixverse create video \
  --prompt "Медленный панорамный кадр сияющих нейронных связей" \
  --image "$IMG" \
  --model v5.6 \
  --quality 1080p \
  --duration 6 \
  --json

Cursor

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

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

Codex и другие агенты

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

Контракт кодов завершения делает обработку ошибок простой:

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

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

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

Один из наиболее полезных конвейеров: создание высококачественного изображения из текстового запроса с последующей его анимацией в видео.

# Шаг 1: Создание базового изображения
IMG_RESULT=$(pixverse create image \
  --prompt "Киберпанк-пейзаж ночью, неоновые огни, отражающиеся на мокрой мостовой" \
  --model gemini-3.1-flash \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json)
 
IMAGE_URL=$(echo "$IMG_RESULT" | jq -r '.image_url')
 
# Шаг 2: Анимация в видео
VID_RESULT=$(pixverse create video \
  --prompt "Камера медленно панорамирует по улицам в неоновом свете" \
  --image "$IMAGE_URL" \
  --model v5.6 \
  --quality 1080p \
  --duration 8 \
  --json)
 
VIDEO_ID=$(echo "$VID_RESULT" | jq -r '.video_id')
 
# Шаг 3: Скачивание итогового видео
pixverse asset download "$VIDEO_ID" --json

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

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

# Шаг 1: Создание базового видео
RESULT=$(pixverse create video \
  --prompt "Продукт собирается в замедленной съёмке" \
  --model v5.6 \
  --quality 720p \
  --duration 5 \
  --json)
 
VID=$(echo "$RESULT" | jq -r '.video_id')
 
# Шаг 2: Продление длительности
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --prompt "Продолжение последовательности сборки" \
  --duration 5 \
  --json | jq -r '.video_id')
 
pixverse task wait "$EXTENDED" --json
 
# Шаг 3: Добавление окружающего звука
WITH_SOUND=$(pixverse create sound \
  --video "$EXTENDED" \
  --prompt "Атмосфера производственного цеха, мягкие механические звуки" \
  --json | jq -r '.video_id')
 
pixverse task wait "$WITH_SOUND" --json
 
# Шаг 4: Масштабирование до 1080p
FINAL=$(pixverse create upscale \
  --video "$WITH_SOUND" \
  --quality 1080p \
  --json | jq -r '.video_id')
 
pixverse task wait "$FINAL" --json
 
# Шаг 5: Скачивание
pixverse asset download "$FINAL" --json

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

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

# Сначала проверьте кредиты
CREDITS=$(pixverse account info --json | jq -r '.credits.total')
echo "Доступные кредиты: $CREDITS"
 
# Отправьте четыре параллельных генерации
pixverse create video --prompt "Восход над горами" --no-wait --json > /tmp/v1.json &
pixverse create video --prompt "Закат над океаном" --no-wait --json > /tmp/v2.json &
pixverse create video --prompt "Звёзды над пустыней" --no-wait --json > /tmp/v3.json &
pixverse create video --prompt "Северное сияние над замёрзшим озером" --no-wait --json > /tmp/v4.json &
wait
 
# Дождитесь каждого и скачайте
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 --mode video --model v5.6 --quality 1080p --aspect-ratio 16:9
pixverse config defaults set --mode image --model seedream-5.0-lite --quality 1800p
pixverse config set output-dir ~/Downloads/pixverse

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

Что можно создать

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

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

CLI разработан для естественной интеграции в любой рабочий процесс на основе оболочки. Если ваша текущая автоматизация работает на 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 для вашего агента (Claude Code, Cursor или Codex)
• Настройте предпочтительные значения по умолчанию с помощью pixverse config defaults set
• Создайте свой первый конвейер автоматизации

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

PixVerse CLI на npm (npm install -g pixverse) даёт немедленный доступ ко всем возможностям генерации. Репозиторий навыков PixVerse предоставляет структурированные файлы навыков, обучающие ИИ-агента правильному использованию этих возможностей в любом контексте.

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

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