聚合短视频解析PROvideo-parse

聚合短视频解析，一个接口覆盖国内外主流视频平台，自动去水印、返回直链 + 多清晰度。 • **国内平台**：抖音 / 快手 / 小红书 / B 站 / 微博 / 皮皮虾 / 西瓜视频 / 好看视频 / 最右 / 全民 K 歌等 • **海外平台**：TikTok / YouTube（含 Shorts）/ Instagram（Reel/Post）/ Twitter(X) / Facebook • **智能路由**：海外 5 站自动走海外节点，国内域名走国内节点，无需用户关心 • **完整直链**：返回原画 / 1080P / 720P / 480P / 360P 等多档直链，前端可自由选择 • **元数据齐全**：作者 / 头像 / 点赞 / 评论 / 播放量 / 发布时间等 • **图集支持**：小红书图集 / Instagram 多图 Reel 返回 imagelist 数组 • **5 分钟短缓存**：视频 CDN URL 带过期时间戳，短缓存兼顾去重和链接鲜度

1. 基本信息

接口地址	`https://v1.apizero.cn/api/video-parse`
请求方法	`GET`
分类	content
提供方	极数本源
计费模式	按次付费 · 月套餐
单次消耗	0 积分
起步价	¥0.00 / 1000 次
QPS 限制	3 req/s
每日免费额度	20 次（已认证用户）
匿名每日额度	5 次（无 API Key）
VIP 免费	否
调用次数

2. 认证

匿名每日 5次、QPS 1；登录用户每日 20次、QPS 3（全部免费）。命中 5 分钟缓存不计入配额。

获取 API Key：登录 https://apizero.cn/account/keys

3. 请求参数

参数名	类型	必填	说明	示例
`url`	`string`	是	待解析的视频/图文链接。支持完整 URL 或分享短链（如 v.douyin.com/xxx、vm.tiktok.com/xxx）。最大 2048 字符	`https://www.bilibili.com/video/BV1gY411A7y7`

5. 请求示例 (cURL)

curl "https://v1.apizero.cn/api/video-parse?url=https%3A%2F%2Fwww.bilibili.com%2Fvideo%2FBV1gY411A7y7&key=YOUR_API_KEY"

6. 响应字段

字段	类型	说明	示例
`code`	`number`	上游业务状态码（200=成功；400/500=解析失败，详见 message）	—
`platform`	`string`	识别到的平台标识（如 douyin / kuaishou / tiktok / youtube / bilibili ...）	—
`type`	`string`	内容类型（视频 / 图集）	—
`message`	`string`	错误说明（仅失败时有；已对敏感信息脱敏）	—
`data.title`	`string`	视频/笔记标题	—
`data.video_url`	`string`	默认清晰度视频直链（可直接用于 <video src>）	—
`data.cover_url`	`string`	封面图 URL	—
`data.audio_url`	`string`	音频直链（YouTube / B 站独立音轨场景）	—
`data.imagelist`	`array`	图集图片 URL 数组（小红书图文笔记 / IG 多图 Post）	—
`stats.author_name`	`string`	作者昵称	—
`stats.author_avatar`	`string`	作者头像 URL	—
`stats.like_count`	`number`	点赞数	—
`stats.comment_count`	`number`	评论数	—
`stats.share_count`	`number`	转发数	—
`stats.play_count`	`number`	播放数	—
`stats.collect_count`	`number`	收藏数	—
`stats.publish_time`	`string`	发布时间（YYYY-MM-DD HH:MM:SS）	—
`video_list`	`array`	多清晰度视频列表	—
`video_list[].quality`	`string`	清晰度标签（如 1080p60 / 720P / 原画 1080P）	—
`video_list[].url`	`string`	该清晰度的视频直链	—
`video_list[].size`	`string`	预估文件大小（如 38.01MB）	—
`video_list[].resolution`	`string`	分辨率（如 1920x1080）	—

7. 响应示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "code": 200,
        "platform": "bilibili",
        "type": "视频",
        "data": {
            "title": "100小时安娜的睡针，献给所有守望玩家",
            "video_url": "https:\/\/upos-sz-mirrorhw.bilivideo.com\/upgcxcode\/...\/xxx.mp4",
            "cover_url": "http:\/\/i0.hdslb.com\/bfs\/archive\/xxx.jpg",
            "audio_url": "",
            "imagelist": []
        },
        "stats": {
            "author_name": "AIX5E",
            "author_avatar": "https:\/\/i0.hdslb.com\/bfs\/face\/xxx.jpg",
            "like_count": 334,
            "comment_count": 74,
            "share_count": 32,
            "play_count": 6843,
            "collect_count": 21,
            "publish_time": "2022-05-05 16:08:33"
        },
        "video_list": [
            {
                "quality": "原画 1080P",
                "url": "https:\/\/...",
                "size": "~38.01MB",
                "resolution": "1920x1080"
            },
            {
                "quality": "720P",
                "url": "https:\/\/...",
                "size": "~25.34MB",
                "resolution": "1280x720"
            },
            {
                "quality": "480P",
                "url": "https:\/\/...",
                "size": "~11.43MB",
                "resolution": "852x480"
            }
        ]
    },
    "request_id": "abc123def456"
}

8. 错误码

code	status	说明
`4000`	`—`	参数错误：url 为空 / 格式无效 / 长度超过 2048
`4015`	`—`	匿名调用每日额度用完，需要 API Key
`4029`	`—`	QPS 超限
`4030`	`—`	今日额度用完
`5020`	`—`	上游传输层故障（连接失败 / 超时 / 返回空）
`5021`	`—`	上游返回非 JSON / 上游业务解析失败（data.code != 200，msg 见 data.message）

9. 变更日志

1.0.0(2026-05-07)
- 首次上线，支持国内外主流短视频平台智能路由
- 海外 5 站（TikTok / YouTube / Instagram / Twitter / Facebook）自动走海外解析节点
- 其他所有平台走国内解析节点（抖音 / 快手 / 小红书 / B 站 / 微博 ...）
- 【安全】脱敏上游错误消息中的代理凭证（user:pass@host）
- 【安全】脱敏上游错误消息中的内部 IP（10/172/192 私有段 + 107.150.x.x 代理段）
- 【安全】过滤 YouTube extra 字段（cookie_present / proxy_rotation_enabled 等调试信息）
- 完整透传上游响应结构（不改字段名），仅做脱敏和包装
- Redis 5 分钟短缓存（CDN URL 通常几小时过期，短缓存兼顾去重和鲜度）
- 错误细分：传输层故障(5020) / 业务失败(5021) 与 4000 客户端参数错区分