X 视频下载 API
通过公开推文链接，获取可用的 MP4 下载地址。
最近更新: 2026-11-02
解析推文
POST https://xvideodownloader.pro/api/v1/resolve
请求头使用 Content-Type: application/json。可选认证：Authorization: Bearer YOUR_API_KEY。
curl https://xvideodownloader.pro/api/v1/resolve \
-H 'Content-Type: application/json' \
--data '{"url":"https://x.com/USERNAME/status/POST_ID"}'
请替换为真实公开推文链接。成功响应包含 code: 0、message: "OK" 和 data。
| 字段 | 含义 |
|---|---|
request_id | 诊断编号 |
post_id, canonical_post_url | 归一化来源信息 |
provider | x-public-embed 或 fxembed |
videos[] | 推文中的可用视频 |
videos[].variants[] | 实际可用 MP4 画质 |
width, height, bitrate | 来源宽高及码率，未知为 null |
has_audio, size_bytes | 未验证为 null，动图音频为 false |
download_url | 临时下载地址 |
ticket_expires_at | 解析后 15 分钟过期 |
source_expires_at | null：上游有效期未知 |
保存文件
GET 访问 download_url，返回 MP4 流及附件下载响应头。支持 HEAD 和单一字节范围，如 bytes=0-1023、bytes=1024-。HEAD 及重试计入下载频率限制。临时地址相当于通行凭证，请勿公开。
错误
错误使用非 2xx HTTP 状态，并包含 code、message、request_id、error、retryable。
| 代码 | HTTP | 处理方式 |
|---|---|---|
INVALID_URL | 400 / 413 / 415 | 检查链接、正文大小和 JSON 格式 |
NO_VIDEO | 422 | 换用包含原生视频的推文 |
NOT_ACCESSIBLE | 422 | 确认公开且未删除 |
UNSUPPORTED_MEDIA | 422 / 413 | 使用受支持且不超过 250 MB 的 MP4 |
UNAUTHORIZED | 401 / 403 | 检查 Key 或请求来源 |
RATE_LIMITED | 429 | 按 Retry-After 等待 |
UPSTREAM_UNAVAILABLE | 502 / 503 | 稍后重试 |
DOWNLOAD_EXPIRED | 410 | 重新解析 |
Key 与限制
登录后创建 Key，完整值仅显示一次，请立即复制。撤销阻止后续认证解析，但已生成的临时下载地址在过期前仍可能有效。查看限制。暂不开放跨域浏览器接入，请从服务器或兼容 MCP 客户端调用。