PixVerse CLI: генеруйте відео й зображення за допомогою ШІ в терміналі
Вступ
У кожному творчому процесі є вузьке місце — момент, коли доводиться залишити редактор коду, відкрити браузер і вручну пройти вебінтерфейс, щоб згенерувати медіаматеріал. Для розробників, ШІ-агентів і всіх, хто створює автоматизовані конвеєри контенту, таке перемикання контексту створює труднощі, які швидко накопичуються.
PixVerse CLI усуває це вузьке місце. Це офіційний інтерфейс командного рядка PixVerse, який надає доступ до генерування в PixVerse та робочих процесів робочого простору безпосередньо з термінала. Перетворення тексту на відео, зображення на відео, тексту на зображення, зображення на зображення, переходи, генерування голосу, генерування музики, відео за референсами, керування рухом, шаблони, підвищення роздільної здатності та керування ресурсами — усе це можна використовувати в скриптах і конвеєрах без відкриття браузера. Щоб знайти найкоротший шлях установлення та огляд налаштування агентів, почніть з офіційної сторінки PixVerse CLI.
Особливу користь PixVerse CLI забезпечує його філософія розробки: його створено з урахуванням потреб ШІ-агентів. Команди можуть повертати структурований JSON із --json або -p, коди завершення детерміновані, а кожен крок конвеєра можна поєднувати з іншими. Це означає, що ви можете навчити Claude Code, Cursor, Codex або будь-якого іншого агента генерувати зображення, відео, голос і музику від вашого імені з меншою кількістю ненадійних передач між етапами.
Цей посібник узгоджено з поточним README репозиторію PixVerseAI/cli на GitHub, його публічним маніфестом можливостей і сторінкою продукту PixVerse CLI, перевіреними 13 липня 2026 року. PixVerse CLI постійно оновлюється через репозиторій GitHub, тому скриптам для виробничого використання все одно слід перевіряти pixverse --version, pixverse create <mode> --help і pixverse update перед великим пакетним запуском.
Передумови
Перш ніж почати, вам знадобляться:
- 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 "A cat walking on Mars"
Крок 2: пройдіть автентифікацію
Виконайте команду входу:
pixverse auth login
CLI відкриває браузер для авторизації пристрою через OAuth. Ви також можете скопіювати URL і завершити авторизацію в будь-якому браузері на будь-якому пристрої, що зручно для SSH і середовищ без графічного інтерфейсу. Ваш токен автоматично зберігається в ~/.pixverse/ і діє протягом 30 днів.
Щоб перевірити, чи ви ввійшли в систему, і переглянути доступні кредити:
pixverse auth status
pixverse account info
pixverse account slots
Команда account info показує рівень вашої підписки, кредити робочого простору та контекст використання. pixverse account usage допомагає переглянути витрати кредитів, а pixverse account slots показує поточні слоти паралельного генерування для завдань зі зображеннями й відео. Сеанси CLI незалежні від сеансів вебверсії та застосунку PixVerse, а збережений токен CLI можна видалити за допомогою pixverse auth logout. Завжди перевіряйте баланс і доступні слоти перед запуском пакетних завдань.
Команди для швидкого старту
Якщо вам потрібен лише найкоротший шлях від установлення до згенерованого ресурсу, почніть із цієї послідовності:
npm install -g pixverse
pixverse auth login
pixverse create image --prompt "A photorealistic forest path at golden hour" --json
pixverse create video --prompt "A sunset over ocean waves" --model v6 --quality 720p --duration 5 --json
Для робочих процесів агентів і CI залишайте --json або -p увімкненими, щоб stdout залишався машиночитним, а повідомлення про перебіг роботи й помилки надходили до stderr. Для повторних спроб у виробничому середовищі додавайте --idempotency-key <key> до команд створення, щоб повторне надсилання випадково не створювало дублікати платних завдань.
Крок 3: згенеруйте перше зображення
Генерування зображення з тексту — найшвидший спосіб перевірити налаштування. Виконайте:
pixverse create image --prompt "A photorealistic forest path at golden hour" --json
У поточному README на GitHub GPT Image 2 зазначено як модель зображень за замовчуванням. Для відтворюваної автоматизації все одно задавайте --model явно та перевіряйте актуальну довідку CLI або capabilities.json перед пакетною роботою. Прапорець --json повертає структурований вивід:
{
"image_id": 789012,
"status": "completed",
"image_url": "https://...",
"prompt": "A photorealistic forest path at golden hour",
"model": "gpt-image-2.0",
"width": 1440,
"height": 1440
}
Для результату з вищою роздільною здатністю вкажіть модель, яка її підтримує:
pixverse create image \
--prompt "A photorealistic forest path at golden hour" \
--model seedream-5.0-lite \
--quality 2160p \
--aspect-ratio 16:9 \
--json
PixVerse підтримує кілька моделей зображень, кожна з яких має різні максимальні роздільні здатності та підтримувані співвідношення сторін:
| Модель | Значення --model |
Якість | Примітки |
|---|---|---|---|
| GPT Image 2 | gpt-image-2.0 |
1080p, 1440p, 2160p | Модель зображень за замовчуванням; підтримує широкі та вертикальні формати |
| Nano Banana 2 | gemini-3.1-flash |
512p, 1080p, 1440p, 2160p | Гнучке налаштування auto і стандартні співвідношення сторін |
| Nano Banana 2 Lite | gemini-3.1-flash-lite |
1080p | Полегшений варіант Nano Banana 2 для швидкої роботи із зображеннями |
| Qwen Image | qwen-image |
720p, 1080p | Швидке генерування для поширених творчих завдань |
| Nano Banana Pro | gemini-3.0 |
1080p, 1440p, 2160p | Створення високоякісних зображень більшого розміру |
| Nano Banana | gemini-2.5-flash |
1080p | Полегшене генерування зображень зі швидким отриманням результату |
| Seedream 5.0 Pro | seedream-5.0-pro |
1080p, 1440p | Підтримує стандартні співвідношення сторін і роботу із зображеннями за кількома референсами |
| Seedream 5.0 Lite | seedream-5.0-lite |
1440p, 1800p, 2160p | Творчі зображення з високою деталізацією |
| Seedream 4.5 | seedream-4.5 |
1440p, 2160p | Генерування зображень високої роздільної здатності |
| Seedream 4.0 | seedream-4.0 |
1080p, 1440p, 2160p | Додатковий варіант Seedream для роботи із зображеннями |
| Kling Image O3 | kling-image-o3 |
1080p, 1440p, 2160p | Стилізовані візуальні результати з гнучким кадруванням |
| Kling Image V3 | kling-image-v3 |
1080p, 1440p | Баланс якості та швидкості |
Ви також можете перетворити наявне зображення в режимі «зображення в зображення»:
pixverse create image \
--prompt "Turn this product photo into a clean watercolor illustration" \
--image ./product-photo.png \
--model gpt-image-2.0 \
--json
Щоб завантажити згенероване зображення:
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 пропонує кілька відеомоделей із різною якістю, тривалістю та підтримкою режимів:
| Модель | Значення --model |
Максимальна якість | Тривалість | Примітки |
|---|---|---|---|---|
| PixVerse V6 | v6 |
1080p | 1–15 с | Відеомодель за замовчуванням; широка підтримка співвідношень сторін |
| PixVerse C1 | pixverse-c1 |
1080p | 1–15 с | Розвинена підтримка створення відео, роботи з референсами та переходами |
| Seedance 2.0 Standard | seedance-2.0-standard |
2160p | 4–15 с | Підтримує режими відео, референсів і переходів |
| Seedance 2.0 Fast | seedance-2.0-fast |
720p | 4–15 с | Швидший варіант Seedance для режимів відео, референсів і переходів |
| Seedance 2.0 Mini | seedance-2.0-mini |
720p | 4–15 с | Полегшений варіант Seedance для режимів відео, референсів і переходів |
| Google Gemini Omni | gemini-omni-flash |
720p | 3–10 с | Підтримує створення відео та роботу з референсами у форматі 16:9 або 9:16 |
| Happy Horse 1.0 | happyhorse-1.0 |
1080p | 3–15 с | Варіант відеомоделі, що враховує аудіо, доступний для create video |
| Kling O3 Pro | kling-o3-pro |
720p | 3–15 с | Підтримує створення відео, роботу з референсами та переходами |
| Kling O3 Standard | kling-o3-standard |
720p | 3–15 с | Стандартний варіант Kling O3 |
| Kling 3.0 Pro | kling-3.0-pro |
720p | 3–15 с | Підтримує створення відео та роботу з переходами |
| Kling 3.0 Standard | kling-3.0-standard |
720p | 3–15 с | Стандартний варіант Kling 3.0 |
| Grok Imagine 1.5 | grok-imagine-1.5 |
720p | 1–15 с | Лише перетворення зображення на відео; потребує --image і зберігає співвідношення сторін вхідного зображення |
| Grok Imagine | grok-imagine |
720p | 1–15 с | Попередній варіант Grok; підтримує створення відео, продовження та роботу з референсами |
| Veo 3.1 Lite | veo-3.1-lite |
1080p | 4, 6 або 8 с | Підтримує створення відео та переходів із 2 кадрів |
| Veo 3.1 Standard | veo-3.1-standard |
2160p | 4, 6 або 8 с | Варіант Veo з вищою роздільною здатністю |
| Veo 3.1 Fast | veo-3.1-fast |
2160p | 4, 6 або 8 с | Швидший варіант Veo |
| Sora 2 Pro | sora-2-pro |
1080p | 4, 8 або 12 с | Варіант Sora з фіксованою тривалістю |
| Sora 2 | sora-2 |
720p | 4, 8 або 12 с | Стандартний варіант Sora |
| PixVerse v5.6 | v5.6 |
1080p | 1–10 с | Досі використовується для керування рухом і окремих процесів генерування |
| PixVerse v5.5 | v5.5 |
1080p | 1–10 с | Використовується для робочих процесів create modify |
| PixVerse v5 | v5 |
1080p | 1–10 с | Використовується для переходів із 3+ кадрів |
Партнерські моделі, як-от Seedance, Kling, Veo, Sora, Gemini Omni, Grok Imagine і HappyHorse, доступні в PixVerse. Використовуйте той самий інтерфейс CLI, щоб порівняти їх із PixVerse V6 і C1.
Анімуйте статичне зображення
Щоб перетворити фотографію або згенероване зображення на відео, вкажіть прапорець --image:
pixverse create video \
--prompt "Gentle wind moves through the scene" \
--image ./product-photo.jpg \
--model v6 \
--quality 1080p \
--json
Можна передати шлях до локального файлу або URL. Локальні файли завантажуються автоматично — окремий крок ручного завантаження не потрібен. Локальні вхідні зображення, що перевищують 1920x1920 або 5MB, автоматично зменшуються або стискаються перед завантаженням; віддалені URL зображень перевіряються серверною частиною без змін.
Для Grok Imagine 1.5 зображення обов’язкове, а співвідношення сторін результату відповідає цьому зображенню:
pixverse create video \
--prompt "Slow camera push-in, subtle fabric motion, clean native ambience" \
--image ./campaign-poster.png \
--model grok-imagine-1.5 \
--quality 720p \
--duration 6 \
--json
Використовуйте референси, переходи, керування рухом і шаблони
Поточна версія CLI підтримує більше, ніж просте перетворення тексту на відео та зображення на відео. Ці режими створення корисні, коли вам потрібен більший контроль над персонажами, ключовими кадрами, редагуванням або ефектами:
# Create a transition between keyframes
pixverse create transition --images ./frame1.png ./frame2.png
# Generate speech audio from text
pixverse create voice --text "Welcome to the launch" --voice-id <preset_voice_id> --output ./voiceover.mp3
# Generate music from a prompt
pixverse create music --prompt "A cinematic synth-pop intro with bright percussion" --auto-lyrics
pixverse create music --prompt "Uplifting piano theme for a product reveal" --instrumental --duration-seconds 60
# Extend a generated video
pixverse create extend --video <video_id>
# Modify an existing video
pixverse create modify --video <video_id> --prompt "Change the background to a beach"
# Upscale video resolution
pixverse create upscale --video <video_id> --quality 1080p
# Generate video with reference images
pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park"
# Seedance 2.0 reference can mix image and video inputs
pixverse create reference \
--model seedance-2.0-standard \
--images ./character.png \
--videos ./motion.mp4 \
--prompt "@image1 follows the motion in @video1"
# Seedance 2.0 models support up to 9 reference images
pixverse create reference \
--model seedance-2.0-standard \
--images ./char1.png ./char2.png ./char3.png ./char4.png \
--prompt "@image1 and @image2 walk through the scene together"
# Motion control with a character image and motion reference video
pixverse create motion-control --image ./character.png --video ./dance.mp4
# Create from a template or effect
pixverse create template --template-id 12345 --image ./photo.png
Не кожна модель підтримує всі режими створення. У поточній матриці README create video підтримує v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Happy Horse 1.0, Kling O3, Kling 3.0, Grok Imagine, Veo 3.1, Sora 2 і v5.6. grok-imagine-1.5 підтримує лише перетворення зображення на відео та потребує --image; create extend підтримує v6 і grok-imagine; create reference підтримує v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Kling O3, grok-imagine і v5.6; переходи з 2 кадрів підтримують новіші сімейства відеомоделей; переходи з 3+ кадрів використовують v5; create modify використовує v5.5; а create motion-control використовує v5.6.
Крок 5: згенеруйте голос і музику
Поточний README на GitHub описує створення окремого аудіо за допомогою спеціальних команд. Використовуйте create voice для перетворення тексту на мовлення та create music для генерування музики за промптом. Голос і музика зберігаються як аудіоресурси, тому їх можна відстежувати за допомогою task, переглядати їхній список за допомогою asset list --type audio і завантажувати за допомогою asset download --type audio. Для вбудованого фонового звуку відео використовуйте --audio або --no-audio у підтримуваних командах створення відео.
Згенеруйте голосове аудіо:
pixverse create voice \
--text "Welcome to the launch. Here is what changed this week." \
--model speech-2.8-hd \
--voice-id <preset_voice_id> \
--output ./voiceover.mp3 \
--json
Перегляньте голосові моделі та попередньо налаштовані голоси:
pixverse voice models --json
pixverse voice presets --model speech-2.8-hd --json
Генеруйте музику:
pixverse create music \
--prompt "A bright cinematic synth-pop track for a 30-second product reveal" \
--auto-lyrics \
--duration-seconds 30 \
--json
Для інструментальних композицій використовуйте --instrumental. Для моделей, що підтримують тексти пісень, передавайте текст пісні як звичайний текст, шлях до локального файлу або через stdin:
pixverse create music \
--prompt "Uplifting electronic pop with a confident chorus" \
--lyrics ./lyrics.txt \
--json
Наразі сімейства голосових моделей включають MiniMax Speech 2.8 та моделі ElevenLabs. Сімейства музичних моделей включають MiniMax Music, ElevenLabs Music і Google Lyria 3 Pro. Перш ніж писати сценарій для виробничого робочого процесу, використовуйте pixverse voice models та pixverse music models, щоб переглянути актуальний каталог.
Крок 6: Запустіть інтерактивний майстер
Якщо ви знайомитеся з інструментом уперше й ще не знаєте всіх доступних прапорців, запустіть будь-яку команду створення без аргументів, щоб відкрити покроковий майстер:
pixverse create video
pixverse create image
Майстер крок за кроком проведе вас через введення промпту, вибір моделі, якості, співвідношення сторін, тривалості та інших параметрів — це допоможе дізнатися, які параметри доступні, перш ніж використовувати їх у сценаріях.
Більше, ніж генерація: керуйте ресурсами та робочим простором
Поточна версія PixVerse CLI також містить команди керування, які допомагають створювати наскрізні робочі процеси в терміналі:
pixverse task status <id>таpixverse task wait <id>для опитування стану завданьpixverse task status --ids 123,456,789 --type video --jsonдля пакетної перевірки стануpixverse asset list,asset upload,asset info,asset downloadтаasset deleteдля операцій життєвого циклу відео-, графічних та аудіоресурсівpixverse saved list,saved items,saved new,saved rename,saved add,saved removeтаsaved deleteдля збережених папокpixverse template categories,template list,template searchтаtemplate infoдля пошуку ефектів і шаблонівpixverse voice models,voice presetsтаmusic modelsдля перегляду актуальних аудіомоделейpixverse workspace list,workspace status,workspace switchтаworkspace manageдля роботи з кількома робочими просторамиpixverse account info,account usageтаaccount slotsдля перевірки кредитів, використання та паралельного виконанняpixverse config set,config list,config pathтаconfig defaultsдля відтворюваних локальних налаштувань за замовчуванням
Це дає змогу легко автоматизувати в одному сценарії не лише створення, а й упорядкування, пошук шаблонів і аудіомоделей, завантаження, вибір робочого простору та доставку результатів. Якщо потрібно виконати одну команду в іншому робочому просторі, використовуйте глобальний прапорець --workspace-id <id>; 0 указує на ваш особистий робочий простір.
Прапорці для сценаріїв
Більшість автоматизації залежить від передбачуваного виводу та передбачуваної поведінки під час виконання. Ці прапорці особливо корисні у сценаріях і робочих процесах ШІ-агентів:
| Прапорець | Призначення |
|---|---|
--json |
Повернення структурованого виводу JSON |
-p |
Короткий псевдонім для --json |
--count <n> |
Генерація 1–4 варіантів за одним запитом |
--seed <number> |
Спрощення відтворення результату генерації |
--off-peak |
Використання тарифів для непікових годин, коли вони доступні |
--audio / --no-audio |
Увімкнення або вимкнення генерації аудіо в підтримуваних командах створення |
--multi-shot / --no-multi-shot |
Увімкнення або вимкнення багатокадрового режиму для відео |
--no-wait |
Надсилання завдання з негайним поверненням керування |
--timeout <sec> |
Налаштування часу очікування опитування, за замовчуванням 300 секунд |
--workspace-id <id> |
Перевизначення активного робочого простору для однієї команди |
--trace-id <uuid> |
Додавання наданого викликачем UUIDv4 до запитів API для налагодження та спостережуваності |
--idempotency-key <key> |
Безпечне повторення запитів на створення без випадкового створення дубльованих платних завдань |
Прапорці введення тексту тепер легше використовувати в автоматизації. --prompt, --text та --lyrics можуть приймати звичайний рядок, шлях до локального файлу або - для stdin:
pixverse create video --prompt ./scene.txt --json
cat scene.txt | pixverse create image --prompt - --json
echo "Hello from the command line" | pixverse create voice --text - --json
pixverse create music --prompt "Bright synth-pop" --lyrics ./lyrics.txt --json
Навчіть свого ШІ-агента генерувати медіа
Для команд, які перед переходом до автоматизації через командний рядок віддають перевагу покроковому старту в застосунку, PixVerse Agent пропонує орієнтований на агентів процес створення в застосунку PixVerse.
Саме тут PixVerse CLI докорінно змінює можливості роботи. Оскільки команди можуть повертати структурований JSON і використовують детерміновані коди завершення, будь-якого ШІ-агента, здатного виконувати команди оболонки, можна навчити генерувати зображення та відео на вимогу.
Встановлення PixVerse Skills
PixVerse Skills — це структурована бібліотека навичок, яка навчає агентів правильно використовувати CLI: прапорці команд, обмеження моделей, багатоетапні конвеєри та надійна обробка помилок.
Для Claude Code та інших агентів, які підтримують формат навичок, додайте навички PixVerse безпосередньо:
npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-and-video-generator
Для Cursor, Claude Code, Codex та інших агентних фреймворків ця навичка підвищує надійність, надаючи агенту явні обмеження, щоб йому не доводилося самостійно виводити їх із нуля.
PixVerse CLI також постачається з компактним машинозчитуваним маніфестом команд за адресою dist/capabilities.json, а його відкритий вихідний файл доступний як capabilities.json у репозиторії GitHub. Цей маніфест описує команди, прапорці, коди завершення, очікуваний вивід JSON і категорії ефектів, тож агенти можуть вивчати контракт CLI без розбору тексту довідки.
Щойно ваш агент завантажить навички PixVerse, ви зможете давати йому інструкції природною мовою, наприклад:
- «Згенеруй 10-секундне демонстраційне відео продукту з цього знімка екрана»
- «Створи чотири варіанти цього зображення обкладинки блогу у форматі 16:9»
- «Анімуй цю діаграму в 5-секундний пояснювальний ролик із фоновим звуком»
- «Згенеруй три 8-секундні проморолики у форматі 16:9 з різними рухами камери»
Агент перетворить ці інструкції на правильні команди CLI, розбере вивід JSON і подбає про опитування стану та завантаження — без ручного втручання.
Claude Code
У Claude Code PixVerse CLI стає вбудованим інструментом, який агент використовує автономно. Після завантаження навичок PixVerse ви можете включити генерацію медіа безпосередньо в будь-яке завдання:
Згенеруй зображення обкладинки для цього допису в блозі про машинне навчання, використай модель seedream-5.0-lite з роздільною здатністю 2160p у форматі 16:9, завантаж його до ./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 2160p \
--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
Cursor
Користувачі Cursor можуть завантажити PixVerse Skills як файл контексту проєкту. Розмістіть відповідні файли навичок у каталозі .cursor/ або додайте їх до правил робочого простору. Після завантаження Cursor знатиме всі команди PixVerse CLI й зможе генерувати медіа в межах будь-якого завдання з програмування.
Поширений робочий процес у Cursor: попросіть агента згенерувати зображення макета на основі дизайну, який ви створюєте, а потім використовуйте його як орієнтир безпосередньо в сесії IDE — не виходячи з редактора.
Codex та інші агенти
PixVerse CLI сумісний із будь-яким агентом, здатним виконувати команди оболонки та розбирати JSON. Структурований формат виводу — узгоджені назви полів, передбачувані коди помилок і повідомлення про помилки, відокремлені у stderr, — дає змогу навіть простим сценарним агентам надійно інтегрувати генерацію.
Контракт кодів завершення спрощує обробку помилок:
| Код | Значення | Дія агента |
|---|---|---|
| 0 | Успіх | Розібрати вивід JSON |
| 1 | Загальна помилка | Перевірити stderr і повторити спробу з перевіреними вхідними даними |
| 2 | Час очікування вичерпано | Повторити спробу з більшим значенням --timeout |
| 3 | Термін дії авторизації минув | Повторно виконати pixverse auth login |
| 4 | Кредити вичерпано | Перевірити баланс, повідомити користувача |
| 5 | Генерація не вдалася | Спробувати інші параметри |
| 6 | Помилка валідації | Переглянути значення прапорців |
Конвеєри автоматизації
Щойно ви розберетеся з окремими командами, 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
Повний конвеєр виробництва відео
Для довершеного результату поєднайте створення з етапами подальшої обробки. Використовуйте --audio або --no-audio, якщо хочете отримати вбудований звук у підтримуваних командах створення відео, а потім використовуйте create voice для озвучення тексту та create music для окремих музичних ресурсів, які ви поєднаєте на подальших етапах:
# Step 1: Create the base video
RESULT=$(pixverse create video \
--prompt "A product being assembled in slow motion" \
--model v6 \
--quality 720p \
--duration 5 \
--audio \
--json)
VID=$(echo "$RESULT" | jq -r '.video_id')
# Step 2: Extend duration
EXTENDED=$(pixverse create extend \
--video "$VID" \
--json | jq -r '.video_id')
pixverse task wait "$EXTENDED" --json
# Step 3: Upscale to 1080p
FINAL=$(pixverse create upscale \
--video "$EXTENDED" \
--quality 1080p \
--json | jq -r '.video_id')
pixverse task wait "$FINAL" --json
# Step 4: Download
pixverse asset download "$FINAL" --json
# Optional: create a separate voiceover asset
pixverse create voice \
--text "The final reveal starts now." \
--voice-id <preset_voice_id> \
--output ./voiceover.mp3 \
--json
Пакетна генерація
Для конвеєрів контенту, які потребують кількох варіантів, запускайте завдання паралельно:
# Check credits and concurrent generation slots first
pixverse account info --json
pixverse account slots --json
# 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
# Check all returned task IDs in one batch status call
IDS=$(jq -r '.video_id' /tmp/v1.json /tmp/v2.json /tmp/v3.json /tmp/v4.json | paste -sd, -)
pixverse task status --ids "$IDS" --type video --json
# 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 надсилає завдання й одразу повертає його ідентифікатор, даючи змогу надіслати кілька завдань перед опитуванням їхнього стану. З --no-wait --json записуйте повернуті ідентифікатори завдань і фактично застосовані параметри створення для журналювання та відтворюваності. Використовуйте --count <n>, якщо хочете отримати кілька варіантів за одним промптом, а пакетну команду task status --ids — якщо потрібна одна відповідь зі станом кількох поточних завдань. Команда 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
pixverse config list
pixverse config path
Прапорці командного рядка завжди мають пріоритет над налаштованими значеннями за замовчуванням, тож ви зберігаєте повну гнучкість і зменшуєте кількість повторень. Для автоматизації в конкретному робочому просторі додайте --workspace-id <id> до команди, якщо хочете перевизначити активний робочий простір лише для цього запуску.
Що ви можете створити
З інтеграцією 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 account slotsперед паралельною пакетною роботою - Згенеруйте своє перше зображення:
pixverse create image --prompt "..." --json - Згенеруйте своє перше відео:
pixverse create video --prompt "..." --json - Згенеруйте свій перший голосовий ресурс:
pixverse create voice --text "..." --json - Згенеруйте свій перший музичний ресурс:
pixverse create music --prompt "..." --json - Перегляньте шаблони за допомогою
pixverse template list - Встановіть PixVerse Skills для свого агента (Claude Code, Cursor або Codex)
- Налаштуйте бажані значення за замовчуванням за допомогою
pixverse config defaults set - Створіть свій перший конвеєр автоматизації
Підтримання CLI в актуальному стані
Використовуйте вбудований засіб оновлення, щоб підтримувати локальний CLI в актуальному стані:
pixverse update
Ви також можете використовувати npm безпосередньо:
npm install -g pixverse@latest
Оскільки PixVerse CLI — це інструмент, який активно оновлюється, а не одноразовий реліз, сприймайте цю статтю як практичний посібник, а офіційні джерела — як актуальний довідник. Офіційна сторінка PixVerse CLI пропонує найкоротший шлях до встановлення та підключення агента, тоді як GitHub залишається місцем для відстеження змін у релізах і нових підтримуваних моделей:
Поточна документація висвітлює PixVerse V6 як відеомодель за замовчуванням, GPT Image 2 як модель зображень за замовчуванням, підтримку відео Google Gemini Omni, підтримку зображень Nano Banana 2 Lite та Seedream 5.0 Pro, підтримку Seedance 2.0 Mini, робочі процеси PixVerse v5 і v5.5 для окремих режимів, спеціальні команди create voice та create music, керування аудіоресурсами, збережені папки, перемикання робочих просторів, config defaults, capabilities.json для агентів, pixverse update, підтримку stdin для текстового введення, --trace-id та --idempotency-key для безпечнішого повторення запитів.
Наступні кроки
Офіційна сторінка PixVerse CLI, PixVerse CLI на GitHub та npm (npm install -g pixverse) надають негайний доступ до генерації, опитування стану завдань, керування ресурсами, шаблонів, збережених папок, перевірок облікового запису, пошуку аудіомоделей і керування робочими просторами через єдиний інтерфейс. Репозиторій PixVerse Skills додає інструкції для агентів, щоб Claude Code, Cursor, Codex та інші інструменти могли виконувати ці робочі процеси з вищою надійністю.
Поєднання надійного CLI та бібліотеки навичок для агентів означає, що генерація зображень, відео, голосу й музики може бути частиною того самого робочого процесу, що й ваш код, — під керуванням того самого агента, у тому самому терміналі, без перемикання інструментів.
Почніть з однієї команди. Розвивайтеся далі.
Пов’язані матеріали
- Огляд ШІ-генератора відео PixVerse V6
- Найкращі ШІ-моделі відео на одній платформі
- Seedance 2.0 тепер доступна на PixVerse
- Grok Imagine тепер доступна на PixVerse
- Посібник із платформи PixVerse AI
Генеруйте відео, зображення, голос і музику зі свого термінала за допомогою PixVerse.