抖音解析 API

抖音无水印视频下载服务，由 Cloud Functions（云函数） 提供，采用 Flask 框架。运行时自动剥离 /api 前缀，内部路由为 /parse、/download、/health。

🎵 接口概览

路径	方法	说明
/douyin/parse	POST	解析分享链接，返回无水印视频信息
/douyin/download	GET / POST	代理下载无水印视频
/douyin/health	GET	健康检查

🚀 快速开始

1. 解析视频 — POST /douyin/parse

请求体（JSON）：

{
  "url": "抖音分享链接（短链）"
}

成功响应 200：

{
  "success": true,
  "data": {
    "video_id": "7234567890123456789",
    "title": "视频标题",
    "download_url": "https://v26-web.douyinvod.com/...",
    "cover_url": "https://...",
    "author": {
      "name": "作者昵称",
      "avatar": "https://..."
    },
    "create_time": "2026-07-13 20:00"
  }
}

错误响应 400：

{
  "success": false,
  "error": "未找到有效的分享链接"
}

2. 下载视频 — GET /douyin/download

通过代理下载无水印视频（解决 Referer 防盗链问题），流式响应避免大文件撑爆内存。

GET 参数：

curl "https://api.160621.xyz/v1/douyin/download?url=<video_url>&filename=<video_id>.mp4"

POST 请求体：

{
  "url": "<video_url>",
  "filename": "<video_id>.mp4"
}

返回 video/mp4 流式响应，带 Content-Disposition 附件头。

安全限制：只允许代理抖音域名的 URL（v26-web.douyinvod.com、v3-web.douyinvod.com、aweme.snssdk.com 等），其他域名返回 400。

3. 健康检查 — GET /douyin/health

curl https://api.160621.xyz/v1/douyin/health

返回：

{ "status": "ok" }

⚠️ 错误处理

HTTP 状态码	场景
400	缺少 url 参数 / 分享链接为空 / 解析失败 / 视频源地址不合法
500	服务器内部错误 / 下载失败

🔗 完整流程示例

# 1. 解析分享链接
curl -X POST https://api.160621.xyz/v1/douyin/parse \
  -H "Content-Type: application/json" \
  -d '{"url":"https://v.douyin.com/xxxxx/"}'

# 2. 用返回的 download_url 下载视频
curl -o video.mp4 "https://api.160621.xyz/v1/douyin/download?url=<download_url>&filename=video.mp4"