核心用法
lovart-api 是 Lovart AI 平台的命令行代理技能，用于将自然语言转化为图像、视频、音频等数字资产。用户通过 chat 命令发送描述，后端 Agent 自动选择最优模型（GPT Image、Midjourney、Kling、Seedance 等）完成生成。
典型工作流：
1. 首次配置：运行 config --json 检查本地状态，若无活跃项目则通过 project-add 创建
2. 智能续聊：执行 threads --json 获取最近对话，相关主题复用 thread-id，全新主题创建新线程
3. 生成内容：使用 chat --prompt "描述" --json --download 提交请求，自动轮询至完成
4. 结果交付：下载的文件通过 downloaded[].local_path 发送给用户，并附加项目画布链接
高级功能：
- 模式切换：
set-mode --fast（消耗积分、无队列）或set-mode --unlimited（免费、可能排队） - 模型指定：
--prefer-models偏好选择、--include-tools强制约束特定工具 - 推理模式：
--mode thinking用于复杂品牌系统等多步骤规划，--mode fast用于快速单图生成 - 流式输出：
watch命令支持 NDJSON 实时推送，适合多图/视频批量生成场景 - 附件编辑：先
upload本地文件获取 CDN 地址，再chat --attachments实现图生图、视频编辑
显著优点
- 零门槛创作：无需学习 Prompt 工程，直接描述需求即可，后端 Agent 自动优化并路由至最佳模型
- 全模态覆盖：图像（20+ 模型）、视频（Kling、Sora、Veo 等）、音频/音乐一站式生成
- 上下文感知：Thread 机制保留多轮对话记忆，支持迭代优化（"把背景换成海滩"）
- 灵活计费策略：Fast 模式即时出图适合商业交付，Unlimited 模式免费适合探索性创作
- 专业级控制：支持精确模型选择、Upscale 超分、3D 生成、硬约束工具调用，满足精细需求
潜在缺点与局限性
- 积分消耗风险：视频生成、GPT Image High 等高质量选项消耗大量积分，需用户确认（
pending_confirmation） - 内容审核限制：涉及武器、敏感身体的复杂描述可能被模型拒绝，返回
done但无产物，需换模型或简化提示词 - 队列等待时间：Unlimited 模式下高峰期可能长时间排队，Fast 模式需持续购买积分
- 认证依赖：必须配置
LOVART_ACCESS_KEY和LOVART_SECRET_KEY，AK/SK 错误将导致 401 失败 - 线程模式锁定：首次消息的
--mode决定整个 Thread 的推理深度，中途无法切换，需新建线程
适合人群
- 视觉创作者：插画师、设计师快速产出概念稿、海报、品牌素材
- 社交媒体运营：批量生成短视频、轮播图、BGM 及封面
- 开发者与自动化工作流：通过命令行集成 AI 生成能力到 CI/CD、批处理脚本
- 电商与广告：产品图生成、模特换装、视频广告素材快速迭代
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| **积分误消耗** | 高成本操作（视频、高清图）未确认即执行 | 严格遵守 `pending_confirmation` 流程，显式询问用户 |
| **并发冲突** | 同一线程同时运行多个任务导致 409 错误 | 每次 `chat` 前检查 `status`，确保前序任务完成 |
| **密钥泄露** | AK/SK 环境变量配置不当 | 使用安全秘钥管理，避免硬编码 |
| **内容合规** | 生成内容触发平台风控 | 避免敏感描述，被拒后换用 `nano_banana_pro` 等宽松模型 |
| **本地状态丢失** | `~/.lovart/state.json` 损坏导致项目/线程混乱 | 定期备份，异常时手动指定 `--project-id` 和 `--thread-id` |