SuperAPI AI 工具集

ecommerce-tiktok-video-download-url

设计与创作

查看项目

更新于 10-16 06:50

技能介绍

用途:把一个 TikTok 视频 URL 解析为直接媒体地址,方便保存达人/推广视频素材。输入为必填的 url,支持短链(如 https://vt.tiktok.com/xxxxxx)和完整链接(如 https://www.tiktok.com/@user/video/1234567890),最大长度 1000。返回字段包括:无水印下载链接 noWatermarkDownloadUrl、带水印下载链接 downloadUrl、播放地址 playUrl,以及静态封面 coverUrl 和动态封面 dynamicCoverUrl。

主要能力与限制:并非所有视频都会返回可下载地址。当视频受地区、隐私或可用性限制时,两个下载字段可能缺失,此时只能拿到 playUrl 与封面,应回退用 playUrl 预览,不要编造下载链接。解析出的地址可能随时间失效,建议尽快使用,链接失效后重新解析。

使用方式:API 端点 POST /echotik/getVideoDownloadUrl;也可用 Python 脚本 python scripts/echotik_get_video_download_url.py '<JSON参数>' [--inline]。需设置 NEXSCOPE_API_KEY。该工具消耗积分,同一会话相同参数默认只调用一次,脚本有 24 小时本地缓存;失败或结果为空时不要自动更换关键词、翻页或筛选重试,追加查询前先告知用户。默认脚本会把完整响应写入工作目录下的 JSON 文件,响应体不超过 8 KB 时向 stdout 打印完整 JSON,超过则只输出摘要,可用 --inline 强制完整输出。

适用场景:用户提供 tiktok.com 或 vt.tiktok.com 链接并要求保存、下载或提取该视频;需要无水印版本;保存达人推广视频;获取可播放链接或封面。不适用:按产品 ID 查找推广视频(应使用产品视频技能)、搜索 TikTok 商品、新品榜单、直播数据、视频剪辑或内容创作建议、非 TikTok 平台视频下载。错误码 400 表示 url 缺失或无效,10000 表示链接不是有效/可访问的 TikTok 视频,应提示检查 URL 格式。展示时优先给出无水印链接,同时列出带水印版本,并提醒链接可能过期。