# liblibtv-skills

**Repository Path**: Darchrow-Mu/liblibtv-skills

## Basic Information

- **Project Name**: liblibtv-skills
- **Description**: claude code skills，调用libtv的api实现图片和视频生成，可以控制使用的模型、品质、时长等
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-05-04
- **Last Updated**: 2026-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LiblibTV Skills - AI 图片/视频生成技能

通过 LiblibTV API 实现 AI 图片和视频创作、编辑、转换的 Claude Code 技能。

## 功能概览

| 功能 | 说明 | 支持模型 |
|------|------|---------|
| 🖼️ 文生图 | 文字描述生成图片 | Seedream, Midjourney, NanoBanana |
| 🎬 文生视频 | 文字描述生成视频 | Seedance, Kling, Wan |
| 🔄 图生视频 | 图片生成动态视频 | Seedance, Kling, Wan |
| ✨ 图生图 | 图片变体/风格转换 | Seedream, Midjourney |
| ✏️ 视频编辑 | 局部修改、元素替换 | 全部视频模型 |
| ⏩ 视频延长 | 继续生成视频后续 | 全部视频模型 |

## 快速开始

### 1. 配置 API Key

```bash
# 添加到 shell 配置文件 (~/.bashrc 或 ~/.zshrc)
export LIBTV_ACCESS_KEY="your-access-key-here"

# 可选：自定义 API 地址
export LIBTV_BASE_URL="https://im.liblib.tv"
```

> **如何获取 Access Key？**
> 1. 访问 [LiblibAI](https://www.liblib.art/) 注册账号
> 2. 进入开发者中心申请 API Access Key

### 2. 使用技能

```bash
# 激活技能
cd ~/.claude/skills/liblibtv-skills

# 快速生成
cd /Users/darchrow/.claude/skills/liblibtv-skills && python3 scripts/create_session.py "生成一张未来城市的图片"

# 交互式引导
cd /Users/darchrow/.claude/skills/liblibtv-skills && python3 scripts/create_session.py
```

### 3. 查看结果

```bash
# 轮询获取结果
cd /Users/darchrow/.claude/skills/liblibtv-skills && python3 scripts/query_session.py SESSION_ID --poll

# 下载结果
cd /Users/darchrow/.claude/skills/liblibtv-skills && python3 scripts/download_results.py SESSION_ID
```

## 脚本说明

### create_session.py - 创建会话/发送消息

```bash
# 创建新会话并发送消息
python3 scripts/create_session.py "生成猫咪图片"

# 向已有会话追加消息
python3 scripts/create_session.py "再生成一张" --session-id SESSION_ID

# 发送原始消息（不追加配置）
python3 scripts/create_session.py "原始消息" --raw
```

### query_session.py - 查询会话消息

```bash
# 查询历史消息
python3 scripts/query_session.py SESSION_ID

# 增量查询（从 seq=5 之后）
python3 scripts/query_session.py SESSION_ID --after-seq 5

# 轮询等待结果（每8秒查询，最多180秒）
python3 scripts/query_session.py SESSION_ID --poll
```

### upload_file.py - 上传文件

```bash
# 上传图片
python3 scripts/upload_file.py /path/to/image.png

# 上传视频
python3 scripts/upload_file.py /path/to/video.mp4

# 输出: {"url": "https://libtv-res.liblib.art/..."}
```

### download_results.py - 下载结果

```bash
# 从会话下载所有结果
python3 scripts/download_results.py SESSION_ID

# 指定输出目录
python3 scripts/download_results.py SESSION_ID --output-dir ~/Downloads/libtv

# 添加文件名前缀
python3 scripts/download_results.py SESSION_ID --prefix "storyboard_"

# 直接下载指定URL
python3 scripts/download_results.py --urls URL1 URL2 URL3
```

### change_project.py - 切换项目

```bash
# 切换到新项目
python3 scripts/change_project.py
```

## 典型工作流

### 1. 文生图/文生视频

```bash
# 步骤1: 创建会话
result=$(python3 scripts/create_session.py "生成一张赛博朋克城市的图片")
session_id=$(echo $result | jq -r '.sessionId')
project_id=$(echo $result | jq -r '.projectUuid')

# 步骤2: 轮询等待结果
python3 scripts/query_session.py "$session_id" --poll

# 步骤3: 下载结果
python3 scripts/download_results.py "$session_id" --output-dir ~/Downloads/generation
```

### 2. 图生视频

```bash
# 步骤1: 上传参考图
upload_result=$(python3 scripts/upload_file.py /path/to/image.png)
oss_url=$(echo $upload_result | jq -r '.url')

# 步骤2: 发送图生视频请求
python3 scripts/create_session.py "让这张图片动起来，参考图: $oss_url"
```

### 3. 视频编辑

```bash
# 步骤1: 上传视频
upload_result=$(python3 scripts/upload_file.py /path/to/video.mp4)
oss_url=$(echo $upload_result | jq -r '.url')

# 步骤2: 发送编辑指令
python3 scripts/create_session.py "把视频里的汽车换成红色，参考视频: $oss_url"
```

## 模型说明

### Seedance（即梦视频）
- **开发商**：字节跳动
- **优势**：古风/国风、中文理解强、9:16短视频优化
- **适用**：抖音/TikTok内容、中国风视频

### Kling（可灵）
- **开发商**：快手
- **优势**：运镜专业、电影感、大场面
- **适用**：电影级短片、广告片

### Wan（通义万相）
- **开发商**：阿里巴巴
- **优势**：物理规律准确、动作流畅
- **适用**：写实场景、动作片

### Seedream
- **开发商**：字节跳动
- **优势**：图片质量高、风格多样
- **版本**：5.0 Lite（默认）, 5.0 Pro

## 提示词技巧

本技能自动追加默认配置，你也可以参考 [video-prompt-optimizer](../video-prompt-optimizer) 技能优化提示词。

### 视频提示词结构

```
[主体动作] + [场景环境] + [镜头描述] + [光影色彩] + [风格]
```

**示例**：
```
一位汉服女子在樱花树下缓缓转身，粉白花瓣飘落，
镜头缓缓推进特写，柔和金色逆光，古风唯美电影质感
```

### 图片提示词结构

```
[主体描述] + [场景环境] + [光影色彩] + [画质要求] + [风格]
```

**示例**：
```
未来赛博朋克城市街头，霓虹灯倒映在雨中路面，
电影级光影，8K超清，冷色调蓝紫色
```

## 文件结构

```
liblibtv-skills/
├── SKILL.md                    # 技能主文档
├── README.md                   # 本文件
├── references/
│   ├── api-reference.md        # API 完整文档
│   ├── seedance-guide.md       # Seedance 提示词规范
│   ├── kling-guide.md          # Kling 提示词规范
│   ├── wan-guide.md            # Wan 提示词规范
│   └── seedream-guide.md       # Seedream 提示词规范
└── scripts/
    ├── create_session.py       # 创建会话/发送消息
    ├── query_session.py        # 查询会话
    ├── upload_file.py          # 上传文件
    ├── download_results.py     # 下载结果
    └── change_project.py       # 切换项目
```

## 版本信息

- **技能版本**: 1.0.0
- **支持 API**: LiblibTV OpenAPI v1
- **更新日期**: 2026-05-03

## 相关技能

- [video-prompt-optimizer](../video-prompt-optimizer) - 视频提示词优化
- [libtv-skill](../libtv-skill) - agent-im 会话技能

## 注意事项

1. **用户侧不做创作，只做传话** - 把用户原始描述传给后端Agent，不自行扩写prompt
2. **自动配置追加** - 脚本会自动根据内容类型追加最佳配置（比例、模型、品质）
3. **文件大小限制** - 上传文件须 < 200MB
4. **轮询间隔** - 建议每8秒查询一次，避免频繁请求