API 参考

所有接口都是普通 HTTP GET 接口，返回 JSON 或重定向。API 已开启 Access-Control-Allow-Origin: *，所以浏览器中的测试工具可以直接请求。

健康检查

GET /health

响应：

{
  "ok": true
}

GET /resolve?url=<douyin-url-or-aweme-id>

名称	是否必填	说明
`url`	是	抖音短链、长链、完整分享文案或裸 `aweme_id`。
`id`	可替代	传裸 `aweme_id` 时可作为 `url` 的别名。

当前 API 基础地址正在读取当前页面域名...

GET /download?url=<douyin-url-or-aweme-id>

该接口返回 302，并重定向到选中的媒体地址。

视频作品默认跳转到探测出的第一个清晰度，通常是最高可用清晰度。

GET /download?url=<douyin-url-or-aweme-id>

指定已探测清晰度：

GET /download?url=<douyin-url-or-aweme-id>&ratio=720p

当前探测阶梯为 1080p、720p、540p、360p。不同作品实际返回的 distinct 文件数量可能不同。

图文作品默认跳转到第一张图片：

GET /download?url=<douyin-url-or-aweme-id>

用从 1 开始的序号指定图片：

GET /download?url=<douyin-url-or-aweme-id>&index=2

当分享数据中包含配乐 MP3 时，可直接跳转到配乐地址：

GET /download?url=<douyin-url-or-aweme-id>&media=music

错误会以 JSON 返回：

{
  "error": "Input must be a Douyin URL or a bare aweme_id."
}

常见状态码：