{"schema_version":"1.2.0","format":"pixverse-cli-capabilities-compact","source":"Generated from Commander definitions and the bundled Create capability registry. Do not hand-edit.","cli":{"name":"pixverse","package":"pixverse","version":"1.4.16","binary":"pixverse","node":">=22.12.0","description":"PixVerse CLI - generate videos and images from the command line"},"contract":{"service":"PixVerse public service","regions":["global","cn"],"default_region":"global","region_precedence":["PIXVERSE_REGION","--region","default"],"auth":"OAuth device flow with a local CLI session","json":"Use --json or -p for pure JSON stdout; errors and progress go to stderr.","text_inputs":"prompt, text, lyrics accept literal text, local file path, or - for stdin.","polling":"done=1; retry=5,9,10; failed=7,8; intervals=2s,5s,10s"},"exit_codes":{"0":"SUCCESS: success","1":"GENERAL_ERROR: general API or unexpected error","2":"TIMEOUT: polling timeout","3":"AUTH_EXPIRED: authentication token invalid or expired","4":"CREDIT_INSUFFICIENT: subscription or credit limit","5":"GENERATION_FAILED: generation failed or was not approved","6":"VALIDATION_ERROR: CLI input validation error","7":"CONCURRENCY_LIMIT: concurrent generation limit; wait for a slot and retry"},"global_options":{"-V, --version":"output the version number","--json":"Output results as JSON","-p":"Print mode - pure JSON output (alias for --json)","--workspace-id ":"Override active workspace for this command (0 = personal)","--trace-id ":"Trace ID to attach to all API requests in this invocation (must be UUIDv4)","--region ":"Region: global or cn (default: global; PIXVERSE_REGION overrides) | choices: global, cn"},"commands":[{"cmd":"pixverse","desc":"PixVerse CLI - generate videos and images from the command line","children":["auth","create","capabilities","canvas","task","asset","account","subscribe","config","template","voice","music","miniapps","saved","workspace","update"],"options":{"-V, --version":"output the version number","--json":"Output results as JSON","-p":"Print mode - pure JSON output (alias for --json)","--workspace-id ":"Override active workspace for this command (0 = personal)","--trace-id ":"Trace ID to attach to all API requests in this invocation (must be UUIDv4)","--region ":"Region: global or cn (default: global; PIXVERSE_REGION overrides) | choices: global, cn"}},{"cmd":"pixverse auth","desc":"Manage authentication","children":["login","status","logout","pair"]},{"cmd":"pixverse auth login","desc":"Login via browser authorization (OAuth device flow)","run":true,"effect":"mutates_cli_or_remote_state","options":{"--json":"Output as JSON"}},{"cmd":"pixverse auth status","desc":"Check authentication status and account info","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse auth logout","desc":"Remove stored token","run":true,"effect":"destructive_remote_or_local_change","destructive":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse auth pair","desc":"Connect a local CLI device through an authorized MCP account","children":["start","finish","cancel","status","logout"]},{"cmd":"pixverse auth pair start","desc":"Start or resume local pairing; output an approval ticket, never the redemption proof","run":true,"effect":"mutates_cli_or_remote_state","options":{"--device-name ":"Device label shown during authorization (defaults to this host at execution)","--json":"Output as JSON"}},{"cmd":"pixverse auth pair finish","desc":"Redeem an approved local pairing once; pending requests can be polled again","run":true,"effect":"mutates_cli_or_remote_state","options":{"--expected-account-id ":"Account ID returned by the authenticated MCP connection","--json":"Output as JSON"}},{"cmd":"pixverse auth pair cancel","desc":"Cancel a pending pairing and revoke any device approved by that intent","run":true,"effect":"destructive_remote_or_local_change","destructive":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse auth pair status","desc":"Validate the isolated CLI profile and show its account without exposing credentials","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse auth pair logout","desc":"Revoke this delegated device session and remove its local credential","run":true,"auth":true,"effect":"destructive_remote_or_local_change","destructive":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse create","desc":"Create videos, images, and audio","children":["video","image","transition","voice","music","extend","modify","upscale","reference","motion-control","template"]},{"cmd":"pixverse create video","desc":"Text/image to video (T2V / I2V)","run":true,"auth":true,"effect":"creates_remote_media_asset","options":{"--prompt ":"Prompt text - literal, a local file path, or - for stdin (required)","--image ":"Image input: file path, HTTPS URL, image ID, or media path (local oversized images are auto-resized to fit 1920x1920)","-m, --model ":"Video model","-d, --duration ":"Duration in seconds","-q, --quality ":"Video quality","--aspect-ratio ":"Aspect ratio, or auto for model-determined framing where supported","--seed ":"Random seed","--relax-mode [boolean]":"Set Relax mode: true | false (bare flag enables; requires account entitlement)","--no-relax-mode":"Disable Relax mode | negates: relaxMode","--count ":"Number of generations","--audio":"Enable audio generation","--no-audio":"Disable audio generation | negates: audio","--multi-shot":"Enable multi-shot mode","--no-multi-shot":"Disable multi-shot mode | negates: multiShot","--off-peak":"Use off-peak pricing","--idempotency-key ":"Idempotency key for safe retry - backend dedupes by key so repeated submissions return the original task without re-charging","--no-wait":"Return immediately without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse create image","desc":"Text/image to image (T2I / I2I)","run":true,"auth":true,"effect":"creates_remote_media_asset","options":{"--prompt ":"Prompt text - literal, a local file path, or - for stdin (required)","--image ":"Single image input: file path, HTTPS URL, image ID, or media path (local oversized images are auto-resized to fit 1920x1920)","--images ":"Multiple image inputs: file paths, HTTPS URLs, image IDs, or media paths (local oversized images are auto-resized to fit 1920x1920)","-m, --model ":"Image model","-q, --quality ":"Image quality","--aspect-ratio ":"Aspect ratio","--background ":"Image background (GPT Image 2.5 only): auto | transparent | opaque","--detail-level ":"Image detail level (model-specific): minimal | low | medium | high | xhigh | max","--relax-mode [boolean]":"Set Relax mode: true | false (bare flag enables; requires account entitlement)","--no-relax-mode":"Disable Relax mode | negates: relaxMode","--count ":"Number of generations","--seed ":"Random seed","--idempotency-key ":"Idempotency key for safe retry - backend dedupes by key so repeated submissions return the original task without re-charging","--no-wait":"Return immediately without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse create transition","desc":"Multi-frame keyframe transition video","run":true,"auth":true,"effect":"creates_remote_media_asset","options":{"--images ":"Image inputs: file paths, HTTPS URLs, image IDs, or media paths (2+ required; local oversized images are auto-resized to fit 1920x1920)","--prompt ":"Prompt text","-m, --model ":"Video model","-q, --quality ":"Video quality","-d, --duration ":"Duration in seconds","--relax-mode [boolean]":"Set Relax mode: true | false (bare flag enables; requires account entitlement)","--no-relax-mode":"Disable Relax mode | negates: relaxMode","--count ":"Number of generations","--seed ":"Random seed","--audio":"Enable audio generation","--no-audio":"Disable audio generation | negates: audio","--off-peak":"Use off-peak pricing","--idempotency-key ":"Idempotency key for safe retry - backend dedupes by key so repeated submissions return the original task without re-charging","--no-wait":"Return immediately without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse create voice","desc":"Generate speech audio from text (TTS)","run":true,"auth":true,"effect":"creates_remote_media_asset","options":{"--text ":"Text to synthesize - literal, a local file path, or - for stdin","-m, --model ":"Voice/TTS model | default: speech-2.8-hd","--voice-id ":"PixVerse preset voice ID (recommended)","--provider-voice-id ":"Provider raw voice ID","--language ":"Language code (default: auto) | default: auto","--stability <0..1>":"ElevenLabs stability","--similarity-boost <0..1>":"ElevenLabs similarity boost","--style <0..1>":"ElevenLabs style (eleven-multilingual-v2 only)","--use-speaker-boost":"ElevenLabs speaker boost (eleven-multilingual-v2 only)","--no-use-speaker-boost":"Disable ElevenLabs speaker boost | negates: useSpeakerBoost","--speed ":"Speech speed (default 1.0; EL 0.7..1.2, MM 0.5..2.0)","--volume <0..10>":"MiniMax volume","--pitch <-12..12>":"MiniMax pitch","--emotion ":"MiniMax emotion preset","--client-request-id ":"Caller-side request id (logged only)","--output ":"Download the finished audio to this file/dir (never overwrite)","--no-wait":"Return immediately without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse create music","desc":"Generate music audio from a prompt","run":true,"auth":true,"effect":"creates_remote_media_asset","options":{"--prompt ":"Music prompt - literal, a local file path, or - for stdin (required)","--lyrics ":"Lyrics for models that support lyrics - literal, a local file path, or - for stdin","-m, --model ":"Music model | default: music-2.6","--instrumental":"Generate instrumental music","--auto-lyrics":"Let the model generate lyrics","--no-duration-auto":"Disable automatic duration selection | negates: durationAuto","--duration-seconds ":"Target duration in seconds (sets duration_auto=false)","--image ":"Reference image(s) for Google Lyria: file path, HTTPS URL, image ID, or media path","--client-request-id ":"Caller-side request id (logged only)","--output ":"Download the finished music to this file/dir (never overwrite)","--no-wait":"Return immediately without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse create extend","desc":"Extend an existing video","run":true,"auth":true,"effect":"creates_remote_media_asset","options":{"--video ":"Video input: file path, HTTPS URL, video ID, or media path","--prompt ":"Prompt for extension","-m, --model ":"Video model","-q, --quality ":"Video quality","-d, --duration ":"Duration in seconds","--count ":"Number of generations","--seed ":"Random seed","--audio":"Enable audio generation","--no-audio":"Disable audio generation | negates: audio","--off-peak":"Use off-peak pricing","--idempotency-key ":"Idempotency key for safe retry - backend dedupes by key so repeated submissions return the original task without re-charging","--no-wait":"Return immediately without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse create modify","desc":"Modify an existing video","run":true,"auth":true,"effect":"creates_remote_media_asset","options":{"--video ":"Video input: file path, HTTPS URL, video ID, or media path","--prompt ":"Prompt describing the modification. Reference uploaded images with @image1, @image2, ... (1-indexed, matches --images order)","--images ":"Reference image inputs (max 5): file paths, HTTPS URLs, image IDs, or media paths. Reference them in --prompt as @image1, @image2, ...","--keyframe-time ":"Keyframe time in milliseconds (0 = first frame) | default: 0","-m, --model ":"Video model","-q, --quality ":"Video quality","--relax-mode [boolean]":"Set Relax mode: true | false (bare flag enables; requires account entitlement)","--no-relax-mode":"Disable Relax mode | negates: relaxMode","--count ":"Number of generations","--seed ":"Random seed","--off-peak":"Use off-peak pricing","--idempotency-key ":"Idempotency key for safe retry - backend dedupes by key so repeated submissions return the original task without re-charging","--no-wait":"Return immediately without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse create upscale","desc":"Upscale video resolution to 2160p","run":true,"auth":true,"effect":"creates_remote_media_asset","options":{"--video ":"Video input: file path, HTTPS URL, video ID, or media path","-q, --quality ":"Target quality | default: 2160p | choices: 2160p","--idempotency-key ":"Idempotency key for safe retry - backend dedupes by key so repeated submissions return the original task without re-charging","--no-wait":"Return immediately without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse create reference","desc":"Create or edit a video with reference media","run":true,"auth":true,"effect":"creates_remote_media_asset","options":{"--images ":"Image references: file paths, HTTPS URLs, image IDs, or media paths (model-specific limits; local oversized images are auto-resized to fit 1920x1920)","--videos ":"Video references: file paths, HTTPS URLs, video IDs, or media paths (supported by V6, Seedance, MiniMax H3/H3 Max, Wan 3.0, Gemini Omni, Kling O3, and Grok Imagine; model-specific limits apply)","--audios ":"Audio references (Seedance, MiniMax H3/H3 Max, and Wan 3.0): file paths, HTTPS URLs, audio IDs, or media paths (model-specific count and known-duration limits apply; Wan 3.0 permits audio-only input)","--prompt ":"Prompt text","-m, --model ":"Video model","--task-type ":"Seedance 2.5 reference task type: auto, reference, edit, or extend","-q, --quality ":"Video quality","--aspect-ratio ":"Aspect ratio, or auto for model-determined framing where supported","-d, --duration ":"Duration in seconds, or auto (locked for V6/Grok video references; default for Seedance 2.5/Wan 3.0 video references)","--relax-mode [boolean]":"Set Relax mode: true | false (bare flag enables; requires account entitlement)","--no-relax-mode":"Disable Relax mode | negates: relaxMode","--count ":"Number of generations","--seed ":"Random seed","--audio":"Enable audio generation","--no-audio":"Disable audio generation | negates: audio","--off-peak":"Use off-peak pricing","--idempotency-key ":"Idempotency key for safe retry - backend dedupes by key so repeated submissions return the original task without re-charging","--no-wait":"Return immediately without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse create motion-control","desc":"Generate video with character image + motion reference video","run":true,"auth":true,"effect":"creates_remote_media_asset","options":{"--image ":"Character image: file path, HTTPS URL, image ID, or media path (required; local oversized images are auto-resized to fit 1920x1920)","--video ":"Motion reference video: file path, HTTPS URL, video ID, or media path (required)","-m, --model ":"Video model","-q, --quality ":"Video quality","--relax-mode [boolean]":"Set Relax mode: true | false (bare flag enables; requires account entitlement)","--no-relax-mode":"Disable Relax mode | negates: relaxMode","--count ":"Number of generations","--off-peak":"Use off-peak pricing","--idempotency-key ":"Idempotency key for safe retry - backend dedupes by key so repeated submissions return the original task without re-charging","--no-wait":"Return immediately without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse create template","desc":"Create from a template/effect","run":true,"auth":true,"effect":"creates_remote_media_asset","options":{"--template-id ":"Template ID (required)","--image ":"Image input(s): file paths, HTTPS URLs, image IDs, or media paths (local oversized images are auto-resized to fit 1920x1920)","--video ":"Video input: file path, HTTPS URL, video ID, or media path","--prompt ":"Prompt text (optional for some templates)","-q, --quality ":"Video/image quality","-d, --duration ":"Duration in seconds","--aspect-ratio ":"Aspect ratio","--seed ":"Random seed","--count ":"Number of generations","--off-peak":"Use off-peak pricing","--idempotency-key ":"Idempotency key for safe retry - backend dedupes by key so repeated submissions return the original task without re-charging","--no-wait":"Return immediately without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse capabilities","desc":"Show installed PixVerse CLI capabilities","run":true,"children":["create","canvas"],"options":{"--json":"Output as JSON"}},{"cmd":"pixverse capabilities create","desc":"Show bundled capabilities for create commands","run":true,"args":{"mode?":"Create mode"},"options":{"-m, --model ":"Resolve capabilities for one model","--json":"Output as JSON"}},{"cmd":"pixverse capabilities canvas","desc":"Show merged Canvas and installed CLI capabilities","run":true,"auth":true,"options":{"--node-type ":"Filter by Canvas node type","--selector ":"Filter by Canvas adapter route selector","-m, --model ":"Resolve mapped CLI capabilities for one model","--raw":"Show the unmodified Canvas capabilities response","--refresh":"Refresh Canvas capabilities from the server","--json":"Output as JSON"}},{"cmd":"pixverse canvas","desc":"Manage Canvas projects, nodes, versions, and generation workflows","children":["project","arrange","graph","node","patch","dispatch"]},{"cmd":"pixverse canvas project","desc":"Create and manage Canvas projects","children":["create"]},{"cmd":"pixverse canvas project create","desc":"Create an empty Canvas project","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","options":{"--name ":"Project name","--description ":"Project description","--json":"Output as JSON"}},{"cmd":"pixverse canvas arrange","desc":"Automatically arrange and save all nodes in a Canvas project","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID (positive decimal integer string)","--json":"Output as JSON"}},{"cmd":"pixverse canvas graph","desc":"Inspect Canvas project structure, status, and recovery","children":["get","status","invalid-nodes","reconcile"]},{"cmd":"pixverse canvas graph get","desc":"Get a Canvas project's nodes, connections, and edit version","run":true,"auth":true,"args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--json":"Output as JSON"}},{"cmd":"pixverse canvas graph status","desc":"Get the generation status of Canvas nodes","run":true,"auth":true,"args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--node-ids ":"Node IDs to include (comma-separated)","--json":"Output as JSON"}},{"cmd":"pixverse canvas graph invalid-nodes","desc":"Show Canvas validation issues and invalid node details","run":true,"auth":true,"args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--json":"Output as JSON"}},{"cmd":"pixverse canvas graph reconcile","desc":"Recover generation for specific Canvas nodes","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--node-ids ":"Node IDs to process (required, comma-separated)","--edit-version ":"Current Canvas edit version (required)","--session-id ":"Optional agent session ID (positive decimal)","--run-id ":"Optional agent run ID (positive decimal)","--dispatch-plan-id ":"Confirmed dispatch plan ID","--require-dispatch":"Fail if no new generation is started","--json":"Output as JSON"}},{"cmd":"pixverse canvas node","desc":"Inspect and manage Canvas nodes","children":["get","schema","versions","version","rerun","extract-audio"]},{"cmd":"pixverse canvas node get","desc":"Get details for a Canvas node","run":true,"auth":true,"args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--node-id ":"Canvas node ID","--json":"Output as JSON"}},{"cmd":"pixverse canvas node schema","desc":"Show the current schema for a Canvas node type","run":true,"auth":true,"options":{"--node-type ":"Canvas node type (for example video_compose)","--json":"Output as JSON"}},{"cmd":"pixverse canvas node versions","desc":"List saved versions for a Canvas node","run":true,"auth":true,"args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--node-id ":"Canvas node ID","--page ":"Page number (default: 1)","--page-size ":"Items per page, 1..100 (default: 20)","--json":"Output as JSON"}},{"cmd":"pixverse canvas node version","desc":"Get or apply a saved version for a Canvas node","run":true,"auth":true,"children":["apply"],"args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--node-id ":"Canvas node ID","--history-id ":"Saved version ID (from `canvas node versions`)","--json":"Output as JSON"}},{"cmd":"pixverse canvas node version apply","desc":"Set a saved version as the current Canvas node version","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--node-id ":"Canvas node ID","--history-id ":"Saved version ID","--session-id ":"Optional agent session ID (positive decimal)","--run-id ":"Optional agent run ID (positive decimal)","--json":"Output as JSON"}},{"cmd":"pixverse canvas node rerun","desc":"Run generation again for a specific Canvas node","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--node-id ":"Canvas node ID","--edit-version ":"Current Canvas edit version (required)","--session-id ":"Optional agent session ID (positive decimal)","--run-id ":"Optional agent run ID (positive decimal)","--json":"Output as JSON"}},{"cmd":"pixverse canvas node extract-audio","desc":"Extract the full audio track from a Canvas video node","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--node-id ":"Target audio node ID (created if missing)","--source-node-id ":"Source video node ID","--json":"Output as JSON"}},{"cmd":"pixverse canvas patch","desc":"Validate and apply changes to a Canvas project","children":["dry-run","apply"]},{"cmd":"pixverse canvas patch dry-run","desc":"Validate Canvas changes without saving them","run":true,"auth":true,"args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--patch ":"Canvas graph_patch as JSON - a literal string, a file path, or \"-\" for stdin","--session-id ":"Optional agent session ID (positive decimal)","--run-id ":"Optional agent run ID (positive decimal)","--idempotency-key ":"Custom stable retry key (automatically derived if omitted)","--json":"Output as JSON"}},{"cmd":"pixverse canvas patch apply","desc":"Apply validated changes to a Canvas project","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--patch ":"Canvas graph_patch as JSON - a literal string, a file path, or \"-\" for stdin","--session-id ":"Optional agent session ID (positive decimal)","--run-id ":"Optional agent run ID (positive decimal)","--idempotency-key ":"Custom stable retry key (automatically derived if omitted)","--json":"Output as JSON"}},{"cmd":"pixverse canvas dispatch","desc":"Start generation for specific ready Canvas nodes","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","children":["rebind"],"args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--node-ids ":"Node IDs to process (required, comma-separated)","--edit-version ":"Current Canvas edit version (required)","--session-id ":"Optional agent session ID (positive decimal)","--run-id ":"Optional agent run ID (positive decimal)","--dispatch-plan-id ":"Confirmed dispatch plan ID","--require-dispatch":"Fail if no new generation is started","--json":"Output as JSON"}},{"cmd":"pixverse canvas dispatch rebind","desc":"Bind specific ready Canvas nodes to a dispatch plan","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","args":{"id?":"Canvas project ID (or use --project-id)"},"options":{"--project-id ":"Canvas project ID","--dispatch-plan-id ":"Dispatch plan ID","--node-ids ":"Ready node IDs (required, comma-separated)","--session-id ":"Optional agent session ID (positive decimal)","--run-id ":"Optional agent run ID (positive decimal)","--json":"Output as JSON"}},{"cmd":"pixverse task","desc":"Manage generation tasks","children":["status","wait"]},{"cmd":"pixverse task status","desc":"Check the status of one or more generation tasks","run":true,"auth":true,"args":{"ids...":"One or more space-separated video, image, or audio IDs (omit when using --ids)"},"options":{"--ids ":"Comma-separated list of IDs for batch query (e.g. 123,456,789)","--type ":"Asset type: video, image, audio, or miniapps | default: video","--json":"Output as JSON"}},{"cmd":"pixverse task wait","desc":"Wait for a generation task to complete","run":true,"auth":true,"args":{"id":"Video, image, audio, or MiniApp project ID"},"options":{"--type ":"Asset type: video, image, audio, or miniapps | default: video","--timeout ":"Timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse asset","desc":"Manage your generated assets","children":["list","info","download","upload","delete"]},{"cmd":"pixverse asset list","desc":"List your generated assets","run":true,"auth":true,"options":{"--type ":"Asset type: video, image, audio, or miniapps | default: video | choices: video, image, audio, miniapps","--source ":"Asset source: create or upload | default: create | choices: create, upload","--off-peak":"Filter off-peak generations only (video + create only)","--limit ":"Number of items per page | default: 20","--page ":"Page number | default: 1","--json":"Output as JSON"}},{"cmd":"pixverse asset info","desc":"Get details of a specific asset","run":true,"auth":true,"args":{"id":"Video, image, or audio ID"},"options":{"--type ":"Asset type: video, image, audio, or miniapps (auto-detected if omitted; miniapps must be explicit)","--source ":"Audio source: create or upload | default: create | choices: create, upload","--json":"Output as JSON"}},{"cmd":"pixverse asset download","desc":"Download a created video, image, or audio to local disk","run":true,"auth":true,"args":{"id":"Created video, image, or audio ID (uploads not downloadable)"},"options":{"--type ":"Asset type: video, image, audio, or miniapps (auto-detected if omitted; miniapps must be explicit)","--dest ":"Destination directory (audio also accepts a file path; never overwrite)","--json":"Output as JSON"}},{"cmd":"pixverse asset upload","desc":"Upload a local file or HTTPS URL to asset library","run":true,"auth":true,"effect":"uploads_local_or_remote_file","args":{"input":"Local file path or HTTPS URL (jpg/png/webp/mp4/mov/mp3/wav/m4a/aac/ogg)"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse asset delete","desc":"Delete a video, image, or audio asset","run":true,"auth":true,"effect":"destructive_remote_or_local_change","destructive":true,"args":{"id":"Video, image, or audio ID"},"options":{"--type ":"Asset type: video, image, audio, or miniapps (auto-detected if omitted; miniapps must be explicit) | choices: video, image, audio, miniapps","--source ":"Asset source: create or upload | default: create | choices: create, upload","--json":"Output as JSON"}},{"cmd":"pixverse account","desc":"View account info and credit usage","children":["info","usage","slots"]},{"cmd":"pixverse account info","desc":"Show account info, workspace, and credit balance","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse account usage","desc":"Show credit consumption records","run":true,"auth":true,"options":{"--type ":"Filter: all, earned, used (personal only) | default: all","--limit ":"Number of records to show | default: 20","--page ":"Page number | default: 1","--json":"Output as JSON"}},{"cmd":"pixverse account slots","desc":"Show current concurrent generation slots (image / video)","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse subscribe","desc":"Open the PixVerse subscription page in your browser","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse config","desc":"Manage CLI configuration","children":["list","get","set","reset","path","defaults"]},{"cmd":"pixverse config list","desc":"List configuration values","run":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse config get","desc":"Get a configuration value","run":true,"args":{"key":"required"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse config set","desc":"Set a configuration value","run":true,"effect":"mutates_cli_or_remote_state","args":{"key":"required","value":"required"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse config reset","desc":"Reset all configuration to defaults","run":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse config path","desc":"Show configuration file path","run":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse config defaults","desc":"Manage per-mode creation default parameters","run":true,"children":["show","set","reset"]},{"cmd":"pixverse config defaults show","desc":"Show creation defaults (all modes or a specific mode)","run":true,"args":{"mode?":"optional"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse config defaults set","desc":"Set a creation default value","run":true,"effect":"mutates_cli_or_remote_state","args":{"mode":"required","key":"required","value":"required"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse config defaults reset","desc":"Reset creation defaults to built-in values","run":true,"effect":"destructive_remote_or_local_change","destructive":true,"args":{"mode?":"optional"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse template","desc":"Browse and manage templates","children":["categories","list","search","info"]},{"cmd":"pixverse template categories","desc":"List template categories","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse template list","desc":"List templates","run":true,"auth":true,"options":{"--category ":"Filter by category ID","--limit ":"Number of items per page | default: 20","--page ":"Page number | default: 1","--json":"Output as JSON"}},{"cmd":"pixverse template search","desc":"Search templates by keyword","run":true,"auth":true,"args":{"query":"Search keyword"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse template info","desc":"Get template details","run":true,"auth":true,"args":{"id":"Template ID"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse voice","desc":"Browse voice/TTS models and preset voices","children":["models","presets"]},{"cmd":"pixverse voice models","desc":"List available voice providers, models, and languages","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse voice presets","desc":"List preset voices","run":true,"auth":true,"options":{"--model ":"Filter by model id","--language ":"Filter by language code","--provider ":"Filter by provider (minimax|elevenlabs)","--page ":"Page number | default: 1","--page-size ":"Items per page (max 10) | default: 10","--json":"Output as JSON"}},{"cmd":"pixverse music","desc":"Browse music generation models","children":["models"]},{"cmd":"pixverse music models","desc":"List available music providers and models","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse miniapps","desc":"Run PixVerse MiniApps (preset generators)","children":["list","info","create"]},{"cmd":"pixverse miniapps list","desc":"List available MiniApps","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse miniapps info","desc":"Show a MiniApp's details","run":true,"auth":true,"args":{"id":"MiniApp id (e.g. magic_extend)"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse miniapps create","desc":"Create a MiniApp project (returns a project_id)","run":true,"auth":true,"options":{"--id ":"MiniApp id, e.g. magic_extend or image_region_editor","--params ":"App args as JSON (required) - a literal string, a file path, or - for stdin","--output ":"Download the finished main asset to this directory (never overwrite)","--no-wait":"Return immediately with the project_id, without polling | negates: wait","--timeout ":"Polling timeout in seconds | default: 300","--json":"Output as JSON"}},{"cmd":"pixverse saved","desc":"Manage saved folders and their contents","children":["list","items","new","rename","add","remove","delete"]},{"cmd":"pixverse saved list","desc":"List your saved folders","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse saved items","desc":"List items in a saved folder","run":true,"auth":true,"args":{"folder_id?":"Folder ID (default: default folder) | default: default"},"options":{"--type ":"Asset type: all, video, or image | default: all | choices: all, video, image","--source ":"Asset source: create or upload | default: create | choices: create, upload","--limit ":"Number of items per page | default: 20","--page ":"Page number | default: 1","--json":"Output as JSON"}},{"cmd":"pixverse saved new","desc":"Create a new saved folder","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","args":{"name":"Folder name"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse saved rename","desc":"Rename a saved folder","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","args":{"folder_id":"Folder ID","name":"New folder name"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse saved add","desc":"Add assets to a saved folder","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","args":{"ids...":"Asset IDs to add"},"options":{"--folder ":"Folder ID (default: default folder) | default: default","--type ":"Asset type: video or image | choices: video, image","--source ":"Asset source: create or upload | default: create | choices: create, upload","--json":"Output as JSON"}},{"cmd":"pixverse saved remove","desc":"Remove assets from a saved folder","run":true,"auth":true,"effect":"destructive_remote_or_local_change","destructive":true,"args":{"ids...":"Asset IDs to remove"},"options":{"--folder ":"Folder ID (default: default folder) | default: default","--type ":"Asset type: video or image | choices: video, image","--source ":"Asset source: create or upload | default: create | choices: create, upload","--json":"Output as JSON"}},{"cmd":"pixverse saved delete","desc":"Delete a saved folder","run":true,"auth":true,"effect":"destructive_remote_or_local_change","destructive":true,"args":{"folder_id":"Folder ID"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse workspace","desc":"Manage workspaces (list, switch, status)","children":["list","status","switch","manage"]},{"cmd":"pixverse workspace list","desc":"List all workspaces","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse workspace status","desc":"Show the currently active workspace","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse workspace switch","desc":"Switch to a different workspace (interactive if ID omitted)","run":true,"auth":true,"effect":"mutates_cli_or_remote_state","args":{"workspace-id?":"optional"},"options":{"--json":"Output as JSON"}},{"cmd":"pixverse workspace manage","desc":"Open workspace management page in your browser","run":true,"auth":true,"options":{"--json":"Output as JSON"}},{"cmd":"pixverse update","desc":"Update the CLI to the latest version (npm i -g pixverse@latest)","run":true,"effect":"updates_local_cli_installation","options":{"--json":"Output as JSON"}}],"capability_domains":{"create":{"schema_version":"pixverse_create_capabilities.v1","source":"bundled","encoding":"normalized","model_catalog":{"v6":"PixVerse V6","pixverse-c1":"PixVerse C1","seedance-2.5":"Seedance 2.5","seedance-2.0-standard":"Seedance 2.0 Standard","seedance-2.0-fast":"Seedance 2.0 Fast","seedance-2.0-mini":"Seedance 2.0 Mini","minimax-h3":"MiniMax H3","minimax-h3-max":"MiniMax H3 Max","flux-3.0":"FLUX 3","wan-3.0":"Wan 3.0","gemini-omni-flash":"Google Gemini Omni","happyhorse-1.0":"Happy Horse 1.0","kling-4.0":"Kling 4.0","kling-o3-pro":"Kling O3 Pro","kling-o3-standard":"Kling O3 Standard","kling-o3-4k":"Kling O3 4K","kling-3.0-pro":"Kling 3.0 Pro","kling-3.0-standard":"Kling 3.0 Standard","kling-3.0-4k":"Kling 3.0 4K","grok-imagine-1.5":"Grok Imagine 1.5","grok-imagine":"Grok Imagine","veo-3.1-lite":"Veo 3.1 Lite","veo-3.1-standard":"Veo 3.1 Standard","veo-3.1-fast":"Veo 3.1 Fast","sora-2-pro":"Sora 2 Pro","sora-2":"Sora 2","v5.6":"PixVerse V5.6","gpt-image-2.5-flare":"GPT Image 2.5 Flare","gpt-image-2.5-sunburst":"GPT Image 2.5 Sunburst","gpt-image-2.0":"GPT Image 2","gemini-nano-banana-2.1":"Nano Banana 2.1","gemini-3.1-flash":"Nano Banana 2","gemini-3.1-flash-lite":"Nano Banana 2 Lite","qwen-image":"Qwen-image","gemini-3.0":"Nano Banana Pro","gemini-2.5-flash":"Nano Banana","seedream-5.0-pro":"Seedream 5.0 Pro","seedream-5.0-lite":"Seedream 5.0 Lite","seedream-4.5":"Seedream 4.5","seedream-4.0":"Seedream 4.0","kling-image-o3":"Kling Image O3","kling-image-v3":"Kling Image V3","v5":"PixVerse V5","speech-2.8-hd":"MiniMax Speech 2.8 HD","speech-2.8-turbo":"MiniMax Speech 2.8 Turbo","eleven-multilingual-v2":"Eleven Multilingual v2","eleven-v3":"Eleven v3","eleven-turbo-v2.5":"Eleven Turbo v2.5","music-3.0":"MiniMax Music 3.0","music-2.6":"MiniMax Music 2.6","music-v2":"ElevenLabs Music V2","music-v1":"ElevenLabs Music","lyria-3-pro-preview":"Google Lyria 3 Pro","v5.5":"PixVerse V5.5"},"shared_parameters":{"count":{"flag":"--count","type":"integer","required":false,"default":1,"min":1,"max":4,"unit":"count","on_invalid":"reject","description":"Number of generation results."},"seed":{"flag":"--seed","type":"integer","required":false,"on_invalid":"reject","description":"Random seed for reproducible generation."},"idempotency_key":{"flag":"--idempotency-key","type":"string","required":false,"on_invalid":"backend","description":"Caller-provided key for safe request retries."},"wait":{"flag":"--no-wait","type":"boolean","required":false,"default":true,"description":"Wait for the generated asset unless disabled."},"timeout":{"flag":"--timeout","type":"integer","required":false,"default":300,"min":1,"unit":"seconds","on_invalid":"reject","description":"Polling timeout when waiting for completion."},"json":{"flag":"--json","type":"boolean","required":false,"default":false,"description":"Write pure JSON to stdout."},"audio":{"flag":"--audio / --no-audio","type":"boolean","required":false,"default":true,"on_invalid":"adjust","description":"Enable or disable generated audio where supported."},"relax_mode":{"flag":"--relax-mode [boolean] / --no-relax-mode","type":"boolean","required":false,"supported":true,"on_invalid":"backend","description":"Relax mode: bare flag or true enables; false or --no-relax-mode disables. Omitted unless specified; model support and account entitlement are validated by the backend. Image benefits and video discounts depend on account rights."},"client_request_id":{"flag":"--client-request-id","type":"string","required":false,"description":"Caller-side request identifier."},"output":{"flag":"--output","type":"string","required":false,"description":"File or directory for the completed download. Existing files are never overwritten."}},"modes":{"video":{"capability_id":"create.video","command":"pixverse create video","description":"Create a video from text or an image.","default_model":"v6","parameters":{"prompt":{"flag":"--prompt","type":"text","required":true,"accepts":["literal","local_file","stdin"],"on_invalid":"reject","description":"Generation prompt."},"image":{"flag":"--image","type":"media","required":false,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Optional source image for image-to-video."},"model":{"flag":"--model","type":"string","required":false,"default":"v6","on_invalid":"reject","description":"Generation model.","enum_ref":"model_ids"},"quality":{"flag":"--quality","type":"string","required":false,"default":"720p","unit":"output_resolution","on_invalid":"adjust","description":"Output quality where the selected model supports it."},"duration":{"flag":"--duration","type":"integer","required":false,"default":5,"unit":"seconds","on_invalid":"adjust","description":"Output duration."},"off_peak":{"flag":"--off-peak","type":"boolean","required":false,"default":false,"on_invalid":"adjust","description":"Use off-peak generation where supported."},"aspect_ratio":{"flag":"--aspect-ratio","type":"string","required":false,"default":"16:9","unit":"width:height","on_invalid":"adjust","description":"Output framing for text-to-video and supported models."},"multi_shot":{"flag":"--multi-shot / --no-multi-shot","type":"boolean","required":false,"default":true,"on_invalid":"adjust","description":"Enable multi-shot generation where supported."}},"model_ids":["v6","pixverse-c1","seedance-2.5","seedance-2.0-standard","seedance-2.0-fast","seedance-2.0-mini","minimax-h3","minimax-h3-max","flux-3.0","wan-3.0","gemini-omni-flash","happyhorse-1.0","kling-4.0","kling-o3-pro","kling-o3-standard","kling-o3-4k","kling-3.0-pro","kling-3.0-standard","kling-3.0-4k","grok-imagine-1.5","grok-imagine","veo-3.1-lite","veo-3.1-standard","veo-3.1-fast","sora-2-pro","sora-2","v5.6"],"model_parameters":{"duration":{"v6":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"pixverse-c1":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"seedance-2.5":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30],"default":5,"on_invalid":"adjust"},"seedance-2.0-standard":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"seedance-2.0-fast":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"seedance-2.0-mini":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"minimax-h3":{"enum":[5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"minimax-h3-max":{"enum":[5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"flux-3.0":{"enum":[5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20],"default":5,"on_invalid":"adjust"},"wan-3.0":{"enum":[2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30],"default":5,"on_invalid":"adjust"},"gemini-omni-flash":{"enum":[3,4,5,6,7,8,9,10],"default":5,"on_invalid":"adjust"},"happyhorse-1.0":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-4.0":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30],"default":5,"on_invalid":"adjust"},"kling-o3-pro":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-o3-standard":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-o3-4k":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-3.0-pro":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-3.0-standard":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-3.0-4k":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"grok-imagine-1.5":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"grok-imagine":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"veo-3.1-lite":{"enum":[4,6,8],"default":4,"on_invalid":"adjust"},"veo-3.1-standard":{"enum":[4,6,8],"default":4,"on_invalid":"adjust"},"veo-3.1-fast":{"enum":[4,6,8],"default":4,"on_invalid":"adjust"},"sora-2-pro":{"enum":[4,8,12],"default":4,"on_invalid":"adjust"},"sora-2":{"enum":[4,8,12],"default":4,"on_invalid":"adjust"},"v5.6":{"enum":[1,2,3,4,5,6,7,8,9,10],"default":5,"on_invalid":"adjust"}},"quality":{"v6":{"supported":true,"enum":["360p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"pixverse-c1":{"supported":true,"enum":["360p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"seedance-2.5":{"supported":true,"enum":["480p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"seedance-2.0-standard":{"supported":true,"enum":["480p","720p","1080p","2160p"],"default":"720p","on_invalid":"adjust"},"seedance-2.0-fast":{"supported":true,"enum":["480p","720p"],"default":"720p","on_invalid":"adjust"},"seedance-2.0-mini":{"supported":true,"enum":["480p","720p"],"default":"720p","on_invalid":"adjust"},"minimax-h3":{"supported":true,"enum":["768p","1440p"],"default":"1440p","on_invalid":"adjust"},"minimax-h3-max":{"supported":true,"enum":["480p","768p","1080p"],"default":"768p","on_invalid":"adjust"},"flux-3.0":{"supported":true,"enum":["720p","1080p"],"default":"720p","on_invalid":"adjust"},"wan-3.0":{"supported":true,"enum":["480p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"gemini-omni-flash":{"supported":true,"enum":["720p"],"default":"720p","on_invalid":"adjust"},"happyhorse-1.0":{"supported":true,"enum":["720p","1080p"],"default":"720p","on_invalid":"adjust"},"kling-4.0":{"supported":true,"enum":["720p","1080p"],"default":"1080p","on_invalid":"adjust"},"kling-o3-pro":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-o3-standard":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-o3-4k":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-3.0-pro":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-3.0-standard":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-3.0-4k":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"grok-imagine-1.5":{"supported":true,"enum":["480p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"grok-imagine":{"supported":true,"enum":["480p","720p"],"default":"720p","on_invalid":"adjust"},"veo-3.1-lite":{"supported":true,"enum":["720p","1080p"],"default":"720p","on_invalid":"adjust"},"veo-3.1-standard":{"supported":true,"enum":["720p","1080p","2160p"],"default":"720p","on_invalid":"adjust"},"veo-3.1-fast":{"supported":true,"enum":["720p","1080p","2160p"],"default":"720p","on_invalid":"adjust"},"sora-2-pro":{"supported":true,"enum":["720p","1080p"],"default":"720p","on_invalid":"adjust"},"sora-2":{"supported":true,"enum":["720p"],"default":"720p","on_invalid":"adjust"},"v5.6":{"supported":true,"enum":["360p","480p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"}},"aspect_ratio":{"v6":{"supported":true,"enum":["16:9","21:9","4:3","1:1","3:4","9:16","3:2","2:3"],"default":"16:9","on_invalid":"adjust"},"pixverse-c1":{"supported":true,"enum":["16:9","4:3","1:1","3:4","9:16","3:2","2:3"],"default":"16:9","on_invalid":"adjust"},"seedance-2.5":{"supported":true,"enum":["auto","21:9","16:9","4:3","1:1","3:4","9:16"],"default":"16:9","on_invalid":"adjust"},"seedance-2.0-standard":{"supported":true,"enum":["16:9","4:3","1:1","3:4","9:16","21:9"],"default":"16:9","on_invalid":"adjust"},"seedance-2.0-fast":{"supported":true,"enum":["16:9","4:3","1:1","3:4","9:16","21:9"],"default":"16:9","on_invalid":"adjust"},"seedance-2.0-mini":{"supported":true,"enum":["16:9","4:3","1:1","3:4","9:16","21:9"],"default":"16:9","on_invalid":"adjust"},"minimax-h3":{"supported":true,"enum":["21:9","16:9","4:3","1:1","3:4","9:16","auto"],"default":"16:9","on_invalid":"adjust"},"minimax-h3-max":{"supported":true,"enum":["21:9","16:9","4:3","1:1","3:4","9:16","auto"],"default":"16:9","on_invalid":"adjust"},"flux-3.0":{"supported":true,"enum":["auto","21:9","2:1","16:9","4:3","1:1","3:4","9:16"],"default":"16:9","on_invalid":"adjust"},"wan-3.0":{"supported":true,"enum":["auto","16:9","4:3","1:1","3:4","9:16"],"default":"auto","on_invalid":"adjust"},"gemini-omni-flash":{"supported":true,"enum":["16:9","9:16"],"default":"16:9","on_invalid":"adjust"},"happyhorse-1.0":{"supported":true,"enum":["16:9","9:16","1:1","4:3","3:4"],"default":"16:9","on_invalid":"adjust"},"kling-4.0":{"supported":true,"enum":["16:9","9:16","1:1","21:9"],"default":"16:9","on_invalid":"adjust"},"kling-o3-pro":{"supported":true,"enum":["16:9","9:16","1:1"],"default":"16:9","on_invalid":"adjust"},"kling-o3-standard":{"supported":true,"enum":["16:9","9:16","1:1"],"default":"16:9","on_invalid":"adjust"},"kling-o3-4k":{"supported":true,"enum":["16:9","9:16","1:1"],"default":"16:9","on_invalid":"adjust"},"kling-3.0-pro":{"supported":true,"enum":["16:9","9:16","1:1"],"default":"16:9","on_invalid":"adjust"},"kling-3.0-standard":{"supported":true,"enum":["16:9","9:16","1:1"],"default":"16:9","on_invalid":"adjust"},"kling-3.0-4k":{"supported":true,"enum":["16:9","9:16","1:1"],"default":"16:9","on_invalid":"adjust"},"grok-imagine-1.5":{"supported":false,"on_invalid":"adjust","description":"Framing is derived from the required source image."},"grok-imagine":{"supported":true,"enum":["16:9","4:3","1:1","9:16","3:4","3:2","2:3"],"default":"16:9","on_invalid":"adjust"},"veo-3.1-lite":{"supported":true,"enum":["16:9","9:16"],"default":"16:9","on_invalid":"adjust"},"veo-3.1-standard":{"supported":true,"enum":["16:9","9:16"],"default":"16:9","on_invalid":"adjust"},"veo-3.1-fast":{"supported":true,"enum":["16:9","9:16"],"default":"16:9","on_invalid":"adjust"},"sora-2-pro":{"supported":true,"enum":["16:9","9:16"],"default":"16:9","on_invalid":"adjust"},"sora-2":{"supported":true,"enum":["16:9","9:16"],"default":"16:9","on_invalid":"adjust"},"v5.6":{"supported":true,"enum":["16:9","9:16","1:1","4:3","3:4","3:2","2:3"],"default":"16:9","on_invalid":"adjust"}},"audio":{"v6":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"pixverse-c1":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"seedance-2.5":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-standard":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"seedance-2.0-fast":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"seedance-2.0-mini":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"minimax-h3":{"supported":false,"on_invalid":"adjust"},"minimax-h3-max":{"supported":false,"on_invalid":"adjust"},"flux-3.0":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"wan-3.0":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"gemini-omni-flash":{"supported":false,"on_invalid":"adjust"},"happyhorse-1.0":{"supported":true,"default":true,"on_invalid":"adjust","description":"Audio is always enabled for this model."},"kling-4.0":{"supported":false,"on_invalid":"adjust"},"kling-o3-pro":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-o3-standard":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-o3-4k":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-3.0-pro":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-3.0-standard":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-3.0-4k":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"grok-imagine-1.5":{"supported":false,"on_invalid":"adjust"},"grok-imagine":{"supported":false,"on_invalid":"adjust"},"veo-3.1-lite":{"supported":false,"on_invalid":"adjust"},"veo-3.1-standard":{"supported":true,"default":true,"on_invalid":"adjust","description":"Audio is always enabled for this model."},"veo-3.1-fast":{"supported":true,"default":true,"on_invalid":"adjust","description":"Audio is always enabled for this model."},"sora-2-pro":{"supported":false,"on_invalid":"adjust"},"sora-2":{"supported":false,"on_invalid":"adjust"},"v5.6":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."}},"multi_shot":{"v6":{"supported":true},"pixverse-c1":{"supported":false,"on_invalid":"adjust"},"seedance-2.5":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-standard":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-fast":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-mini":{"supported":false,"on_invalid":"adjust"},"minimax-h3":{"supported":false,"on_invalid":"adjust"},"minimax-h3-max":{"supported":false,"on_invalid":"adjust"},"flux-3.0":{"supported":false,"on_invalid":"adjust"},"wan-3.0":{"supported":false,"on_invalid":"adjust"},"gemini-omni-flash":{"supported":false,"on_invalid":"adjust"},"happyhorse-1.0":{"supported":false,"on_invalid":"adjust"},"kling-4.0":{"supported":false,"on_invalid":"adjust"},"kling-o3-pro":{"supported":false,"on_invalid":"adjust"},"kling-o3-standard":{"supported":false,"on_invalid":"adjust"},"kling-o3-4k":{"supported":false,"on_invalid":"adjust"},"kling-3.0-pro":{"supported":false,"on_invalid":"adjust"},"kling-3.0-standard":{"supported":false,"on_invalid":"adjust"},"kling-3.0-4k":{"supported":false,"on_invalid":"adjust"},"grok-imagine-1.5":{"supported":false,"on_invalid":"adjust"},"grok-imagine":{"supported":false,"on_invalid":"adjust"},"veo-3.1-lite":{"supported":false,"on_invalid":"adjust"},"veo-3.1-standard":{"supported":false,"on_invalid":"adjust"},"veo-3.1-fast":{"supported":false,"on_invalid":"adjust"},"sora-2-pro":{"supported":false,"on_invalid":"adjust"},"sora-2":{"supported":false,"on_invalid":"adjust"},"v5.6":{"supported":false,"on_invalid":"adjust"}},"off_peak":{"v6":{"supported":true},"pixverse-c1":{"supported":true},"seedance-2.5":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-standard":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-fast":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-mini":{"supported":false,"on_invalid":"adjust"},"minimax-h3":{"supported":false,"on_invalid":"adjust"},"minimax-h3-max":{"supported":false,"on_invalid":"adjust"},"flux-3.0":{"supported":false,"on_invalid":"adjust"},"wan-3.0":{"supported":false,"on_invalid":"adjust"},"gemini-omni-flash":{"supported":false,"on_invalid":"adjust"},"happyhorse-1.0":{"supported":false,"on_invalid":"adjust"},"kling-4.0":{"supported":false,"on_invalid":"adjust"},"kling-o3-pro":{"supported":false,"on_invalid":"adjust"},"kling-o3-standard":{"supported":false,"on_invalid":"adjust"},"kling-o3-4k":{"supported":false,"on_invalid":"adjust"},"kling-3.0-pro":{"supported":false,"on_invalid":"adjust"},"kling-3.0-standard":{"supported":false,"on_invalid":"adjust"},"kling-3.0-4k":{"supported":false,"on_invalid":"adjust"},"grok-imagine-1.5":{"supported":false,"on_invalid":"adjust"},"grok-imagine":{"supported":false,"on_invalid":"adjust"},"veo-3.1-lite":{"supported":false,"on_invalid":"adjust"},"veo-3.1-standard":{"supported":false,"on_invalid":"adjust"},"veo-3.1-fast":{"supported":false,"on_invalid":"adjust"},"sora-2-pro":{"supported":false,"on_invalid":"adjust"},"sora-2":{"supported":false,"on_invalid":"adjust"},"v5.6":{"supported":true}}},"variants":{"text_to_video":{"description":"No source image is provided.","when":{"image":{"present":false}}},"image_to_video":{"description":"A source image is provided.","when":{"image":{"present":true}},"rules":[{"id":"image-derived-framing","description":"Most image-to-video models derive framing from the source image; model-specific validation remains authoritative.","when":{"model":{"not_in":["seedance-2.5"]}},"parameters":{"aspect_ratio":{"on_invalid":"adjust"}}}]}},"rules":[{"id":"grok-1.5-requires-image","description":"Grok Imagine 1.5 is image-to-video only.","when":{"model":"grok-imagine-1.5"},"parameters":{"image":{"required":true}}}],"parameter_refs":["count","seed","idempotency_key","wait","timeout","json","audio","relax_mode"]},"image":{"capability_id":"create.image","command":"pixverse create image","description":"Create an image from text and optional reference images.","default_model":"gpt-image-2.5-flare","parameters":{"prompt":{"flag":"--prompt","type":"text","required":true,"accepts":["literal","local_file","stdin"],"on_invalid":"reject","description":"Generation prompt."},"image":{"flag":"--image","type":"media","required":false,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Single reference image."},"images":{"flag":"--images","type":"media_list","required":false,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Multiple reference images; limits depend on the selected model."},"model":{"flag":"--model","type":"string","required":false,"default":"gpt-image-2.5-flare","on_invalid":"reject","description":"Image generation model.","enum_ref":"model_ids"},"quality":{"flag":"--quality","type":"string","required":false,"default":"1080p","unit":"output_resolution","on_invalid":"adjust","description":"Output quality."},"aspect_ratio":{"flag":"--aspect-ratio","type":"string","required":false,"default":"16:9","unit":"width:height","on_invalid":"adjust","description":"Output framing."},"background":{"flag":"--background","type":"string","required":false,"supported":false,"on_invalid":"reject","description":"GPT Image 2.5 background; output format is determined by the backend."},"detail_level":{"flag":"--detail-level","type":"string","required":false,"supported":false,"on_invalid":"reject","description":"Image detail level; accepted values and defaults depend on model."}},"model_ids":["gpt-image-2.5-flare","gpt-image-2.5-sunburst","gpt-image-2.0","gemini-nano-banana-2.1","gemini-3.1-flash","gemini-3.1-flash-lite","qwen-image","gemini-3.0","gemini-2.5-flash","seedream-5.0-pro","seedream-5.0-lite","seedream-4.5","seedream-4.0","kling-image-o3","kling-image-v3"],"model_parameters":{"quality":{"gpt-image-2.5-flare":{"enum":["1080p","1440p","2160p"],"default":"1080p","on_invalid":"adjust"},"gpt-image-2.5-sunburst":{"enum":["1080p","1440p","2160p"],"default":"1080p","on_invalid":"adjust"},"gpt-image-2.0":{"enum":["1080p","1440p","2160p"],"default":"1080p","on_invalid":"adjust"},"gemini-nano-banana-2.1":{"enum":["1080p","1440p","2160p"],"default":"1080p","on_invalid":"adjust"},"gemini-3.1-flash":{"enum":["512p","1080p","1440p","2160p"],"default":"1080p","on_invalid":"adjust"},"gemini-3.1-flash-lite":{"enum":["1080p"],"default":"1080p","on_invalid":"adjust"},"qwen-image":{"enum":["720p","1080p"],"default":"1080p","on_invalid":"adjust"},"gemini-3.0":{"enum":["1080p","1440p","2160p"],"default":"1080p","on_invalid":"adjust"},"gemini-2.5-flash":{"enum":["1080p"],"default":"1080p","on_invalid":"adjust"},"seedream-5.0-pro":{"enum":["1080p","1440p"],"default":"1080p","on_invalid":"adjust"},"seedream-5.0-lite":{"enum":["1440p","1800p","2160p"],"default":"1440p","on_invalid":"adjust"},"seedream-4.5":{"enum":["1440p","2160p"],"default":"1440p","on_invalid":"adjust"},"seedream-4.0":{"enum":["1080p","1440p","2160p"],"default":"1080p","on_invalid":"adjust"},"kling-image-o3":{"enum":["1080p","1440p","2160p"],"default":"1080p","on_invalid":"adjust"},"kling-image-v3":{"enum":["1080p","1440p"],"default":"1080p","on_invalid":"adjust"}},"aspect_ratio":{"gpt-image-2.5-flare":{"enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","2:1","1:2","21:9"],"default":"16:9","on_invalid":"adjust"},"gpt-image-2.5-sunburst":{"enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","2:1","1:2","21:9"],"default":"16:9","on_invalid":"adjust"},"gpt-image-2.0":{"enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","2:1","1:2","21:9"],"default":"16:9","on_invalid":"adjust"},"gemini-nano-banana-2.1":{"enum":["auto","1:1","3:2","2:3","3:4","4:3","4:5","5:4","9:16","16:9","21:9","1:4","4:1","1:8","8:1"],"default":"16:9","on_invalid":"adjust"},"gemini-3.1-flash":{"enum":["auto","1:1","16:9","9:16","4:3","3:4","5:4","4:5","3:2","2:3","21:9"],"default":"16:9","on_invalid":"adjust"},"gemini-3.1-flash-lite":{"enum":["auto","1:1","3:2","2:3","3:4","4:3","4:5","5:4","9:16","16:9","21:9"],"default":"16:9","on_invalid":"adjust"},"qwen-image":{"enum":["1:1","16:9","9:16","4:3","3:4","5:4","4:5","3:2","2:3","21:9"],"default":"16:9","on_invalid":"adjust"},"gemini-3.0":{"enum":["auto","1:1","16:9","9:16","4:3","3:4","5:4","4:5","3:2","2:3","21:9"],"default":"16:9","on_invalid":"adjust"},"gemini-2.5-flash":{"enum":["auto","1:1","16:9","9:16","4:3","3:4","5:4","4:5","3:2","2:3","21:9"],"default":"16:9","on_invalid":"adjust"},"seedream-5.0-pro":{"enum":["auto","1:1","16:9","9:16","4:3","3:4","5:4","4:5","3:2","2:3","21:9"],"default":"16:9","on_invalid":"adjust"},"seedream-5.0-lite":{"enum":["auto","1:1","16:9","9:16","4:3","3:4","5:4","4:5","3:2","2:3","21:9"],"default":"16:9","on_invalid":"adjust"},"seedream-4.5":{"enum":["auto","1:1","16:9","9:16","4:3","3:4","5:4","4:5","3:2","2:3","21:9"],"default":"16:9","on_invalid":"adjust"},"seedream-4.0":{"enum":["auto","1:1","16:9","9:16","4:3","3:4","5:4","4:5","3:2","2:3","21:9"],"default":"16:9","on_invalid":"adjust"},"kling-image-o3":{"enum":["16:9","9:16","1:1","4:3","3:4","3:2","2:3","21:9"],"default":"16:9","on_invalid":"adjust"},"kling-image-v3":{"enum":["16:9","9:16","1:1","4:3","3:4","3:2","2:3","21:9"],"default":"16:9","on_invalid":"adjust"}},"images":{"gpt-image-2.5-flare":{"max_count":16},"gpt-image-2.5-sunburst":{"max_count":16},"gpt-image-2.0":{"max_count":9},"gemini-nano-banana-2.1":{"max_count":14},"gemini-3.1-flash":{"max_count":9},"gemini-3.1-flash-lite":{"max_count":14},"qwen-image":{"max_count":3},"gemini-3.0":{"max_count":9},"gemini-2.5-flash":{"max_count":3},"seedream-5.0-pro":{"max_count":10},"seedream-5.0-lite":{"max_count":6},"seedream-4.5":{"max_count":6},"seedream-4.0":{"max_count":6},"kling-image-o3":{"max_count":10},"kling-image-v3":{"max_count":1}},"count":{"gpt-image-2.5-flare":{"max":4,"on_invalid":"adjust"},"gpt-image-2.5-sunburst":{"max":4,"on_invalid":"adjust"},"gpt-image-2.0":{"max":4,"on_invalid":"adjust"},"gemini-nano-banana-2.1":{"max":4,"on_invalid":"adjust"},"gemini-3.1-flash":{"max":4,"on_invalid":"adjust"},"gemini-3.1-flash-lite":{"max":4,"on_invalid":"adjust"},"qwen-image":{"max":4,"on_invalid":"adjust"},"gemini-3.0":{"max":4,"on_invalid":"adjust"},"gemini-2.5-flash":{"max":4,"on_invalid":"adjust"},"seedream-5.0-pro":{"max":4,"on_invalid":"adjust"},"seedream-5.0-lite":{"max":4,"on_invalid":"adjust"},"seedream-4.5":{"max":4,"on_invalid":"adjust"},"seedream-4.0":{"max":4,"on_invalid":"adjust"},"kling-image-o3":{"max":4,"on_invalid":"adjust"},"kling-image-v3":{"max":4,"on_invalid":"adjust"}},"background":{"gpt-image-2.5-flare":{"supported":true,"enum":["auto","transparent","opaque"],"default":"auto"},"gpt-image-2.5-sunburst":{"supported":true,"enum":["auto","transparent","opaque"],"default":"auto"},"gpt-image-2.0":{"supported":false,"on_invalid":"reject"},"gemini-nano-banana-2.1":{"supported":false,"on_invalid":"reject"},"gemini-3.1-flash":{"supported":false,"on_invalid":"reject"},"gemini-3.1-flash-lite":{"supported":false,"on_invalid":"reject"},"qwen-image":{"supported":false,"on_invalid":"reject"},"gemini-3.0":{"supported":false,"on_invalid":"reject"},"gemini-2.5-flash":{"supported":false,"on_invalid":"reject"},"seedream-5.0-pro":{"supported":false,"on_invalid":"reject"},"seedream-5.0-lite":{"supported":false,"on_invalid":"reject"},"seedream-4.5":{"supported":false,"on_invalid":"reject"},"seedream-4.0":{"supported":false,"on_invalid":"reject"},"kling-image-o3":{"supported":false,"on_invalid":"reject"},"kling-image-v3":{"supported":false,"on_invalid":"reject"}},"detail_level":{"gpt-image-2.5-flare":{"supported":true,"default":"low","enum":["low","medium","high","xhigh","max"]},"gpt-image-2.5-sunburst":{"supported":true,"default":"low","enum":["low","medium","high","xhigh","max"]},"gpt-image-2.0":{"supported":true,"default":"low","enum":["low","medium","high"]},"gemini-nano-banana-2.1":{"supported":true,"default":"medium","enum":["minimal","medium","high"]},"gemini-3.1-flash":{"supported":false,"on_invalid":"reject"},"gemini-3.1-flash-lite":{"supported":false,"on_invalid":"reject"},"qwen-image":{"supported":false,"on_invalid":"reject"},"gemini-3.0":{"supported":false,"on_invalid":"reject"},"gemini-2.5-flash":{"supported":false,"on_invalid":"reject"},"seedream-5.0-pro":{"supported":false,"on_invalid":"reject"},"seedream-5.0-lite":{"supported":false,"on_invalid":"reject"},"seedream-4.5":{"supported":false,"on_invalid":"reject"},"seedream-4.0":{"supported":false,"on_invalid":"reject"},"kling-image-o3":{"supported":false,"on_invalid":"reject"},"kling-image-v3":{"supported":false,"on_invalid":"reject"}},"seed":{"gemini-nano-banana-2.1":{"default":null,"description":"Accepted silently but omitted from the request."}}},"parameter_refs":["count","seed","idempotency_key","wait","timeout","json","relax_mode"]},"transition":{"capability_id":"create.transition","command":"pixverse create transition","description":"Create a transition video from ordered keyframe images.","default_model":"v6","parameters":{"images":{"flag":"--images","type":"media_list","required":true,"accepts":["local_path","https_url","asset_id","media_path"],"min_count":2,"on_invalid":"reject","description":"Ordered keyframe images."},"prompt":{"flag":"--prompt","type":"text","required":false,"accepts":["literal","local_file","stdin"],"on_invalid":"reject","description":"Optional prompt; required by some models."},"model":{"flag":"--model","type":"string","required":false,"default":"v6","on_invalid":"reject","description":"Generation model.","enum_ref":"model_ids"},"quality":{"flag":"--quality","type":"string","required":false,"default":"720p","unit":"output_resolution","on_invalid":"adjust","description":"Output quality where the selected model supports it."},"duration":{"flag":"--duration","type":"integer","required":false,"default":5,"unit":"seconds","on_invalid":"adjust","description":"Output duration."},"off_peak":{"flag":"--off-peak","type":"boolean","required":false,"default":false,"on_invalid":"adjust","description":"Use off-peak generation where supported."}},"model_ids":["v6","pixverse-c1","seedance-2.5","seedance-2.0-standard","seedance-2.0-fast","seedance-2.0-mini","minimax-h3","minimax-h3-max","wan-3.0","kling-4.0","kling-o3-pro","kling-o3-standard","kling-o3-4k","kling-3.0-pro","kling-3.0-standard","kling-3.0-4k","veo-3.1-lite","veo-3.1-standard","veo-3.1-fast","v5.6","v5"],"model_parameters":{"duration":{"v6":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"pixverse-c1":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"seedance-2.5":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30],"default":5,"on_invalid":"adjust"},"seedance-2.0-standard":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"seedance-2.0-fast":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"seedance-2.0-mini":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"minimax-h3":{"enum":[5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"minimax-h3-max":{"enum":[5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"wan-3.0":{"enum":[2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30],"default":5,"on_invalid":"adjust"},"kling-4.0":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30],"default":5,"on_invalid":"adjust"},"kling-o3-pro":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-o3-standard":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-o3-4k":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-3.0-pro":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-3.0-standard":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-3.0-4k":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"veo-3.1-lite":{"enum":[4,6,8],"default":4,"on_invalid":"adjust"},"veo-3.1-standard":{"enum":[4,6,8],"default":4,"on_invalid":"adjust"},"veo-3.1-fast":{"enum":[4,6,8],"default":4,"on_invalid":"adjust"},"v5.6":{"enum":[1,2,3,4,5,6,7,8,9,10],"default":5,"on_invalid":"adjust"},"v5":{"enum":[1,2,3,4,5,6,7,8,9,10],"default":5,"on_invalid":"adjust"}},"quality":{"v6":{"supported":true,"enum":["360p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"pixverse-c1":{"supported":true,"enum":["360p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"seedance-2.5":{"supported":true,"enum":["480p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"seedance-2.0-standard":{"supported":true,"enum":["480p","720p","1080p","2160p"],"default":"720p","on_invalid":"adjust"},"seedance-2.0-fast":{"supported":true,"enum":["480p","720p"],"default":"720p","on_invalid":"adjust"},"seedance-2.0-mini":{"supported":true,"enum":["480p","720p"],"default":"720p","on_invalid":"adjust"},"minimax-h3":{"supported":true,"enum":["768p","1440p"],"default":"1440p","on_invalid":"adjust"},"minimax-h3-max":{"supported":true,"enum":["480p","768p","1080p"],"default":"768p","on_invalid":"adjust"},"wan-3.0":{"supported":true,"enum":["480p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"kling-4.0":{"supported":true,"enum":["720p","1080p"],"default":"1080p","on_invalid":"adjust"},"kling-o3-pro":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-o3-standard":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-o3-4k":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-3.0-pro":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-3.0-standard":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-3.0-4k":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"veo-3.1-lite":{"supported":true,"enum":["720p","1080p"],"default":"720p","on_invalid":"adjust"},"veo-3.1-standard":{"supported":true,"enum":["720p","1080p","2160p"],"default":"720p","on_invalid":"adjust"},"veo-3.1-fast":{"supported":true,"enum":["720p","1080p","2160p"],"default":"720p","on_invalid":"adjust"},"v5.6":{"supported":true,"enum":["360p","480p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"v5":{"supported":true,"enum":["360p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"}},"audio":{"v6":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"pixverse-c1":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"seedance-2.5":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-standard":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"seedance-2.0-fast":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"seedance-2.0-mini":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"minimax-h3":{"supported":false,"on_invalid":"adjust"},"minimax-h3-max":{"supported":false,"on_invalid":"adjust"},"wan-3.0":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-4.0":{"supported":false,"on_invalid":"adjust"},"kling-o3-pro":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-o3-standard":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-o3-4k":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-3.0-pro":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-3.0-standard":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-3.0-4k":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"veo-3.1-lite":{"supported":false,"on_invalid":"adjust"},"veo-3.1-standard":{"supported":true,"default":true,"on_invalid":"adjust","description":"Audio is always enabled for this model."},"veo-3.1-fast":{"supported":true,"default":true,"on_invalid":"adjust","description":"Audio is always enabled for this model."},"v5.6":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"v5":{"supported":false,"on_invalid":"adjust"}},"off_peak":{"v6":{"supported":true},"pixverse-c1":{"supported":true},"seedance-2.5":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-standard":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-fast":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-mini":{"supported":false,"on_invalid":"adjust"},"minimax-h3":{"supported":false,"on_invalid":"adjust"},"minimax-h3-max":{"supported":false,"on_invalid":"adjust"},"wan-3.0":{"supported":false,"on_invalid":"adjust"},"kling-4.0":{"supported":false,"on_invalid":"adjust"},"kling-o3-pro":{"supported":false,"on_invalid":"adjust"},"kling-o3-standard":{"supported":false,"on_invalid":"adjust"},"kling-o3-4k":{"supported":false,"on_invalid":"adjust"},"kling-3.0-pro":{"supported":false,"on_invalid":"adjust"},"kling-3.0-standard":{"supported":false,"on_invalid":"adjust"},"kling-3.0-4k":{"supported":false,"on_invalid":"adjust"},"veo-3.1-lite":{"supported":false,"on_invalid":"adjust"},"veo-3.1-standard":{"supported":false,"on_invalid":"adjust"},"veo-3.1-fast":{"supported":false,"on_invalid":"adjust"},"v5.6":{"supported":true},"v5":{"supported":true}}},"variants":{"two_frames":{"description":"Exactly two keyframes.","when":{"images":{"count":2}},"allowed_models":["v6","pixverse-c1","seedance-2.5","seedance-2.0-standard","seedance-2.0-fast","seedance-2.0-mini","minimax-h3","minimax-h3-max","wan-3.0","kling-4.0","kling-o3-pro","kling-o3-standard","kling-o3-4k","kling-3.0-pro","kling-3.0-standard","kling-3.0-4k","veo-3.1-lite","veo-3.1-standard","veo-3.1-fast","v5.6"]},"multi_frame":{"description":"Three or more keyframes.","when":{"images":{"min_count":3}},"allowed_models":["v5"]}},"rules":[{"id":"transition-prompt-required","description":"These models require a transition prompt.","when":{"model":{"in":["minimax-h3","minimax-h3-max","seedance-2.5","wan-3.0"]}},"parameters":{"prompt":{"required":true}}}],"parameter_refs":["count","seed","idempotency_key","wait","timeout","json","audio","relax_mode"]},"voice":{"capability_id":"create.voice","command":"pixverse create voice","description":"Generate speech audio from text.","default_model":"speech-2.8-hd","parameters":{"text":{"flag":"--text","type":"text","required":true,"accepts":["literal","local_file","stdin"],"on_invalid":"reject","description":"Text to synthesize.","min_length":1},"model":{"flag":"--model","type":"string","required":false,"default":"speech-2.8-hd","on_invalid":"reject","description":"Voice model.","enum_ref":"model_ids"},"voice_id":{"flag":"--voice-id","type":"string","required":false,"on_invalid":"backend","description":"PixVerse preset voice identifier."},"provider_voice_id":{"flag":"--provider-voice-id","type":"string","required":false,"on_invalid":"backend","description":"Provider-native voice identifier."},"language":{"flag":"--language","type":"string","required":false,"default":"auto","on_invalid":"backend","description":"Language code; auto omits the provider language field."},"stability":{"flag":"--stability","type":"number","required":false,"min":0,"max":1,"on_invalid":"reject","description":"ElevenLabs voice stability."},"similarity_boost":{"flag":"--similarity-boost","type":"number","required":false,"min":0,"max":1,"on_invalid":"reject","description":"ElevenLabs similarity boost."},"style":{"flag":"--style","type":"number","required":false,"min":0,"max":1,"on_invalid":"reject","description":"Eleven Multilingual v2 style strength."},"use_speaker_boost":{"flag":"--use-speaker-boost / --no-use-speaker-boost","type":"boolean","required":false,"on_invalid":"reject","description":"Eleven Multilingual v2 speaker boost."},"speed":{"flag":"--speed","type":"number","required":false,"default":1,"unit":"multiplier","on_invalid":"reject","description":"Provider-specific speech speed."},"volume":{"flag":"--volume","type":"number","required":false,"min":0,"max":10,"on_invalid":"reject","description":"MiniMax volume."},"pitch":{"flag":"--pitch","type":"number","required":false,"min":-12,"max":12,"unit":"semitones","on_invalid":"reject","description":"MiniMax pitch adjustment."},"emotion":{"flag":"--emotion","type":"string","required":false,"enum":["auto","happy","sad","angry","fearful","disgusted","surprised","calm","fluent","whisper"],"on_invalid":"reject","description":"MiniMax emotion preset."}},"model_ids":["speech-2.8-hd","speech-2.8-turbo","eleven-multilingual-v2","eleven-v3","eleven-turbo-v2.5"],"model_parameters":{"language":{"speech-2.8-hd":{"supported":true,"on_invalid":"backend"},"speech-2.8-turbo":{"supported":true,"on_invalid":"backend"},"eleven-multilingual-v2":{"supported":true,"on_invalid":"backend"},"eleven-v3":{"supported":false,"on_invalid":"adjust"},"eleven-turbo-v2.5":{"supported":true,"on_invalid":"backend"}},"stability":{"speech-2.8-hd":{"supported":false,"on_invalid":"reject"},"speech-2.8-turbo":{"supported":false,"on_invalid":"reject"},"eleven-multilingual-v2":{"supported":true,"min":0,"max":1,"default":0.5},"eleven-v3":{"supported":true,"min":0,"max":1,"default":0.5},"eleven-turbo-v2.5":{"supported":true,"min":0,"max":1,"default":0.5}},"similarity_boost":{"speech-2.8-hd":{"supported":false,"on_invalid":"reject"},"speech-2.8-turbo":{"supported":false,"on_invalid":"reject"},"eleven-multilingual-v2":{"supported":true,"min":0,"max":1,"default":0.75},"eleven-v3":{"supported":true,"min":0,"max":1,"default":0.75},"eleven-turbo-v2.5":{"supported":true,"min":0,"max":1,"default":0.75}},"style":{"speech-2.8-hd":{"supported":false,"on_invalid":"reject"},"speech-2.8-turbo":{"supported":false,"on_invalid":"reject"},"eleven-multilingual-v2":{"supported":true,"min":0,"max":1,"default":0},"eleven-v3":{"supported":false,"on_invalid":"reject"},"eleven-turbo-v2.5":{"supported":false,"on_invalid":"reject"}},"use_speaker_boost":{"speech-2.8-hd":{"supported":false,"on_invalid":"reject"},"speech-2.8-turbo":{"supported":false,"on_invalid":"reject"},"eleven-multilingual-v2":{"supported":true,"default":true},"eleven-v3":{"supported":false,"on_invalid":"reject"},"eleven-turbo-v2.5":{"supported":false,"on_invalid":"reject"}},"speed":{"speech-2.8-hd":{"min":0.5,"max":2,"default":1},"speech-2.8-turbo":{"min":0.5,"max":2,"default":1},"eleven-multilingual-v2":{"min":0.7,"max":1.2,"default":1},"eleven-v3":{"min":0.7,"max":1.2,"default":1},"eleven-turbo-v2.5":{"min":0.7,"max":1.2,"default":1}},"volume":{"speech-2.8-hd":{"supported":true,"min":0,"max":10,"default":1},"speech-2.8-turbo":{"supported":true,"min":0,"max":10,"default":1},"eleven-multilingual-v2":{"supported":false,"on_invalid":"reject"},"eleven-v3":{"supported":false,"on_invalid":"reject"},"eleven-turbo-v2.5":{"supported":false,"on_invalid":"reject"}},"pitch":{"speech-2.8-hd":{"supported":true,"min":-12,"max":12,"default":0},"speech-2.8-turbo":{"supported":true,"min":-12,"max":12,"default":0},"eleven-multilingual-v2":{"supported":false,"on_invalid":"reject"},"eleven-v3":{"supported":false,"on_invalid":"reject"},"eleven-turbo-v2.5":{"supported":false,"on_invalid":"reject"}},"emotion":{"speech-2.8-hd":{"supported":true,"enum":["auto","happy","sad","angry","fearful","disgusted","surprised","calm","fluent","whisper"],"default":"auto"},"speech-2.8-turbo":{"supported":true,"enum":["auto","happy","sad","angry","fearful","disgusted","surprised","calm","fluent","whisper"],"default":"auto"},"eleven-multilingual-v2":{"supported":false,"on_invalid":"reject"},"eleven-v3":{"supported":false,"on_invalid":"reject"},"eleven-turbo-v2.5":{"supported":false,"on_invalid":"reject"}}},"model_metadata":{"speech-2.8-hd":{"provider":"minimax"},"speech-2.8-turbo":{"provider":"minimax"},"eleven-multilingual-v2":{"provider":"elevenlabs"},"eleven-v3":{"provider":"elevenlabs"},"eleven-turbo-v2.5":{"provider":"elevenlabs"}},"rules":[{"id":"voice-required","description":"Either voice_id or provider_voice_id is required.","when":{"always":true}}],"runtime_discovery":["pixverse voice models --json","pixverse voice presets --model --json"],"parameter_refs":["wait","timeout","json","client_request_id","output"]},"music":{"capability_id":"create.music","command":"pixverse create music","description":"Generate music audio from a prompt.","default_model":"music-2.6","parameters":{"prompt":{"flag":"--prompt","type":"text","required":true,"accepts":["literal","local_file","stdin"],"on_invalid":"reject","description":"Music generation prompt.","min_length":1},"lyrics":{"flag":"--lyrics","type":"text","required":false,"accepts":["literal","local_file","stdin"],"on_invalid":"reject","description":"Lyrics for models that support separate lyrics."},"model":{"flag":"--model","type":"string","required":false,"default":"music-2.6","on_invalid":"reject","description":"Music model.","enum_ref":"model_ids"},"instrumental":{"flag":"--instrumental","type":"boolean","required":false,"default":false,"on_invalid":"reject","description":"Generate instrumental music."},"auto_lyrics":{"flag":"--auto-lyrics","type":"boolean","required":false,"default":false,"on_invalid":"reject","description":"Let the model generate lyrics."},"duration_auto":{"flag":"--no-duration-auto","type":"boolean","required":false,"default":true,"on_invalid":"reject","description":"Automatically select duration unless disabled."},"duration_seconds":{"flag":"--duration-seconds","type":"integer","required":false,"unit":"seconds","on_invalid":"reject","description":"Manual target duration."},"image":{"flag":"--image","type":"media_list","required":false,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Reference images for models that support them."}},"model_ids":["music-3.0","music-2.6","music-v2","music-v1","lyria-3-pro-preview"],"model_parameters":{"lyrics":{"music-3.0":{"supported":true},"music-2.6":{"supported":true},"music-v2":{"supported":true},"music-v1":{"supported":true},"lyria-3-pro-preview":{"supported":false,"on_invalid":"reject"}},"instrumental":{"music-3.0":{"supported":true,"on_invalid":"reject"},"music-2.6":{"supported":true,"on_invalid":"reject"},"music-v2":{"supported":true,"on_invalid":"reject"},"music-v1":{"supported":true,"on_invalid":"reject"},"lyria-3-pro-preview":{"supported":true,"on_invalid":"reject"}},"auto_lyrics":{"music-3.0":{"supported":true,"on_invalid":"reject"},"music-2.6":{"supported":true,"on_invalid":"reject"},"music-v2":{"supported":true,"on_invalid":"reject"},"music-v1":{"supported":true,"on_invalid":"reject"},"lyria-3-pro-preview":{"supported":true,"on_invalid":"reject"}},"duration_auto":{"music-3.0":{"supported":true,"default":true,"on_invalid":"reject"},"music-2.6":{"supported":true,"default":true,"on_invalid":"reject"},"music-v2":{"supported":true,"default":true,"on_invalid":"reject"},"music-v1":{"supported":true,"default":true,"on_invalid":"reject"},"lyria-3-pro-preview":{"supported":true,"default":true,"on_invalid":"reject"}},"duration_seconds":{"music-3.0":{"min":10,"max":240},"music-2.6":{"min":10,"max":240},"music-v2":{"min":10,"max":240},"music-v1":{"min":10,"max":240},"lyria-3-pro-preview":{"min":10,"max":240}},"image":{"music-3.0":{"supported":false,"max_count":0,"on_invalid":"reject"},"music-2.6":{"supported":false,"max_count":0,"on_invalid":"reject"},"music-v2":{"supported":false,"max_count":0,"on_invalid":"reject"},"music-v1":{"supported":false,"max_count":0,"on_invalid":"reject"},"lyria-3-pro-preview":{"supported":true,"max_count":10,"on_invalid":"reject"}}},"model_metadata":{"music-3.0":{"provider":"minimax","credits":50},"music-2.6":{"provider":"minimax","credits":40},"music-v2":{"provider":"elevenlabs","credits":125},"music-v1":{"provider":"elevenlabs","credits":150},"lyria-3-pro-preview":{"provider":"google","credits":20}},"rules":[{"id":"music-lyrics-choice","description":"Models with separate lyrics require lyrics, instrumental, or auto_lyrics.","when":{"model":{"supports":"lyrics"}}},{"id":"manual-duration-required","description":"duration_seconds is required when automatic duration is disabled.","when":{"duration_auto":false},"parameters":{"duration_seconds":{"required":true}}}],"runtime_discovery":["pixverse music models --json"],"parameter_refs":["wait","timeout","json","client_request_id","output"]},"extend":{"capability_id":"create.extend","command":"pixverse create extend","description":"Extend an existing video.","default_model":"v6","parameters":{"video":{"flag":"--video","type":"media","required":true,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Source video to extend."},"prompt":{"flag":"--prompt","type":"text","required":false,"accepts":["literal","local_file","stdin"],"on_invalid":"reject","description":"Extension prompt."},"model":{"flag":"--model","type":"string","required":false,"default":"v6","on_invalid":"reject","description":"Generation model.","enum_ref":"model_ids"},"quality":{"flag":"--quality","type":"string","required":false,"default":"720p","unit":"output_resolution","on_invalid":"adjust","description":"Output quality where the selected model supports it."},"duration":{"flag":"--duration","type":"integer","required":false,"default":5,"unit":"seconds","on_invalid":"adjust","description":"Output duration."},"off_peak":{"flag":"--off-peak","type":"boolean","required":false,"default":false,"on_invalid":"adjust","description":"Use off-peak generation where supported."}},"model_ids":["v6","grok-imagine"],"model_parameters":{"duration":{"v6":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"grok-imagine":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"}},"quality":{"v6":{"supported":true,"enum":["360p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"grok-imagine":{"supported":true,"enum":["480p","720p"],"default":"720p","on_invalid":"adjust"}},"audio":{"v6":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"grok-imagine":{"supported":false,"on_invalid":"adjust"}},"off_peak":{"v6":{"supported":true},"grok-imagine":{"supported":false,"on_invalid":"adjust"}}},"parameter_refs":["count","seed","idempotency_key","wait","timeout","json","audio"]},"modify":{"capability_id":"create.modify","command":"pixverse create modify","description":"Modify an existing video with a prompt and references.","default_model":"v5.5","parameters":{"video":{"flag":"--video","type":"media","required":true,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Source video to modify."},"prompt":{"flag":"--prompt","type":"text","required":true,"accepts":["literal","local_file","stdin"],"on_invalid":"reject","description":"Modification prompt."},"images":{"flag":"--images","type":"media_list","required":false,"accepts":["local_path","https_url","asset_id","media_path"],"max_count":5,"on_invalid":"reject","description":"Reference images addressable as @image1, @image2, and so on."},"keyframe_time":{"flag":"--keyframe-time","type":"integer","required":false,"default":0,"min":0,"unit":"milliseconds","on_invalid":"reject","description":"Frame position used as the modification keyframe."},"model":{"flag":"--model","type":"string","required":false,"default":"v5.5","on_invalid":"reject","description":"Generation model.","enum_ref":"model_ids"},"quality":{"flag":"--quality","type":"string","required":false,"default":"720p","unit":"output_resolution","on_invalid":"adjust","description":"Output quality where the selected model supports it."},"off_peak":{"flag":"--off-peak","type":"boolean","required":false,"default":false,"on_invalid":"adjust","description":"Use off-peak generation where supported."}},"model_ids":["v5.5"],"model_parameters":{"quality":{"v5.5":{"supported":true,"enum":["360p","540p","720p"],"default":"720p","on_invalid":"adjust"}},"off_peak":{"v5.5":{"supported":true}}},"parameter_refs":["count","seed","idempotency_key","wait","timeout","json","relax_mode"]},"upscale":{"capability_id":"create.upscale","command":"pixverse create upscale","description":"Upscale a video to 2160p.","parameters":{"video":{"flag":"--video","type":"media","required":true,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Source video to upscale."},"quality":{"flag":"--quality","type":"string","required":false,"default":"2160p","enum":["2160p"],"unit":"output_resolution","on_invalid":"reject","description":"Target output quality."}},"parameter_refs":["idempotency_key","wait","timeout","json"]},"reference":{"capability_id":"create.reference","command":"pixverse create reference","description":"Create or edit a video with reference media.","default_model":"v6","parameters":{"images":{"flag":"--images","type":"media_list","required":false,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Reference images."},"videos":{"flag":"--videos","type":"media_list","required":false,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Reference videos."},"audios":{"flag":"--audios","type":"media_list","required":false,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Reference audio clips."},"prompt":{"flag":"--prompt","type":"text","required":true,"accepts":["literal","local_file","stdin"],"on_invalid":"reject","description":"Generation or editing prompt."},"model":{"flag":"--model","type":"string","required":false,"default":"v6","on_invalid":"reject","description":"Generation model.","enum_ref":"model_ids"},"quality":{"flag":"--quality","type":"string","required":false,"default":"720p","unit":"output_resolution","on_invalid":"adjust","description":"Output quality where the selected model supports it."},"duration":{"flag":"--duration","type":"integer","required":false,"default":5,"unit":"seconds","on_invalid":"adjust","description":"Output duration in seconds; 0 is the normalized automatic-duration value where supported (use \"auto\" in the CLI)."},"off_peak":{"flag":"--off-peak","type":"boolean","required":false,"default":false,"on_invalid":"adjust","description":"Use off-peak generation where supported."},"task_type":{"flag":"--task-type","type":"string","required":false,"supported":false,"on_invalid":"reject","description":"Seedance 2.5 reference task type."},"aspect_ratio":{"flag":"--aspect-ratio","type":"string","required":false,"default":"16:9","unit":"width:height","on_invalid":"adjust","description":"Output framing or auto where supported."}},"model_ids":["v6","pixverse-c1","seedance-2.5","seedance-2.0-standard","seedance-2.0-fast","seedance-2.0-mini","minimax-h3","minimax-h3-max","wan-3.0","gemini-omni-flash","kling-4.0","kling-o3-pro","kling-o3-standard","kling-o3-4k","grok-imagine","v5.6"],"model_parameters":{"duration":{"v6":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,0],"default":5,"on_invalid":"adjust"},"pixverse-c1":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"seedance-2.5":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,0],"default":5,"on_invalid":"adjust"},"seedance-2.0-standard":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"seedance-2.0-fast":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"seedance-2.0-mini":{"enum":[4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"minimax-h3":{"enum":[5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"minimax-h3-max":{"enum":[5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"wan-3.0":{"enum":[2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,0],"default":5,"on_invalid":"adjust"},"gemini-omni-flash":{"enum":[3,4,5,6,7,8,9,10,0],"default":5,"on_invalid":"adjust"},"kling-4.0":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30],"default":5,"on_invalid":"adjust"},"kling-o3-pro":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-o3-standard":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"kling-o3-4k":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"on_invalid":"adjust"},"grok-imagine":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,0],"default":5,"on_invalid":"adjust"},"v5.6":{"enum":[1,2,3,4,5,6,7,8,9,10],"default":5,"on_invalid":"adjust"}},"quality":{"v6":{"supported":true,"enum":["360p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"pixverse-c1":{"supported":true,"enum":["360p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"seedance-2.5":{"supported":true,"enum":["480p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"seedance-2.0-standard":{"supported":true,"enum":["480p","720p","1080p","2160p"],"default":"720p","on_invalid":"adjust"},"seedance-2.0-fast":{"supported":true,"enum":["480p","720p"],"default":"720p","on_invalid":"adjust"},"seedance-2.0-mini":{"supported":true,"enum":["480p","720p"],"default":"720p","on_invalid":"adjust"},"minimax-h3":{"supported":true,"enum":["768p","1440p"],"default":"1440p","on_invalid":"adjust"},"minimax-h3-max":{"supported":true,"enum":["480p","768p","1080p"],"default":"768p","on_invalid":"adjust"},"wan-3.0":{"supported":true,"enum":["480p","720p","1080p"],"default":"720p","on_invalid":"adjust"},"gemini-omni-flash":{"supported":true,"enum":["720p"],"default":"720p","on_invalid":"adjust"},"kling-4.0":{"supported":true,"enum":["720p","1080p"],"default":"1080p","on_invalid":"adjust"},"kling-o3-pro":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-o3-standard":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"kling-o3-4k":{"supported":false,"on_invalid":"adjust","description":"Resolution is selected by the model ID."},"grok-imagine":{"supported":true,"enum":["480p","720p"],"default":"720p","on_invalid":"adjust"},"v5.6":{"supported":true,"enum":["360p","480p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"}},"aspect_ratio":{"v6":{"supported":true,"enum":["16:9","21:9","4:3","1:1","3:4","9:16","3:2","2:3"],"default":"16:9","on_invalid":"adjust"},"pixverse-c1":{"supported":true,"enum":["16:9","4:3","1:1","3:4","9:16","3:2","2:3"],"default":"16:9","on_invalid":"adjust"},"seedance-2.5":{"supported":true,"enum":["auto","21:9","16:9","4:3","1:1","3:4","9:16"],"default":"16:9","on_invalid":"adjust"},"seedance-2.0-standard":{"supported":true,"enum":["16:9","4:3","1:1","3:4","9:16","21:9"],"default":"16:9","on_invalid":"adjust"},"seedance-2.0-fast":{"supported":true,"enum":["16:9","4:3","1:1","3:4","9:16","21:9"],"default":"16:9","on_invalid":"adjust"},"seedance-2.0-mini":{"supported":true,"enum":["16:9","4:3","1:1","3:4","9:16","21:9"],"default":"16:9","on_invalid":"adjust"},"minimax-h3":{"supported":true,"enum":["21:9","16:9","4:3","1:1","3:4","9:16","auto"],"default":"16:9","on_invalid":"adjust"},"minimax-h3-max":{"enum":["auto","21:9","16:9","4:3","1:1","3:4","9:16"],"default":"auto","on_invalid":"adjust"},"wan-3.0":{"supported":true,"enum":["auto","16:9","4:3","1:1","3:4","9:16"],"default":"auto","on_invalid":"adjust"},"gemini-omni-flash":{"supported":true,"enum":["16:9","9:16"],"default":"16:9","on_invalid":"adjust"},"kling-4.0":{"enum":["auto","16:9","9:16","1:1","21:9"],"default":"16:9","on_invalid":"adjust"},"kling-o3-pro":{"supported":true,"enum":["16:9","9:16","1:1"],"default":"16:9","on_invalid":"adjust"},"kling-o3-standard":{"supported":true,"enum":["16:9","9:16","1:1"],"default":"16:9","on_invalid":"adjust"},"kling-o3-4k":{"supported":true,"enum":["16:9","9:16","1:1"],"default":"16:9","on_invalid":"adjust"},"grok-imagine":{"supported":true,"enum":["16:9","4:3","1:1","9:16","3:4","3:2","2:3"],"default":"16:9","on_invalid":"adjust"},"v5.6":{"supported":true,"enum":["16:9","9:16","1:1","4:3","3:4","3:2","2:3"],"default":"16:9","on_invalid":"adjust"}},"audio":{"v6":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"pixverse-c1":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"seedance-2.5":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-standard":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"seedance-2.0-fast":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"seedance-2.0-mini":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"minimax-h3":{"supported":false,"on_invalid":"adjust"},"minimax-h3-max":{"supported":false,"on_invalid":"adjust"},"wan-3.0":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"gemini-omni-flash":{"supported":false,"on_invalid":"adjust"},"kling-4.0":{"supported":false,"on_invalid":"adjust"},"kling-o3-pro":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-o3-standard":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"kling-o3-4k":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."},"grok-imagine":{"supported":false,"on_invalid":"adjust"},"v5.6":{"supported":true,"on_invalid":"reject","description":"Enable generated audio."}},"off_peak":{"v6":{"supported":true},"pixverse-c1":{"supported":true},"seedance-2.5":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-standard":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-fast":{"supported":false,"on_invalid":"adjust"},"seedance-2.0-mini":{"supported":false,"on_invalid":"adjust"},"minimax-h3":{"supported":false,"on_invalid":"adjust"},"minimax-h3-max":{"supported":false,"on_invalid":"adjust"},"wan-3.0":{"supported":false,"on_invalid":"adjust"},"gemini-omni-flash":{"supported":false,"on_invalid":"adjust"},"kling-4.0":{"supported":false,"on_invalid":"adjust"},"kling-o3-pro":{"supported":false,"on_invalid":"adjust"},"kling-o3-standard":{"supported":false,"on_invalid":"adjust"},"kling-o3-4k":{"supported":false,"on_invalid":"adjust"},"grok-imagine":{"supported":false,"on_invalid":"adjust"},"v5.6":{"supported":true}},"images":{"v6":{"max_count":10},"pixverse-c1":{"max_count":7},"seedance-2.5":{"max_count":30},"seedance-2.0-standard":{"max_count":9},"seedance-2.0-fast":{"max_count":9},"seedance-2.0-mini":{"max_count":9},"minimax-h3":{"max_count":9},"minimax-h3-max":{"max_count":9},"wan-3.0":{"max_count":10},"gemini-omni-flash":{"max_count":5},"kling-4.0":{"max_count":10},"kling-o3-pro":{"max_count":7},"kling-o3-standard":{"max_count":7},"kling-o3-4k":{"max_count":7},"grok-imagine":{"max_count":7},"v5.6":{"max_count":7}},"videos":{"v6":{"supported":true,"max_count":2},"pixverse-c1":{"supported":false,"max_count":0},"seedance-2.5":{"supported":true,"max_count":10},"seedance-2.0-standard":{"supported":true,"max_count":3},"seedance-2.0-fast":{"supported":true,"max_count":3},"seedance-2.0-mini":{"supported":true,"max_count":3},"minimax-h3":{"supported":true,"max_count":3},"minimax-h3-max":{"supported":true,"max_count":3},"wan-3.0":{"supported":true,"max_count":5},"gemini-omni-flash":{"supported":true,"max_count":1},"kling-4.0":{"supported":true,"max_count":5},"kling-o3-pro":{"supported":true,"max_count":1},"kling-o3-standard":{"supported":true,"max_count":1},"kling-o3-4k":{"supported":true,"max_count":1},"grok-imagine":{"supported":true,"max_count":1},"v5.6":{"supported":false,"max_count":0}},"audios":{"v6":{"supported":false,"max_count":0},"pixverse-c1":{"supported":false,"max_count":0},"seedance-2.5":{"supported":true,"max_count":10},"seedance-2.0-standard":{"supported":true,"max_count":3},"seedance-2.0-fast":{"supported":true,"max_count":3},"seedance-2.0-mini":{"supported":true,"max_count":3},"minimax-h3":{"supported":true,"max_count":3},"minimax-h3-max":{"supported":true,"max_count":3},"wan-3.0":{"supported":true,"max_count":5},"gemini-omni-flash":{"supported":false,"max_count":0},"kling-4.0":{"supported":false,"max_count":0},"kling-o3-pro":{"supported":false,"max_count":0},"kling-o3-standard":{"supported":false,"max_count":0},"kling-o3-4k":{"supported":false,"max_count":0},"grok-imagine":{"supported":false,"max_count":0},"v5.6":{"supported":false,"max_count":0}},"task_type":{"v6":{"supported":false,"on_invalid":"reject"},"pixverse-c1":{"supported":false,"on_invalid":"reject"},"seedance-2.5":{"supported":true,"enum":["auto","reference","edit","extend"],"default":"auto"},"seedance-2.0-standard":{"supported":false,"on_invalid":"reject"},"seedance-2.0-fast":{"supported":false,"on_invalid":"reject"},"seedance-2.0-mini":{"supported":false,"on_invalid":"reject"},"minimax-h3":{"supported":false,"on_invalid":"reject"},"minimax-h3-max":{"supported":false,"on_invalid":"reject"},"wan-3.0":{"supported":false,"on_invalid":"reject"},"gemini-omni-flash":{"supported":false,"on_invalid":"reject"},"kling-4.0":{"supported":false,"on_invalid":"reject"},"kling-o3-pro":{"supported":false,"on_invalid":"reject"},"kling-o3-standard":{"supported":false,"on_invalid":"reject"},"kling-o3-4k":{"supported":false,"on_invalid":"reject"},"grok-imagine":{"supported":false,"on_invalid":"reject"},"v5.6":{"supported":false,"on_invalid":"reject"}}},"model_metadata":{"v6":{"max_video_duration_seconds":15},"pixverse-c1":{},"seedance-2.5":{"max_reference_items":50,"max_video_duration_seconds":30},"seedance-2.0-standard":{"max_video_duration_seconds":15},"seedance-2.0-fast":{"max_video_duration_seconds":15},"seedance-2.0-mini":{"max_video_duration_seconds":15},"minimax-h3":{},"minimax-h3-max":{"max_reference_items":12},"wan-3.0":{"max_reference_items":20,"max_video_duration_seconds":15},"gemini-omni-flash":{"max_video_duration_seconds":10},"kling-4.0":{"max_video_duration_seconds":30},"kling-o3-pro":{"max_video_duration_seconds":15},"kling-o3-standard":{"max_video_duration_seconds":15},"kling-o3-4k":{"max_video_duration_seconds":15},"grok-imagine":{"max_video_duration_seconds":8.7},"v5.6":{}},"rules":[{"id":"reference-media-required","description":"At least one supported image, video, or audio reference is required.","when":{"always":true}},{"id":"audio-requires-visual-reference","description":"Audio references require an image or video reference except where the selected model explicitly supports audio-only input.","when":{"model":{"not_in":["wan-3.0"]},"audios":{"min_count":1}}}],"parameter_refs":["count","seed","idempotency_key","wait","timeout","json","audio","relax_mode"]},"motion-control":{"capability_id":"create.motion-control","command":"pixverse create motion-control","description":"Create a video from a character image and motion video.","default_model":"v5.6","parameters":{"image":{"flag":"--image","type":"media","required":true,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Character image."},"video":{"flag":"--video","type":"media","required":true,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Motion reference video."},"model":{"flag":"--model","type":"string","required":false,"default":"v5.6","on_invalid":"reject","description":"Motion-control model.","enum_ref":"model_ids"},"quality":{"flag":"--quality","type":"string","required":false,"default":"720p","unit":"output_resolution","on_invalid":"adjust","description":"Output quality."},"off_peak":{"flag":"--off-peak","type":"boolean","required":false,"default":false,"on_invalid":"adjust","description":"Use off-peak generation where supported."}},"model_ids":["v5.6"],"model_parameters":{"quality":{"v5.6":{"supported":true,"enum":["360p","480p","540p","720p","1080p"],"default":"720p","on_invalid":"adjust"}},"off_peak":{"v5.6":{"supported":true}}},"parameter_refs":["count","idempotency_key","wait","timeout","json","relax_mode"]},"template":{"capability_id":"create.template","command":"pixverse create template","description":"Create media from more template types or effects. Templates with ordered input fields may return multiple image/video outputs and use fixed output settings; quality, duration, framing, seed, count, off-peak, and idempotency overrides are rejected for these templates. Malformed accepted responses from these templates exit with code 1 and preserve the response, valid output IDs, and trace in stderr for recovery; do not resubmit automatically. Polling communication errors exit with code 1, polling deadlines with code 2, and confirmed generation failures with code 5; accepted output IDs and completed results are preserved.","parameters":{"template_id":{"flag":"--template-id","type":"integer","required":true,"min":1,"unit":"identifier","on_invalid":"reject","description":"Template identifier."},"image":{"flag":"--image","type":"media_list","required":false,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Template image inputs. For ordered input fields, reserve images for required slots and fill remaining optional slots from left to right. Empty arguments must match that mapping; selections lost when empty paths are removed are rejected before upload or generation with validation exit code 6."},"video":{"flag":"--video","type":"media","required":false,"accepts":["local_path","https_url","asset_id","media_path"],"on_invalid":"reject","description":"Template video input."},"prompt":{"flag":"--prompt","type":"text","required":false,"accepts":["literal","local_file","stdin"],"on_invalid":"reject","description":"Prompt for templates that accept text."},"quality":{"flag":"--quality","type":"string","required":false,"default":"720p","unit":"output_resolution","on_invalid":"backend","description":"Template output quality."},"duration":{"flag":"--duration","type":"integer","required":false,"unit":"seconds","on_invalid":"backend","description":"Template output duration."},"aspect_ratio":{"flag":"--aspect-ratio","type":"string","required":false,"unit":"width:height","on_invalid":"backend","description":"Template output framing."},"off_peak":{"flag":"--off-peak","type":"boolean","required":false,"default":false,"on_invalid":"backend","description":"Use off-peak generation where the template supports it."}},"runtime_discovery":["pixverse template info --json"],"parameter_refs":["count","seed","idempotency_key","wait","timeout","json"]}}},"canvas":{"source":"runtime","discovery":{"merged_command":"pixverse capabilities canvas --json","raw_command":"pixverse capabilities canvas --raw --json","schema_command":"pixverse canvas node schema --node-type --json","adapter_contract_revision":"canvas_cli_capability_adapter.v2"}}},"bindings":{"canvas_cli":{"schema_version":"pixverse_canvas_cli_bindings.v1","items":[]}}}