Skip to content

README.md

Latest commit

 

History

History
60 lines (44 loc) · 2.22 KB

README.md

File metadata and controls

60 lines (44 loc) · 2.22 KB

MediaAsset

Seedance 人像库封面图采集工具。

背景

Seedance（字节跳动火山引擎）未提供人像库的开放 API 接口，无法直接批量获取封面图片资源。本项目通过浏览器扩展拦截控制台接口请求，自动采集人像元数据并下载对应封面图。

项目结构

MediaAsset/
├── chrome-extension/    # Chrome 扩展 — 采集人像列表数据
│   ├── manifest.json
│   ├── background.js
│   ├── popup.html / popup.js
│   └── sidepanel.html
├── assets/              # 采集到的 JSON 数据 & 下载的图片
│   ├── {pageNum}-{pageSize}.json
│   └── images/
│       └── {assetId}.png
├── download_images.py   # 从 JSON 中提取并批量下载封面图
└── 需求.md              # 接口详情与原始需求

使用流程

1. 安装 Chrome 扩展

  1. 打开 Chrome → 扩展程序 → 管理扩展程序 → 开启「开发者模式」
  2. 点击「加载已解压的扩展程序」，选择 chrome-extension 文件夹
  3. 进入 Seedance 控制台 的人像库页面
  4. 扩展会自动拦截 ListMediaAssetGroup 接口响应，将分页数据保存为 assets/{pageNum}-{pageSize}.json

2. 批量下载封面图

# 安装依赖
pip install aiohttp

# 执行下载
python download_images.py

脚本会：

  • 遍历 assets/*.json 提取所有 AssetGroup.Content.Image
  • 以 AssetID 为文件名，并发下载到 assets/images/
  • 自动去重，跳过已存在的文件

免责声明

本工具仅供个人学习与研究使用，请勿用于任何商业用途。

使用本工具时，请合理控制请求频率，避免对 Seedance / 火山引擎官方服务造成不必要的访问压力。请遵守相关平台的服务条款与使用政策。因使用本工具产生的任何责任，由使用者自行承担。

注意事项

  • Cookie 与请求头具有时效性，采集时需确保火山引擎控制台处于登录状态
  • 图片 URL 含临时签名（X-Tos-Expires），需在有效期内完成下载
  • 建议调整并发数（CONCURRENCY）与请求间隔，避免高频请求