重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
pixverse-ai-image-and-video-generator by pixverseai/skills
npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-and-video-generatorPixVerse CLI 是 PixVerse 的官方命令行界面——一个用于生成视频和图像的 AI 驱动创意平台。它本质上是 PixVerse 网站的无界面版本:所有功能、模型和参数都与 app.pixverse.ai 的网页体验保持一致。
它专为以下场景设计:
关键事实:
--json 标志以结构化 JSON 形式返回npm install -g pixverse
或者无需安装直接运行:
npx pixverse
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
验证:
pixverse --version
需要 Node.js >= 20。
# 1. 安装
npm install -g pixverse
# 2. 身份验证(OAuth 设备流程 —— 会打开浏览器)
pixverse auth login --json
# 3. 创建视频(默认等待完成)
RESULT=$(pixverse create video --prompt "A cat astronaut floating in space" --json)
VIDEO_ID=$(echo "$RESULT" | jq -r '.video_id')
# 4. 下载结果
pixverse asset download $VIDEO_ID --json
要跳过等待稍后轮询:
RESULT=$(pixverse create video --prompt "A cat astronaut floating in space" --no-wait --json)
VIDEO_ID=$(echo "$RESULT" | jq -r '.video_id')
pixverse task wait $VIDEO_ID --json
pixverse asset download $VIDEO_ID --json
PixVerse CLI 使用 OAuth 设备流程 —— 无需手动复制令牌:
pixverse auth login --json~/.pixverse/ 中详细信息:
pixverse auth login --jsonPIXVERSE_TOKEN 环境变量以覆盖存储的令牌pixverse auth status --json 以检查登录状态和积分| 我想... | 使用技能 |
|---|---|
| 从文本或图像创建视频 | pixverse:create-video |
| 创建或编辑图像 | pixverse:create-and-edit-image |
| 延长、放大视频或为视频添加音频 | pixverse:post-process-video |
| 在帧之间创建过渡动画 | pixverse:transition |
| 检查生成进度 | pixverse:task-management |
| 浏览、下载或删除资源 | pixverse:asset-management |
| 设置身份验证或检查账户 | pixverse:auth-and-account |
| 浏览效果模板并从中创建 | pixverse:template |
查找模型或参数? 不必等到生成时才查 —— 直接阅读相关的功能文件:
- 视频模型和约束 →
skills/capabilities/create-video.md(模型参考部分)- 图像模型和约束 →
skills/capabilities/create-and-edit-image.md(模型参考部分)
在深入了解子技能之前,使用此参考来选择模型。
pixverse create video --model <value>)| 模型 | --model 值 | 最高质量 | 时长 |
|---|---|---|---|
| PixVerse v5.6 (默认) | v5.6 | 1080p | 1–10s |
| Sora 2 | sora-2 | 720p | 4 8 12s |
| Sora 2 Pro | sora-2-pro | 1080p | 4 8 12s |
| Veo 3.1 Standard | veo-3.1-standard | 1080p | 4 6 8s |
| Veo 3.1 Fast | veo-3.1-fast | 1080p | 4 6 8s |
| Grok Imagine | grok-imagine | 720p | 1–15s |
pixverse create image --model <value>)| 模型 | --model 值 | 最高质量 |
|---|---|---|
| Qwen Image (默认) | qwen-image | 1080p |
| Seedream 5.0 Lite | seedream-5.0-lite | 1800p |
| Seedream 4.5 | seedream-4.5 | 2160p |
| Seedream 4.0 | seedream-4.0 | 2160p |
| Gemini 2.5 Flash (Nanobanana) | gemini-2.5-flash | 1080p |
| Gemini 3.0 (Nano Banana Pro) | gemini-3.0 | 2160p |
| Gemini 3.1 Flash (Nano Banana 2) | gemini-3.1-flash | 2160p |
有关完整的参数约束(宽高比、各模型支持的质量、模式支持),请阅读上面列出的功能文件。
| 我想... | 使用技能 |
|---|---|
| 端到端地从文本生成视频 | pixverse:text-to-video-pipeline |
| 将图像动画化为视频 | pixverse:image-to-video-pipeline |
| 生成图像然后将其动画化 | pixverse:text-to-image-to-video |
| 迭代编辑图像 | pixverse:image-editing-pipeline |
| 完整的视频制作(创建 + 延长 + 音频 + 放大) | pixverse:video-production |
| 并行创建多个项目 | pixverse:batch-creation |
| 命令 | 描述 |
|---|---|
auth login | 通过浏览器登录(OAuth 设备流程) |
auth status | 检查身份验证状态 |
auth logout | 移除存储的令牌 |
create video | 文本到视频或图像到视频 |
create image | 文本到图像或图像到图像 |
create transition | 在关键帧之间创建过渡 |
create speech | 为视频添加唇形同步语音 |
create sound | 为视频添加 AI 音效 |
create extend | 延长视频时长 |
create upscale | 放大视频分辨率 |
create reference | 使用角色参考生成视频 |
create template | 从效果模板创建视频或图像 |
template categories | 列出模板类别 |
template list | 浏览模板(可选的类别过滤器) |
template search | 按关键词搜索模板 |
template info | 获取模板详细信息 |
task status | 检查任务状态 |
task wait | 等待任务完成 |
asset list | 列出生成的资源 |
asset info | 获取资源详细信息 |
asset download | 下载生成的资源 |
asset delete | 删除资源 |
account info | 查看账户信息和积分 |
account usage | 查看积分使用记录 |
subscribe | 在浏览器中打开订阅页面 |
config list | 列出所有配置值 |
config get | 获取配置值 |
config set | 设置配置值 |
config reset | 将配置重置为默认值 |
config path | 显示配置文件路径 |
config defaults | 管理每种模式的创建默认值 |
| 标志 | 描述 |
|---|---|
--json 或 -p | 纯 JSON 输出到 stdout(智能体使用必需) |
-V, --version | 显示 CLI 版本 |
-h, --help | 显示任何命令的帮助 |
每个命令都支持 --json。技能中的所有示例都使用 --json 以获得机器可读的输出。
交互模式:运行任何创建命令时不带参数(且不带 --json)即可进入交互式向导。
--json)jq 或任何 JSON 解析器解析 stdout。| 代码 | 名称 | 含义 | 恢复方法 |
|---|---|---|---|
| 0 | SUCCESS | 完成 | — |
| 1 | GENERAL_ERROR | 意外错误 | 检查 stderr 获取详细信息 |
| 2 | TIMEOUT | 轮询超时 | 增加 --timeout 或使用 --no-wait 然后 pixverse task wait |
| 3 | AUTH_EXPIRED | 令牌无效/过期 | 重新运行 pixverse auth login --json |
| 4 | CREDIT_INSUFFICIENT | 积分不足 | 检查 pixverse account info --json,等待每日重置或升级 |
| 5 | GENERATION_FAILED | 生成失败/被拒绝 | 检查提示词,尝试不同的参数 |
| 6 | VALIDATION_ERROR | 参数无效 | 根据每个技能中的枚举检查标志值 |
RESULT=$(pixverse create video --prompt "A sunset over mountains" --json 2>/tmp/pv_err)
EXIT_CODE=$?
if [ $EXIT_CODE -eq 0 ]; then
VIDEO_ID=$(echo "$RESULT" | jq -r '.video_id')
echo "Success: $VIDEO_ID"
pixverse asset download $VIDEO_ID --json
elif [ $EXIT_CODE -eq 3 ]; then
echo "Token expired, re-authenticating..."
pixverse auth login --json
elif [ $EXIT_CODE -eq 4 ]; then
echo "Not enough credits"
pixverse account info --json | jq '.credits'
elif [ $EXIT_CODE -eq 5 ]; then
echo "Generation failed — check prompt or parameters"
cat /tmp/pv_err
else
echo "Error (code $EXIT_CODE)"
cat /tmp/pv_err
fi
每周安装数
63
代码仓库
GitHub 星标数
6
首次出现
12 天前
安全审计
安装于
gemini-cli60
github-copilot60
amp60
codex60
kimi-cli60
cursor60
PixVerse CLI is the official command-line interface for PixVerse — an AI-powered creative platform for generating videos and images. It is essentially a UI-free version of the PixVerse website : all features, models, and parameters are aligned with the web experience at app.pixverse.ai.
It is designed for:
Key facts:
--json flagnpm install -g pixverse
Or run without installing:
npx pixverse
Verify:
pixverse --version
Requires Node.js >= 20.
# 1. Install
npm install -g pixverse
# 2. Authenticate (OAuth device flow — opens browser)
pixverse auth login --json
# 3. Create a video (waits for completion by default)
RESULT=$(pixverse create video --prompt "A cat astronaut floating in space" --json)
VIDEO_ID=$(echo "$RESULT" | jq -r '.video_id')
# 4. Download the result
pixverse asset download $VIDEO_ID --json
To skip waiting and poll later:
RESULT=$(pixverse create video --prompt "A cat astronaut floating in space" --no-wait --json)
VIDEO_ID=$(echo "$RESULT" | jq -r '.video_id')
pixverse task wait $VIDEO_ID --json
pixverse asset download $VIDEO_ID --json
PixVerse CLI uses OAuth device flow — no need to manually copy tokens:
pixverse auth login --json~/.pixverse/Details:
pixverse auth login --jsonPIXVERSE_TOKEN environment variable to override the stored tokenpixverse auth status --json to check login state and credits| I want to... | Use skill |
|---|---|
| Create a video from text or image | pixverse:create-video |
| Create or edit an image | pixverse:create-and-edit-image |
| Extend, upscale, or add audio to a video | pixverse:post-process-video |
| Create transition animation between frames | pixverse:transition |
| Check generation progress | pixverse:task-management |
| Browse, download, or delete assets | pixverse:asset-management |
Looking up models or parameters? Don't wait until you're generating — read the relevant capabilities file directly:
- Video models & constraints →
skills/capabilities/create-video.md(Model Reference section)- Image models & constraints →
skills/capabilities/create-and-edit-image.md(Model Reference section)
Use this to pick a model before diving into a sub-skill.
pixverse create video --model <value>)| Model | --model value | Max Quality | Duration |
|---|---|---|---|
| PixVerse v5.6 (default) | v5.6 | 1080p | 1–10s |
| Sora 2 | sora-2 | 720p | 4 s |
pixverse create image --model <value>)| Model | --model value | Max Quality |
|---|---|---|
| Qwen Image (default) | qwen-image | 1080p |
| Seedream 5.0 Lite | seedream-5.0-lite | 1800p |
| Seedream 4.5 | seedream-4.5 | 2160p |
For full parameter constraints (aspect ratios, quality per model, mode support), read the capabilities files listed above.
| I want to... | Use skill |
|---|---|
| Generate video from text end-to-end | pixverse:text-to-video-pipeline |
| Animate an image into video | pixverse:image-to-video-pipeline |
| Generate image then animate it | pixverse:text-to-image-to-video |
| Iteratively edit an image | pixverse:image-editing-pipeline |
| Full video production (create + extend + audio + upscale) | pixverse:video-production |
| Create multiple items in parallel |
| Command | Description |
|---|---|
auth login | Login via browser (OAuth device flow) |
auth status | Check authentication status |
auth logout | Remove stored token |
create video | Text-to-video or image-to-video |
create image | Text-to-image or image-to-image |
create transition | Create transitions between keyframes |
| Flag | Description |
|---|---|
--json or -p | Pure JSON output to stdout (required for agent use) |
-V, --version | Show CLI version |
-h, --help | Show help for any command |
Every command supports --json. All examples in skills use --json for machine-readable output.
Interactive mode : Run any creation command without arguments (and without --json) to enter the interactive wizard.
--json)jq or any JSON parser.| Code | Name | Meaning | Recovery |
|---|---|---|---|
| 0 | SUCCESS | Completed | — |
| 1 | GENERAL_ERROR | Unexpected error | Check stderr for details |
| 2 | TIMEOUT | Polling timed out | Increase --timeout or use --no-wait then pixverse task wait |
| 3 | AUTH_EXPIRED | Token invalid/expired | Re-run pixverse auth login --json |
RESULT=$(pixverse create video --prompt "A sunset over mountains" --json 2>/tmp/pv_err)
EXIT_CODE=$?
if [ $EXIT_CODE -eq 0 ]; then
VIDEO_ID=$(echo "$RESULT" | jq -r '.video_id')
echo "Success: $VIDEO_ID"
pixverse asset download $VIDEO_ID --json
elif [ $EXIT_CODE -eq 3 ]; then
echo "Token expired, re-authenticating..."
pixverse auth login --json
elif [ $EXIT_CODE -eq 4 ]; then
echo "Not enough credits"
pixverse account info --json | jq '.credits'
elif [ $EXIT_CODE -eq 5 ]; then
echo "Generation failed — check prompt or parameters"
cat /tmp/pv_err
else
echo "Error (code $EXIT_CODE)"
cat /tmp/pv_err
fi
Weekly Installs
63
Repository
GitHub Stars
6
First Seen
12 days ago
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
gemini-cli60
github-copilot60
amp60
codex60
kimi-cli60
cursor60
超能力技能使用指南:AI助手技能调用优先级与工作流程详解
53,700 周安装
| Set up auth or check account | pixverse:auth-and-account |
| Browse and create from effect templates | pixverse:template |
812| Sora 2 Pro | sora-2-pro | 1080p | 4 8 12s |
| Veo 3.1 Standard | veo-3.1-standard | 1080p | 4 6 8s |
| Veo 3.1 Fast | veo-3.1-fast | 1080p | 4 6 8s |
| Grok Imagine | grok-imagine | 720p | 1–15s |
| Seedream 4.0 | seedream-4.0 | 2160p |
| Gemini 2.5 Flash (Nanobanana) | gemini-2.5-flash | 1080p |
| Gemini 3.0 (Nano Banana Pro) | gemini-3.0 | 2160p |
| Gemini 3.1 Flash (Nano Banana 2) | gemini-3.1-flash | 2160p |
pixverse:batch-creationcreate speech | Add lip-sync speech to video |
create sound | Add AI sound effects to video |
create extend | Extend video duration |
create upscale | Upscale video resolution |
create reference | Generate video with character references |
create template | Create video or image from an effect template |
template categories | List template categories |
template list | Browse templates (with optional category filter) |
template search | Search templates by keyword |
template info | Get template details |
task status | Check task status |
task wait | Wait for task completion |
asset list | List generated assets |
asset info | Get asset details |
asset download | Download a generated asset |
asset delete | Delete an asset |
account info | View account info and credits |
account usage | View credit usage records |
subscribe | Open subscription page in browser |
config list | List all config values |
config get | Get a config value |
config set | Set a config value |
config reset | Reset config to defaults |
config path | Show config file path |
config defaults | Manage per-mode creation defaults |
| 4 | CREDIT_INSUFFICIENT | Not enough credits | Check pixverse account info --json, wait for daily reset or upgrade |
| 5 | GENERATION_FAILED | Generation failed/rejected | Check prompt, try different parameters |
| 6 | VALIDATION_ERROR | Invalid parameters | Check flag values against enums in each skill |