Pixverse AI Image And Video Generator

PixVerse CLI

Generate media using the user's PixVerse account and credits. CLI access requires a subscription. Use --json for machine-readable results.

Read only what the task needs

This is the entrypoint; the linked Markdown files are supporting instructions, not separately installed commands. Resolve links relative to this file, regardless of the working directory. Select one capability or workflow below; follow additional links only for a needed operation. Do not load the entire catalog, every related file, or all design references.

For a single operation, read its capability. For a multi-step deliverable, start with the workflow. Before executing a creation chain, read the execution contract once for output shapes, waiting, and recovery. For prompt advice or rewriting, select one strategy using the prompt contract.

Setup and parameter discovery

1. Check pixverse --version. If missing, install with npm install -g pixverse (Node.js >= 22.12); an existing older installation need not be changed for unrelated tasks.
2. On CLI 1.4.0+, query only the required mode/model: pixverse capabilities create video --model v6 --json. Use pixverse capabilities create --json to discover mode/model IDs if unknown. These queries are offline and need no login. Avoid the full pixverse capabilities --json bundle for a narrow task.
3. On older versions, use pixverse create <mode> --help and the relevant capability's static reference. This skill documents CLI 1.4.0; a static table does not prove an older installation supports a model or flag. If support cannot be established, report the required upgrade instead of submitting an invented combination.
4. Before account operations or generation, check pixverse auth status --json if login state is unknown. For login, run pixverse auth login --json and show the returned authorization URL; JSON mode does not open the browser automatically. See auth and account for access keys, configuration, and recovery.

Canvas capabilities and MiniApp schemas are live: query the relevant node/app before constructing a request. See capability discovery. Do not infer Canvas node mappings from Create model names.

Select an operation

Select a creative strategy

Explicit user constraints take priority over default creative advice. An instruction to optimize and generate authorizes that rewrite; an ordinary generation request does not authorize silently changing a supplied prompt. Do not run several optimizers sequentially.

Multi-step deliverables

Execution essentials

• Create normally waits for completion. Save its result; do not create again to extract an ID or wait again for a completed result. For background work use --no-wait, retain all IDs, then wait/query existing tasks.
• Preserve the requested model, region, workspace, and creative constraints. Query supported parameters before selecting replacements. Text inputs (--prompt, --text, --lyrics) accept literal text, a file path, or - for stdin.
• PIXVERSE_REGION overrides --region; default is global. Login, active workspace, and creation defaults are isolated by region. CN does not support standalone voice/music or audio asset/task operations; model availability also differs. See the selected capability before submission.
• --workspace-id <id> overrides workspace for one invocation; 0 is personal. If the CLI resets an inaccessible active workspace to personal, re-establish the intended destination before retrying team work.
• Preserve successful outputs on partial failure. A nonzero exit can accompany usable batch results. A timeout is not proof of a failed submission. Follow the execution contract, not a blind create retry.

For Windows shell syntax, see the PowerShell pipeline. For updating this skill checkout, run update.sh only from a clean main checkout; it supports fast-forward updates and does not stash or switch branches.