libtv-labs-libtv-skills

前置要求

• Python 3.6+（仅使用标准库，无需安装额外依赖）
• LIBTV_ACCESS_KEY 环境变量已设置

创建会话 & 发送生成指令

# 创建新会话，发送「生一个动漫视频」
python3 skills/libtv-skill/scripts/create_session.py "生一个动漫视频"

# 向已有会话追加消息
python3 skills/libtv-skill/scripts/create_session.py "再生成一张风景图" --session-id <SESSION_ID>

# 只创建/绑定会话，不发消息
python3 skills/libtv-skill/scripts/create_session.py

输出示例：

{
  "projectUuid": "aa3ba04c5044477cb7a00a9e5bf3b4d0",
  "sessionId": "90f05e0c-5d08-4148-be40-e30fc7c7bedf",
  "projectUrl": "https://www.liblib.tv/canvas?projectId=aa3ba04c5044477cb7a00a9e5bf3b4d0"
}

查询会话进展

# 查询会话消息列表
python3 skills/libtv-skill/scripts/query_session.py <SESSION_ID>

# 增量拉取（只返回 seq > N 的新消息，适合轮询）
python3 skills/libtv-skill/scripts/query_session.py <SESSION_ID> --after-seq 5

# 附带项目地址
python3 skills/libtv-skill/scripts/query_session.py <SESSION_ID> --project-id <PROJECT_UUID>

输出示例：

{
  "messages": [
    { "id": "msg-xxx", "role": "user", "content": "生一个动漫视频" },
    { "id": "msg-yyy", "role": "assistant", "content": "..." }
  ],
  "projectUrl": "https://www.liblib.tv/canvas?projectId=..."
}

切换项目

# 切换当前 accessKey 绑定的项目
python3 skills/libtv-skill/scripts/change_project.py

输出示例：

{
  "projectUuid": "新项目UUID",
  "projectUrl": "https://www.liblib.tv/canvas?projectId=新项目UUID"
}

上传文件

# 上传图片
python3 skills/libtv-skill/scripts/upload_file.py /path/to/image.png

# 上传视频
python3 skills/libtv-skill/scripts/upload_file.py /path/to/video.mp4

输出示例：

{
  "url": "https://libtv-res.liblib.art/claw/{projectUuid}/{uuid}.png"
}

下载结果

# 从会话自动提取并下载所有图片/视频
python3 skills/libtv-skill/scripts/download_results.py <SESSION_ID>

# 指定输出目录
python3 skills/libtv-skill/scripts/download_results.py <SESSION_ID> --output-dir ~/Desktop/my_project

# 指定文件名前缀（如 storyboard_01.png, storyboard_02.png ...）
python3 skills/libtv-skill/scripts/download_results.py <SESSION_ID> --prefix "storyboard"

# 直接下载指定 URL 列表（无需 session_id）
python3 skills/libtv-skill/scripts/download_results.py --urls URL1 URL2 URL3 --output-dir ./output

输出示例：

{
  "output_dir": "/Users/xxx/Downloads/libtv_results",
  "downloaded": ["/Users/xxx/Downloads/libtv_results/01.png", "..."],
  "total": 9
}

Request Body:

{
  "sessionId": "（可选）已有会话 ID",
  "message": "（可选）要发送的消息内容"
}

Response:

{
  "data": {
    "projectUuid": "aa3ba04c5044477cb7a00a9e5bf3b4d0",
    "sessionId": "90f05e0c-5d08-4148-be40-e30fc7c7bedf"
  }
}