Skip to main content
Skill ID: $video-downloader · Source · Provider API: TikWM

​
Mục đích

Chuẩn hóa bước ingest footage từ TikTok thành asset local để pipeline dùng ngay như raw asset thật:
  • Video .mp4
  • Slideshow images .jpg
  • Audio .mp3
Output mặc định:
  • Không có job: raw_assets/<media>/downloaded/
  • Có job: jobs/<id>/input/raw_assets/<media>/downloaded/

​
Khi nào invoke

  • User đưa link TikTok và muốn dùng clip đó cho pipeline video.
  • Cần tải hàng loạt URL để tạo pool asset cho asset-index.
  • Cần kéo cả video + images + audio từ một nguồn TikTok trước khi map scene.

​
Cách dùng nhanh

$video-downloader — tải link TikTok vào job hiện tại để pipeline dùng ngay
Hoặc gọi script trực tiếp: 
# Tải 1 video vào global raw_assets
python skills/video_downloader/scripts/download_video.py \
  --url "https://www.tiktok.com/@user/video/123" \
  --hd

# Tải vào job cụ thể
python skills/video_downloader/scripts/download_video.py \
  --url "https://www.tiktok.com/@user/video/123" \
  --job jobs/<id> \
  --mode all \
  --hd

​
Tham số chính

FlagÝ nghĩa
--url1 URL TikTok
--urls-fileFile text nhiều URL (mỗi dòng 1 link)
--job jobs/<id>Ghi output vào job thay vì global pool
--mode video|images|audio|allLoại media cần tải (mặc định video)
--hdƯu tiên bản HD nếu API trả về
--output-dirOverride thư mục output
--report-tomlOverride đường dẫn report TOML

​
Report đầu ra

Skill ghi report TOML gồm:
  • URL nguồn
  • media type
  • local file path
  • title / author (nếu có)
  • dung lượng file
  • metadata duration/dimension (nếu có ffprobe)

​
Lưu ý pháp lý

  • Chỉ tải nội dung khi bạn có quyền sử dụng cho mục đích hiện tại.
  • Không dùng để bypass paywall hoặc nội dung riêng tư.
  • Nếu dùng thương mại, cần xác minh quyền sử dụng footage/audio trước khi render final.