Utwórz Wideo
Samouczki

PixVerse CLI: Generuj filmy, obrazy, głos i muzykę AI z terminala

Ostatnia aktualizacja
PixVerse CLI: Generuj filmy, obrazy, głos i muzykę AI z terminala

Sprawdzono 2026-10-13: wymagany jest Node.js >=22.12. Domyślnym modelem obrazu jest GPT Image 2.5 Flare, a wideo PixVerse V6. Modele i ustawienia zależą od trybu. Przed produkcją sprawdź zainstalowane capabilities i oficjalny README. README · capabilities.json

pixverse --version
pixverse capabilities create --json
pixverse canvas --help

Wprowadzenie

Interfejsy generowania oparte na przeglądarce dobrze sprawdzają się w eksploracji i jednorazowych projektach. Jednak kilka scenariuszy wymaga innego podejścia:

CLI PixVerse wprowadza generowanie filmów, obrazów, głosu i muzyki AI bezpośrednio do przepływów pracy opartych na terminalu. Zamiast przełączać się między interfejsem przeglądarki a środowiskiem programistycznym, możesz tworzyć, zarządzać i pobierać treści AI z tej samej linii poleceń, w której piszesz kod, uruchamiasz buildy i zarządzasz wdrożeniami. PixVerse CLI

CLI PixVerse zostało zbudowane dokładnie wokół tej listy i szczególnie mocno skłania się ku przypadkowi użycia sterowanemu przez agentów: polecenia zwracają ustrukturyzowany JSON, kody wyjścia są przewidywalne, a każdy krok jest zaprojektowany tak, by mógł być łączony przez skrypt lub autonomicznego agenta, a nie przez człowieka klikającego w interfejsie.

Wymagania wstępne

Zanim zaczniesz, potrzebujesz:

  • Node.js 22.12 lub nowszego —— sprawdź za pomocą node --version
  • Konta PixVerse —— zarejestruj się na pixverse.ai
  • Aktywnej subskrypcji PixVerse —— CLI korzysta z tego samego systemu kredytów co strona internetowa, więc generowanie wymaga subskrybowanego konta

Nie ma żadnego klucza API do ręcznego kopiowania i wklejania. Uwierzytelnianie odbywa się poprzez przepływ oparty na przeglądarce, który przechowuje token lokalnie.

Instalacja

Zainstaluj CLI globalnie za pomocą npm:

npm install -g pixverse

Potwierdź, że instalacja przebiegła poprawnie:

pixverse --version

Jeśli wolisz nie instalować niczego globalnie, możesz również uruchamiać polecenia na żądanie za pomocą npx:

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

Uwierzytelnianie

Zaloguj się za pomocą:

pixverse auth login

Otworzy to okno przeglądarki do autoryzacji OAuth. Jeśli pracujesz przez SSH lub na maszynie bez interfejsu graficznego, przepływ logowania dostarcza również adres URL, który możesz wkleić do przeglądarki na dowolnym innym urządzeniu, aby zakończyć autoryzację. Po autoryzacji token jest zapisywany w ~/.pixverse/ i pozostaje ważny przez 30 dni.

Sprawdź status logowania i dostępne kredyty:

pixverse auth status
pixverse account info
pixverse account slots
pixverse capabilities canvas --json

account info pokazuje poziom subskrypcji i kredyty przestrzeni roboczej. account usage rozbija sposób wykorzystania tych kredytów, a account slots informuje, ile generacji możesz uruchomić jednocześnie —— warto to sprawdzić przed rozpoczęciem zadania wsadowego. Sesje CLI nie współdzielą stanu z sesją przeglądarki ani aplikacji, więc wylogowanie z CLI (pixverse auth logout) nie wpływa na inne Twoje sesje.

Szybki start

Jeśli chcesz jak najszybciej przejść od instalacji do gotowego zasobu, ta sekwencja Cię tam zaprowadzi:

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

W skryptach i agentach zostaw --json (lub jego skrót -p) włączony, aby standardowe wyjście pozostało czyste i możliwe do sparsowania, podczas gdy komunikaty o postępie i błędy trafiają do stderr. Jeśli zadanie może zostać wysłane więcej niż raz — niestabilna sieć, powtarzany krok CI — dodaj --idempotency-key <key>, aby przypadkowo nie utworzyć zduplikowanych, płatnych zadań.

Generowanie obrazów

Tekst na obraz to najszybszy sposób na potwierdzenie, że wszystko działa:

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

Obecnym domyślnym modelem obrazu jest GPT Image 2.5 Flare, ale dla wszystkiego, co planujesz uruchamiać wielokrotnie, ustaw --model jawnie zamiast polegać na domyślnym —— wartości domyślne zmieniają się wraz z pojawianiem się nowych modeli. --json daje odpowiedź, którą możesz przekazać bezpośrednio do następnego kroku:

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

Dla wyższych rozdzielczości sięgnij po model, który je obsługuje:

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

Oferta modeli obrazów obejmuje kilka różnych przypadków użycia:

pixverse capabilities create image --json
pixverse capabilities create image --model gpt-image-2.5-flare --json

Możesz również ponownie wprowadzić istniejący obraz i go przekształcić:

pixverse create image \
  --prompt "Turn this product photo into a clean watercolor illustration" \
  --image ./product-photo.png \
  --model gpt-image-2.0 \
  --json

Następnie pobrać plik lokalnie:

pixverse asset download 789012 --type image

Generowanie filmów

Tekst na film przebiega według tego samego schematu. Szybki 5-sekundowy klip:

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

Lub w pełni określone generowanie:

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

W modelach obsługujących natywny dźwięk: --audio dodaje wygenerowany przez AI dźwięk otoczenia pasujący do sceny. Po zakończeniu odpowiedź JSON zawiera video_url, który możesz przekazać bezpośrednio do kroku pobierania lub kolejnego etapu potoku.

Modele wideo różnią się znacznie pod względem limitu rozdzielczości, zakresu czasu trwania oraz obsługiwanych trybów tworzenia:

pixverse capabilities create video --json
pixverse capabilities create reference --model seedance-2.5 --json

Modele partnerskie Seedance, Kling, Veo, Sora, Gemini Omni, Grok Imagine i HappyHorse są również dostępne w PixVerse. Porównuj je z PixVerse V6 i C1 przez ten sam CLI.

Animowanie statycznego obrazu

Przekaż --image, aby zamienić zdjęcie lub wygenerowany obraz w ruch:

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

Możesz wskazać --image na lokalną ścieżkę pliku lub zdalny adres URL —— lokalne pliki są przesyłane automatycznie, bez potrzeby osobnego kroku przesyłania. Wszystko, co przekracza 1920×1920 lub 5MB, jest automatycznie zmieniane w rozmiarze lub kompresowane przed przesłaniem; zdalne adresy URL są weryfikowane przez backend w niezmienionej postaci.

Grok Imagine 1.5 to szczególny przypadek: wymaga --image i blokuje proporcje wyjściowe na tych, których używa obraz źródłowy:

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

Referencje, przejścia, kontrola ruchu i szablony

Poza prostym tekstem na film i obrazem na film, CLI udostępnia kilka bardziej wyspecjalizowanych trybów tworzenia, przydatnych, gdy potrzebujesz ściślejszej kontroli nad postaciami, kluczowymi klatkami lub efektami:

# 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 to 2160p
pixverse create upscale --video <video_id> --quality 2160p

# 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

Generowanie głosu i muzyki

Samodzielne generowanie dźwięku znajduje się za dwoma dedykowanymi poleceniami: create voice dla tekstu na mowę i create music dla muzyki opartej na promptach. Oba zapisują swoje wyjście jako zasoby audio, więc możesz je śledzić za pomocą task, wyświetlać listę za pomocą asset list --type audio i pobierać za pomocą asset download. Jeśli chcesz po prostu dźwięk otoczenia wbudowany w film, użyj --audio / --no-audio w obsługiwanym poleceniu tworzenia wideo —— to osobna ścieżka od tych samodzielnych poleceń audio.

Wygeneruj klip głosowy:

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

Wyświetl listę dostępnych modeli głosu i predefiniowanych głosów, zanim się na coś zdecydujesz:

pixverse voice models --json
pixverse voice presets --model speech-2.8-hd --json

Wygeneruj utwór muzyczny:

pixverse create music \
  --prompt "A bright cinematic synth-pop track for a 30-second product reveal" \
  --auto-lyrics \
  --duration-seconds 30 \
  --json

Dodaj --instrumental dla utworu bez wokalu. Gdy chcesz tekst piosenki, --lyrics akceptuje dosłowny tekst, ścieżkę do lokalnego pliku lub standardowe wejście przekazane przez potok:

pixverse create music \
  --prompt "Uplifting electronic pop with a confident chorus" \
  --lyrics ./lyrics.txt \
  --json

Obecne opcje głosowe obejmują rodziny MiniMax Speech 2.8 i ElevenLabs, a generowanie muzyki pochodzi obecnie z MiniMax Music, ElevenLabs Music i Google Lyria 3 Pro. Ponieważ te oferty zmieniają się z czasem, uruchom pixverse voice models i pixverse music models, aby zobaczyć, co jest dostępne, zanim napiszesz skrypt, który planujesz ponownie wykorzystać.

Interaktywny kreator

Jeśli wciąż uczysz się, jakie flagi istnieją, uruchom polecenie tworzenia bez żadnych argumentów:

pixverse create video
pixverse create image

To przenosi Cię do prowadzonego kreatora, który krok po kroku przechodzi przez prompt, model, jakość, proporcje obrazu, czas trwania i inne istotne opcje —— dobry sposób na odkrycie flag, zanim utrwalisz je w skrypcie.

Zarządzanie zasobami i przestrzenią roboczą

Generowanie to tylko część obrazu. CLI zawiera również polecenia zarządzania dla wszystkiego wokół niego:

  • pixverse task status <id> i pixverse task wait <id> do odpytywania pojedynczego zadania
  • pixverse task status --ids 123,456,789 --type video --json do sprawdzania wielu zadań w jednym wywołaniu
  • pixverse asset list, asset upload, asset info, asset download i asset delete dla operacji cyklu życia zasobów wideo, obrazów i audio
  • pixverse saved list, saved items, saved new, saved rename, saved add, saved remove i saved delete dla zapisanych folderów
  • pixverse template categories, template list, template search i template info do przeglądania efektów i szablonów
  • pixverse voice models, voice presets i music models do bieżącego odkrywania modeli audio
  • pixverse workspace list, workspace status, workspace switch i workspace manage dla konfiguracji z wieloma przestrzeniami roboczymi
  • pixverse account info, account usage i account slots do sprawdzania kredytów, użycia i współbieżności
  • pixverse config set, config list, config path i config defaults dla powtarzalnych ustawień lokalnych

Razem umożliwiają one jednemu skryptowi obsługę tworzenia, organizacji, odkrywania szablonów, pobierania i kierowania przestrzeni roboczej bez opuszczania terminala. Aby skierować pojedyncze polecenie do innej przestrzeni roboczej niż domyślna, dodaj --workspace-id <id> (użyj 0 dla swojej osobistej przestrzeni roboczej).

Projekty Canvas i aktualnie obsługiwane modele

CLI oferuje teraz operacje Canvas dotyczące projektów, grafów, węzłów, poprawek i uruchamiania. Przed automatyzacją sprawdź pixverse canvas --help i pixverse capabilities canvas --json. Funkcje Canvas wymagają logowania i są pobierane z usługi; funkcje generowania opisują zainstalowany CLI. Zaktualizuj CLI, jeśli brakuje modelu.

Aktualny katalog obejmuje Seedance 2.5, MiniMax H3/H3 Max, FLUX 3, Wan 3.0, Kling 4K, GPT Image 2.5 Flare/Sunburst i Nano Banana 2.1. Sprawdzaj możliwości konkretnego modelu i trybu zamiast przenosić ustawienia czasu, dźwięku, referencji lub rozdzielczości z innego modelu.

Flagi warte poznania w skryptach

Przewidywalne wyjście liczy się bardziej niż cokolwiek innego, gdy automatyzujesz. Te flagi pojawiają się nieustannie w skryptach i przepływach pracy z agentami:

Flaga Do czego służy
--json Zwraca ustrukturyzowane wyjście JSON
-p Krótki alias dla --json
--count <n> Generuje 1–4 wariacje z jednego żądania
--seed <number> Ułatwia odtworzenie generacji
--off-peak Wykorzystuje ceny poza godzinami szczytu, gdy są dostępne
--audio / --no-audio Przełącza dźwięk w obsługiwanych poleceniach tworzenia wideo
--multi-shot / --no-multi-shot Przełącza tryb wielokadrowy dla wideo
--no-wait Wysyła zadanie i natychmiast wraca zamiast blokować
--timeout <sec> Ustawia limit czasu odpytywania (domyślnie 300 sekund)
--workspace-id <id> Zastępuje aktywną przestrzeń roboczą dla jednego polecenia
--trace-id <uuid> Dołącza do żądania dostarczony przez wywołującego UUIDv4 do celów debugowania
--idempotency-key <key> Bezpiecznie ponawia żądanie tworzenia bez zdublowanych opłat

Flagi wprowadzania tekstu akceptują teraz więcej niż tylko ciągi wpisane w linii. --prompt, --text i --lyrics wszystkie akceptują dosłowny ciąg znaków, ścieżkę do lokalnego pliku lub - do odczytu ze 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

Uczenie agenta AI generowania mediów

Aby przed automatyzacją poleceń wypróbować tworzenie z agentem w aplikacji, zacznij od PixVerse Agent.

To tutaj CLI przestaje być zwykłą wygodą, a staje się mnożnikiem możliwości. Ponieważ każde polecenie zwraca ustrukturyzowany JSON i kończy się deterministycznym kodem, każdy agent zdolny do wykonywania poleceń powłoki może zostać nauczony generowania obrazów, wideo, głosu i muzyki w Twoim imieniu.

Instalowanie PixVerse Skills

PixVerse Skills to biblioteka umiejętności zbudowana specjalnie po to, by nauczyć agentów flag CLI, ograniczeń modeli, wieloetapowych potoków i wzorców obsługi błędów, zamiast pozwalać agentowi zgadywać na podstawie tekstu pomocy.

Dla Claude Code i innych narzędzi obsługujących format skills:

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

Po załadowaniu agent dysponuje jawnymi ograniczeniami, na których może się oprzeć, zamiast wnioskować zachowanie metodą prób i błędów —— co ma duże znaczenie dla niezawodności w Cursor, Claude Code, Codex i podobnych frameworkach.

Po załadowaniu PixVerse Skills możesz przekazać agentowi instrukcje w języku naturalnym, takie jak:

  • „Wygeneruj 10-sekundowy film demonstracyjny produktu na podstawie tego zrzutu ekranu”
  • „Utwórz cztery warianty tego obrazu okładki bloga w formacie 16:9”
  • „Animuj ten diagram w 5-sekundowy klip wyjaśniający z dźwiękiem otoczenia”
  • „Wygeneruj trzy 8-sekundowe klipy promocyjne 16:9 z różnymi ruchami kamery”

Agent tłumaczy to na właściwe wywołania CLI, parsuje odpowiedzi JSON, obsługuje odpytywanie i pobiera wynik —— bez żadnych ręcznych kroków po drodze.

Claude Code

Wewnątrz Claude Code CLI staje się narzędziem, po które agent sięga samodzielnie. Po załadowaniu PixVerse Skills możesz włączyć generowanie mediów do dowolnego zadania:

Wygeneruj okładkę tego wpisu o uczeniu maszynowym modelem seedream-5.0-lite w 2160p i 16:9, a potem pobierz do ./assets/cover.webp.

Claude Code uruchomi właściwe polecenia, wyodrębni adres URL obrazu z JSON i zapisze plik pod wskazaną przez Ciebie ścieżką —— wszystko to w tej samej sesji, w której edytuje również Twój kod.

Przykładowy przepływ pracy:

# 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

W Cursor możesz umieścić odpowiednie pliki PixVerse Skills w .cursor/ lub dodać je do reguł przestrzeni roboczej. Po załadowaniu pomagają generować media podczas programowania.

Na przykład poproś Cursor o makietę obrazu dla projektu i użyj jej bezpośrednio jako referencji w tej samej sesji edytora.

Codex i inni agenci

Każdy agent zdolny do wykonywania poleceń powłoki i parsowania JSON może obsługiwać to CLI. Spójne nazwy pól, przewidywalne kody błędów oraz komunikaty o błędach oddzielone w stderr oznaczają, że nawet prosty agent skryptowy może zintegrować generowanie bez specjalnej obsługi.

Kody wyjścia dają agentowi jasne drzewo decyzyjne:

Kod Znaczenie Działanie agenta
0 Sukces Sparsuj wyjście JSON
1 Błąd ogólny Sprawdź stderr i ponów próbę ze zweryfikowanymi danymi wejściowymi
2 Przekroczono limit czasu Ponów próbę z dłuższym --timeout
3 Wygasła autoryzacja Uruchom ponownie pixverse auth login
4 Brak kredytów Sprawdź saldo, powiadom użytkownika
5 Generowanie nie powiodło się Wypróbuj inne parametry
6 Błąd walidacji Sprawdź wartości flag
7 Limit równoległych zadań Poczekaj na wolne miejsce i spróbuj ponownie

Potoki automatyzacji

Gdy poczujesz się swobodnie z pojedynczymi poleceniami, prawdziwa wartość ujawnia się w wieloetapowych potokach, które działają bez niczyjego nadzoru.

Tekst na obraz na film

Wygeneruj obraz w wysokiej rozdzielczości z promptu, a następnie go animuj:

# 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

Pełny potok produkcji wideo

Aby uzyskać bardziej dopracowany efekt, połącz generowanie z przetwarzaniem końcowym. Użyj --audio lub --no-audio, gdy natywny dźwięk obsługiwanego modelu wideo wystarcza, a sięgnij po create voice lub create music, gdy potrzebujesz osobnego zasobu audio do późniejszego połączenia:

# 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 2160p
FINAL=$(pixverse create upscale \
  --video "$EXTENDED" \
  --quality 2160p \
  --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

Generowanie wsadowe

Dla potoków treści wymagających kilku wariacji jednocześnie, uruchamiaj zadania równolegle zamiast jedno po drugim:

# 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 wysyła zadanie i natychmiast zwraca identyfikator zadania, pozwalając kolejkować wiele zadań przed rozpoczęciem odpytywania któregokolwiek z nich. Zapisuj identyfikatory zadań i rozwiązane parametry z każdej odpowiedzi --no-wait --json —— ten zapis sprawia, że przebieg wsadowy staje się później odtwarzalny. Użyj --count <n> dla wielu wariacji z jednego promptu i polegaj na wsadowym task status --ids, gdy wolisz jedną odpowiedź o statusie obejmującą kilka działających zadań zamiast odpytywania każdego z osobna. pixverse task wait samodzielnie obsługuje adaptacyjne odpytywanie.

Konfigurowanie wartości domyślnych

Jeśli zauważysz, że powtarzasz ten sam model, jakość lub proporcje obrazu przy każdym wywołaniu, ustaw je raz na zawsze:

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

Flagi w wierszu poleceń zawsze mają pierwszeństwo przed skonfigurowanymi wartościami domyślnymi, więc ustawienie wartości domyślnych nie kosztuje Cię żadnej elastyczności. Dla jednorazowego uruchomienia w innej niż domyślna przestrzeni roboczej, dodaj --workspace-id <id> do swoich zwykłych wartości domyślnych.

Co możesz zbudować

Podłączenie CLI do agenta lub skryptu znacznie poszerza zakres możliwej automatyzacji:

  • Dokumentacja —— automatyczne generowanie filmów demonstracyjnych produktu i zrzutów ekranu jako część budowy dokumentacji
  • Marketing —— uruchamianie nocnych zadań wsadowych generujących wariacje treści społecznościowych z jednej biblioteki promptów
  • Rozwój aplikacji —— pozwolenie agentowi kodującemu na generowanie wizualizacji zastępczych, animacji makiet lub filmów ekranu ładowania podczas budowy rzeczywistego interfejsu
  • Przepływy audio —— generowanie szkiców narracji, utworów z promptu na muzykę lub samodzielnych zasobów audio do późniejszej edycji
  • Potoki treści —— łączenie wywołań CLI z ffmpeg, ImageMagick lub narzędziami przechowywania w chmurze w celu zbudowania w pełni zautomatyzowanego potoku produkcyjnego
  • Prototypowanie —— generowanie szybkich koncepcji ruchu w kilka sekund w celu zweryfikowania pomysłów przed zaangażowaniem się w pełną produkcję

Ponieważ są to po prostu polecenia powłoki, CLI pasuje do bash, Python, Node lub CI/CD bez żadnej specjalnej pracy integracyjnej.

Lista kontrolna na start

  • Zainstaluj Node.js 22.12 lub nowszy
  • Uruchom npm install -g pixverse
  • Uruchom pixverse auth login i autoryzuj w przeglądarce
  • Uruchom pixverse account info, aby zweryfikować kredyty
  • Uruchom pixverse account slots przed jednoczesną pracą wsadową
  • Wygeneruj swój pierwszy obraz: pixverse create image --prompt "..." --json
  • Wygeneruj swój pierwszy film: pixverse create video --prompt "..." --json
  • Wygeneruj swój pierwszy zasób głosowy: pixverse create voice --text "..." --json
  • Wygeneruj swój pierwszy zasób muzyczny: pixverse create music --prompt "..." --json
  • Poznaj szablony za pomocą pixverse template list
  • Zainstaluj PixVerse Skills dla swojego agenta (Claude Code, Cursor lub Codex)
  • Ustaw preferowane wartości domyślne za pomocą pixverse config defaults set
  • Zbuduj swój pierwszy potok automatyzacji

Utrzymywanie CLI w aktualności

Użyj wbudowanego narzędzia aktualizującego, aby Twoje lokalne CLI było aktualne:

pixverse update

Możesz również zaktualizować bezpośrednio przez npm:

npm install -g pixverse@latest

Modele i flagi zmieniają się szybciej niż większość dokumentacji, więc w przypadku zmian na poziomie wydań sprawdzaj bezpośrednio podstawowe źródła:

Na dzień tej aktualizacji PixVerse V6 pozostaje domyślnym modelem wideo, a GPT Image 2.5 Flare domyślnym modelem obrazu, przy czym Seedance 2.0 Mini, dedykowane polecenia create voice/create music, zarządzanie zasobami audio, zapisane foldery, przełączanie przestrzeni roboczych, config defaults, manifest capabilities.json, pixverse update, obsługa stdin dla danych tekstowych, --trace-id i --idempotency-key są częścią obecnego zestawu narzędzi. PixVerse CLI

Co umożliwia CLI

PixVerse CLI, GitHub i npm (npm install -g pixverse) oferują generowanie, sprawdzanie zadań, zasoby, szablony, głos, muzykę i zarządzanie przestrzeniami. PixVerse Skills zapewnia instrukcje dla agentów.

CLI i umiejętności dla agentów łączą obrazy, filmy, głos i muzykę z pracą nad kodem, obsługiwaną przez tego samego agenta w tym samym terminalu.

Zacznij od jednego polecenia i rozwijaj przepływ pracy.

Powiązane zasoby

→ Zacznij korzystać z CLI PixVerse