libtv-skills

概览

GitHubGitHub

**libtv-skills** 是一组面向 AI Agent 的技能包（Skills），基于 Python 编写，遵循 OpenClaw 技能规范。它通过 LibLib.tv 的 OpenAPI 为支持该规范的 AI Agent 平台提供 AI 生图、AI 生视频等 AIGC 能力。 ### 解决什么问题 AI Agent 在接收到用户的创作指令后，需要与外部 AIGC 服务进行交互。libtv-skills 封装了与 LibLib.tv 通信的完整流程，包括创建会话、发送指令、轮询进度、上传素材和下载结果，使 Agent 无需从零对接 API 即可完成图像和视频生成任务。 ### 主要能力 - **会话管理**：创建新会话或向已有会话追加消息，获取 sessionId 和 projectUuid。 - **进度查询**：查询会话消息列表，支持通过 `--after-seq` 参数进行增量拉取，适合轮询场景。 - **文件上传**：将图片或视频文件上传至 OSS，获取 URL 后可作为参考素材传入消息。 - **结果下载**：从会话中自动提取并批量下载生成的图片/视频到本地，支持指定输出目录和文件名前缀。 - **项目切换**：切换当前 accessKey 绑定的项目，用于隔离不同任务。 ### 技术细节 所有脚本仅依赖 Python 3.6+ 标准库，无需安装额外第三方依赖。API 请求通过 HTTP Header 中的 Bearer Token 进行鉴权。项目结构包含一个 `libtv-skill` 技能文件夹，内含 `SKILL.md` 描述文件和多个功能脚本（如 `create_session.py`、`query_session.py` 等）。 ### 适合谁 适用于正在开发或配置 AI Agent 的开发者，尤其是使用支持 OpenClaw 规范平台的用户，希望让 Agent 具备调用 LibLib.tv 进行图像和视频生成的能力。

Q&A

使用前需要配置什么？由 AI 生成

必须设置环境变量 LIBTV_ACCESS_KEY 作为 LibTV API 的鉴权密钥。可选配置 IM 服务地址 OPENAPI_IM_BASE 或 IM_BASE_URL，默认值为 https://im.liblib.tv。

如何安装这个技能包？由 AI 生成

可以通过 npx skills add libtv-labs/libtv-skills 交互式安装，或使用 --skill libtv-skill 参数直接安装指定技能。安装后设置环境变量即可被 Agent 自动识别。

运行这些脚本需要什么环境？由 AI 生成

需要 Python 3.6 及以上版本。所有脚本仅使用 Python 标准库，不需要通过 pip 安装任何额外依赖。

上传文件支持哪些格式？由 AI 生成

仅支持图片（image/*）和视频（video/*）类型的文件，其他类型会被拒绝。

Agent 的典型工作流是怎样的？由 AI 生成

用户发出指令后，Agent 调用 create_session.py 发送指令并获取 sessionId，接着轮询 query_session.py 获取结果，完成后用 download_results.py 批量下载到本地，最后向用户展示结果和项目画布链接。