AdsTurbo AI 视频生成 · AdsTurbo AI Video Generation

从零造画面：文生视频、图生视频、首尾帧补全、多参考素材生成，以及对已有视频做延长和局部编辑。

AdsTurbo AI Video Generation

Generate video footage from scratch, and extend or locally edit existing video.

When to use this skill

Use it when the user says "text-to-video," "image-to-video," "generate a video," "start/end frame," "extend video," "continue video," or "change the background in the video."

To make a character speak, use adsturbo-digital-human; to replicate a reference video, use adsturbo-ad-clone.

Prerequisites

• Python 3.8+, pip install -r scripts/requirements.txt
• Environment variable ADSTURBO_API_KEY (obtain it at https://adsturbo.ai?channel=clawhub)
• Optional ADSTURBO_BASE_URL, defaults to https://adsturbo.ai/klian/novartapi

Three commands

bash

# Text-to-video
python3 scripts/video_generation.py generate --prompt "Sunset over the ocean, camera slowly pushing in"

# Image-to-video / start-end frame
python3 scripts/video_generation.py generate --prompt "Product rotating on display" \
  --start-frame https://.../product.jpg

# Extend (seedance-2.0 only)
python3 scripts/video_generation.py extend --video-url https://.../clip.mp4 --duration 10

# Local edit (seedance-2.0 only)
python3 scripts/video_generation.py edit --video-url https://.../clip.mp4 \
  --prompt "Replace the background with an office" --mask-url https://.../mask.png

Key point: the model determines valid parameter values

duration / resolution / ratio / reference-asset limits differ per model — veo-3.1 only supports 4/6/8 seconds, seedance-2.0 supports 4-15 seconds, and grok doesn't support start-end frames.

Before building a request for the user, check the model comparison table in references/video_generation.md. When a non-default model is specified, verify duration, ratio, and resolution individually. Omitting --model falls back to the server default, which is the simplest option.

extend and edit only support seedance-2.0 — don't recommend other models for these.

Hard constraint: assets must be public URLs only

--start-frame, --end-frame, --reference-images, --reference-videos, and --video-url do not accept local file paths:

bash

python3 scripts/upload.py image ./frame.jpg
python3 scripts/upload.py file ./clip.mp4

See references/upload.md for details.

Handling async tasks

All three commands are asynchronous; by default the script submits the job and polls automatically until a result is ready.

• On timeout: use query --workspace-id <id> to keep waiting — do not resubmit, the task is still running and resubmitting will incur duplicate charges
• To submit without waiting: --no-wait
• For idempotent retries: pass --idempotency-key — the same key will not create a duplicate task

See references/work.md for details.

When replying to the user

• Give the video link directly — don't mention script names, command lines, JSON, or exit codes
• After submission, mention it will take about 3-8 minutes
• If a parameter is rejected by the server, it's usually a model/duration/ratio/resolution mismatch — check the table, retry with a valid value, and don't dump the raw error on the user

Capability boundaries

User wants	Use
Digital human voiceover / lip sync	adsturbo-digital-human
Replicate a reference video	adsturbo-ad-clone
Watermark removal / 4K / subtitles	adsturbo-video-enhance
Character swap / translation / motion control	adsturbo-video-transform
Generate images	adsturbo-image

---

AdsTurbo AI 视频生成

从零生成视频画面，以及对已有视频做延长和局部编辑。

什么时候用这个 skill

用户说「文生视频」「图生视频」「生成一段视频」「首尾帧」「视频延长」「续写视频」「改视频里的背景」时用它。

要让人物说话用 adsturbo-digital-human；要照着一条参考视频复刻用 adsturbo-ad-clone。

前置条件

• Python 3.8+，pip install -r scripts/requirements.txt
• 环境变量 ADSTURBO_API_KEY（在 https://adsturbo.ai?channel=clawhub 获取）
• 可选 ADSTURBO_BASE_URL，默认 https://adsturbo.ai/klian/novartapi

三个命令

bash

# 文生视频
python3 scripts/video_generation.py generate --prompt "海边日落，镜头缓慢推进"

# 图生视频 / 首尾帧
python3 scripts/video_generation.py generate --prompt "产品旋转展示" \
  --start-frame https://.../product.jpg

# 延长（仅 seedance-2.0）
python3 scripts/video_generation.py extend --video-url https://.../clip.mp4 --duration 10

# 局部编辑（仅 seedance-2.0）
python3 scripts/video_generation.py edit --video-url https://.../clip.mp4 \
  --prompt "把背景换成办公室" --mask-url https://.../mask.png

关键：模型决定参数取值

duration / resolution / ratio / 参考素材上限每个模型都不一样——veo-3.1 只能 4/6/8 秒，seedance-2.0 是 4~15 秒，grok 不支持首尾帧。

为用户构造请求前，先查 references/video_generation.md 里的模型对照表，指定了非默认 model 时必须逐项核对 duration、ratio、resolution。不传 --model 就走服务端默认，最省事。

extend 和 edit 只支持 seedance-2.0，不要给用户推荐其他模型。

硬约束：素材只收公网 URL

--start-frame --end-frame --reference-images --reference-videos --video-url 都不接受本地文件路径：

bash

python3 scripts/upload.py image ./frame.jpg
python3 scripts/upload.py file ./clip.mp4

详见 references/upload.md。

异步任务怎么处理

三个命令都是异步的，脚本默认提交后自动轮询到出结果。

• 超时了：query --workspace-id <id> 接着等，不要重新提交——任务还在跑，重交会重复扣费
• 只想提交不等：--no-wait
• 重试要幂等：带上 --idempotency-key，同一个 key 不会重复建任务

详见 references/work.md。

回复用户时

• 直接给视频链接，不要提脚本名、命令行、JSON 或退出码
• 提交后说一句预计 3–8 分钟
• 参数被服务端拒了，多半是模型与 duration/ratio/resolution 不匹配——查表改一个合法值重试，别把原始报错甩给用户

能力边界

用户想要	该用
数字人口播 / 对口型	adsturbo-digital-human
照着参考视频复刻	adsturbo-ad-clone
去水印 / 4K / 字幕	adsturbo-video-enhance
换角色 / 翻译 / 动作控制	adsturbo-video-transform
生成图片	adsturbo-image