Seedance 视频生成

通过 SkillBoss API Hub 的统一视频生成能力生成 AI 视频。

前提条件

用户必须设置 SKILLBOSS_API_KEY 环境变量。可通过以下命令设置：

export SKILLBOSS_API_KEY="your-api-key-here"

基础 URL：https://api.skillbossai.com/v1/pilot

支持的模型

SkillBoss API Hub 自动路由至最优视频生成模型。模型提示（model hints）通过 inputs 字段传入，并在可用时被采纳。

默认模型：doubao-seedance-1-5-pro-251215（最新版，支持音频）

执行方式（推荐：Python CLI 工具）

提供了一个 Python CLI 工具，路径为 ~/.claude/skills/seedance-video/seedance.py，具备健壮的错误处理机制，并可自动完成本地图像到 base64 的转换。请优先使用该工具，而非原始 curl 命令。

Python CLI 快速示例

# 文本生成视频（创建并下载）
python3 ~/.claude/skills/seedance-video/seedance.py create --prompt "小猫对着镜头打哈欠" --download ~/Desktop

# 从本地文件进行图像生成视频
python3 ~/.claude/skills/seedance-video/seedance.py create --prompt "人物缓缓转头微笑" --image /path/to/photo.jpg --download ~/Desktop

# 从 URL 进行图像生成视频
python3 ~/.claude/skills/seedance-video/seedance.py create --prompt "风景画面缓缓推进" --image "https://example.com/image.jpg" --download ~/Desktop

# 首帧 + 末帧模式
python3 ~/.claude/skills/seedance-video/seedance.py create --prompt "花朵从含苞到盛开" --image first.jpg --last-frame last.jpg --download ~/Desktop

# 参考图像模式（Lite I2V）
python3 ~/.claude/skills/seedance-video/seedance.py create --prompt "[图1]的人物在跳舞" --ref-images ref1.jpg ref2.jpg --model doubao-seedance-1-0-lite-i2v-250219 --download ~/Desktop

# 自定义参数
python3 ~/.claude/skills/seedance-video/seedance.py create --prompt "城市夜景延时摄影" --ratio 21:9 --duration 8 --resolution 1080p --generate-audio false --download ~/Desktop

# 草稿模式（低成本预览）
python3 ~/.claude/skills/seedance-video/seedance.py create --prompt "海浪拍打沙滩" --draft true --download ~/Desktop

# 基于草稿任务 ID 生成最终视频
python3 ~/.claude/skills/seedance-video/seedance.py create --draft-task-id  --resolution 720p --download ~/Desktop

替代方案：原始 curl 命令

文本生成视频（Text-to-Video）

[ -z "$SKILLBOSS_API_KEY" ] && echo "Error: SKILLBOSS_API_KEY not set" && exit 1

RESULT=$(curl -s -X POST "https://api.skillbossai.com/v1/pilot" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" 
  -d '{
    "type": "video",
    "inputs": {
      "prompt": "YOUR_PROMPT_HERE",
      "ratio": "16:9",
      "duration": 5,
      "resolution": "720p",
      "generate_audio": true
    },
    "prefer": "balanced"
  }')

VIDEO_URL=$(echo "$RESULT" | python3 -c "import sys,json; print(json.load(sys.stdin)['result']['video_url'])")
echo "Video URL: $VIDEO_URL"

图像生成视频（首帧，URL 方式）

[ -z "$SKILLBOSS_API_KEY" ] && echo "Error: SKILLBOSS_API_KEY not set" && exit 1

RESULT=$(curl -s -X POST "https://api.skillbossai.com/v1/pilot" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" 
  -d '{
    "type": "video",
    "inputs": {
      "prompt": "YOUR_PROMPT_HERE",
      "image": "IMAGE_URL_HERE",
      "ratio": "adaptive",
      "duration": 5,
      "resolution": "720p",
      "generate_audio": true
    },
    "prefer": "balanced"
  }')

VIDEO_URL=$(echo "$RESULT" | python3 -c "import sys,json; print(json.load(sys.stdin)['result']['video_url'])")
echo "Video URL: $VIDEO_URL"

图像生成视频（首帧，本地文件方式）

[ -z "$SKILLBOSS_API_KEY" ] && echo "Error: SKILLBOSS_API_KEY not set" && exit 1

IMG_PATH="/path/to/image.png"
IMG_EXT="${IMG_PATH##*.}"
IMG_EXT_LOWER=$(echo "$IMG_EXT" | tr '[:upper:]' '[:lower:]')
IMG_BASE64=$(base64 < "$IMG_PATH" | tr -d 'n')
IMG_DATA_URL="data:image/${IMG_EXT_LOWER};base64,${IMG_BASE64}"

RESULT=$(curl -s -X POST "https://api.skillbossai.com/v1/pilot" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" 
  -d "{
    "type": "video",
    "inputs": {
      "prompt": "YOUR_PROMPT_HERE",
      "image": "${IMG_DATA_URL}",
      "ratio": "adaptive",
      "duration": 5,
      "resolution": "720p",
      "generate_audio": true
    },
    "prefer": "balanced"
  }")

VIDEO_URL=$(echo "$RESULT" | python3 -c "import sys,json; print(json.load(sys.stdin)['result']['video_url'])")
echo "Video URL: $VIDEO_URL"

图像生成视频（首帧 + 末帧）

[ -z "$SKILLBOSS_API_KEY" ] && echo "Error: SKILLBOSS_API_KEY not set" && exit 1

RESULT=$(curl -s -X POST "https://api.skillbossai.com/v1/pilot" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" 
  -d '{
    "type": "video",
    "inputs": {
      "prompt": "YOUR_PROMPT_HERE",
      "image": "FIRST_FRAME_IMAGE_URL",
      "last_frame": "LAST_FRAME_IMAGE_URL",
      "ratio": "adaptive",
      "duration": 5,
      "resolution": "720p",
      "generate_audio": true
    },
    "prefer": "balanced"
  }')

VIDEO_URL=$(echo "$RESULT" | python3 -c "import sys,json; print(json.load(sys.stdin)['result']['video_url'])")
echo "Video URL: $VIDEO_URL"

参考图像生成视频（Reference Image-to-Video）

[ -z "$SKILLBOSS_API_KEY" ] && echo "Error: SKILLBOSS_API_KEY not set" && exit 1

RESULT=$(curl -s -X POST "https://api.skillbossai.com/v1/pilot" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $SKILLBOSS_API_KEY" 
  -d '{
    "type": "video",
    "inputs": {
      "prompt": "[图1]的人物在跳舞",
      "ref_images": ["REF_IMAGE_URL_1"],
      "ratio": "16:9",
      "duration": 5,
      "resolution": "720p"
    },
    "prefer": "balanced"
  }')

VIDEO_URL=$(echo "$RESULT" | python3 -c "import sys,json; print(json.load(sys.stdin)['result']['video_url'])")
echo "Video URL: $VIDEO_URL"

下载并打开视频

OUTPUT_PATH="$HOME/Desktop/seedance_video_$(date +%Y%m%d_%H%M%S).mp4"
curl -s -o "$OUTPUT_PATH" "$VIDEO_URL"
echo "Video saved to: $OUTPUT_PATH"
open "$OUTPUT_PATH"

可选参数参考

图像要求

• 格式：jpeg、png、webp、bmp、tiff、gif（Seedance 1.5 Pro 还额外支持 heic、heif）
• 宽高比（width/height）：介于 0.4 至 2.5 之间
• 尺寸：单边像素范围为 300–6000 px
• 最大文件大小：30 MB

通过飞书发送视频文件（OpenClaw）

详见 how_to_send_video_via_feishu_app.md

规范

1. 始终检查是否已设置 SKILLBOSS_API_KEY 环境变量，再发起 API 调用：[ -z "$SKILLBOSS_API_KEY" ] && echo "Error: SKILLBOSS_API_KEY not set" && exit 1
2. 默认使用 Seedance 1.5 Pro 模型提示（doubao-seedance-1-5-pro-251215），除非用户明确指定其他模型。
3. 文本生成视频的默认参数：分辨率为 720p、宽高比为 16:9、时长为 5 秒、启用音频生成。
4. 图像生成视频的默认宽高比为 adaptive（自动适配输入图像的原始比例）。
5. 视频 URL 有效期为 24 小时——生成后请立即下载。
6. 对于本地图像文件，需先转换为 base64 data URL 格式再提交。
7. 始终向用户展示生成的视频 URL，以便其直接访问结果。
8. 若生成失败，请清晰显示错误信息，并给出可能的修复建议。