PixVerse CLI 安装与入门 — 终端里生成 AI 视频

什么是 PixVerse CLI

PixVerse CLI 是官方提供的命令行工具——开发者可以在终端里直接调用 PixVerse 的能力，生成视频、图片、音乐，而不需要打开浏览器手动操作 Web 界面。

它解决的核心问题：

批量生成：一次性生成几十上百个视频，Web 界面手动操作不现实
自动化流水线：把 AI 视频生成嵌入 CI/CD 或内容生产流水线
本地开发测试：在脚本里快速验证 prompt 效果
服务器端运行：无 GUI 的服务器（VPS、Docker、K8s）上也能调用

安装

前提条件

Node.js 18+（npm 随 Node.js 一起安装）
PixVerse 账号（用于获取 API Key）

安装方式一：全局安装

npm install -g pixverse

安装完成后验证：

pixverse --version

安装方式二：npx 直接运行（推荐测试用）

如果不想全局安装，可以用 npx 直接执行：

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

获取 API Key

安装好 CLI 后需要配置 API Key：

登录 PixVerse Web 端
进入个人设置 → API Key 管理
创建新 Key，复制下来
在终端里配置：

pixverse config set api-key YOUR_PIXVERSE_API_KEY

快速开始第一条命令

pixverse create video \
  --prompt "一只橘色小猫坐在温暖的窗台上，阳光洒下来" \
  --model v6 \
  --duration 8 \
  --aspect-ratio "16:9"

这条命令会：

用 V6 模型生成视频
时长 8 秒
画幅 16:9
生成完成后，视频文件会下载到当前目录

核心命令

CLI 的核心命令结构是：pixverse <action> <resource> [options]

视频生成

# 文生视频
pixverse create video --prompt "描述" --model v6 --duration 8 --aspect-ratio "16:9"

# 图生视频
pixverse create video --prompt "让图片动起来" --image ./photo.jpg --model v6

# 指定输出路径
pixverse create video --prompt "..." --output ./videos/output.mp4

图片生成

# 文生图
pixverse create image --prompt "描述" --model v6

# 图生图
pixverse create image --prompt "改成赛博朋克风格" --image ./photo.jpg

音乐生成

pixverse create music --prompt "轻柔的钢琴背景乐" --duration 30

模板相关

# 列出可用模板
pixverse template list

# 使用模板生成
pixverse create video --template "product-showcase" --prompt "替换主体描述"

常用参数速查

参数	说明	示例值
`--prompt`	提示词	"一只猫在火星上走"
`--model`	模型版本	`v6` / `v5` / `v5.6`
`--duration`	视频时长（秒）	`5` / `8` / `10` / `15`
`--aspect-ratio`	画幅比例	`"16:9"` / `"9:16"` / `"1:1"`
`--resolution`	分辨率	`"720p"` / `"1080p"`
`--image`	输入图片路径	`./photo.jpg`
`--output`	输出文件路径	`./videos/output.mp4`
`--json`	以 JSON 格式输出结果	(无值)

批量生成实战

脚本示例：批量生成产品视频

#!/bin/bash
products=("智能音箱" "护肤品瓶" "机械手表" "香薰蜡烛" "蓝牙耳机")

for product in "${products[@]}"; do
  echo "正在生成：$product"
  pixverse create video \
    --prompt "$product放在极简风格的桌面上，镜头缓慢推进，自然光" \
    --model v6 \
    --duration 8 \
    --aspect-ratio "16:9" \
    --output "./output/${product}.mp4" \
    --json
  echo "完成：$product"
  sleep 3  # 避免请求过快
done

这段脚本会：

遍历产品列表
为每个产品生成一段 8 秒 16:9 的视频
输出 JSON 格式结果（方便后续处理）
每个请求间隔 3 秒

Skills 集成

PixVerse CLI 可以作为 Skills 集成到 AI 编码助手中：

Claude Code：在 Claude Code 中调用 pixverse create video
Cursor：配置为自定义命令
Codex：作为工具函数使用

这样你可以在写代码的同时，让 AI 帮你生成视频素材。

与 API Platform 的关系

CLI 和 API Platform 底层用的是同一个服务——CLI 本质上是对 API 的命令行封装：

维度	CLI	API Platform
适合场景	快速脚本、本地开发、命令行流程	集成到自己的服务、网页后端、大型系统
调用方式	终端命令	HTTP 请求（RESTful）
参数传递	命令行 flags	JSON body
鉴权方式	本地 config 存 API Key	HTTP Header 传 App-Key

简单说：CLI 适合单机脚本，API 适合服务端集成。

局限性

需要 Node.js 环境：不是纯 Python 工具，在纯 Python 项目里需要额外装 Node
参数有限：CLI 暴露的是常用参数，API 的全部参数 CLI 可能不支持
文档相对简洁：CLI 的帮助信息够用但不如 API 文档详细

下一步

CLI 上手后，想更深入了解每个命令的参数？看 CLI 命令速查。需要在自己的服务里集成 PixVerse？看 API Platform 概览。