核心用法
pixcli 是面向AI代理的统一创意工具集，通过自然语言描述即可生成图像、视频、音频、播客等全类型数字资产。CLI 自动完成任务分类→提示词增强→模型选择→结果输出的完整链路，用户无需管理多模型配置。
典型工作流：
1. 素材生成：pixcli image 生成静态图（支持 SVG 矢量化），pixcli video 生成动态视频（I2V/T2V/扩展），pixcli voice/music/sfx 生成音轨
2. 智能编辑：pixcli edit 实现背景移除、风格迁移、身份保持编辑；pixcli removebg 处理视频抠像；pixcli tryon 虚拟试穿
3. 播客工厂：pixcli podcast 单命令完成选题→脚本（Google Search 实时 grounding）→双主播配音→配乐→封面→分享页的全流程
4. 视频组装：通过 Remotion 模板将AI素材整合为专业成片，支持 6 套预设模板（产品营销/SaaS 数据/短视频等）
关键特性：
- 模型自动路由：Nano Banana（Gemini 图像）、GPT-Image-2（文字渲染）、Veo 3.1（视频）、Seedance 2（电影级运动）、Kontext（身份保持）等自动择优调用
- 非阻塞执行：视频生成支持
--no-wait异步提交，避免代理超时，通过pixcli job <id>轮询状态 - 成本优化：
--json模式减少 90% token 消耗，-q draft快速迭代后再渲染成片
显著优点
| 维度 | 优势 |
|------|------|
| **统一接口** | 单一 CLI 覆盖图像/视频/音频/播客四大品类，告别多工具切换 |
| **智能提示** | 自动任务分类与模型特定提示重写（描述性散文 vs 指令式结构） |
| **生产级播客** | 自动脚本撰写、实时信息 grounding、双声部配音、专业混音、封面生成、分享页托管 |
| **视频生态** | 原生支持 Veo 3.1 音视频同步生成，Seedance 2 电影级运动，Bria 视频抠像透明通道输出 |
| **Remotion 集成** | 6 套专业模板 + React 代码级控制，实现 AI 素材的精确时间线组装 |
| **成本透明** | JSON 输出含精确计费（credits），草稿模式降低迭代成本 |
潜在局限
- 视频耗时：高清视频生成需 5-10 分钟，必须配合
--no-wait异步模式，否则触发代理超时 - 双声部限制：
pixcli dialogue与播客功能仅支持最多 2 名说话人，多角色场景需手动拼接 - 网络依赖：所有生成任务依赖 pixcli.shellbot.sh 后端，离线不可用
- 成本累积：高清 4K 视频、长时长音乐生成 credits 消耗较高，需关注预算
- 提示工程门槛：视频生成需遵循 60-100 词的结构化公式（Subject→Action→Environment→Camera→Style→Constraints），自由描述易产出不一致结果
适合人群
- AI 原生创作者：需要快速原型→成品的全自动化管线
- 营销团队：产品视频、社交广告、品牌播客的高频批量生产
- 独立开发者：为应用/游戏生成图标、宣传素材、背景音轨
- 内容创作者：短视频脚本 + AI 素材 + 自动配音的一站式工作流
常规风险
| 风险类别 | 说明 | 缓解建议 |
|----------|------|----------|
| **API 密钥泄露** | `METERKEY_API_KEY` 需注入环境变量，硬编码有泄露风险 | 使用 secret 管理工具，避免提交到版本控制 |
| **生成内容合规** | AI 生成图像/视频可能存在版权、肖像、深度伪造争议 | 商用前人工审核，避免直接生成真实人物 |
| **成本失控** | 4K 视频、批量播客生成 credits 消耗快 | 先用 `-q draft` 验证，监控 JSON 输出中的 `cost` 字段 |
| **异步任务丢失** | 代理超时后需正确解析 `job_id` 恢复，否则重复提交 | 始终捕获并持久化 `job_id`，使用 `pixcli job <id> --wait` 恢复 |
| **依赖供应链** | npm/npx、Node.js 版本、后端 API 可用性 | 锁定 Node ≥18，监控 pixcli.shellbot.sh 状态 |
安全与可信度评估
- 代码执行安全：CLI 仅作为 HTTP 客户端与 API 通信，不执行任意代码；允许的工具严格限定于
pixcli、remotion、ffmpeg等白名单命令 - 网络隔离：所有模型提供商（fal、Google、OpenAI、ElevenLabs）由服务端调用，CLI 不直接接触第三方 API
- 输出验证：
--json模式返回结构化数据，便于程序化校验与审计
---
> 最佳实践速记：export PIXCLI_JSON=1 开启 JSON 模式 → 图片/音频用默认阻塞模式 → 视频必加 --no-wait → 通过 job_id 轮询 → 成品用 Remotion 组装。