PixVerse CLI：开发者的 AI 视频与图像生成终端方案

简介

每个创意工作流都有一个瓶颈：你不得不离开代码编辑器、打开浏览器，并在网页界面里手动点击来生成媒体内容。对于开发者、AI 智能体，以及所有在构建自动化内容流水线的人来说，这种上下文切换会持续带来高成本摩擦。

PixVerse CLI 正是为了解决这个瓶颈。它是 PixVerse 官方命令行工具，让你可以直接在终端中调用 PixVerse 平台上的全部模型、功能与能力。文生视频、图生视频、文生图、口型同步语音、音效生成、超分放大——都能脚本化、管道化，而且全程无需打开浏览器。

PixVerse CLI 的核心优势在于它以 AI 智能体为中心设计：每条命令都输出结构化 JSON，退出码可预测且确定，每一步管道都可组合复用。这意味着你可以把图像和视频生成任务交给 Claude Code、Cursor、Codex 或其他智能体，并让它们稳定、准确地重复执行。

本指南将带你完成完整路径：从安装开始，到第一次生成，再到多步骤自动化流水线与智能体原生工作流。

前置条件

开始前你需要准备：

• Node.js 20 或更高版本 — 使用 node --version 检查
• PixVerse 账号 — 在 pixverse.ai 注册
• 有效的 PixVerse 订阅 — CLI 与官网共用同一积分系统；仅订阅用户可生成内容

PixVerse CLI 不需要你手动复制 API 密钥。认证通过浏览器 OAuth 流程完成，令牌会保存到本地。

第一步：安装 CLI

使用 npm 全局安装：

npm install -g pixverse

验证安装：

pixverse --version

如果你不想全局安装，也可以通过 npx 直接运行命令：

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

第二步：认证登录

运行登录命令：

pixverse auth login

CLI 会打开浏览器进行 OAuth 设备授权。你也可以复制 URL，在任意设备的浏览器中完成授权，这对于 SSH 或无界面环境尤其方便。令牌会自动保存到 ~/.pixverse/，有效期为 30 天。

验证登录状态并检查可用积分：

pixverse auth status
pixverse account info

account info 命令会显示你的订阅档位、剩余积分和每日积分重置时间。执行批量任务前，建议先确认余额。

第三步：生成第一张图像

文生图是验证环境配置的最快方式。运行：

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

--json 参数会返回结构化输出：

{
  "image_id": 789012,
  "status": "completed",
  "image_url": "https://...",
  "prompt": "A photorealistic forest path at golden hour",
  "model": "qwen-image",
  "width": 1024,
  "height": 1024
}

如果你需要更高分辨率，请指定支持高分输出的模型：

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

PixVerse 支持多种图像模型，每个模型在分辨率上限和适用场景上各有特点：

下载生成图像：

pixverse asset download 789012

第四步：生成第一个视频

文生视频的流程与文生图类似。先生成一段 5 秒短片：

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

如果你需要完整自定义参数：

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

--audio 参数可启用与视频内容匹配的 AI 环境音。任务完成后，--json 会返回 video_url，可直接传给下载命令或流水线下一步。

PixVerse 提供多个视频模型，能力侧重点各不相同：

让静态图像动起来

想把照片或生成图像转成视频时，请使用 --image 参数：

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

你可以传入本地文件路径或 URL。本地文件会自动上传，无需额外手动上传步骤。

第五步：运行交互式向导

如果你是第一次使用，对全部参数还不熟悉，可以不带参数运行创建命令，进入引导式向导：

pixverse create video
pixverse create image

向导会一步步带你设置提示词、模型、画质、宽高比、时长等选项，便于你在脚本化之前先了解参数空间。

超越生成：管理资产与工作区

最新 PixVerse CLI 还提供了管理类命令，方便你构建端到端终端工作流：

• pixverse task status <id> 与 pixverse task wait <id> 用于任务轮询
• pixverse asset list|upload|info|download|delete 用于资产全生命周期管理
• pixverse saved list|items|new|rename|add|remove|delete 用于收藏文件夹管理
• pixverse workspace list|status|switch|manage 用于多工作区操作

这让你不仅能自动化生成，也能在同一脚本中自动化组织、下载与交付。

教你的 AI 智能体生成媒体

这正是 PixVerse CLI 的关键价值。由于每条命令都返回结构化 JSON 且退出码可预测，任何能够执行 shell 命令的 AI 智能体都能被训练为按需生成图像与视频。

安装 PixVerse Skills

PixVerse Skills 是一套结构化技能库，用于教会智能体正确使用 CLI：参数约束、模型限制、多步骤流水线和稳健错误处理。

对于 Claude Code 以及支持 skills 格式的其他智能体，可直接添加 PixVerse skills：

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

对于 Cursor、Claude Code、Codex 及其他智能体框架，这套技能可以显著提升稳定性，因为它为智能体提供了显式约束，而不是让它从零推断。

当智能体加载 PixVerse skills 后，你可以直接给自然语言指令，例如：

• “Generate a 10-second product demo video from this screenshot”
• “Create four variations of this blog cover image in 16:9 format”
• “Animate this diagram into a 5-second explainer clip with ambient sound”
• “Generate three 8-second 16:9 promo clips with different camera motions”

智能体会把这些指令转换成正确的 CLI 命令，解析 JSON 输出，并自动处理轮询与下载，全程无需人工介入。

Claude Code

在 Claude Code 中，PixVerse CLI 会成为智能体可自主调用的原生工具。加载 PixVerse skills 后，你可以把媒体生成直接并入任意任务：

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

Claude Code 会调用正确命令，从 JSON 响应中解析图像 URL，并下载到你指定路径，同时继续在同一会话中完成代码工作。

典型的 Claude Code 工作流：

# Claude Code 会根据你的指令自动运行
IMG=$(pixverse create image \
  --prompt "Abstract visualization of neural network layers, dark background, blue and purple tones" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json | jq -r '.image_url')
 
# 然后将其动画化
pixverse create video \
  --prompt "Slow pan across glowing neural connections" \
  --image "$IMG" \
  --model v6 \
  --quality 1080p \
  --duration 6 \
  --json

Cursor

Cursor 用户可以将 PixVerse Skills 作为项目上下文文件加载。把相关技能文件放入 .cursor/ 目录，或加入工作区规则。加载后，Cursor 能完整理解 PixVerse CLI 全部命令，并在编码任务中直接执行媒体生成。

常见的 Cursor 用法是：让智能体基于你正在开发的设计生成 mockup 图像，然后在 IDE 会话里直接引用，全程无需离开编辑器。

Codex 与其他智能体

PixVerse CLI 与所有可以执行 shell 命令并解析 JSON 的智能体兼容。其结构化输出格式——一致字段名、可预测错误码、与 stderr 分离的错误信息——确保即便是简单脚本型智能体也能稳定集成生成能力。

退出码约定让错误处理非常直接：

自动化流水线

理解单条命令后，PixVerse CLI 就可以解锁完全无需人工交互的多步骤强大流程。

文生图到图生视频

这是最实用的流水线之一：先通过文本提示生成高分辨率图像，再将其动画化为视频。

# 第一步：生成基础图像
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')
 
# 第二步：将图像动画化为视频
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')
 
# 第三步：下载最终视频
pixverse asset download "$VIDEO_ID" --json

完整视频制作流水线

如果你需要更精细的成片效果，可将生成与后处理步骤串联：

# 第一步：创建基础视频
RESULT=$(pixverse create video \
  --prompt "A product being assembled in slow motion" \
  --model v6 \
  --quality 720p \
  --duration 5 \
  --json)
 
VID=$(echo "$RESULT" | jq -r '.video_id')
 
# 第二步：延长时长
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --prompt "Continue the assembly sequence" \
  --duration 5 \
  --json | jq -r '.video_id')
 
pixverse task wait "$EXTENDED" --json
 
# 第三步：添加环境音
WITH_SOUND=$(pixverse create sound \
  --video "$EXTENDED" \
  --prompt "Industrial workshop ambience, soft mechanical sounds" \
  --json | jq -r '.video_id')
 
pixverse task wait "$WITH_SOUND" --json
 
# 第四步：放大到 1080p
FINAL=$(pixverse create upscale \
  --video "$WITH_SOUND" \
  --quality 1080p \
  --json | jq -r '.video_id')
 
pixverse task wait "$FINAL" --json
 
# 第五步：下载
pixverse asset download "$FINAL" --json

批量生成

如果内容流水线需要多个版本，可以并行提交任务：

# 先检查积分
CREDITS=$(pixverse account info --json | jq -r '.credits.total')
echo "Available credits: $CREDITS"
 
# 并行提交四个生成任务
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
 
# 逐个等待完成并下载
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

--no-wait 会在提交后立即返回任务 ID，便于你先提交多个任务再统一轮询。pixverse task wait 会自动执行自适应轮询，你无需手动写 sleep 循环。

配置默认值

如果你长期使用固定模型、画质或宽高比，可以设为默认值，减少重复输入：

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

命令行 flags 会始终覆盖默认配置，因此你在减少重复的同时仍保有完整灵活性。

你可以构建什么

当 PixVerse CLI 接入智能体工作流后，可自动化任务的范围会显著扩展：

• 文档 — 在文档构建流程中自动生成产品演示视频与截图
• 营销 — 运行夜间批任务，从同一提示词库批量生成社媒内容变体
• 应用开发 — 让编码智能体在你开发 UI 时并行生成占位视觉、mockup 动画或加载页视频
• 内容流水线 — 将 CLI 与其他工具（ffmpeg、ImageMagick、云存储）串联，构建全自动媒体生产流程
• 原型验证 — 数秒内生成运动概念，先验证想法再投入完整制作

CLI 被设计为可自然融入任何基于 shell 的流程。无论你的自动化运行在 bash、Python、Node 还是 CI/CD 管道中，PixVerse CLI 都能低成本接入。

快速开始清单

• 安装 Node.js 20 或更高版本
• 运行 npm install -g pixverse
• 运行 pixverse auth login 并在浏览器完成授权
• 运行 pixverse account info 确认积分
• 生成第一张图：pixverse create image --prompt "..." --json
• 生成第一个视频：pixverse create video --prompt "..." --json
• 为你的智能体安装 PixVerse Skills（Claude Code、Cursor 或 Codex）
• 使用 pixverse config defaults set 设置常用默认参数
• 构建你的第一个自动化流水线

保持 CLI 最新

使用 npm 更新本地 CLI：

npm update -g pixverse

如需查看版本级更新和新支持模型，请查看官方 CLI 更新日志：

• PixVerse CLI Changelog

下一步

npm 上的 PixVerse CLI（npm install -g pixverse）让你通过单一界面立即调用生成、任务轮询、资产管理、收藏夹与工作区控制。PixVerse Skills 仓库 则提供智能体可用的结构化指导，让 Claude Code、Cursor、Codex 等工具更稳定地执行这些流程。

稳定可靠的 CLI 加上面向智能体的技能库，意味着图像与视频生成可以和代码工作保持在同一流程中：同一个智能体、同一个终端、无需切换工具。

从一条命令开始，然后持续扩展。