净链 API · 短视频解析接口平台

在线解析调试

把分享文案整段粘贴进来即可，会自动提取链接。注册后可免费获得 API Key。

API Key 分享链接 / 分享文案

支持抖音视频与图文

↗

解析结果会显示在这里

直链、封面、作者、时长

接口文档

所有接口返回 JSON，鉴权放在请求头。Key 在本机 data/db.json 中管理。

POST /api/v1/parse 解析作品

位置	参数	必填	说明
Header	`x-api-key`	是	API Key，也支持 `Authorization: Bearer <key>`
Body	`url`	是	分享链接或整段分享文案

请求示例

curl -X POST http://localhost:3000/api/v1/parse \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk_你的Key" \
  -d '{"url":"https://v.douyin.com/xxxxxx/"}'

成功响应

{
  "code": 0,
  "message": "ok",
  "requestId": "…",
  "data": {
    "platform": "douyin",
    "id": "7xxxxxxxxxxxxxxxx",
    "mediaType": "video",
    "title": "作品标题",
    "author": "作者昵称",
    "cover": "https://…",
    "duration": 15,
    "videoUrl": "https://…",
    "downloadUrl": "https://…",
    "download": "/api/v1/download?url=…&exp=…&sig=…",
    "cached": false,
    "elapsedMs": 412
  }
}

错误码	HTTP	含义
`MISSING_API_KEY`	401	未携带 Key
`INVALID_API_KEY`	401	Key 不存在
`KEY_DISABLED`	403	Key 被禁用
`QUOTA_EXCEEDED`	429	今日额度用完
`RATE_LIMITED`	429	超过每秒请求限制
`UNSUPPORTED_PLATFORM`	400	平台暂未接入
`UPSTREAM_BLOCKED`	502	上游风控，需要配置 Cookie
`BROWSER_ERROR`	502	无头浏览器启动或解析失败
`DOWNLOAD_TOKEN_INVALID`	403	下载链接过期或签名错误

下载： 解析结果里的 download 是带签名的中转地址，有效期 10 分钟，可直接放到 <a href> 或浏览器打开。解析接口需要 Key，下载接口不需要再带 Key。
其他接口： GET /api/v1/usage 查询当日用量 · GET /api/v1/platforms 查询支持平台 · GET /health 健康检查

套餐与配额

当前骨架按“每日次数”配额，支付与订单模块尚未接入。

免费版

20次 / 日

抖音解析
每秒 2 次限流
30 分钟结果缓存

控制台

注册用户请前往个人控制台；也可以直接输入 Key 查询用量。

尚未查询