X 视频下载 · Cloudflare Pages 版

无服务器部署。粘贴推文链接，解析出清晰度后直接下载；也是 iOS 快捷指令的备用入口。

连接设置未检测

API 地址（HTTPS）

API Token

设置只保存在本机浏览器。留空 API 地址时自动使用当前站点。遇到 401 时点「检测接口」，会直接告诉你是服务端没配密钥、没传 Token，还是两边不一致。

支持 x.com / twitter.com、i/web/status、/statuses/ 以及带 /video/2 后缀的链接；分享文本里混着文字也能识别。

curl -s "https://你的域名/api/resolve?url=https://x.com/user/status/1234567890&token=你的TOKEN" | jq

接口只处理公开推文；锁推、敏感内容、已删除推文会返回明确错误（Pages 版没有 yt-dlp / Cookie 兜底）。
默认 redirect 模式：接口只返回 302，iPhone 需要能直连 video.twimg.com 才能下载成功。
若 iPhone 无法直连 X CDN，可设 PROXY_MODE=1 让 Workers 转发视频，但会触碰 Cloudflare 关于传输视频的服务条款，请自行评估。
一条推文有多个视频时，用 index 参数（1 起）选择，默认第 1 个。
*.pages.dev 在国内常被 DNS 污染，务必绑定自定义域名。
报 401 时先点上方「检测接口」看诊断。最常见的是首次部署后还没设置 API_TOKEN Secret，或设置后忘了重新部署 —— 这两种情况下填什么 Token 都会被拒绝。
点「下载」出现 HTTP 403，是 X 的 CDN 拒绝了请求：跨域跳转带上了本站 Referer（防盗链），或当前网络根本连不上 video.twimg.com。页面已对所有下载链接强制 no-referrer；仍失败就点「服务端代理下载」，让 Workers 转发视频（个人低频自用；注意 Cloudflare 关于传输视频的服务条款）。国内网络最稳的仍是 VPS 代理版。