PixVerse CLI: tạo video và hình ảnh AI trong terminal

Cài PixVerse CLI để tạo video, hình ảnh, giọng nói và nhạc AI trong terminal, đồng thời tự động hóa quy trình Agent bằng JSON.

Product Update •
PixVerse CLI: tạo video và hình ảnh AI trong terminal

Với các đội ngũ muốn có điểm khởi đầu được hướng dẫn trong ứ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 sáng tạo do Agent hỗ trợ trong ứng dụng PixVerse.

Giới thiệu

Mọi quy trình sáng tạo đều có một nút thắt cổ chai - thời điểm bạn phải rời khỏi trình soạn thảo mã của mình, mở trình duyệt và nhấp qua giao diện web theo cách thủ công để tạo một tư liệu đa nội dung đa phương tiện. Đối với các nhà phát triển, Agent AI và bất kỳ ai xây dựng quy trình nội dung tự động, việc chuyển đổi ngữ cảnh đó là trở ngại tăng lên nhanh chóng.

PixVerse CLI loại bỏ nút thắt cổ chai đó. Đây là giao diện dòng lệnh chính thức cho PixVerse, cho phép bạn truy cập quy trình tạo nội dung và không gian làm việc PixVerse trực tiếp từ terminal của bạn. Chuyển văn bản thành video, hình ảnh thành video, văn bản thành hình ảnh, hình ảnh thành hì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 và quản lý tài sản đều có thể tự động hóa bằng tập lệnh và nối qua pipe và có sẵn mà không cần chạm vào trình duyệt. Công cụ đưa quy trình tạo video AI PixVerse vào tập lệnh và quy trình Agent. Để có lộ trình cài đặt 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ế của nó: nó được xây dựng với các Agent AI. Các lệnh có thể trả về JSON có cấu trúc với --json hoặc -p, mã thoát có tính xác định và mọi bước quy trình đều có thể kết hợp được. Điều này có nghĩa là bạn có thể hướng dẫn Claude Code, Cursor, Codex hoặc bất kỳ Agent nào khác thay mặt bạn tạo hình ảnh, video, giọng nói và âm nhạc với ít bước chuyển giao dễ lỗi hơn.

Hướng dẫn này phù hợp với PixVerseAI/cli GitHub README hiện tại, tệp kê khai khả năng công khai và trang sản phẩm PixVerse CLI, được 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, vì vậy, tập lệnh sản xuất vẫn phải xác minh pixverse --version, pixverse create <mode> --help và pixverse update trước khi chạy một đợt 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 với node --version
  • Tài khoản PixVerse — đăng ký tại pixverse.ai
  • Đăng ký PixVerse đang hoạt động — CLI sử dụng hệ thống Credits giống như trang web; chỉ người dùng có gói trả phí mới có thể tạo nội dung

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

Bước 1: Cài đặt CLI

Cài đặt toàn cầu với npm:

npm install -g pixverse

Xác minh cài đặt:

pixverse --version

Nếu bạn không muốn cài đặt trên toàn cầu, 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 rất hữu ích cho môi trường SSH và không có giao diện người dùng. Mã thông báo của bạn được lưu trữ tự động trong ~/.pixverse/ và có giá trị trong 30 ngày.

Để xác minh bạn đã đăng nhập và kiểm tra số Credits hiện có của mình:

pixverse auth status pixverse account info pixverse account slots

Lệnh account info hiển thị cấp đăng ký, Credits không gian làm việc và bối cảnh sử dụng của bạn. pixverse account usage giúp bạn xem xét mức tiêu thụ Credits, trong khi pixverse account slots hiển thị số tác vụ tạo đồng thời hiện tại cho các tác vụ hình ả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 xác thực CLI được lưu trữ bằng pixverse auth logout. Luôn kiểm tra số dư của bạn và số tác vụ đồng thời còn trống trước khi chạy các tác vụ hàng loạt.

Lệnh khởi động nhanh

Nếu bạn chỉ cần đường đi ngắn nhất từ quá trình cài đặt đến nội dung được tạo, hãy bắt đầu với trình tự sau:

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

Đối với quy trình của Agent và CI, hãy luôn bật --json hoặc -p để stdout vẫn có thể đọc được bằng máy trong khi tiến trình và lỗi được gửi tới stderr. Đối với các lần thử lại trong sản xuất, hãy thêm --idempotency-key <key> vào các lệnh tạo để việc gửi đi lặp lại không vô tình tạo ra các tác vụ bị tính phí trùng lặp.

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

Tạo văn bản thành hình ảnh là cách nhanh nhất để kiểm tra thiết lập của bạn. Chạy:

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

GitHub README hiện tại liệt kê GPT Image 2 làm mô hình ảnh mặc định. Để tự động hóa có thể tái lập, vẫn đặt --model một cách rõ ràng và kiểm tra trợ giúp CLI trực tiếp hoặc capabilities.json trước khi làm việc hàng loạt. Cờ --json trả về kết quả 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 có độ phân giải cao hơn, hãy chỉ định mô hình hỗ trợ nó:

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ợ một số mô hình ảnh, mỗi mô hình có trần độ phân giải và hỗ trợ tỷ lệ khung hình khác nhau:

Mô hình --model value Chất lượng Ghi chú
GPT Image 2 gpt-image-2.0 1080p, 1440p, 2160p Mô hình hình ảnh mặc định; hỗ trợ nhiều tỷ lệ khung hình và cao
Nano Banana 2 gemini-3.1-flash 512p, 1080p, 1440p, 2160p auto linh hoạt và tỷ lệ khung hình tiêu chuẩn
Nano Banana 2 Lite gemini-3.1-flash-lite 1080p Tùy chọn Nano Banana 2 nhẹ cho quy trình hì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 hình ảnh chất lượng cao ở kích thước lớn hơn
Nano Banana gemini-2.5-flash 1080p Tạo hình ảnh nhẹ với thời gian tạo nhanh
Seedream 5.0 Pro seedream-5.0-pro 1080p, 1440p Hỗ trợ tỷ lệ khung hình tiêu chuẩn và quy trình nhiều hình ảnh tham chiếu
Seedream 5.0 Lite seedream-5.0-lite 1440p, 1800p, 2160p Hình ảnh sáng tạo có độ chi tiết cao
Seedream 4.5 seedream-4.5 1440p, 2160p Tạo hình ảnh có độ 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 hình ảnh
Kling Image O3 kling-image-o3 1080p, 1440p, 2160p Đầu ra trực quan được cách điệu hóa 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ể chuyển đổi hình ảnh hiện có bằng hình ảnh thành hình ả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 xuống hình ảnh được 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ự. Tạo clip dài 5 giây:

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

Để tùy chỉnh đầy đủ một lần tạo:

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 cho phép âm thanh xung quanh do AI tạo ra phù hợp với nội dung video của bạn. Cờ --json trả về video_url khi hoàn thành mà bạn có thể chuyển trực tiếp tới lệnh tải xuống hoặc bước tiếp theo trong quy trình.

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 --model value 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 mẽ trên các quy trình bằng video, tài liệu tham khảo 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 có sẵn cho create video
Kling O3 Pro kling-o3-pro 720p 3–15 giây Hỗ trợ 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ợ 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 1080p 1–15 giây Chỉ chuyển hình ảnh thành video; yêu cầu --image và tuân theo tỷ lệ khung hình của hình ảnh đầu vào
Grok Imagine grok-imagine 720p 1–15 giây Tùy chọn Grok trước đó; hỗ trợ quy trình video, mở rộng và tham chiếu
Veo 3.1 Lite veo-3.1-lite 1080p 4, 6 hoặc 8 giây Hỗ trợ tạo video và chuyển cảnh giữa 2 khung hình
Veo 3.1 Standard veo-3.1-standard 2160p 4, 6 hoặc 8 giây Tùy chọn Veo có độ 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 lịch sử; Sora API đã ngừng ngày 24/9/2026
Sora 2 sora-2 720p 4, 8 hoặc 12 giây Tùy chọn lịch sử; Sora API đã ngừng ngày 24/9/2026
PixVerse v5.6 v5.6 1080p 1–10 giây Vẫn được sử dụng cho quy trình điều khiển chuyển động và một số quy trình tạo nội dung
PixVerse v5.5 v5.5 1080p 1–10 giây Được sử dụng cho quy trình create modify
PixVerse v5 v5 1080p 1–10 giây Được sử dụng cho quy trình chuyển cảnh từ 3 khung hình trở lên

Tạo hoạt ảnh cho hình ảnh tĩnh

Để biến ảnh hoặc hình ảnh được 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ể chuyển đường dẫn tệp cục bộ hoặc URL. Các 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. Đầu vào hình ảnh cục bộ lớn hơn 1920x1920 hoặc 5MB sẽ tự động được thay đổi kích thước hoặc nén trước khi tải lên; URL hình ảnh từ xa được xác thực bởi hệ thống phía máy chủ.

Đối với Grok Imagine 1.5, cần có hình ảnh và tỷ lệ khung hình đầu ra tuân theo hình ả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

Sử 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 tính năng hơn là chuyển văn bản thành video và hình ảnh thành video đơn giản. Các chế độ tạo này rất hữu ích khi bạn cần kiểm soát tốt hơn nhân vật, khung hình chính, chỉnh sửa hoặc hiệu ứng:

# Create a transition between keyframes pixverse create transition --images ./frame1.png ./frame2.png # Tạo âm thanh lời nói từ văn bản pixverse create voice --text "Welcome to the launch" --voice-id <preset_voice_id> --output ./voiceover.mp3 # Tạo nhạc từ 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 # Mở rộng video đã tạo pixverse create extend --video <video_id> # Sửa đổi video hiện có pixverse create modify --video <video_id> --prompt "Change the background to a beach" # Độ phân giải video cao cấp pixverse create upscale --video <video_id> --quality 1080p # Tạo video có hình ảnh tham khảo pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park" # Tham chiếu Seedance 2.0 có thể kết hợp đầu vào hình ảnh và video pixverse create reference \ --model seedance-2.0-standard \ --images ./character.png \ --videos ./motion.mp4 \ --prompt "@image1 follows the motion in @video1" # Mô hình Seedance 2.0 hỗ trợ tối đa 9 hình ảnh tham chiếu 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" # Điều khiển chuyển động bằng hình ảnh nhân vật và video tham chiếu chuyển động pixverse create motion-control --image ./character.png --video ./dance.mp4 # Tạo từ mẫu hoặc hiệu ứng pixverse create template --template-id 12345 --image ./photo.png

Không phải mọi mô hình đều hỗ trợ mọi chế độ sáng tạo. Ma trận README liệt kê 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 cho create video; mục Sora 2 là tư liệu lịch sử vì API đã ngừng ngày 24/9/2026. grok-imagine-1.5 chỉ chuyển từ hình ả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ình hỗ trợ các dòng video mới hơn; Chuyển cảnh từ 3 khung hình trở lên sử dụng v5; create modify sử dụng v5.5; và create motion-control sử dụng v5.6.

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

GitHub README hiện tại ghi lại âm thanh độc lập thông qua các lệnh tạo chuyên dụng. Sử dụng create voice để chuyển văn bản thành giọng nói và create music để tạo nhạc từ prompt. Đầu ra giọng nói và âm nhạc được lưu dưới dạng nội dung âm thanh, vì vậy bạn có thể theo dõi chúng bằng task, liệt kê chúng bằng asset list --type audio và tải chúng xuống bằng asset download --type audio. Để tạo âm thanh môi trường tích hợp trong video, hãy sử 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 nói và giọng nói cài 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

Đối với nhạc không lời, hãy sử dụng --instrumental. Đối với các mô hình hỗ trợ lời bài hát, hãy chuyển lời bài hát dưới dạng văn bản trực tiếp, đườ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 bao gồm các mô hình MiniMax Speech 2.8 và ElevenLabs. Các dòng mô hình âm nhạc hiện tại bao gồm MiniMax Music, ElevenLabs Music và Google Lyria 3 Pro. Sử dụng pixverse voice models và pixverse music models cho danh mục hiện hành trước khi viết tập lệnh 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 tiên và chưa quen với tất cả các cờ có sẵn, hãy chạy bất kỳ lệnh tạo nào mà không có đối số để vào trình hướng dẫn từng bước:

pixverse create video pixverse create image

Trình hướng dẫn sẽ hướng dẫn bạn từng bước về 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 tạo tập lệnh cho chúng.

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

PixVerse CLI hiện tại cũng bao gồm các lệnh quản lý giúp bạn xây dựng quy trình của terminal từ đầu đến cuối:

  • pixverse task status <id> và pixverse task wait <id> để thăm dò trạng thái 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 dành cho các hoạt động trong vòng đời nội dung video, hình ảnh và âm thanh
  • pixverse saved list, saved items, saved new, saved rename, saved add, saved remove và saved delete cho các thư mục đã lưu
  • pixverse template categories, template list, template search và template info để khám phá các hiệu ứng và mẫu
  • pixverse voice models, voice presets và music models để tìm mô hình âm thanh hiện hành
  • pixverse workspace list, workspace status, workspace switch và workspace manage cho hoạt động đa không gian làm việc
  • pixverse account info, account usage và account slots để kiểm tra Credits, mức sử dụng và số tác vụ đồng thời
  • pixverse config set, config list, config path và config defaults cho các giá trị mặc định cục bộ có thể lặp lại

Điều này giúp việc tự động hóa không chỉ quá trình tạo mà còn cả việ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 một tập lệnh trở nên đơn giản. Nếu bạn cần chạy một lệnh trên một không gian làm việc khác, hãy sử dụng cờ --workspace-id <id> chung; 0 hướng tới không gian làm việc cá nhân của bạn.

Cờ thân thiện với tập lệnh

Hầu hết tự động hóa đều phụ thuộc vào kết quả đầu ra có thể dự đoán được và hành vi thời gian chạy có thể dự đoán được. Những cờ này đặc biệt hữu ích trong tập lệnh và quy trình của Agent AI:

Cờ Sử dụng nó cho
--json Trả về đầu ra JSON có cấu trúc
-p Dạng viết tắt cho --json
--count <n> Tạo 1–4 biến thể từ một yêu cầu
--seed <number> Giúp tái lập kết quả tạo dễ hơn
--off-peak Sử dụng giá thấp điểm khi có sẵn
--audio / --no-audio Bật hoặc tắt tính năng 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 quay cho video
--no-wait Gửi tác vụ và trả về ngay
--timeout <sec> Đặt thời gian chờ thăm dò trạng thái, mặc định là 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> Đính kèm UUIDv4 do người gọi cung cấp vào các yêu cầu API để gỡ lỗi và khả năng quan sát
--idempotency-key <key> Thử lại các yêu cầu tạo một cách an toàn mà không vô tình tạo ra các tác vụ bị tính phí trùng lặp

Cờ nhập văn bản giờ đây dễ dàng tự động hóa hơn. --prompt, --text và --lyrics có thể chấp nhận chuỗi ký tự, đườ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

Hướng dẫn Agent AI của bạn cách tạo nội dung đa phương tiện

Đây là lúc PixVerse CLI tạo thay đổi lớn cho quy trình. Vì các lệnh có thể trả về JSON có cấu trúc và sử dụng mã thoát xác định nên bất kỳ Agent AI nào có thể chạy 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 kỹ năng có cấu trúc hướng dẫn các Agent cách sử dụng CLI một cách chính xác: cờ lệnh, ràng buộc mô hình, quy trình nhiều bước và xử lý lỗi mạnh mẽ.

Đối với Claude Code và các Agent khác hỗ trợ định dạng kỹ năng, hãy thêm trực tiếp các kỹ năng PixVerse:

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

Đối với Cursor, Claude Code, Codex và các khung Agent khác, kỹ năng này cải thiện độ tin cậy bằng cách đưa ra các ràng buộc rõ ràng cho Agent thay vì buộc nó phải suy ra chúng từ đầu.

PixVerse CLI cũng cung cấp một bản kê khai lệnh nhỏ gọn có thể đọc được bằng máy tại dist/capabilities.json, với nguồn công khai có sẵn dưới dạng capabilities.json trong kho lưu trữ GitHub. Tệp kê khai này mô tả các lệnh, cờ, mã thoát, kỳ vọng đầu ra của JSON và các danh mục hiệu ứng để Agent có thể kiểm tra giao diện sử dụng CLI mà không cần trích xuất từ văn bản trợ giúp.

Sau khi Agent của bạn đã tải các kỹ năng PixVerse, bạn có thể đưa ra các hướng 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ể của ảnh bìa blog này ở định dạng 16:9”
  • “Hoạt hình hóa sơ đồ này thành clip giải thích dài 5 giây với âm thanh xung quanh”
  • “Tạo ba clip quảng cáo 16:9 dài 8 giây với các chuyển động camera khác nhau”

Agent sẽ dịch các hướng dẫn đó thành các lệnh CLI chính xác, phân tích đầu ra JSON, đồng thời xử lý việc 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ụ tích hợp mà Agent sử dụng một cách tự động. Sau khi tải các kỹ năng PixVerse, bạn có thể đưa trực tiếp việc tạo nội dung đa phương tiện vào bất kỳ tác vụ nào:

Generate a cover image for this blog post about machine learning, use the seedream-5.0-lite model at 2160p in 16:9 format, download it to ./assets/cover.webp

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

Quy trình làm việc 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') # Sau đó làm động nó 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ể tải PixVerse Skills dưới dạng tệp ngữ cảnh dự án. Đặt các tệp kỹ năng có liên quan vào thư mục .cursor/ của bạn hoặc thêm chúng vào quy tắc không gian làm việc của bạn. Sau khi được tải, Cursor có nhận thức đầy đủ về mọi lệnh PixVerse CLI và có thể tạo nội dung đa phương tiện như một phần của bất kỳ tác vụ lập trình nào.

Quy trình làm việc chung của Cursor: yêu cầu Agent tạo hình ảnh mô phỏng dựa trên thiết kế mà bạn đang xây dựng, sau đó sử dụng nó làm tài liệu tham khảo trực tiếp trong phiên IDE của bạn — mà không cần rời khỏi trình chỉnh sửa.

Codex và các Agent khác

PixVerse CLI tương thích với bất kỳ Agent nào có thể thực thi các 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 riêng trên stderr — đảm bảo rằng ngay cả các Agent tạo tập lệnh đơn giản cũng có thể tích hợp việc tạo nội dung một cách đáng tin cậy.

Quy ước mã thoát giúp việc xử lý lỗi trở nên đơn giản:

Mã Ý nghĩa Hành động của Agent
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 thông tin đầu vào đã được 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 Credits Kiểm tra số dư, thông báo cho người dùng
5 Tạo nội dung thất bại Hãy thử các thông số khác nhau
6 Lỗi kiểm tra tính hợp lệ Xem lại giá trị cờ

Quy trình tự động hóa

Khi bạn hiểu các lệnh riêng lẻ, PixVerse CLI sẽ mở ra các quy trình gồm nhiều bước mạnh mẽ chạy hoàn toàn mà không cần sự tương tác của người dùng.

Chuyển văn bản thành hình ảnh thành video

Một trong những quy trình hữu ích nhất: tạo hình ảnh có độ phân giải cao từ prompt văn bản, sau đó tạo hoạt ảnh cho hình ảnh đó 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') # Bước 2: Hoạt hình thành 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') # Bước 3: Tải xuống video cuối cùng pixverse asset download "$VIDEO_ID" --json

Quy trình sản xuất video đầy đủ

Để có đầu ra hoàn thiện, tạo chuỗi với các bước xử lý hậu kỳ. Sử dụng --audio hoặc --no-audio khi bạn muốn âm thanh tạo tích hợp trên các lệnh tạo video được hỗ trợ, sau đó sử dụng create voice cho âm thanh chuyển văn bản sang giọng nói và create music cho nội dung nhạc độc lập mà bạn sẽ kết hợ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') # Bước 2: Gia hạn thời hạn EXTENDED=$(pixverse create extend \ --video "$VID" \ --json | jq -r '.video_id') pixverse task wait "$EXTENDED" --json # Bước 3: Nâng cấp lên 1080p FINAL=$(pixverse create upscale \ --video "$EXTENDED" \ --quality 1080p \ --json | jq -r '.video_id') pixverse task wait "$FINAL" --json # Bước 4: Tải xuống pixverse asset download "$FINAL" --json # Tùy chọn: tạo nội dung lồng tiếng riêng pixverse create voice \ --text "The final reveal starts now." \ --voice-id <preset_voice_id> \ --output ./voiceover.mp3 \ --json

Tạo hàng loạt

Đối với các quy trình nội dung yêu cầu nhiều biến thể, hãy chạy song song các tác vụ:

# Check credits and concurrent generation slots first pixverse account info --json pixverse account slots --json # Gửi bốn tác vụ tạo song song 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 # Kiểm tra tất cả các ID tác vụ được trả về trong một cuộc gọi trạng thái hàng loạt 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 # Đợi từng cái và tải xuống 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 lập tức kèm theo ID nhiệm vụ, cho phép bạn gửi nhiều công việc trước khi thăm dò trạng thái. Với --no-wait --json, ghi lại ID tác vụ được trả về và các tham số tạo thực tế đã được xác định để ghi nhật ký và tái tạo. Sử dụng --count <n> khi bạn muốn có nhiều biến thể từ một prompt và sử dụng task status --ids theo lô khi bạn muốn có một phản hồi trạng thái cho một số công việc đang chạy. Lệnh pixverse task wait xử lý thăm dò trạng thái thích ứng cho bạn.

Định cấu hình mặc định

Nếu bạn thường xuyên sử dụng cùng một mô hình, chất lượng hoặc tỷ lệ khung hình, hãy đặt chúng làm mặc định để bạn 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 đè các giá trị mặc định đã định cấu hình của bạn, do đó bạn vẫn giữ được sự linh hoạt hoàn toàn trong khi giảm sự lặp lại. Để tự động hóa dành riêng cho không gian làm việc, hãy thêm --workspace-id <id> vào lệnh khi bạn muốn ghi đè không gian làm việc đang hoạt động cho lần chạy đó.

Những gì bạn có thể xây dựng

Với PixVerse CLI được tích hợp vào quy trình Agent của bạn, phạm vi tác vụ có thể tự động hóa sẽ mở rộng đáng kể:

  • Tài liệu — tự động tạo video giới thiệu sản phẩm và ảnh chụp màn hình như một phần của quá trình xây dựng tài liệu của bạn
  • Tiếp thị — chạy các tác vụ hàng loạt hàng đêm để tạo ra các biến thể nội dung trên mạng xã hội từ một thư viện prompt duy nhất
  • Phát triển ứng dụng — cho phép Agent mã hóa của bạn tạo hình ảnh giữ chỗ, hoạt ảnh mô phỏng hoặc video màn hình chờ trong khi bạn xây dựng giao diện người dùng
  • Quy trình làm việc về âm thanh — tạo bản nháp lồng tiếng, bản nhạc từ prompt hoặc nội dung âm thanh để chỉnh sửa sau này
  • Quy trình nội dung — gọi CLI theo chuỗi bằng các công cụ khác (ffmpeg, ImageMagick, lưu trữ đám mây) để xây dựng quy trình sản xuất đa nội dung đa phương tiện hoàn toàn tự động
  • Tạo nguyên mẫu — tạo ra các ý tưởng chuyển động nhanh trong vài giây để xác thực các ý tưởng trước khi đưa vào sản xuất hoàn chỉnh

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

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

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

Luôn cập nhật CLI

Sử dụng trình cập nhật tích hợp để cập nhật CLI cục bộ của bạn:

pixverse update

Bạn cũng có thể sử 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 một lần ra mắt duy nhất, hãy xem bài viết này như một hướng dẫn 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à lộ trình ngắn nhất để cài đặt và đưa Agent vào sử dụng, còn GitHub vẫn là nơi theo dõi thay đổi cấp phiên bản và các mô hình mới được hỗ trợ:

Các 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 chế độ cụ thể, các lệnh create voice và create music chuyên dụng, quản lý nội dung âm thanh, thư mục đã lưu, chuyển đổi không gian làm việc, config defaults, capabilities.json dành cho Agent, 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.

Các bước tiếp theo

Trang PixVerse CLI chính thức, PixVerse CLI trên GitHub và npm (npm install -g pixverse) cho phép bạn truy cập ngay vào quá trình tạo, thăm dò trạng thái tác vụ, quản lý nội dung, 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 lưu trữ PixVerse Skills bổ sung thêm hướng dẫn dành cho Agent để Claude Code, Cursor, Codex và các công cụ khác có thể 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 kỹ năng sẵn sàng cho Agent có nghĩa là việc tạo hình ảnh, video, giọng nói và âm nhạc có thể hoạt động trong cùng một quy trình với mã của bạn — được quản lý bởi cùng một Agent, trong cùng một terminal mà không cần chuyển đổi công cụ.

Bắt đầu với một lệnh duy nhất. Xây dựng từ đó.