tuzi-video-gen

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Video Generation (AI SDK)

视频生成（AI SDK）

Tuzi API video generation backend. Default model: veo3.1.

Tuzi API 视频生成后端，默认模型：veo3.1。

Script Directory

脚本目录

Agent Execution:

```
SKILL_DIR
```
= this SKILL.md file's directory
Script path =
```
${SKILL_DIR}/scripts/main.ts
```

Agent 执行：

```
SKILL_DIR
```
= 本 SKILL.md 文件所在目录
脚本路径 =
```
${SKILL_DIR}/scripts/main.ts
```

Step 0: Load Preferences ⛔ BLOCKING

第0步：加载偏好设置 ⛔ 阻塞步骤

CRITICAL: This step MUST complete BEFORE any video generation. Do NOT skip or defer.

重要提示：本步骤必须在所有视频生成操作前完成，请勿跳过或延后执行。

0.1 Check API Key

0.1 检查API密钥

bash

echo "${TUZI_API_KEY:-not_set}"
grep -s TUZI_API_KEY .tuzi-skills/.env "$HOME/.tuzi-skills/.env"

Result	Action
Key found	Continue to Step 0.2
Key NOT found	⛔ Run API key setup (see references/config/first-time-setup.md) → Store key → Then continue

bash

echo "${TUZI_API_KEY:-not_set}"
grep -s TUZI_API_KEY .tuzi-skills/.env "$HOME/.tuzi-skills/.env"

结果	操作
找到密钥	继续执行第0.2步
未找到密钥	⛔ 运行API密钥设置（参考 references/config/first-time-setup.md）→ 存储密钥 → 继续后续操作

0.2 Check EXTEND.md

0.2 检查 EXTEND.md 文件

bash

test -f .tuzi-skills/tuzi-video-gen/EXTEND.md && echo "project"
test -f "$HOME/.tuzi-skills/tuzi-video-gen/EXTEND.md" && echo "user"

Result	Action
Found	Load, parse, apply settings
Not found	⛔ Run first-time setup (references/config/first-time-setup.md) → Save EXTEND.md → Then continue

Path	Location
`.tuzi-skills/tuzi-video-gen/EXTEND.md`	Project directory
`$HOME/.tuzi-skills/tuzi-video-gen/EXTEND.md`	User home

EXTEND.md Supports: Default model | Default seconds | Default size

Schema:

references/config/preferences-schema.md

bash

test -f .tuzi-skills/tuzi-video-gen/EXTEND.md && echo "project"
test -f "$HOME/.tuzi-skills/tuzi-video-gen/EXTEND.md" && echo "user"

结果	操作
找到文件	加载、解析并应用配置
未找到文件	⛔ 运行首次设置（参考 references/config/first-time-setup.md）→ 保存 EXTEND.md → 继续后续操作

路径	位置
`.tuzi-skills/tuzi-video-gen/EXTEND.md`	项目目录
`$HOME/.tuzi-skills/tuzi-video-gen/EXTEND.md`	用户根目录

EXTEND.md 支持配置项：默认模型 | 默认时长（秒）| 默认尺寸

配置规则：

references/config/preferences-schema.md

Usage

使用方法

bash

undefined

bash

undefined

Single video

生成单个视频

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat walking in a garden" --video cat.mp4

With model and duration

指定模型和时长

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "城市夜景延时" --video city.mp4 --model veo3 --seconds 8

With reference image

带参考图生成

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Animate this scene" --video out.mp4 --ref source.png

From prompt file

从提示词文件读取

npx -y bun ${SKILL_DIR}/scripts/main.ts --promptfiles prompt.md --video out.mp4

Long video (multi-segment with ffmpeg concat)

生成长视频（通过 ffmpeg 拼接多段视频）

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A journey through seasons" --video long.mp4 --segments 3

Long video with per-segment prompts

按分段提示词生成长视频

npx -y bun ${SKILL_DIR}/scripts/main.ts --video long.mp4 --segments 3 --segment-prompts seg1.md seg2.md seg3.md

undefined

npx -y bun ${SKILL_DIR}/scripts/main.ts --video long.mp4 --segments 3 --segment-prompts seg1.md seg2.md seg3.md

undefined

Options

参数说明

Option	Description
`--prompt <text>` , `-p`	Prompt text
`--promptfiles <files...>`	Read prompt from files (concatenated)
`--video <path>`	Output video path (required)
`--model <id>` , `-m`	Model ID (default: veo3.1)
`--seconds <n>` , `-s`	Duration in seconds
`--size <WxH>`	Video size (e.g., `1280x720` , `16x9` )
`--ref <files...>`	Reference images
`--ref-mode reference\|frames\|components`	Reference image mode
`--segments <n>`	Long video segment count (min 2)
`--segment-prompts <files...>`	Per-segment prompt files
`--json`	JSON output

参数	描述
`--prompt <text>` , `-p`	提示词文本
`--promptfiles <files...>`	从文件读取提示词（自动拼接内容）
`--video <path>`	输出视频路径（必填）
`--model <id>` , `-m`	模型ID（默认：veo3.1）
`--seconds <n>` , `-s`	视频时长（单位：秒）
`--size <WxH>`	视频尺寸（例如 `1280x720` 、 `16x9` ）
`--ref <files...>`	参考图片
`--ref-mode reference\|frames\|components`	参考图片使用模式
`--segments <n>`	长视频分段数量（最小值为2）
`--segment-prompts <files...>`	各分段对应的提示词文件
`--json`	以JSON格式输出结果

Models

支持的模型

Model	Provider	Duration	Sizes	Image Mode
`veo3`	Veo	8s	16:9, 9:16	reference
`veo3.1` (default)	Veo	8s	16:9, 9:16	frames
`veo3.1-4k`	Veo	8s	4K	frames
`sora-2`	Sora	10/15s	16:9, 9:16	reference
`sora-2-pro`	Sora	10/15/25s	16:9, 9:16, HD	reference
`kling-v1-6`	Kling	5/10s	16:9, 9:16, 1:1	reference
`seedance-1.5-pro`	Seedance	5/10s	1080p, 720p	frames

模型ID	提供方	支持时长	支持尺寸	参考图模式
`veo3`	Veo	8s	16:9, 9:16	reference
`veo3.1` （默认）	Veo	8s	16:9, 9:16	frames
`veo3.1-4k`	Veo	8s	4K	frames
`sora-2`	Sora	10/15s	16:9, 9:16	reference
`sora-2-pro`	Sora	10/15/25s	16:9, 9:16, HD	reference
`kling-v1-6`	Kling	5/10s	16:9, 9:16, 1:1	reference
`seedance-1.5-pro`	Seedance	5/10s	1080p, 720p	frames

Long Video Mode

长视频模式

When

--segments N

is specified (N >= 2):

Generates N video segments sequentially
After each segment, extracts last frame via ffmpeg
Last frame becomes next segment's reference image (continuity)
All segments concatenated via
```
ffmpeg -f concat
```
Temporary files cleaned up

Requirements: ffmpeg must be installed.

Per-segment prompts: Use

--segment-prompts

to provide individual prompt files for each segment. If fewer files than segments, remaining segments use the main

--prompt

当指定

--segments N

参数（N >= 2）时：

按顺序生成N段视频
每段生成完成后，通过 ffmpeg 提取最后一帧
上一段的最后一帧作为下一段的参考图（保证内容连贯性）
所有分段通过
```
ffmpeg -f concat
```
拼接为完整视频
清理临时文件

依赖要求：必须安装 ffmpeg。

分段提示词说明：使用

--segment-prompts

可以为每个分段指定单独的提示词文件，如果提供的文件数量少于分段数，剩余分段将使用主

--prompt

参数的提示词。

Environment Variables

环境变量

Variable	Description
`TUZI_API_KEY`	Tuzi API key (https://api.tu-zi.com)
`TUZI_VIDEO_MODEL`	Default video model (default: veo3.1)
`TUZI_BASE_URL`	Custom Tuzi endpoint (default: https://api.tu-zi.com)

Load Priority: CLI args > EXTEND.md > env vars >

<cwd>/.tuzi-skills/.env

~/.tuzi-skills/.env

变量名	描述
`TUZI_API_KEY`	Tuzi API 密钥（获取地址：https://api.tu-zi.com）
`TUZI_VIDEO_MODEL`	默认视频生成模型（默认值：veo3.1）
`TUZI_BASE_URL`	自定义 Tuzi 接口地址（默认：https://api.tu-zi.com）

加载优先级：命令行参数 > EXTEND.md配置 > 环境变量 >

<cwd>/.tuzi-skills/.env

~/.tuzi-skills/.env

Model Resolution

模型选择优先级

Priority (highest → lowest):

CLI:
```
--model <id>
```
EXTEND.md:
```
default_model
```
Env var:
```
TUZI_VIDEO_MODEL
```
Built-in default:
```
veo3.1
```

Agent MUST display model info before each generation:

Show:
```
Using [model]
```

Show switch hint:

Switch model: --model <id> | EXTEND.md default_model | env TUZI_VIDEO_MODEL

优先级（从高到低）：

命令行参数：
```
--model <id>
```
EXTEND.md 配置：
```
default_model
```
环境变量：
```
TUZI_VIDEO_MODEL
```
内置默认值：
```
veo3.1
```

Agent 必须在每次生成前展示模型信息：

展示内容：
```
Using [model]
```

展示切换提示：

Switch model: --model <id> | EXTEND.md default_model | env TUZI_VIDEO_MODEL

Error Handling

错误处理

Missing API key → ⛔ MUST run API key setup from Step 0.1
Generation failure → auto-retry once
Business failure (content rejected) → no retry, report error
Network error → exponential backoff (1.5x, max 60s)
Timeout → error after 90 minutes
Missing ffmpeg (long video mode) → clear error with install instructions

缺少API密钥 → ⛔ 必须执行第0.1步的API密钥设置流程
生成失败 → 自动重试1次
业务错误（内容被拒绝）→ 不重试，直接上报错误
网络错误 → 指数退避重试（每次间隔乘以1.5，最大间隔60秒）
超时 → 90分钟后返回超时错误
长视频模式下缺少 ffmpeg → 返回清晰的错误信息并附带安装指引

Extension Support

扩展支持

Custom configurations via EXTEND.md. See Step 0 for paths and supported options.

可通过 EXTEND.md 进行自定义配置，路径和支持的配置项参考第0步。