API 文档 - 全平台去水印 | RESTful 接口与多语言示例

快速导航

快速开始

在注册账号，普通用户每日享 100 次解析额度
登录用户中心，复制属于你的 API Key
在请求头添加 X-API-Key: 你的密钥
调用 GET https://__SITE_HOST__/api/v1/parse?url=分享链接
小程序开发者请先阅读微信小程序对接，并在后台配置域名 __SITE_HOST__

会员与配额

套餐	每日次数	限速	说明
普通用户 (regular)	100 次/天	正常	注册即得，每日 0 点重置
高级会员 (premium)	不限	不限速	按月订阅，QQ 331727029 联系开通，后台开通后生效

配额可在管理后台自定义调整。超出配额返回 429 错误。

认证方式

所有 API 请求必须携带 API Key，网页解析需先登录，使用 Session 鉴权。

Header: X-API-Key: wm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

或 Query 参数: ?api_key=wm_xxxxxxxx

在用户中心获取 Key。演示 Key：demo_key_1234567890abcdef（普通用户 100 次/天）

解析去水印

GET POST /api/v1/parse

核心接口，传入分享链接，返回无水印资源地址。

请求参数

参数	类型	必填	说明
url	string	是	视频或图集分享链接
api_key	string	是	API 密钥（Header 或参数）

请求示例

GET /api/v1/parse?url=https://v.douyin.com/xxxxx/&api_key=demo_key_1234567890abcdef

响应示例

所有平台统一返回三个核心字段：video（视频）、cover（封面）、caption（文案）。

{
  "code": 200,
  "message": "解析成功",
  "data": {
    "platform": "douyin",
    "video": "https://...无水印视频地址",
    "cover": "https://...视频封面",
    "caption": "视频文案内容",
    "author": "作者昵称",
    "type": "video",
    "images": [],
    "music": "https://...背景音乐地址",
    "title": "视频文案内容"
  },
  "time": 1719667200
}

检测平台

GET /api/v1/detect

检测链接属于哪个平台，以及当前是否支持解析。

GET /api/v1/detect?url=https://www.bilibili.com/video/BV1xx

支持平台列表

GET /api/v1/platforms 获取所有支持的平台列表。

查询 Key 用量

GET /api/v1/key/info 查询当前 API Key 的套餐、今日用量与剩余次数。

GET /api/v1/key/info
X-API-Key: wm_xxxxxxxx

{
  "plan": "regular",
  "plan_label": "普通用户",
  "daily_limit": 100,
  "unlimited": false,
  "today_used": 12,
  "today_remain": 88
}

查询解析记录

GET /api/v1/logs

查询当前 API Key 对应账号的解析历史，包含网页与 API 调用，也可在用户中心查看。

参数	类型	必填	说明
page	int	否	页码，默认 1
per_page	int	否	每页条数，默认 20，最大 50
status	string	否	筛选：success 或 failed

GET /api/v1/logs?page=1&per_page=20&status=success
X-API-Key: wm_xxxxxxxx

微信小程序对接

适用于自有小程序或与本站同款的去水印类产品，通过 HTTPS 调用本站 API 完成全平台解析。

1. 配置服务器域名（必做）

登录微信公众平台，进入 开发 → 开发管理 → 开发设置 → 服务器域名。

将以下域名添加到小程序开发者后台，仅填写域名，不要带 https:// 或路径：

配置项	填写域名	用途
request 合法域名	`__SITE_HOST__`	调用解析、检测等 API 接口
downloadFile 合法域名	`__SITE_HOST__`	经本站代理下载视频或图片（使用 `/api/media.php`）

重要：请务必在微信开发者后台添加 __SITE_HOST__，否则小程序内 wx.request 会被微信拦截。域名需已完成 ICP 备案并支持 HTTPS。

2. 接口 Base URL

https://__SITE_HOST__/api/v1

所有接口均在此域名下访问，例如解析接口完整地址：

https://__SITE_HOST__/api/v1/parse

3. 接入流程

在开发者后台配置 __SITE_HOST__ 为合法域名
注册账号并在用户中心获取 API Key
将 API Key 配置在云函数或自有后端，不要写死在小程序前端
小程序通过 wx.request 请求解析接口，展示无水印视频或图集

4. 小程序请求示例

以下为云函数或后端转发后的调用逻辑，Header 携带 X-API-Key：

const API_BASE = 'https://__SITE_HOST__/api/v1';
const API_KEY = '你的API_Key';

async function parseWatermark(shareUrl) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: `${API_BASE}/parse`,
      method: 'GET',
      header: { 'X-API-Key': API_KEY },
      data: { url: shareUrl },
      success(res) {
        if (res.data && res.data.code === 200) {
          resolve(res.data.data);
        } else {
          reject(res.data?.message || '解析失败');
        }
      },
      fail: reject
    });
  });
}

parseWatermark('https://v.douyin.com/xxxxx/')
  .then(data => {
    console.log('视频', data.video);
    console.log('封面', data.cover);
    console.log('文案', data.caption);
  })
  .catch(err => wx.showToast({ title: String(err), icon: 'none' }));

5. 云函数转发示例（推荐）

API Key 放在云函数中更安全，小程序只调用自己的云函数：

const cloud = require('wx-server-sdk');
cloud.init();
const API_KEY = process.env.WATERMARK_API_KEY;

exports.main = async (event) => {
  const url = event.url;
  const https = require('https');
  const qs = new URLSearchParams({ url }).toString();
  const apiUrl = `https://__SITE_HOST__/api/v1/parse?${qs}`;

  return new Promise((resolve, reject) => {
    https.get(apiUrl, { headers: { 'X-API-Key': API_KEY } }, (res) => {
      let body = '';
      res.on('data', chunk => body += chunk);
      res.on('end', () => resolve(JSON.parse(body)));
    }).on('error', reject);
  });
};

6. 常用接口一览

接口	方法	说明
`/api/v1/parse`	GET / POST	解析去水印（核心）
`/api/v1/detect`	GET	检测链接平台
`/api/v1/platforms`	GET	支持平台列表
`/api/v1/key/info`	GET	查询 Key 用量
`/api/v1/logs`	GET	解析记录

7. 注意事项

域名必须配置为 __SITE_HOST__，与开发者后台保持一致
仅支持 https，不支持 HTTP 或 IP 直连
API Key 请勿硬编码在小程序前端，应使用云函数或服务器转发
超出每日配额返回 429，可升级高级会员或购买同款永久方案
视频播放或保存若遇跨域，先 POST /api/media.php 注册媒体地址获取 token，再 GET /api/media.php?t=token 拉取

代码示例

PHP

$url = 'https://v.douyin.com/xxxxx/';
$apiKey = 'demo_key_1234567890abcdef';
$api = "https://__SITE_HOST__/api/v1/parse?url=" . urlencode($url) . "&api_key={$apiKey}";
$result = json_decode(file_get_contents($api), true);
print_r($result['data']);

JavaScript

const res = await fetch('https://__SITE_HOST__/api/v1/parse?url=' + encodeURIComponent(url), {
  headers: { 'X-API-Key': 'YOUR_KEY' }
});
const data = await res.json();
console.log(data.data.video);
console.log(data.data.cover);
console.log(data.data.caption);

Python

import requests
r = requests.get('https://__SITE_HOST__/api/v1/parse', params={
    'url': 'https://v.douyin.com/xxxxx/',
    'api_key': 'demo_key_1234567890abcdef'
})
print(r.json()['data'])

cURL

curl -H "X-API-Key: demo_key_1234567890abcdef" \
  "https://__SITE_HOST__/api/v1/parse?url=https://v.douyin.com/xxxxx/"

错误码

code	说明
200	成功
400	参数错误
401	API Key 无效
429	请求频率超限
500	解析失败

网页解析接口 /api/parse.php 需浏览器登录（Cookie Session），自动消耗账号配额。

获取 API Key

请前往用户注册页面创建账号，注册成功后登录用户中心即可查看 API Key。

不再开放匿名 API Key 申请接口，防止滥用。

API 开发文档