Upload Media

上传媒体文件到即梦 VOD

将本地视频、音频或图片文件上传到字节跳动 VOD (Video On Demand) 平台，获取 Vid 标识符。

支持的文件类型

使用方法

执行上传脚本：

python3 .claude/skills/upload-media/scripts/upload.py <文件路径> [--type video|audio|image]

• <文件路径>: 必需，要上传的文件绝对路径
• --type: 可选，强制指定文件类型。不指定时根据扩展名自动检测
• --cookies: 可选，自定义 cookies.json 路径

输出格式

脚本输出两个流:

• stderr: 人类可读的进度日志
• stdout: 最终一行 JSON 结果

成功:

{
  "ok": true,
  "vid": "v03870g10004d6480qfog65tipnb6ah0",
  "uri": "tos-cn-v-148450/oxxxxxx",
  "meta": {
    "width": 1920,
    "height": 1080,
    "duration": 9.94,
    "format": "MP4",
    "codec": "h264",
    "size": 8517914,
    "md5": "52c5619242d245bd2d056ae7fe717d76",
    "file_type": "video"
  }
}

失败:

{
  "ok": false,
  "error": "获取凭证失败: session expired",
  "step": "get_token"
}

使用示例

# 上传视频
python3 .claude/skills/upload-media/scripts/upload.py /path/to/video.mp4

# 上传音频
python3 .claude/skills/upload-media/scripts/upload.py /path/to/audio.mp3

# 强制指定类型
python3 .claude/skills/upload-media/scripts/upload.py /path/to/file.dat --type video

提取结果

只取 stdout 最后一行 JSON (过滤 stderr 日志):

python3 .claude/skills/upload-media/scripts/upload.py /path/to/file.mp4 2>/dev/null

或解析 vid:

VID=$(python3 .claude/skills/upload-media/scripts/upload.py /path/to/file.mp4 2>/dev/null | python3 -c "import sys,json; print(json.load(sys.stdin)['vid'])")

Cookie 过期处理

上传依赖即梦平台的登录 Cookie。如果上传失败且 step 为 get_token，说明 Cookie 已过期。

更新方法:

1. 在浏览器中登录 https://jimeng.jianying.com
2. 打开 DevTools → Network → 找任意一个请求 → 复制 Cookie
3. 更新 .claude/skills/upload-media/cookies.json 中对应的 cookie 值

关键 Cookie 字段: sessionid, sid_tt, uid_tt, odin_tt

内部流程

1. getUploadToken     → 用 Cookie 从即梦获取 STS 临时凭证
2. ApplyUploadInner   → 用 AK/SK 签名调 VOD API，获取上传地址
3. TOS 分片上传        → 4MB 分片 + CRC32 校验，上传到 TOS 存储
4. CommitUploadInner  → 确认上传，VOD 注册视频，返回 Vid + 元数据