API 文档

媒体解析 · 无水印素材提取

首页 购买 Key 我的账号

接入说明

Base URL（当前部署）：

http://110.42.63.245:8051

统一响应结构：

{
  "code": 200,
  "message": "成功",
  "succ": true,
  "data": { ... }
}
首页网页体验可不带 Key，但每个 IP 每小时限 30 次。正式对接请使用 API Key，不受该限制。

鉴权

可在 我的账号 注册登录后购买/续费/更换 Key，也可走 购买页。请求时携带：

方式写法
推荐 HeaderX-API-Key: mp_xxxx
BearerAuthorization: Bearer mp_xxxx
Body / Queryapi_key=mp_xxxx（备选）

无效或已禁用的 Key 返回 403。开启强制鉴权（REQUIRE_API_KEY=1）后，无 Key 返回 401。

POST/api/parse

解析短视频 / 图文链接，返回无水印地址。

请求

Content-Type: application/json
X-API-Key: mp_xxxx

{
  "text": "分享文案或完整链接，例如 https://v.douyin.com/xxxxx/"
}

成功 data 字段

字段说明
platform平台名，如抖音、快手、小红书
title标题
video_url视频直链（CDN 原地址）
source_video_url与 video_url 相同，兼容旧字段
cover_url封面
audio_url音频（如有）
image_list图集；元素可为字符串或 {url, live_photo_url}
video_list多视频列表（如豆包一帖多视频）；元素为 {index, vid, video_url, source_video_url, cover_url}；单视频时为空数组，主地址仍用 video_url
author作者信息对象
video_id平台侧视频 ID（如有）

示例

curl -X POST 'http://110.42.63.245:8051/api/parse' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: mp_xxxx' \
  -d '{"text":"https://v.douyin.com/xxxxx/"}'

POSTGET/api/parse/v2

与 /api/parse 相同解析逻辑，额外返回兼容字段。

入参说明
POST body text分享文案 / 链接
GET query url链接地址

额外字段：url、sourceURL、streamUrl、imgUrls、sourceImgUrls、type（1=视频，0=图文）。

curl 'http://110.42.63.245:8051/api/parse/v2?url=https://v.douyin.com/xxxxx/' \
  -H 'X-API-Key: mp_xxxx'

POSTGET/api/detail

作品详情：标题、发布时间、作者、点赞 / 评论 / 收藏 / 分享 / 播放量。目前支持抖音、快手、小红书、视频号、微博、今日头条、知乎。不返回视频或图片直链。

请求

Content-Type: application/json
X-API-Key: mp_xxxx

{
  "text": "https://v.douyin.com/xxxxx/"
}

GET 也可用 ?url= 或 ?text=。

成功 data 字段

字段说明
platform抖音 / 快手 / 小红书 / 视频号 / 微博 / 今日头条 / 知乎
work_id作品 ID
title标题
desc正文 / 描述
typevideo / image / note
publish_time发布时间（Unix 秒）
publish_time_str北京时间 YYYY-MM-DD HH:MM:SS
author作者：nickname / author_id / avatar
stats.like_count点赞
stats.comment_count评论
stats.collect_count收藏
stats.share_count分享 / 转发
stats.play_count播放 / 阅读（有则返回）
cover_url封面

示例

curl -X POST 'https://video.zacao.top/api/detail' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: mp_xxxx' \
  -d '{"text":"https://v.douyin.com/xxxxx/"}'

POSTGET/api/user/posts

主页作品列表（分页）。已支持：抖音、快手、小红书、哔哩哔哩、微博、知乎、TikTok。返回作品元信息与封面，不返回视频直链；需要直链请再调 /api/parse。

说明：小红书建议主页链接自带 xsec_token；快手依赖有效 PC Cookie；B 站 / 微博 / TikTok 在部分机房 IP 下可能被平台风控。

请求

Content-Type: application/json
X-API-Key: mp_xxxx

{
  "text": "https://www.douyin.com/user/MS4wLjABAAAA...",
  "cursor": 0,
  "count": 18
}

也可传 user_id / 抖音 sec_uid，并可用 platform 强制指定。小红书建议带 xsec_token。下一页把上次返回的 cursor 原样带回。GET 可用查询参数。

成功 data 字段

字段说明
platform平台名
user_id / sec_uid用户 ID（抖音兼容 sec_uid）
author作者：nickname / author_id / avatar
list作品数组：work_id / desc / type / cover_url / share_url / stats / create_time
cursor / max_cursor下一页游标（B 站为页码）
has_more是否还有下一页
count本页条数

示例

curl -X POST 'https://video.zacao.top/api/user/posts' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: mp_xxxx' \
  -d '{"text":"https://space.bilibili.com/2","cursor":1,"count":12}'

GET/api/video/stream

部分平台直链有防盗链，接口可能返回站内代理地址。也可自行调用流代理：

参数说明
url源视频地址（需 URL 编码）
referer可选，源站 Referer
 
GET /api/video/stream?url=<encoded_video_url>&referer=<encoded_page_url>

错误码

code / HTTP含义
200成功
400参数错误 / 链接不支持
401缺少 API Key（强制鉴权时）
403Key 无效、禁用，或内容不可访问
404内容可能已删除
429匿名 IP 小时额度用尽（默认 30 次）
500 / 502服务异常或抓取失败

探活：GET /api/health → {"code":200,"message":"ok","succ":true}

客户账号 API

浏览器访问 /account 使用完整界面。以下接口需携带 Cookie 会话（credentials: 'same-origin'）。

方法路径说明
POST/api/account/register注册：username + password
POST/api/account/login登录
POST/api/account/logout退出
GET/api/account/me当前登录状态
POST/api/account/password改密：old_password + new_password
GET/api/account/keys我的 Key 列表（脱敏）
POST/api/account/keys/bind绑定已有 Key
POST/api/account/keys/<id>/rotate更换 Key（旧串立即作废）
POST/api/account/keys/<id>/revoke作废 Key
GET/api/account/keys/<id>/usage用量统计
POST/api/account/orders登录态下单购买/续费
Key 泄露时在账号中心点「更换」即可签发新串并作废旧串。忘记密码请联系管理员在后台重置。

支持平台

抖音、快手、小红书、B站、今日头条、TikTok、豆包、Dola、即梦、视频号、公众号、百度、得物、腾讯新闻、微博、西瓜视频、知乎、微视、梨视频等 30+ 平台。

API Key 建议在 /account 管理；也可在 /buy 购买。请求时携带 X-API-Key，完整 Key 请妥善保存。