ShortVideo 创作者

使用 ShortVideo 后端 API 创建视频，支持多种任务类型。

认证配置（首次使用必需）

ShortVideo 需要 API 凭据。请通过环境变量进行配置：

方法 1：Claude Code 配置

添加至 ~/.claude/settings.json：

{
  "env": {
    "SHORTVIDEO_BASE_URL": "https://api.shortvideo.ai",
    "SHORTVIDEO_API_KEY": "your-api-key-here"
  }
}

方法 2：OpenClaw 配置

添加至 ~/.openclaw/openclaw.json：

{
  "skills": {
    "entries": {
      "shortvideo": {
        "env": {
          "SHORTVIDEO_BASE_URL": "https://api.shortvideo.ai",
          "SHORTVIDEO_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

方法 3：Shell 环境变量

添加至 ~/.zshrc（或 ~/.bashrc）：

export SHORTVIDEO_BASE_URL="https://api.shortvideo.ai"
export SHORTVIDEO_API_KEY="your-api-key-here"

然后重新加载配置：source ~/.zshrc

注意：执行脚本时，若未检测到环境变量，请尝试运行 source ~/.zshrc && python3 scripts/...

子命令

product-to-video —— 从单张图片生成产品视频

使用 Sora2 AI 从单张产品图片生成营销视频。

触发关键词：product-to-video、产品视频、product video

source ~/.zshrc && python3 scripts/product-to-video.py 
  --product-name "" 
  --image  
  --aspect-ratio <16:9|9:16> 
  --duration 12 
  [--product-info ""] 
  [--no-poll]

参数说明：

积分消耗：100（固定）

示例：

source ~/.zshrc && python3 scripts/product-to-video.py 
  --product-name "Premium Headphones" 
  --image https://example.com/product.jpg 
  --aspect-ratio 16:9 
  --duration 12

image-to-ad-video —— 从多张图片生成广告视频

基于 1–7 张产品图片生成广告视频。

触发关键词：image-to-ad-video、广告视频、ad video、image to video

source ~/.zshrc && python3 scripts/image-to-ad-video.py 
  --images   ... 
  --duration <8|15|30|60> 
  --aspect-ratio <16:9|9:16|1:1> 
  [--prompt ""] 
  [--no-poll]

参数说明：

积分消耗：每秒 30 点

示例：

source ~/.zshrc && python3 scripts/image-to-ad-video.py 
  --images d2mm4m9addr0008000a0.png 
  --duration 15 
  --aspect-ratio 16:9

replicate-video —— 使用新图片复刻已有视频风格

基于现有视频风格，使用新的产品图或模特图进行视频复刻。

触发关键词：replicate-video、视频复刻、video replication

source ~/.zshrc && python3 scripts/replicate-video.py 
  --video  
  --aspect-ratio <16:9|9:16> 
  --resolution <540p|720p|1080p> 
  [--product-images   ...] 
  [--model-images   ...] 
  [--prompt ""] 
  [--remove-audio] 
  [--no-poll]

参数说明：

* 至少需提供 product-images 或 model-images 中的任意一类图片（至少 1 张，最多 7 张）。

积分消耗：每秒 9–15 点（按分辨率不同而变化）

示例：

source ~/.zshrc && python3 scripts/replicate-video.py 
  --video template.mp4 
  --aspect-ratio 16:9 
  --resolution 1080p 
  --product-images product.jpg

poll-videos —— 轮询视频生成结果

轮询查询视频生成任务的状态。

触发关键词：poll-videos、查询视频、check video status

source ~/.zshrc && python3 scripts/poll-videos.py --video-ids   [options]

参数说明：

视频状态码说明：

示例：

# 持续轮询
source ~/.zshrc && python3 scripts/poll-videos.py --video-ids video_abc123

# 单次检查
source ~/.zshrc && python3 scripts/poll-videos.py --video-ids video_abc123 --once

文件路径类型

所有文件类参数均支持以下三种路径格式：

支持的文件类型

API 响应格式

// 成功响应
{"code": 0, "data": {...}}

// 失败响应
{"code": 1, "info": "error message"}

参考文档

• Product to Video
• Image to Ad Video
• Replicate Video