核心用法
lovart-api 是 Lovart AI 平台的官方技能封装，提供自然语言驱动的多模态内容生成能力。用户通过 chat 命令发送描述，后端 Agent 自动选择最优模型（Midjourney、Kling、Sora、Veo 等 20+ 模型）完成图像、视频、音频生成。
关键工作流：
1. 首次初始化：config --json 检查项目状态 → threads --json 复用或新建对话线程
2. 内容生成：chat --prompt "描述" --json --download 阻塞等待完成，自动下载文件
3. 高成本确认：视频生成需显式用户确认（pending_confirmation 状态），使用 confirm 命令继续
4. 模式切换：set-mode --fast（消耗积分免排队）或 --unlimited（免费但可能排队）
5. 模型精确指定：--prefer-models 偏好推荐 vs --include-tools 强制约束
进阶功能：
watch流式输出适合批量生成场景，实时交付每个完成项upload本地上传 → CDN URL，支持以图生图/视频编辑- 项目（Project）与线程（Thread）双层级管理，自动状态持久化
显著优点
- 全模型覆盖：图像（Midjourney/Flux/Seedream/GPT Image/Imagen）、视频（Kling/Veo/Sora/Seedance/Wan）、3D（Tripo）一站集成
- 智能路由：无需学习模型差异，自然语言描述由 Agent 自动匹配最优工作流
- 上下文继承：多轮对话线程保留历史生成结果，支持迭代精修
- 工程化设计：AK/SK 签名认证、自动重试、SSL 降级、幂等同步，适合生产环境
- 灵活成本控制：Fast/Unlimited 双模式，显式高成本确认机制防误操作
潜在局限
- 并发限制：单账户存在并发任务上限（错误码 1200000200），需串行执行
- 积分体系：Fast 模式消耗积分，免费额度有限；错误处理需向用户解释余额/订阅状态
- 视频延迟：视频生成耗时数分钟，长等待可能影响交互体验
- 环境依赖：必须配置
LOVART_ACCESS_KEY和LOVART_SECRET_KEY，无密钥无法降级运行 - 状态耦合：强制要求首次使用前检查
config和threads，流程侵入性较强
适合人群
- 设计师/创意工作者：快速原型视觉概念，支持从草图到高保真的迭代
- 内容运营：批量生成社交媒体素材（海报、Banner、短视频），支持流式交付
- 开发者/自动化场景：需要程序化调用多模态 AI 的集成方案
- 多语言用户：原生支持中英日韩等多语言提示词，Agent 自动处理
常规风险
- 账户安全：AK/SK 泄露可导致积分被盗用，需妥善保管环境变量
- 成本失控：视频生成未显式确认可能意外消耗大量积分
- 版权模糊：AI 生成内容的商用授权需遵守各模型底层条款
- 生成不确定性：同一提示词多次运行结果可能差异显著，不适合要求 pixel-perfect 的场景
- 服务依赖：第三方平台可用性、模型下架或政策变更可能影响功能