LibTV API Skills

核心用法

LibTV Skill 是 LiblibAI 官方推出的 AI 图片/视频创作工具，通过自然语言交互完成复杂创意任务。

生成能力：支持文生图、文生视频、图生视频、视频续写延长，涵盖 Seedance 2.0、Kling 3.0/O3、Wan 2.6、Midjourney 等顶级模型。

编辑能力：局部修改、元素替换（如"把纸船换成爱心"）、镜头调整、风格迁移/转绘，支持上传参考图/视频进行精准编辑。

复杂工作流：一句话生成完整短剧（剧本→分镜→成片）、复刻视频风格制作 TVC/宣传片、音乐驱动 MV 生成、产品广告片制作、分镜故事板设计。

使用模式：创建会话发送自然语言指令 → 轮询查询进展 → 自动下载结果。用户侧 Agent 仅作为"搬运工"，不做 prompt 扩写或任务拆解，后端 Agent 自主编排工作流。

显著优点

• 零依赖部署：纯 Python 标准库实现，无第三方包依赖，开箱即用
• 官方权威背书：LiblibAI 出品，模型接入专业，工作流编排智能
• 端到端复杂创作：从一句描述直接产出完整短剧、MV 或广告片，无需人工分镜
• 灵活编辑范式：支持"把xxx换成yyy"等直观自然语言编辑，降低专业门槛
• 结果可溯源：生成内容附带项目画布链接，支持二次编辑和版本管理

潜在缺点与局限性

• 生成耗时较长：复杂任务（短剧、MV）可能需要数分钟，需轮询等待
• 云端依赖：所有计算在 LibTV 云端完成，断网不可用，高峰期可能排队
• 文件外传风险：上传的参考图/视频需传输至 LibTV OSS，敏感素材需谨慎
• 可控性边界：后端 Agent 自主决策模型选择和 prompt 工程，用户无法细调参数
• 成本不透明：依赖 API 密钥授权，实际计费模式需查阅 LibTV 官方文档

适合人群

• 短视频/短剧创作者：快速生成剧本分镜、成片素材
• 广告/营销从业者：一句话产出产品展示片、TVC 风格复刻
• 独立艺术家/音乐人：音乐驱动 MV 生成、风格实验
• 教育/培训内容生产者：教学视频、故事板快速制作
• 设计团队：海报、角色设定、分镜预演

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 数据外泄 | 文件上传至 LibTV 云端 OSS | 确认平台隐私政策，避免上传敏感机密素材 |

| 密钥管理 | API Key 通过环境变量传递 | 使用后立即 `unset`，勿写入持久化配置文件 |

| 版权争议 | AI 生成内容的商用授权边界 | 查阅 LibTV 服务条款，保留原始素材权利证明 |

| 内容安全 | 生成内容可能触发平台审核 | 遵守法律法规，避免生成违规素材 |

| 服务可用性 | 依赖第三方云服务稳定性 | 关键任务预留本地备选方案 |

使用建议

• 明确边界：信任后端 Agent 的专业性，用户侧不做 prompt 工程越俎代庖
• 及时取件：任务完成后自动下载结果，避免云端链接过期
• 项目隔离：复杂任务建议新建项目，便于后续版本管理和协作分享

核心用法

LibTV-Skill 是 LiblibAI 官方推出的 AI 视频创作 Agent 入口，通过 OpenAPI 与后端专业创作 Agent 协作完成复杂任务。用户侧无需掌握 prompt 工程，只需用自然语言描述需求（如"生成动漫视频""把纸船换成爱心""用这首歌做 MV"），Skill 自动完成上传、传话、取件全流程。

核心能力矩阵：

• 生成类：文生图、文生视频、图生视频、视频续写延长
• 编辑类：局部修改、元素替换（把 X 换成 Y）、镜头调整、风格迁移
• 复杂创作：一句话生成短剧（剧本→分镜→成片）、复刻视频/TVC 风格、音乐 MV 生成、产品广告片、分镜故事板设计

典型工作流：
1. 纯生成：create_session.py "描述" → 轮询 → 下载 → 展示
2. 编辑任务：upload_file.py 上传参考 → create_session.py "编辑指令+OSS_URL" → 轮询 → 下载
3. 追加需求：同一 session-id 继续发送新消息

显著优点

• 零创作门槛：用户无需写 prompt、拆任务、选模型，后端专业 Agent 自动编排工作流
• 顶级模型池：Seedance 2.0、Kling 3.0/O3、Wan 2.6、Midjourney、Seedream 5.0 等即调即用
• 纯净无依赖：仅用 Python 标准库（urllib/json/os），零供应链攻击面
• 来源高度可信：LiblibAI 是国内头部 AI 创作平台，T2 级别可信组织
• 企业级安全：HTTPS 全程加密、文件类型白名单（image/+video/）、200MB 大小限制、无危险函数

潜在缺点与局限性

• 耗时较长：复杂任务（短剧、MV）需数分钟至数十分钟，需耐心轮询或异步查看
• 外部依赖：必须联网访问 liblib.tv 官方 API，无法离线使用
• 密钥管理：需配置 LIBTV_ACCESS_KEY，企业场景需额外密钥轮换机制
• 创意黑盒：用户无法干预后端 Agent 的模型选择、prompt 编写、分镜拆解逻辑
• 平台锁定：生成结果托管于 LiblibAI 生态，跨平台迁移需手动导出

适合人群

• 内容创作者：短视频博主、短剧团队、广告制作方，需快速产出视觉素材
• 营销人员：产品展示片、TVC 复刻、宣传片一键生成
• 教育工作者：课件视频、分镜故事板、教学动画制作
• 开发者/Agent 构建者：需在 IM/对话系统中集成 AI 视频能力的工程团队

常规风险

• 密钥泄露：LIBTV_ACCESS_KEY 若硬编码或日志泄露，可能导致账户被盗用
• 网络中间人：虽使用 HTTPS，但企业环境需确保根证书可信、无恶意代理
• 生成内容合规：AI 生成内容可能涉及版权、肖像权、虚假信息风险，需人工审核后发布
• 文件下载目录：默认下载至 ~/Downloads/libtv_results/，多用户环境需权限隔离