LibTV Skill Pro — LibTV 技能 Pro

代理-im 会话（生图 / 生视频）

Fork of @haofanwang/libtv-技能 — 保留 6 个基础脚本（创建_会话 / 查询_会话 / change_project / 上传_file / 下载_结果s / _common），扩展 7 个高级工作流脚本（manage_project / batch_创建 / 监控_会话 / quick_poll / 工作流_template / 导出_结果s / 会话_历史）。

通过 代理-im 的 OpenAPI 创建会话、发送消息（生图、生视频、编辑视频等）、上传图片/视频文件，并查询会话消息进展。

LibTV 是 LiblibAI 推出的 AI 视频创作平台，同时为人类创作者和 代理 设计。代理 通过 技能 入口理解任务、调用模型并自动编排工作流。

平台核心能力：

生成：文生图、文生视频、图生视频、视频续写 编辑：局部修改、元素替换、镜头调整、风格迁移 复杂创作：一句话生成完整短剧（剧本→分镜→成片）、复刻已有视频风格做 TVC/宣传片、用音乐生成 MV、产品展示片制作 模型：种子ance 2.0、Kling 3.0/O3、Wan 2.6、NanoBanana、Midjourney、种子ream 5.0 等顶级模型

用户的所有创作和编辑需求都通过发送自然语言消息来完成，代理 会自主编排工作流。复杂任务（短剧、MV）耗时较长，需耐心轮询。

功能 创建会话 / 发消息 - 创建新会话或向已有会话发送一条消息（如「生一个动漫视频」「把纸船换成爱心」） 查询会话进展 - 根据 会话Id 拉取该会话的消息列表，用于轮询生图/生视频结果 切换项目 - 将当前 访问Key 绑定的项目切换到新项目，后续 创建_会话 将使用新 projectUuid 上传文件 - 上传图片或视频文件到 OSS，返回可访问的 OSS 地址（编辑已有视频/图片时需要先上传） 下载结果 - 将会话中生成的图片/视频批量下载到本地，自动提取 URL 并命名 高级功能 批量创建任务 - 同时发起多个生图/生视频任务，支持并发控制和任务队列 实时监控 - 持续监控会话消息进展，支持多种输出格式和 URL 提取 快速轮询 - 简化版轮询工具，自动等待直到任务完成 工作流模板 - 预设常用工作流（分镜生成、角色设计、短剧制作等） 结果导出 - 导出会话结果为 JSON/Markdown/HTML 格式 会话历史 - 管理常用会话，快速查看历史记录 项目管理 - 多项目管理，快速切换和查看项目列表 前置要求 导出 LIBTV_访问_KEY="your-访问-key"

可选：OPENAPI_IM_BASE 或 IM_BASE_URL，默认 https://im.liblib.tv。

无需安装额外依赖，仅使用 Python 标准库。

使用方法

• 创建会话 / 发送消息

# 创建新会话并发送「生一个动漫视频」 python3 {baseDir}/scripts/创建_会话.py "生一个动漫视频"

# 向已有会话发送消息 python3 {baseDir}/scripts/创建_会话.py "再生成一张风景图" --会话-id 会话_ID

# 只创建/绑定会话，不发消息 python3 {baseDir}/scripts/创建_会话.py

• 查询会话进展

# 查询会话消息列表 python3 {baseDir}/scripts/查询_会话.py 会话_ID

# 增量拉取（只返回 seq 大于 N 的消息） python3 {baseDir}/scripts/查询_会话.py 会话_ID --after-seq 5

# 附带项目地址（传入 创建_会话 返回的 projectUuid，结果中带 projectUrl） python3 {baseDir}/scripts/查询_会话.py 会话_ID --project-id PROJECT_UUID

• 切换项目

# 切换当前 访问Key 绑定的项目（后续创建会话将使用新项目） python3 {baseDir}/scripts/change_project.py

• 上传文件

当用户提供了参考的文件地址时，进行上传，仅支持图片、视频，文件大小必须在200M以下。

# 上传图片 python3 {baseDir}/scripts/上传_file.py /path/to/image.png

# 上传视频 python3 {baseDir}/scripts/上传_file.py /path/to/video.mp4

• 下载结果

生成完成后，可以将会话中的所有图片/视频批量下载到本地。

# 从会话自动提取并下载所有结果 python3 {baseDir}/scripts/下载_结果s.py 会话_ID

# 指定输出目录 python3 {baseDir}/scripts/下载_结果s.py 会话_ID --输出-dir ~/桌面/my_project

# 指定文件名前缀（如 storyboard_01.png, storyboard_02.png ...） python3 {baseDir}/scripts/下载_结果s.py 会话_ID --prefix "storyboard"

# 直接下载指定 URL 列表（不需要 会话_id） python3 {baseDir}/scripts/下载_结果s.py --urls URL1 URL2 URL3 --输出-dir ./输出

• 批量创建任务

同时发起多个生图/生视频任务，支持并发控制。

# 从文件批量创建（每行一个任务描述） python3 {baseDir}/scripts/batch_创建.py --file tasks.txt

# 直接指定多个任务 python3 {baseDir}/scripts/batch_创建.py -m "生成猫的图片" -m "生成狗的图片" -m "生成鸟的图片"

# 限制并发数 python3 {baseDir}/scripts/batch_创建.py --file tasks.txt --workers 3 --输出 结果s.json

• 实时监控

持续监控会话消息进展，支持多种输出格式。

# 基本监控 python3 {baseDir}/scripts/监控_会话.py 会话_ID

# 轮询模式（每 10 秒查询一次） python3 {baseDir}/scripts/监控_会话.py 会话_ID --poll --interval 10

# 只显示助手消息并提取 URL python3 {baseDir}/scripts/监控_会话.py 会话_ID --poll --角色 助手 --提取-urls

# JSON 格式输出并保存 python3 {baseDir}/scripts/监控_会话.py 会话_ID --poll --格式化 json --输出 记录.json

• 快速轮询

简化版轮询工具，自动等待直到任务完成。

# 基本轮询（默认间隔 8 秒，超时 10 分钟） python3 {baseDir}/scripts/quick_poll.py 会话_ID

# 自定义间隔和超时 python3 {baseDir}/scripts/quick_poll.py 会话_ID --interval 5 --timeout 300

# 安静模式（只输出最终结果） python3 {baseDir}/scripts/quick_poll.py 会话_ID --quiet

• 工作流模板

预设常用工作流，快速创建标准任务。

# 列出所有模板 python3 {baseDir}/scripts/工作流_template.py --列出

# 使用分镜模板 python3 {baseDir}/scripts/工作流_template.py storyboard "科幻城市的故事"

# 使用角色设计模板 python3 {baseDir}/scripts/工作流_template.py character_de签名 "勇敢的骑士"

# 使用短剧模板（自动生成完整短剧） python3 {baseDir}/scripts/工作流_template.py short_drama "友情故事"

# 使用已有会话 python3 {baseDir}/scripts/工作流_template.py video_generation "夕阳下的海滩" --会话-id 会话_ID

可用模板： storyboard, character_de签名, video_generation, image_generation, style_transfer, short_drama, music_video, product_showcase

• 结果导出

导出会话结果为多种格式。

# JSON 格式导出（默认） python3 {baseDir}/scripts/导出_结果s.py 会话_ID

# Markdown 格式 python3 {baseDir}/scripts/导出_结果s.py 会话_ID --格式化 markdown --输出 报告.md

# HTML 格式（包含图片/视频预览） python3 {baseDir}/scripts/导出_结果s.py 会话_ID --格式化 html --输出 报告.html

# 只导出 URL 列表 python3 {baseDir}/scripts/导出_结果s.py 会话_ID --urls-only

• 会话历史

管理常用会话，快速查看历史记录。

# 列出所有会话 python3 {baseDir}/scripts/会话_历史.py 列出

# 添加会话记录 python3 {baseDir}/scripts/会话_历史.py 添加 会话_ID --project-id PROJECT_UUID --desc "项目描述"

# 查看会话详情 python3 {baseDir}/scripts/会话_历史.py show 1

# 获取会话 ID（用于脚本） python3 {baseDir}/scripts/会话_历史.py 获取 1

# 删除会话记录 python3 {baseDir}/scripts/会话_历史.py 移除 1