Hướng dẫn

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

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

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.

Hướng dẫn này khớp với README GitHub PixVerseAI/cli hiện tại, bản kê khả năng công khai của nó, và trang sản phẩm PixVerse CLI, đã kiểm tra vào ngày 13 tháng 7 năm 2026. PixVerse CLI được cập nhật liên tục qua kho GitHub, nên các script sản xuất vẫn nên xác minh pixverse --version, pixverse create <mode> --help và pixverse update trước một lần chạy lô lớn.

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

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

  • Node.js 20 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

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 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.0",
  "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:

Mô hình Giá trị --model Chất lượng Ghi chú
GPT Image 2 gpt-image-2.0 1080p, 1440p, 2160p Mô hình ảnh mặc định; hỗ trợ tỷ lệ khung rộng và cao
Nano Banana 2 gemini-3.1-flash 512p, 1080p, 1440p, 2160p auto linh hoạt và các tỷ lệ khung chuẩn
Nano Banana 2 Lite gemini-3.1-flash-lite 1080p Tùy chọn Nano Banana 2 nhẹ cho quy trình ảnh nhanh
Qwen Image qwen-image 720p, 1080p Tạo nhanh cho các tác vụ sáng tạo thông thường
Nano Banana Pro gemini-3.0 1080p, 1440p, 2160p Tạo ảnh chất lượng cao ở kích thước lớn hơn
Nano Banana gemini-2.5-flash 1080p Tạo ảnh nhẹ với thời gian hoàn thành nhanh
Seedream 5.0 Pro seedream-5.0-pro 1080p, 1440p Hỗ trợ tỷ lệ khung chuẩn và quy trình ảnh đa tham chiếu
Seedream 5.0 Lite seedream-5.0-lite 1440p, 1800p, 2160p Ảnh sáng tạo chi tiết cao
Seedream 4.5 seedream-4.5 1440p, 2160p Tạo ảnh độ phân giải cao
Seedream 4.0 seedream-4.0 1080p, 1440p, 2160p Tùy chọn Seedream bổ sung cho quy trình ảnh
Kling Image O3 kling-image-o3 1080p, 1440p, 2160p Đầu ra hình ảnh cách điệu với khung hình linh hoạt
Kling Image V3 kling-image-v3 1080p, 1440p Cân bằng chất lượng và tốc độ

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

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

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:

Mô hình Giá trị --model Chất lượng tối đa Thời lượng Ghi chú
PixVerse V6 v6 1080p 1–15 giây Mô hình video mặc định; hỗ trợ nhiều tỷ lệ khung hình
PixVerse C1 pixverse-c1 1080p 1–15 giây Hỗ trợ mạnh trên các quy trình video, tham chiếu và chuyển cảnh
Seedance 2.0 Standard seedance-2.0-standard 2160p 4–15 giây Hỗ trợ các chế độ video, tham chiếu và chuyển cảnh
Seedance 2.0 Fast seedance-2.0-fast 720p 4–15 giây Tùy chọn Seedance nhanh hơn cho các chế độ video, tham chiếu và chuyển cảnh
Seedance 2.0 Mini seedance-2.0-mini 720p 4–15 giây Tùy chọn Seedance nhẹ cho các chế độ video, tham chiếu và chuyển cảnh
Google Gemini Omni gemini-omni-flash 720p 3–10 giây Hỗ trợ quy trình video và tham chiếu ở 16:9 hoặc 9:16
Happy Horse 1.0 happyhorse-1.0 1080p 3–15 giây Tùy chọn video nhận biết âm thanh, khả dụng cho create video
Kling O3 Pro kling-o3-pro 720p 3–15 giây Hỗ trợ các quy trình video, tham chiếu và chuyển cảnh
Kling O3 Standard kling-o3-standard 720p 3–15 giây Tùy chọn Kling O3 tiêu chuẩn
Kling 3.0 Pro kling-3.0-pro 720p 3–15 giây Hỗ trợ các quy trình video và chuyển cảnh
Kling 3.0 Standard kling-3.0-standard 720p 3–15 giây Tùy chọn Kling 3.0 tiêu chuẩn
Grok Imagine 1.5 grok-imagine-1.5 720p 1–15 giây Chỉ ảnh-sang-video; yêu cầu --image và theo tỷ lệ khung của ảnh đầu vào
Grok Imagine grok-imagine 720p 1–15 giây Tùy chọn Grok trước đó; hỗ trợ các quy trình video, kéo dài và tham chiếu
Veo 3.1 Lite veo-3.1-lite 1080p 4, 6 hoặc 8 giây Hỗ trợ quy trình video và chuyển cảnh 2 khung
Veo 3.1 Standard veo-3.1-standard 2160p 4, 6 hoặc 8 giây Tùy chọn Veo độ phân giải cao hơn
Veo 3.1 Fast veo-3.1-fast 2160p 4, 6 hoặc 8 giây Tùy chọn Veo nhanh hơn
Sora 2 Pro sora-2-pro 1080p 4, 8 hoặc 12 giây Tùy chọn Sora thời lượng cố định
Sora 2 sora-2 720p 4, 8 hoặc 12 giây Tùy chọn Sora tiêu chuẩn
PixVerse v5.6 v5.6 1080p 1–10 giây Vẫn được dùng cho điều khiển chuyển động và một số quy trình tạo
PixVerse v5.5 v5.5 1080p 1–10 giây Dùng cho các quy trình create modify
PixVerse v5 v5 1080p 1–10 giây Dùng cho các quy trình chuyển cảnh từ 3 khung trở lên

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
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

Không phải mô hình nào cũng hỗ trợ mọi chế độ tạo. Trong ma trận README hiện tại, create video hỗ trợ 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 và v5.6. grok-imagine-1.5 chỉ dùng cho ảnh-sang-video và yêu cầu --image; create extend hỗ trợ v6 và grok-imagine; create reference hỗ trợ v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Kling O3, grok-imagine và v5.6; chuyển cảnh 2 khung hỗ trợ các dòng video mới hơn; chuyển cảnh từ 3 khung trở lên dùng v5; create modify dùng v5.5; và create motion-control dùng v5.6.

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.

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.

PixVerse CLI cũng kèm một manifest lệnh gọn, máy có thể đọc được, tại dist/capabilities.json, với nguồn công khai là capabilities.json trong kho GitHub. Manifest này mô tả lệnh, cờ, mã thoát, kỳ vọng đầu ra JSON và danh mục hiệu ứng, để tác nhân có thể kiểm tra hợp đồng CLI mà không cần cạo văn bản trợ giúp.

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ờ

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 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

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 20 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 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.