核心用法
narrator-ai-cli 是 Narrator AI 平台的官方命令行客户端，专为AI Agent和开发者设计，用于自动化创建AI配音的影视解说视频。提供两种工作流：
- 快速路径（推荐）：search-movie → fast-writing → fast-clip-data → video-composing，适合热门影视二创，成本更低、速度更快
- 标准路径：popular-learning → generate-writing → clip-data → video-composing，适合自定义风格训练，质量更高
核心资源库包含93部预置电影（支持按类型筛选）、146首版权BGM、63种AI配音（覆盖11种语言）、90+种解说风格模板。所有任务异步执行，需轮询查询状态至完成。
显著优点
- 资源丰富：预置素材库大幅降低素材获取成本，支持上传自定义视频/SRT
- 双工作流灵活：快速路径适合追热点，标准路径适合深度定制
- 多语言支持：11种语言配音，含39种普通话音色
- 成本可控：提供
flash（5点/字）和pro（15点/字）两档模型，支持预算预估 - 机器友好：全命令支持
--json输出，SSE流式进度，3步分片上传大文件
潜在缺点与局限
- API Key依赖：需联系商务获取（微信/邮箱），非公开注册
- 异步任务延迟：
search-movie可能耗时60秒以上，Gradio后端偶发超时 - 学习曲线陡峭：工作流链条长，
order_num与task_id易混淆（常见错误：video-composing误用clip-data的order_num） - 点数计费不透明：点数消耗与字符数、模型档、视频长度挂钩，需提前用
task budget估算 - 模板覆盖有限：90+模板虽多，但小众题材可能无匹配风格
适合人群
- 短视频MCN机构批量生产影视解说
- 独立创作者追热点影视二创
- 出海内容团队制作多语言配音版本
- 开发者集成AI视频工作流到自动化平台
常规风险
- API Key泄露：存储于
~/.narrator-ai/config.yaml（权限0600），建议通过NARRATOR_APP_KEY环境变量注入 - 余额不足中断：错误码10009/10013，需预充值或监控余额
- 素材版权：预置电影素材仅限平台内使用，商用需确认授权范围
- 生成内容合规：AI解说可能涉及影视片段版权问题，需遵守平台内容政策