<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# 聚合短视频解析PRO

> 聚合短视频解析，一个接口覆盖国内外主流视频平台，自动去水印、返回直链 + 多清晰度。

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

## 1. 基本信息

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

## 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)

```bash
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. 响应示例

```json
{
    "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 客户端参数错区分

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/video-parse`

Source: `https://apizero.cn/aidocs/video-parse/raw.md`
Last updated: 2026-05-13T10:42:06+08:00