Tạo video
Hướng dẫn

PixVerse CLI: Tạo video và ảnh AI trong terminal

Cập nhật lần cuối vào
PixVerse CLI: Tạo video và ảnh AI trong terminal

Kiểm tra ngày 2026-10-13: yêu cầu Node.js >=22.12. Mô hình ảnh mặc định là GPT Image 2.5 Flare, mô hình video mặc định là PixVerse V6. Mô hình và tùy chọn khác nhau theo chế độ. Kiểm tra capabilities đã cài và README chính thức trước khi sản xuất. README · capabilities.json

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

Giới thiệu

Mọi quy trình sáng tạo đều có một nút thắt — khoảnh khắc bạn phải rời trình soạn mã, mở trình duyệt và bấm thủ công qua giao diện web để tạo một mẫu media. Với nhà phát triển, agent AI và bất kỳ ai đang xây pipeline nội dung tự động, việc chuyển ngữ cảnh đó là ma sát cộng dồn rất nhanh.

PixVerse CLI loại bỏ nút thắt đó. Đây là giao diện dòng lệnh chính thức của PixVerse, cho bạn truy cập tạo sinh PixVerse và quy trình workspace trực tiếp từ terminal. Chuyển văn bản thành video, ảnh thành video, văn bản thành ảnh, ảnh thành ảnh, chuyển cảnh, tạo giọng nói, tạo nhạc, video tham chiếu, điều khiển chuyển động, mẫu, nâng cấp độ phân giải và quản lý tài sản đều có thể viết script, nối pipe và dùng mà không cần chạm trình duyệt. Để có đường cài ngắn nhất và tổng quan thiết lập agent, hãy bắt đầu từ trang PixVerse CLI chính thức.

Điều khiến PixVerse CLI đặc biệt hữu ích là triết lý thiết kế: nó được xây với agent AI trong tâm trí. Lệnh có thể trả về JSON có cấu trúc với --json hoặc -p, mã thoát là tất định, và mỗi bước pipeline đều có thể ghép. Nghĩa là bạn có thể dạy Claude Code, Cursor, Codex hoặc bất kỳ agent nào khác tạo ảnh, video, giọng nói và nhạc thay bạn với ít lần chuyển giao dễ vỡ hơn.

Điều kiện tiên quyết

Trước khi bắt đầu, bạn cần:

  • Node.js 22.12 trở lên — kiểm tra bằng node --version
  • Một tài khoản PixVerse — đăng ký tại pixverse.ai
  • Một gói PixVerse đang hoạt động — CLI dùng cùng hệ thống credit như website; chỉ người dùng đã đăng ký mới tạo được nội dung

PixVerse CLI không yêu cầu sao chép thủ công bất kỳ API key nào. Xác thực được xử lý qua luồng OAuth trên trình duyệt và lưu token của bạn tại máy.

Bước 1: Cài CLI

Cài toàn cục bằng npm:

npm install -g pixverse

Xác minh bản cài:

pixverse --version

Nếu bạn không muốn cài toàn cục, bạn cũng có thể chạy lệnh qua npx:

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

Bước 2: Xác thực

Chạy lệnh đăng nhập:

pixverse auth login

CLI mở trình duyệt để ủy quyền thiết bị OAuth. Bạn cũng có thể sao chép URL và hoàn tất ủy quyền từ bất kỳ trình duyệt nào trên bất kỳ thiết bị nào, điều này hữu ích cho SSH và môi trường headless. Token của bạn được lưu tự động trong ~/.pixverse/ và có hiệu lực 30 ngày.

Để xác minh bạn đã đăng nhập và kiểm tra credit khả dụng:

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

Lệnh account info hiển thị hạng gói, credit workspace và ngữ cảnh sử dụng của bạn. pixverse account usage giúp bạn xem mức tiêu thụ credit, trong khi pixverse account slots hiển thị các slot tạo đồng thời hiện tại cho tác vụ ảnh và video. Phiên CLI độc lập với phiên web/ứng dụng PixVerse, và bạn có thể xóa token CLI đã lưu bằng pixverse auth logout. Luôn kiểm tra số dư và slot khả dụng trước khi chạy tác vụ theo lô.

Lệnh bắt đầu nhanh

Nếu bạn chỉ cần đường ngắn nhất từ lúc cài đến một tài sản đã tạo, hãy bắt đầu bằng chuỗi này:

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

Với quy trình agent và CI, hãy bật --json hoặc -p để stdout vẫn máy đọc được trong khi tiến trình và lỗi nằm trên stderr. Với lần thử lại trên production, hãy thêm --idempotency-key <key> vào các lệnh tạo để các lần gửi lặp không vô tình tạo các job bị tính phí trùng.

Bước 3: Tạo ảnh đầu tiên của bạn

Tạo ảnh từ văn bản là cách nhanh nhất để kiểm tra thiết lập. Hãy chạy:

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

README GitHub hiện tại liệt GPT Image 2.5 Flare là mô hình ảnh mặc định. Với các tự động hóa có thể tái lập, vẫn hãy đặt --model rõ ràng và kiểm tra trợ giúp CLI trực tiếp hoặc capabilities.json trước khi làm theo lô. Cờ --json trả về đầu ra có cấu trúc:

{
  "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
}

Để có đầu ra độ phân giải cao hơn, hãy chỉ định một mô hình hỗ trợ điều đó:

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

PixVerse hỗ trợ nhiều mô hình ảnh, mỗi mô hình có trần độ phân giải và hỗ trợ tỷ lệ khung khác nhau:

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

Bạn cũng có thể biến đổi một ảnh có sẵn bằng ảnh-sang-ảnh:

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

Để tải ảnh đã tạo:

pixverse asset download 789012 --type image

Bước 4: Tạo video đầu tiên của bạn

Chuyển văn bản thành video hoạt động theo cách tương tự. Hãy tạo một clip 5 giây:

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

Để tạo với tùy chỉnh đầy đủ:

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

Với các mô hình hỗ trợ âm thanh gốc: Cờ --audio bật âm thanh môi trường do AI tạo, khớp với nội dung video của bạn. Cờ --json trả về một video_url khi hoàn tất, bạn có thể truyền thẳng vào lệnh tải xuống hoặc bước tiếp theo trong pipeline.

PixVerse cung cấp nhiều mô hình video với chất lượng, thời lượng và hỗ trợ chế độ khác nhau:

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

Các mô hình đối tác như Seedance, Kling, Veo, Sora, Gemini Omni, Grok Imagine và HappyHorse là các tùy chọn trên PixVerse. Hãy dùng cùng bề mặt CLI để so chúng với PixVerse V6 và C1.

Tạo chuyển động cho một ảnh tĩnh

Để biến một ảnh chụp hoặc ảnh đã tạo thành video, hãy cung cấp cờ --image:

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

Bạn có thể truyền đường dẫn tệp cục bộ hoặc một URL. Tệp cục bộ được tải lên tự động — không cần bước tải lên thủ công. Ảnh đầu vào cục bộ lớn hơn 1920x1920 hoặc 5MB sẽ tự động được đổi kích thước hoặc nén trước khi tải lên; URL ảnh từ xa được backend xác thực nguyên trạng.

Với Grok Imagine 1.5, bắt buộc có ảnh và tỷ lệ khung đầu ra theo ảnh đó:

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

Dùng tham chiếu, chuyển cảnh, điều khiển chuyển động và mẫu

CLI hiện tại hỗ trợ nhiều hơn chuyển văn bản thành video và ảnh thành video đơn giản. Các chế độ tạo này hữu ích khi bạn cần kiểm soát nhiều hơn về nhân vật, khung chính, chỉnh sửa hoặc hiệu ứng:

# 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

Bước 5: Tạo giọng nói và nhạc

README GitHub hiện tại ghi âm thanh độc lập qua các lệnh tạo chuyên biệt. Dùng create voice cho chuyển văn bản thành giọng nói và create music cho tạo nhạc từ prompt. Đầu ra giọng nói và nhạc được lưu dưới dạng tài sản âm thanh, nên bạn có thể theo dõi chúng bằng task, liệt kê bằng asset list --type audio và tải xuống bằng asset download --type audio. Với âm nền video gốc, hãy dùng --audio hoặc --no-audio trên các lệnh tạo video được hỗ trợ.

Tạo âm thanh giọng nói:

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

Duyệt các mô hình giọng và giọng đặt sẵn:

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

Tạo nhạc:

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

Với bản nhạc không lời, hãy dùng --instrumental. Với các mô hình hỗ trợ lời bài hát, hãy truyền lời dưới dạng văn bản nguyên văn, đường dẫn tệp cục bộ hoặc stdin:

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

Các dòng mô hình giọng nói hiện tại gồm MiniMax Speech 2.8 và các mô hình ElevenLabs. Các dòng mô hình nhạc hiện tại gồm MiniMax Music, ElevenLabs Music và Google Lyria 3 Pro. Hãy dùng pixverse voice models và pixverse music models để xem danh mục trực tiếp trước khi viết kịch bản cho quy trình sản xuất.

Bước 6: Chạy trình hướng dẫn tương tác

Nếu bạn đang khám phá lần đầu và chưa quen với mọi cờ có sẵn, hãy chạy bất kỳ lệnh tạo nào mà không kèm đối số để vào trình hướng dẫn:

pixverse create video
pixverse create image

Trình hướng dẫn dẫn bạn lần lượt qua prompt, lựa chọn mô hình, chất lượng, tỷ lệ khung hình, thời lượng và các tùy chọn khác — hữu ích để khám phá những tham số nào có sẵn trước khi đưa chúng vào kịch bản.

Ngoài việc tạo nội dung: Quản lý tài sản và không gian làm việc

PixVerse CLI hiện tại còn có các lệnh quản lý giúp bạn xây dựng quy trình đầu cuối trên terminal:

  • pixverse task status <id> và pixverse task wait <id> để thăm dò tác vụ
  • pixverse task status --ids 123,456,789 --type video --json để kiểm tra trạng thái hàng loạt
  • pixverse asset list, asset upload, asset info, asset download và asset delete cho các thao tác vòng đời tài sản video, hình ảnh và âm thanh
  • pixverse saved list, saved items, saved new, saved rename, saved add, saved remove và saved delete cho thư mục đã lưu
  • pixverse template categories, template list, template search và template info để khám phá hiệu ứng và mẫu
  • pixverse voice models, voice presets và music models để khám phá mô hình âm thanh trực tiếp
  • pixverse workspace list, workspace status, workspace switch và workspace manage cho thao tác đa không gian làm việc
  • pixverse account info, account usage và account slots để kiểm tra tín dụng, mức sử dụng và mức đồng thời
  • pixverse config set, config list, config path và config defaults cho các mặc định cục bộ có thể lặp lại

Nhờ đó, bạn dễ dàng tự động hóa không chỉ việc tạo nội dung mà còn cả tổ chức, khám phá mẫu, khám phá âm thanh, tải xuống, định tuyến không gian làm việc và bàn giao trong cùng một script. Nếu cần chạy một lệnh trên không gian làm việc khác, hãy dùng cờ toàn cục --workspace-id <id>; 0 nhắm tới không gian làm việc cá nhân của bạn.

Dự án Canvas và các mô hình hiện được hỗ trợ

CLI hiện có các quy trình Canvas cho dự án, đồ thị, nút, bản vá và điều phối tác vụ. Xem pixverse canvas --help và pixverse capabilities canvas --json trước khi tự động hóa. Khả năng Canvas được truy vấn từ dịch vụ sau khi đăng nhập; khả năng tạo nội dung mô tả CLI đã cài. Hãy cập nhật CLI nếu thiếu mô hình.

Danh mục hiện tại có Seedance 2.5, MiniMax H3/H3 Max, FLUX 3, Wan 3.0, Kling 4K, GPT Image 2.5 Flare/Sunburst và Nano Banana 2.1. Kiểm tra khả năng của mô hình và chế độ cụ thể, thay vì dùng lại thời lượng, âm thanh, tham chiếu hay độ phân giải của mô hình khác.

Các cờ thân thiện với script

Hầu hết quy trình tự động hóa đều phụ thuộc vào đầu ra có thể dự đoán và hành vi thời gian chạy có thể dự đoán. Các cờ sau đặc biệt hữu ích trong script và quy trình của tác nhân AI:

Cờ Dùng để
--json Trả về đầu ra JSON có cấu trúc
-p Bí danh ngắn cho --json
--count <n> Tạo 1–4 biến thể từ một yêu cầu
--seed <number> Giúp lần tạo dễ tái lập hơn
--off-peak Dùng giá ngoài giờ cao điểm khi có
--audio / --no-audio Bật hoặc tắt tạo âm thanh trên các lệnh tạo được hỗ trợ
--multi-shot / --no-multi-shot Bật hoặc tắt chế độ nhiều cảnh cho video
--no-wait Gửi tác vụ và trả về ngay
--timeout <sec> Đặt thời gian chờ thăm dò, mặc định 300 giây
--workspace-id <id> Ghi đè không gian làm việc đang hoạt động cho một lệnh
--trace-id <uuid> Gắn UUIDv4 do bên gọi cung cấp vào yêu cầu API để gỡ lỗi và quan sát
--idempotency-key <key> Thử lại yêu cầu tạo một cách an toàn mà không vô tình tạo tác vụ bị tính phí trùng lặp

Các cờ nhập văn bản giờ dễ tự động hóa hơn. --prompt, --text và --lyrics có thể nhận chuỗi nguyên văn, đường dẫn tệp cục bộ hoặc - cho 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

Dạy tác nhân AI của bạn tạo phương tiện

Với các nhóm muốn điểm khởi đầu có hướng dẫn, dựa trên ứng dụng, trước khi chuyển sang tự động hóa dòng lệnh, PixVerse Agent cung cấp quy trình tạo nội dung theo hướng tác nhân trong ứng dụng PixVerse.

Đây là lúc PixVerse CLI thực sự tạo khác biệt. Vì các lệnh có thể trả về JSON có cấu trúc và dùng mã thoát xác định, bất kỳ tác nhân AI nào chạy được lệnh shell đều có thể được dạy để tạo hình ảnh và video theo yêu cầu.

Cài đặt PixVerse Skills

PixVerse Skills là thư viện skill có cấu trúc dạy tác nhân cách dùng CLI đúng: cờ lệnh, ràng buộc mô hình, pipeline nhiều bước và xử lý lỗi vững chắc.

Với Claude Code và các tác nhân khác hỗ trợ định dạng skill, hãy thêm trực tiếp PixVerse skills:

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

Với Cursor, Claude Code, Codex và các khung tác nhân khác, skill này cải thiện độ tin cậy bằng cách đưa cho tác nhân các ràng buộc rõ ràng thay vì bắt nó suy luận từ đầu.

Khi tác nhân đã nạp PixVerse skills, bạn có thể đưa chỉ dẫn bằng ngôn ngữ tự nhiên như:

  • “Tạo video demo sản phẩm dài 10 giây từ ảnh chụp màn hình này”
  • “Tạo bốn biến thể ảnh bìa blog này ở định dạng 16:9”
  • “Biến sơ đồ này thành clip giải thích 5 giây có âm thanh nền”
  • “Tạo ba clip quảng bá 8 giây tỷ lệ 16:9 với các chuyển động camera khác nhau”

Tác nhân sẽ chuyển các chỉ dẫn đó thành lệnh CLI đúng, phân tích đầu ra JSON, rồi xử lý thăm dò và tải xuống — không cần can thiệp thủ công.

Claude Code

Trong Claude Code, PixVerse CLI trở thành công cụ gốc mà tác nhân dùng tự chủ. Sau khi nạp PixVerse skills, bạn có thể đưa việc tạo phương tiện trực tiếp vào bất kỳ tác vụ nào:

Tạo ảnh bìa cho bài blog về machine learning này, dùng mô hình seedream-5.0-lite ở 2160p định dạng 16:9, tải về ./assets/cover.webp

Claude Code sẽ gọi đúng lệnh CLI, lấy URL hình ảnh từ phản hồi JSON và tải tệp về đường dẫn bạn chỉ định — tất cả trong cùng phiên mà nó cũng đang viết mã của bạn.

Một quy trình Claude Code điển hình:

# 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

Người dùng Cursor có thể nạp PixVerse Skills như tệp ngữ cảnh dự án. Đặt các tệp skill liên quan vào thư mục .cursor/ hoặc thêm vào quy tắc không gian làm việc. Sau khi nạp, Cursor nắm đầy đủ mọi lệnh PixVerse CLI và có thể tạo phương tiện như một phần của bất kỳ tác vụ lập trình nào.

Một quy trình Cursor phổ biến: yêu cầu tác nhân tạo ảnh mockup dựa trên thiết kế bạn đang dựng, rồi dùng trực tiếp làm tham chiếu trong phiên IDE — mà không rời trình soạn thảo.

Codex và các tác nhân khác

PixVerse CLI tương thích với mọi tác nhân có thể thực thi lệnh shell và phân tích JSON. Định dạng đầu ra có cấu trúc — tên trường nhất quán, mã lỗi có thể dự đoán và thông báo lỗi tách trên stderr — bảo đảm ngay cả tác nhân script đơn giản cũng tích hợp việc tạo nội dung một cách ổn định.

Hợp đồng mã thoát giúp xử lý lỗi trở nên rõ ràng:

Mã Ý nghĩa Hành động của tác nhân
0 Thành công Phân tích đầu ra JSON
1 Lỗi chung Kiểm tra stderr và thử lại với đầu vào đã xác thực
2 Hết thời gian chờ Thử lại với --timeout dài hơn
3 Xác thực hết hạn Chạy lại pixverse auth login
4 Hết tín dụng Kiểm tra số dư, thông báo cho người dùng
5 Tạo thất bại Thử tham số khác
6 Lỗi xác thực Xem lại giá trị cờ
7 Giới hạn đồng thời Chờ chỗ trống rồi thử lại

Pipeline tự động hóa

Khi đã nắm các lệnh riêng lẻ, PixVerse CLI mở ra các quy trình nhiều bước mạnh mẽ, chạy hoàn toàn không cần tương tác người dùng.

Từ văn bản sang hình ảnh rồi sang video

Một trong những pipeline hữu ích nhất: tạo hình ảnh độ phân giải cao từ prompt văn bản, rồi biến nó thành video.

# 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

Pipeline sản xuất video đầy đủ

Để có đầu ra chỉn chu, hãy nối bước tạo với các bước hậu xử lý. Dùng --audio hoặc --no-audio khi bạn muốn âm thanh gốc trên các lệnh tạo video được hỗ trợ, rồi dùng create voice cho âm thanh chuyển văn bản thành giọng nói và create music cho tài sản nhạc độc lập mà bạn sẽ ghép ở bước sau:

# 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

Tạo hàng loạt

Với các pipeline nội dung cần nhiều biến thể, hãy chạy tác vụ song song:

# 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

Cờ --no-wait gửi tác vụ và trả về ngay kèm ID tác vụ, cho phép bạn gửi nhiều tác vụ trước khi thăm dò. Với --no-wait --json, hãy ghi lại ID tác vụ trả về và các tham số tạo đã phân giải để ghi nhật ký và tái lập. Dùng --count <n> khi muốn nhiều biến thể từ một prompt, và dùng task status --ids hàng loạt khi muốn một phản hồi trạng thái cho nhiều tác vụ đang chạy. Lệnh pixverse task wait xử lý thăm dò thích ứng cho bạn.

Cấu hình giá trị mặc định

Nếu bạn luôn dùng cùng mô hình, chất lượng hoặc tỷ lệ khung hình, hãy đặt chúng làm mặc định để không phải lặp lại cờ mỗi lần:

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

Cờ dòng lệnh luôn ghi đè mặc định đã cấu hình, nên bạn vẫn giữ toàn bộ tính linh hoạt đồng thời giảm lặp lại. Với tự động hóa theo không gian làm việc, hãy thêm --workspace-id <id> vào lệnh khi muốn ghi đè không gian làm việc đang hoạt động cho lần chạy đó.

Bạn có thể xây dựng gì

Khi tích hợp PixVerse CLI vào quy trình tác nhân, phạm vi tác vụ có thể tự động hóa mở rộng đáng kể:

  • Tài liệu — tự động tạo video demo sản phẩm và ảnh chụp màn hình như một phần quy trình dựng tài liệu
  • Tiếp thị — chạy tác vụ hàng loạt ban đêm để tạo các biến thể nội dung mạng xã hội từ một thư viện prompt
  • Phát triển ứng dụng — để tác nhân lập trình tạo hình minh họa tạm, hoạt ảnh mockup hoặc video màn hình tải trong lúc bạn dựng UI
  • Quy trình âm thanh — tạo bản nháp thuyết minh, bản nhạc từ prompt hoặc tài sản âm thanh để chỉnh sửa sau
  • Pipeline nội dung — nối các lệnh CLI với công cụ khác (ffmpeg, ImageMagick, lưu trữ đám mây) để xây quy trình sản xuất phương tiện tự động hoàn toàn
  • Làm mẫu — tạo ý tưởng chuyển động nhanh trong vài giây để kiểm chứng ý tưởng trước khi cam kết sản xuất đầy đủ

CLI được thiết kế để hòa vào mọi quy trình dựa trên shell. Nếu tự động hóa hiện có của bạn chạy trên bash, Python, Node hoặc pipeline CI/CD, PixVerse CLI gắn vào mà không cần chi phí tích hợp thêm.

Danh sách kiểm tra bắt đầu

  • Cài Node.js 22.12 trở lên
  • Chạy npm install -g pixverse
  • Chạy pixverse auth login và ủy quyền trên trình duyệt
  • Chạy pixverse account info để xác minh tín dụng
  • Chạy pixverse account slots trước khi làm việc hàng loạt đồng thời
  • Tạo hình ảnh đầu tiên: pixverse create image --prompt "..." --json
  • Tạo video đầu tiên: pixverse create video --prompt "..." --json
  • Tạo tài sản giọng nói đầu tiên: pixverse create voice --text "..." --json
  • Tạo tài sản nhạc đầu tiên: pixverse create music --prompt "..." --json
  • Khám phá mẫu với pixverse template list
  • Cài PixVerse Skills cho tác nhân của bạn (Claude Code, Cursor hoặc Codex)
  • Thiết lập mặc định bạn thích với pixverse config defaults set
  • Xây pipeline tự động hóa đầu tiên

Giữ CLI luôn cập nhật

Dùng trình cập nhật tích hợp để giữ CLI cục bộ luôn mới:

pixverse update

Bạn cũng có thể dùng npm trực tiếp:

npm install -g pixverse@latest

Vì PixVerse CLI là công cụ được cập nhật liên tục chứ không phải lần ra mắt một lần, hãy xem bài viết này như cẩm nang thực hành và các nguồn chính thức như lớp tham chiếu trực tiếp. Trang PixVerse CLI chính thức là đường cài đặt và đưa tác nhân vào việc ngắn nhất, còn GitHub là nơi theo dõi thay đổi theo từng bản phát hành và các mô hình mới được hỗ trợ:

Tài liệu hiện tại nêu bật PixVerse V6 là mô hình video mặc định, GPT Image 2.5 Flare là mô hình hình ảnh mặc định, hỗ trợ video Google Gemini Omni, hỗ trợ hình ảnh Nano Banana 2 Lite và Seedream 5.0 Pro, hỗ trợ Seedance 2.0 Mini, quy trình PixVerse v5 và v5.5 theo từng chế độ, các lệnh chuyên biệt create voice và create music, quản lý tài sản âm thanh, thư mục đã lưu, chuyển không gian làm việc, config defaults, capabilities.json cho tác nhân, pixverse update, hỗ trợ stdin cho đầu vào văn bản, --trace-id và --idempotency-key để thử lại an toàn hơn.

Bước tiếp theo

Trang PixVerse CLI chính thức, PixVerse CLI trên GitHub và npm (npm install -g pixverse) cho bạn quyền truy cập ngay vào tạo nội dung, thăm dò tác vụ, quản lý tài sản, mẫu, thư mục đã lưu, kiểm tra tài khoản, khám phá mô hình âm thanh và điều khiển không gian làm việc từ một giao diện duy nhất. Kho PixVerse Skills bổ sung hướng dẫn sẵn sàng cho tác nhân để Claude Code, Cursor, Codex và các công cụ khác chạy các quy trình này với độ tin cậy cao hơn.

Sự kết hợp giữa CLI đáng tin cậy và thư viện skill sẵn sàng cho tác nhân nghĩa là việc tạo hình ảnh, video, giọng nói và nhạc có thể nằm trong cùng quy trình với mã của bạn — do cùng một tác nhân quản lý, trong cùng một terminal, không cần chuyển công cụ.

Bắt đầu bằng một lệnh. Rồi xây từ đó.

Tài nguyên liên quan

Tạo video, hình ảnh, giọng nói và nhạc từ terminal của bạn với PixVerse.