pixverse-ai-image-and-video-generator

PixVerse CLI

使用用户的 PixVerse 账户和额度生成媒体。CLI 访问需要订阅。使用 --json 获取机器可读结果。

只阅读任务所需的内容

这是入口文件；链接的 Markdown 文件是辅助说明，并非单独安装的命令。无论当前工作目录是什么，都以此文件为基准解析链接。选择以下一项功能或工作流；仅在需要执行某项操作时才继续查看其他链接。不要加载整个目录、所有相关文件或所有设计参考。

对于单项操作，请阅读对应功能。对于多步骤交付，请从工作流开始。执行创建链之前，请先阅读一次执行约定，了解输出格式、等待和恢复方式。获取提示词建议或改写提示词时，请使用提示词约定选择一种策略。

设置和参数发现

1. 检查 pixverse --version。如果未安装，请使用 npm install -g pixverse 安装（Node.js >= 22.12）；对于无关任务，无需更改已有的旧版本安装。
2. 在 CLI 1.4.0+ 中，仅查询所需模式/模型：pixverse capabilities create video --model v6 --json。如果模式/模型 ID 未知，请使用 pixverse capabilities create --json 进行发现。这些查询离线执行，无需登录。对于范围较窄的任务，请避免使用完整的 pixverse capabilities --json 数据包。
3. 在旧版本中，请使用 pixverse create <mode> --help 和相关功能的静态参考。本文档说明的是 CLI 1.4.13；静态表格不能证明较旧的安装支持某个模型或标志。如果无法确认支持情况，请说明需要升级，不要提交臆造的组合。
4. 在账户操作或生成之前，如果登录状态未知，请检查 pixverse auth status --json。对于 PIXVERSE_AUTH_PROFILE=chatgpt，请改用 MCP 配对，而非普通登录；整个工作流期间都要保留此配置。对于普通登录，请运行 pixverse auth login --json 并显示返回的授权 URL；JSON 模式不会自动打开浏览器。有关访问密钥、配置和恢复方式，请参阅身份验证与账户。

Canvas 功能和 MiniApp 架构实时更新：构造请求之前，请查询相关节点/应用。请参阅功能发现。不要根据 Create 模型名称推断 Canvas 节点映射。

选择操作

任务	阅读
文本/图像转视频；参考生成或源视频编辑	创建视频
创建或编辑图像	创建和编辑图像
在关键帧处修改视频	修改视频
将视频中的动作迁移到角色	动作控制
延长或放大视频	后期处理视频
在关键帧之间生成动画	转场
语音/旁白	创建语音
音乐/配乐	创建音乐
浏览并运行特效	模板
发现并运行预设应用	MiniApps
构建、操作或自动排列 Canvas 图表	Canvas
查询/等待现有任务	任务管理
上传、检查、下载或删除素材	素材管理
整理已保存的文件夹	已保存文件夹
登录、额度、用量或创建默认设置	身份验证与账户
列出或选择工作区	工作区

选择创作策略

用户明确提出的约束优先于默认创作建议。要求优化并生成，表示授权进行改写；普通的生成请求并不授权你悄悄修改给定的提示词。不要连续运行多个优化器。

任务	阅读
通用提示词建议，或没有专用优化器的模型	prompting-guide
V6 提示词改写	prompt-enhance
Seedance 提示词结构、参考素材、编辑或镜头控制	seedance-prompt-optimize
Seedance 情绪／氛围概念开发	seedance-vibe-creating
持续使用的角色	character-design
持续使用的道具／物品	item-design
Mondo 风格海报、封面或专辑美术	mondo-poster-design

多步骤交付内容

任务	阅读
文本转成片	text-to-video-pipeline
为现有图像制作动画	image-to-video-pipeline
先生成图像，再制作动画	text-to-image-to-video
迭代式图像编辑	image-editing-pipeline
修改视频，再增强视频	modify-video-pipeline
动作迁移与后期处理	motion-control-pipeline
可选择延长、放大并配上原声带的视频	video-production
并行或多输出生成	batch-creation
Mondo 海报制作	mondo-poster-pipeline
为 Mondo 海报制作动画	mondo-poster-to-video-pipeline
四镜头分镜与最终剪辑	storyboard-to-video

执行要点

• Create 通常会等待任务完成。保存其结果；不要为了提取 ID 或再次等待已完成的结果而重新创建。要在后台执行，请使用 --no-wait，保留所有 ID，然后等待／查询现有任务。
• 保留请求中指定的模型、区域、工作区和创作约束。选择替代项前，先查询支持的参数。文本输入（--prompt、--text、--lyrics）接受字面文本、文件路径，或表示从 stdin 读取的 -。
• PIXVERSE_REGION 的优先级高于 --region；默认值为 global。登录状态、活动工作区和创建默认值均按区域隔离。CN 不支持独立的语音／音乐或音频资产／任务操作；模型可用性也因区域而异。提交前请查看所选能力说明。
• --workspace-id <id> 可覆盖单次调用使用的工作区；0 表示个人工作区。如果 CLI 将无法访问的活动工作区重置为个人工作区，请在重试团队任务前重新设置预期的目标位置。
• 部分失败时保留成功的输出。非零退出状态也可能伴随可用的批处理结果。超时不能证明提交失败。请遵循执行契约，不要盲目重试 Create。

Windows shell 语法请参阅 PowerShell 管道。要更新此技能检出版本，请仅在干净的 main 检出版本中运行 update.sh；该脚本支持快进更新，不会暂存更改或切换分支。