libtv-skill

1# agent-im 会话（生图 / 生视频）
2 
3通过 agent-im 的 OpenAPI 创建会话、发送消息（生图、生视频、编辑视频等）、上传图片/视频文件，并查询会话消息进展。
4 
5LibTV 是 LiblibAI 推出的 AI 视频创作平台，同时为人类创作者和 Agent 设计。Agent 通过 Skill 入口理解任务、调用模型并自动编排工作流。
6 
7**平台核心能力：**
8- **生成**：文生图、文生视频、图生视频、视频续写
9- **编辑**：局部修改、元素替换、镜头调整、风格迁移
10- **复杂创作**：一句话生成完整短剧（剧本→分镜→成片）、复刻已有视频风格做 TVC/宣传片、用音乐生成 MV、产品展示片制作
11- **模型**：Seedance 2.0、Kling 3.0/O3、Wan 2.6、NanoBanana、Midjourney、Seedream 5.0 等顶级模型
12 
13用户的所有创作和编辑需求都通过发送自然语言消息来完成，Agent 会自主编排工作流。复杂任务（短剧、MV）耗时较长，需耐心轮询。
14 
15## 功能
16 
171. **创建会话 / 发消息** - 创建新会话或向已有会话发送一条消息（如「生一个动漫视频」「把纸船换成爱心」）
182. **查询会话进展** - 根据 sessionId 拉取该会话的消息列表，用于轮询生图/生视频结果
193. **切换项目** - 将当前 accessKey 绑定的项目切换到新项目，后续 create_session 将使用新 projectUuid
204. **上传文件** - 上传图片或视频文件到 OSS，返回可访问的 OSS 地址（编辑已有视频/图片时需要先上传）
215. **下载结果** - 将会话中生成的图片/视频批量下载到本地，自动提取 URL 并命名
22 
23## 前置要求
24 
25```bash
26export LIBTV_ACCESS_KEY="your-access-key"
27```
28 
29可选：`OPENAPI_IM_BASE` 或 `IM_BASE_URL`，默认 `https://im.liblib.tv`。
30 
31无需安装额外依赖，仅使用 Python 标准库。
32 
33## 使用方法
34 
35### 1. 创建会话 / 发送消息
36 
37```bash
38# 创建新会话并发送「生一个动漫视频」
39python3 {baseDir}/scripts/create_session.py "生一个动漫视频"
40 
41# 向已有会话发送消息
42python3 {baseDir}/scripts/create_session.py "再生成一张风景图" --session-id SESSION_ID
43 
44# 只创建/绑定会话，不发消息
45python3 {baseDir}/scripts/create_session.py
46```
47 
48### 2. 查询会话进展
49 
50```bash
51# 查询会话消息列表
52python3 {baseDir}/scripts/query_session.py SESSION_ID
53 
54# 增量拉取（只返回 seq 大于 N 的消息）
55python3 {baseDir}/scripts/query_session.py SESSION_ID --after-seq 5
56 
57# 附带项目地址（传入 create_session 返回的 projectUuid，结果中带 projectUrl）
58…