PixVerse CLI 命令速查 — 所有命令和参数详解

命令结构

PixVerse CLI 采用动词 + 名词的结构：

pixverse <动词> <资源> [选项]

动词：create（生成）、list（列出）、config（配置）、help（帮助）
资源：video、image、music、template、config

config — 配置

设置 API Key

pixverse config set api-key pixverse_xxxxxxxxxxxx

查看当前配置

pixverse config list

清除配置

pixverse config clear

create video — 视频生成

文生视频

pixverse create video \
  --prompt "一只橘色小猫坐在窗台上" \
  --model v6

图生视频

pixverse create video \
  --prompt "让图片动起来，轻微推进" \
  --image ./input.jpg \
  --model v6

完整参数示例

pixverse create video \
  --prompt "描述内容" \
  --model v6 \
  --duration 10 \
  --aspect-ratio "16:9" \
  --resolution "1080p" \
  --output ./output/video.mp4 \
  --json

参数	必填	说明
`--prompt`	✅	提示词文本
`--model`	❌	模型版本：`v6` / `v5` / `v5.6` / `v5.5`（默认最新）
`--image`	条件必填	图生视频时的输入图片路径
`--duration`	❌	时长（秒）：5 / 8 / 10 / 15
`--aspect-ratio`	❌	画幅：`"16:9"` / `"9:16"` / `"1:1"`
`--resolution`	❌	分辨率：`"720p"` / `"1080p"`
`--output`	❌	输出文件路径
`--template`	❌	使用的模板名
`--json`	❌	JSON 格式输出

create image — 图片生成

# 文生图
pixverse create image --prompt "赛博朋克风格的未来城市夜景" --model v6

# 图生图
pixverse create image --prompt "改成水彩画风格" --image ./input.webp

create music — 音乐生成

pixverse create music \
  --prompt "轻柔的钢琴背景音乐，适合治愈系视频" \
  --duration 30

参数	说明
`--prompt`	音乐风格/情绪/乐器描述
`--duration`	时长（秒）
`--output`	输出文件路径

template — 模板

列出所有可用模板

pixverse template list

使用模板生成视频

pixverse create video --template "product-showcase" --prompt "替换主体为智能音箱"

查看模板详情

pixverse template show <template-id>

help — 帮助

全局帮助

pixverse --help

子命令帮助

pixverse create video --help
pixverse create image --help

输出格式

默认格式（可读文本）

生成中...
进度：████████████████████████████ 100%
完成！输出文件：./output/cat.mp4
Credits 消耗：10

JSON 格式（适合脚本解析）

{
  "success": true,
  "output_path": "./output/cat.mp4",
  "task_id": "abc123-def456",
  "credits_used": 10,
  "model": "v6",
  "duration": 8,
  "aspect_ratio": "16:9"
}

实战脚本示例

示例一：根据 CSV 批量生成

#!/bin/bash
# products.csv 格式：产品名,提示词
# 智能音箱,智能音箱放在胡桃木桌上，镜头推进
# 护肤品瓶,护肤品瓶放在大理石台上，自然光

while IFS=',' read -r name prompt; do
  echo "生成 $name ..."
  pixverse create video \
    --prompt "$prompt" \
    --model v6 \
    --duration 8 \
    --output "./videos/${name}.mp4" \
    --json >> results.json
  sleep 2
done < products.csv

示例二：多轮迭代同一视频

#!/bin/bash
# 先生成低质量版本快速验证，再出高质量版本

PROMPT="一只橘色小猫在窗台上，阳光洒下来"

# 第一轮：720P / 5 秒 / 快速验证
pixverse create video \
  --prompt "$PROMPT" --model v5 --duration 5 --resolution "720p" \
  --output ./v1_preview.mp4

# (人工查看 v1_preview.mp4 确认方向没问题后...)

# 第二轮：1080P / 10 秒 / 最终版
pixverse create video \
  --prompt "$PROMPT" --model v6 --duration 10 --resolution "1080p" \
  --output ./v2_final.mp4

示例三：配合图生视频

#!/bin/bash
# 先从一组产品图生成多个动态版本

for img in ./assets/product_*.jpg; do
  base=$(basename "$img" .jpg)
  echo "处理 $base ..."
  
  # 版本 A：缓慢推进
  pixverse create video \
    --prompt "镜头缓慢推进到产品特写，光线和背景保持与图片一致" \
    --image "$img" --model v6 --duration 8 \
    --output "./output/${base}_zoom-in.mp4"
  
  # 版本 B：环绕展示
  pixverse create video \
    --prompt "镜头围绕产品 180 度环绕展示，保持产品外观不变" \
    --image "$img" --model v6 --duration 8 \
    --output "./output/${base}_orbit.mp4"
  
  sleep 3
done

错误处理

常见错误码

错误	原因	解决
`API_KEY_INVALID`	API Key 错了或过期	重新生成 Key 并 `config set`
`CREDITS_INSUFFICIENT`	Credits 不够	充值或换更低消耗的模型/参数
`RATE_LIMITED`	请求太频繁	加 `sleep` 或换更长间隔
`INVALID_PROMPT`	提示词含敏感内容或格式不对	修改提示词
`IMAGE_TOO_LARGE`	输入图片太大	压缩到建议尺寸

与 Web 界面的配合

CLI 适合批量和自动化，Web 界面适合：

直观预览模板效果
交互式调整参数
多版本对比
视频编辑和 Agent 对话

最佳实践是：Web 界面试出最佳 prompt → CLI 批量生产。