short-video-gen

Category: Content & Multimedia | Uploader: Yeadon8888 | Downloads: 0 | Version: v1.0（Latest）

短视频自动生成。支持抖音/TikTok 链接二创、本地视频二创、主题生产三种模式，自动生成配套标题/文案/首评。用户提到"生成短视频"、"视频二创"、"sora生成视频"、"产品视频"、"帮我用这个链接生成视频"时使用。

Changelog: Source: GitHub https://github.com/Yeadon8888/short-video-gen

Directory Structure

Current level: Root

📁 .github/
- 📄 copilot-instructions.md 4.1 KB
📁 docs/
- 📁 assets/
  - 📁 css/
    
    📄 animations.css 2.5 KB
    
    📄 demo.css 9.0 KB
    
    📄 footer.css 2.7 KB
    
    📄 hero.css 7.5 KB
    
    📄 layout.css 1.8 KB
    
    📄 pricing.css 5.1 KB
    
    📄 reset.css 2.9 KB
    
    📄 usecases.css 3.5 KB
    
    📄 workflow.css 4.8 KB
  - 📁 img/
    
    📄 qr_code.jpg 146.3 KB
  - 📁 js/
    
    📄 main.js 4.3 KB
    
    📄 particles.js 4.2 KB
    
    📄 scroll.js 1.7 KB
    
    📄 workflow.js 5.8 KB
- 📁 plans/
  - 📄 2026-03-12-short-video-gen-gateway-design.md 2.5 KB
- 📄 .nojekyll 0 B
- 📄 CNAME 18 B
- 📄 index.html 36.3 KB
- 📄 upload_assets.py 2.5 KB
- 📄 vercel.json 593 B
📁 image/
- 📄 sample_product.jpg 52.2 KB
📁 scripts/
- 📄 generate.py 46.2 KB
📁 web/
- 📁 app/
  - 📁 api/
    
    📁 generate/
    
    📁 status/
    
    📄 route.ts 927 B
    
    📄 route.ts 7.8 KB
    
    📁 images/
    
    📄 route.ts 2.1 KB
    
    📁 prompts/
    
    📄 route.ts 1.5 KB
  - 📁 chat/
    
    📄 page.tsx 124 B
  - 📄 globals.css 943 B
  - 📄 layout.tsx 739 B
  - 📄 page.tsx 124 B
- 📁 components/
  - 📄 ChatInterface.tsx 21.8 KB
  - 📄 CopySection.tsx 2.5 KB
  - 📄 FallbackNotice.tsx 1.6 KB
  - 📄 ImageManager.tsx 6.0 KB
  - 📄 MessageBubble.tsx 4.2 KB
  - 📄 ParamBar.tsx 2.6 KB
  - 📄 ProcessLog.tsx 1.9 KB
  - 📄 PromptEditor.tsx 5.3 KB
  - 📄 ScriptOutput.tsx 3.5 KB
- 📁 lib/
  - 📁 storage/
    
    📄 gateway.ts 9.0 KB
  - 📁 video/
    
    📄 plato.ts 7.3 KB
    
    📄 types.ts 300 B
  - 📄 gemini.ts 9.4 KB
  - 📄 tikhub.ts 6.2 KB
  - 📄 workspace.ts 1.3 KB
- 📄 .env.local.example 324 B
- 📄 .gitignore 20 B
- 📄 next-env.d.ts 211 B
- 📄 next.config.ts 224 B
- 📄 package-lock.json 69.0 KB
- 📄 package.json 580 B
- 📄 postcss.config.js 83 B
- 📄 tailwind.config.ts 674 B
- 📄 tsconfig.json 630 B
- 📄 tsconfig.tsbuildinfo 99.1 KB
- 📄 vercel.json 128 B
📁 workers/
- 📁 upload-gateway/
  - 📁 src/
    
    📄 index.ts 7.3 KB
  - 📄 package-lock.json 47.4 KB
  - 📄 package.json 133 B
  - 📄 wrangler.jsonc 381 B
📄 .env.example 338 B
📄 .gitignore 492 B
📄 CLAUDE.md 4.8 KB
📄 prompts.md.example 15.7 KB
📄 prompts_glumoo.md 14.2 KB
📄 README.md 4.0 KB
📄 SKILL.md 8.5 KB

SKILL.md

---
name: short-video-gen
description: 短视频自动生成。支持抖音/TikTok 链接二创、本地视频二创、主题生产三种模式，自动生成配套标题/文案/首评。用户提到"生成短视频"、"视频二创"、"sora生成视频"、"产品视频"、"帮我用这个链接生成视频"时使用。
---

# 短视频自动生成

通过 Gemini（视频理解）+ VEO 3.1 / Sora（视频生成）的完整工作流。支持三种模式：抖音/TikTok 链接二创、本地视频二创、主题生产。

## 参数说明

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `--url <文本>` | 抖音/TikTok 分享链接，**支持直接粘贴含表情/中文/话题标签的完整分享文字** | — |
| `--video <路径>` | 本地视频文件路径 | — |
| `--prompt <文本>` | 生产模式必填；二创模式为修改意见 | — |
| `--images <文件夹>` | 产品图片文件夹；传 `0` 不使用产品图 | skill 目录下的 `image/` |
| `--orientation` | `portrait`（竖屏）/ `landscape`（横屏） | `portrait` |
| `--duration` | `10` / `15`（秒） | `15` |
| `--count` | 生成视频数量（1–10） | `1` |
| `--random-image` | 从图片文件夹随机选一张（不加则用第一张） | 否 |
| `--model <名称>` | 视频生成模型：`veo3.1-fast` / `veo3.1-components` / `veo3.1-pro-4k` / `sora` | `veo3.1-fast` |
| `--submit` | 仅提交任务不等待结果，状态保存到 `.task_state.json`（适用于 OpenClaw 等短会话环境） | 否 |
| `--check [task_ids]` | 快速检查任务状态（不阻塞）。不传参数则从上次 `--submit` 的状态恢复 | — |

**模式判断：**
- 提供 `--url` → 自动提取链接 → TikHub 下载原视频 → Gemini 分析 → Sora 生成
- 提供 `--video` → Gemini 分析本地视频 → Sora 生成
- 只有 `--prompt` → Gemini 扩展主题 → Sora 生成（生产模式）

## 前置条件：.env 文件

脚本从**运行目录**自动加载 `.env`。使用前确认用户运行目录有 `.env`，或 skill 目录下有 `.env`。

必填：
```
VIDEO_API_KEY=sk-...        # 柏拉图 / BLTCY 视频接口
```

按需填写：
```
GEMINI_API_KEY=sk-...       # 单独的 Gemini Key
GEMINI_BASE_URL=...         # 默认 https://yunwu.ai
VIDEO_BASE_URL=...          # 默认 https://api.bltcy.ai
VIDEO_MODEL=veo3.1-fast       # 默认 veo3.1-fast，可选 veo3.1-components / veo3.1-pro-4k / sora
TIKHUB_API_KEY=...          # 使用 --url 时必填，用于解析抖音/TikTok 链接
UPLOAD_API_URL=...          # Cloudflare 上传网关
UPLOAD_API_KEY=...
UPLOAD_PREFIX=vidclaw-assets
```

如果 `.env` 不存在或缺少 `VIDEO_API_KEY`，脚本会报错退出并提示用户添加。

## 执行方式

**必须从 skill 目录运行**（脚本自动加载该目录的 `.env`）：

```bash
SKILL_DIR="$HOME/.claude/skills/short-video-gen"
cd "$SKILL_DIR"

# 标准模式（阻塞等待结果）
python3 scripts/generate.py \
  [--url "<分享文字或链接>"] \
  [--video <视频路径>] \
  [--prompt "<提示词或修改意见>"] \
  [--images <图片文件夹 或 0>] \
  [--orientation portrait|landscape] \
  [--duration 10|15] \
  [--count 1-10] \
  [--model veo3.1-fast|veo3.1-components|veo3.1-pro-4k|sora] \
  [--random-image]

# OpenClaw 短会话模式（分步执行）
python3 scripts/generate.py --prompt "主题" --submit   # 提交任务，~60s 返回
python3 scripts/generate.py --check                     # 检查状态，~2s 返回
```

> 视频路径如果是相对路径，需相对于 skill 目录。如果用户给的是绝对路径则直接用。

### OpenClaw / 短会话环境专用

视频生成耗时 2-5 分钟，OpenClaw 等平台无法维持长连接。解决方案：

1. **提交阶段** (`--submit`)：执行 Gemini 分析 + 任务创建（~60s），状态保存到 `.task_state.json`，立即返回 task_ids
2. **检查阶段** (`--check`)：瞬间查询所有任务的 status + progress（如 `IN_PROGRESS 67%`），任务完成后自动显示视频 URL 和文案

Agent 工作流：
```
# 会话 1：提交
python3 scripts/generate.py --prompt "猫咪在夜市" --submit
# → 返回 task_ids，保存到 .task_state.json

# 等 1-2 分钟后，会话 2：检查
python3 scripts/generate.py --check
# → 如果未完成：显示 status=IN_PROGRESS progress=67%
# → 如果已完成：显示视频 URL + 文案，自动清理状态文件
```

## 场景示例

**场景 1：抖音链接二创（直接粘贴分享文字）**
```bash
cd "$HOME/.claude/skills/short-video-gen"
python3 scripts/generate.py \
  --url "5.33 lPX:/ 小猫咪洗头 #AI创作 https://v.douyin.com/xxx/ 复制此链接..."
```

**场景 2：链接二创 + 修改意见**
```bash
cd "$HOME/.claude/skills/short-video-gen"
python3 scripts/generate.py \
  --url "https://v.douyin.com/xxx/" \
  --prompt "把里面的人换成猫咪"
```

**场景 3：本地视频二创**
```bash
cd "$HOME/.claude/skills/short-video-gen"
python3 scripts/generate.py --video /path/to/demo.mp4
```

**场景 4：本地视频二创 + 修改意见 + 自定义产品图**
```bash
cd "$HOME/.claude/skills/short-video-gen"
python3 scripts/generate.py \
  --video /path/to/demo.mp4 \
  --prompt "更明亮的色调，加快节奏" \
  --images /path/to/imgs
```

**场景 5：生产模式（主题扩展）**
```bash
cd "$HOME/.claude/skills/short-video-gen"
python3 scripts/generate.py \
  --prompt "一只猫咪在吉隆坡街头跳舞" \
  --orientation landscape \
  --duration 10
```

**场景 6：批量生成（最多 10 个）**
```bash
cd "$HOME/.claude/skills/short-video-gen"
python3 scripts/generate.py \
  --url "https://v.douyin.com/xxx/" \
  --count 3
```

**场景 7：不使用产品图**
```bash
cd "$HOME/.claude/skills/short-video-gen"
python3 scripts/generate.py --video /path/to/demo.mp4 --images 0
```

**场景 8：OpenClaw 短会话模式（分步执行）**
```bash
cd "$HOME/.claude/skills/short-video-gen"
# 第一步：提交任务（~60秒内完成，立即返回 task_ids）
python3 scripts/generate.py --prompt "猫咪在夜市" --submit

# 第二步：检查状态（瞬间返回，可多次调用）
python3 scripts/generate.py --check

# 或指定 task_ids 检查
python3 scripts/generate.py --check "veo3.1-fast:xxx,veo3.1-fast:yyy"
```

## 输出结果

脚本成功完成后输出：
1. **视频 URL**：可直接在浏览器打开或下载
2. **视频文案**：标题 + 正文文案（含话题标签）+ 首评

示例输出：
```
✅ https://midjourney-plus.oss-us-west-1.aliyuncs.com/xxx.mp4

📋 视频文案
  标题：...
  文案：... #glumoo #NAG
  首评：... #glumoo #NAG
```

## 常见错误排查

| 错误信息 | 原因 | 解决方法 |
|---------|------|---------|
| `未找到 VIDEO_API_KEY` | .env 不存在或未填 Key | 在运行目录创建 `.env` 并填入 Key |
| `未找到 TIKHUB_API_KEY` | 使用 --url 但未配置 | 在 `.env` 添加 `TIKHUB_API_KEY=...` |
| `TikHub 返回空响应` | Key 无效 / 网络不通 / 链接失效 | 检查 Key 是否正确，确认链接可访问 |
| `TikHub 返回非 JSON` | Key 格式错误或无权限 | 重新检查 TIKHUB_API_KEY |
| `视频文件不存在` | 路径错误 | 使用绝对路径，或确认相对路径正确 |
| `Gemini API 超时` | 视频文件过大（>50MB） | 压缩视频后重试 |

## 自定义提示词（prompts.md）

编辑 skill 目录下的 `prompts.md` 可定制 Gemini 的行为，无需修改代码。文件使用 `## SECTION_NAME` 分节，`{{PLACEHOLDER}}` 在运行时自动替换。

| 区块名 | 用途 | 占位符 |
|--------|------|--------|
| `VIDEO_REMIX_BASE` | 视频二创（无修改建议） | — |
| `VIDEO_REMIX_WITH_MODIFICATION` | 视频二创（有修改建议） | `{{MODIFICATION_PROMPT}}` |
| `THEME_TO_VIDEO` | 生产模式主题扩展 | `{{THEME}}` |
| `COPY_GENERATION` | 生成标题/文案/首评 JSON | `{{SORA_PROMPT}}` |

preset 模板：
- `prompts.md.example` — 通用默认模板
- `prompts_glumoo.md` — Glumoo 品牌专用（猫产品 + 东南亚 + Malaysian English + #glumoo 标签）

切换品牌模板：`cp prompts_glumoo.md prompts.md`

## 注意事项

- Sora 视频生成为异步任务，每 30 秒轮询一次，通常需等待 2–5 分钟，最长 30 分钟超时
- **OpenClaw 等短会话环境**：使用 `--submit` + `--check` 分步执行，避免长连接超时
- 轮询时显示任务进度百分比（如 `progress=67%`），方便 agent 判断状态
- 产品图默认使用 skill 目录下的 `image/` 文件夹，图片会上传到 Cloudflare 上传网关并缓存
- `--count` 最多 10，超出会直接报错
- 提示词风格可在 `prompts.md` 中修改，无需动代码

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

short-video-gen

Directory Structure

SKILL.md

Report

Notice