用途：gen-ai CLI 通过 Picsart API 在终端生成 AI 图像、视频和音频，并提供图像处理与批量生成能力。
主要能力：认证命令 login、logout、whoami；生成命令 generate、remove-bg、change-bg、enhance、vectorize、redo、extend；模型与计费命令 models、models info、models compare、pricing、credits、validate；批量命令 batch run、batch status、batch resume；Drive 命令 upload、upload-to-drive、download、list；配置命令 config get|set|list|keys|unset；历史命令 history 系列；工具命令 completion、update。
安装与认证：可用签名二进制 curl -fsSL https://picsart.com/gen-ai-cli/install.sh | bash，或 npm install -g @picsart/gen-ai（需 Node 22+），随后执行 gen-ai login 与 gen-ai whoami。注意 whoami 只读取本地缓存凭证，不检查过期也不联网，成功不代表后续网络命令可用。
用法示例：gen-ai generate -m flux-2-pro -p "a sunset over mountains" -s；图生图 gen-ai generate -m gemini-3.1-flash-image -i ~/photo.jpg -p "make it watercolor"；文生视频 gen-ai generate -m kling-v3-pro -p "a cat playing piano" --ar 16:9；图生视频 gen-ai generate -m veo-3.1 -i ~/photo.jpg -p "camera zooms in" -d 5。图像操作如 gen-ai remove-bg -i photo.jpg、gen-ai vectorize -i logo.png。
默认行为：结果默认保存到 Picsart Drive 的 gen-ai-cli 文件夹，可用 --no-save-to-drive 关闭，--drive-folder 指定文件夹；i2v 模型下 -i/--image 自动映射到 startFrame；--script 等于 --silent --quiet --json；CI 中应加 --no-input 避免交互挂起。
限制与注意：模型 ID 会变化，使用前先运行 gen-ai models 或 gen-ai validate -m <id>；向非 i2v 视频模型传 --image 会被静默忽略；--multi 与 --batch 互斥；AuthError 需重新登录，NetworkError 需恢复网络而非重登。SDK 集成、Picsart 网页小程序或移动端流程、尚未进入目录的新后端模型不在本工具范围内。更多细节见 references/FLAGS.md、BATCH.md、DRIVE.md、ADVANCED.md、TROUBLESHOOTING.md、EXAMPLES.md、COMPLETIONS.md。