API 文档

RESTful 接口说明 · 小程序对接域名 qsy.aiwyuw.cn

快速开始

  1. 注册账号(普通用户每日 100 次)
  2. 登录 用户中心 复制你的 API Key
  3. 在请求头添加 X-API-Key: 你的密钥
  4. 调用 GET https://qsy.aiwyuw.cn/api/v1/parse?url=分享链接
  5. 小程序开发者请先阅读 微信小程序对接,并在后台配置域名 qsy.aiwyuw.cn

会员与配额

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

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

认证方式

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

Header: X-API-Key: wm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

或 Query 参数: ?api_key=wm_xxxxxxxx

在用户中心获取 Key。演示 Key: demo_key_1234567890abcdef(普通用户 100 次/天)

解析去水印

GETPOST /api/v1/parse

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

请求参数

参数类型必填说明
urlstring视频/图片分享链接
api_keystringAPI 密钥(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

// 响应 data.usage 示例:
{
  "plan": "regular",
  "plan_label": "普通用户",
  "daily_limit": 100,
  "unlimited": false,
  "today_used": 12,
  "today_remain": 88
}

查询解析记录

GET /api/v1/logs

查询当前 API Key 对应账号的解析历史(网页 + API 调用)。也可在 用户中心 查看。

参数类型必填说明
pageint页码,默认 1
per_pageint每页条数,默认 20,最大 50
statusstring筛选:success / failed
GET /api/v1/logs?page=1&per_page=20&status=success
X-API-Key: wm_xxxxxxxx

微信小程序对接

适用于自有小程序或「0毛去水印」类产品,通过 HTTPS 调用本站 API 完成全平台去水印解析。

1. 配置服务器域名(必做)

登录 微信公众平台,进入:

开发 → 开发管理 → 开发设置 → 服务器域名

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

配置项填写域名用途
request 合法域名qsy.aiwyuw.cn调用解析、检测等 API 接口
downloadFile 合法域名qsy.aiwyuw.cn经本站代理下载视频/图片(使用 /api/media.php
重要:请务必在微信开发者后台添加 qsy.aiwyuw.cn,否则小程序内 wx.request 会被微信拦截。域名需已完成 ICP 备案并支持 HTTPS。

2. 接口 Base URL

https://qsy.aiwyuw.cn/api/v1

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

https://qsy.aiwyuw.cn/api/v1/parse

3. 接入流程

  1. 在开发者后台配置 qsy.aiwyuw.cn 为合法域名
  2. 注册账号 并在 用户中心 获取 API Key
  3. 将 API Key 配置在云函数或自有后端(勿写死在小程序前端)
  4. 小程序通过 wx.request 请求解析接口,展示无水印视频/图集

4. 小程序请求示例

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

// 小程序 pages/parse/parse.js
const API_BASE = 'https://qsy.aiwyuw.cn/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 放在云函数中更安全,小程序只调自己的云函数:

// 云函数 cloudfunctions/parse/index.js
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://qsy.aiwyuw.cn/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/parseGET / POST解析去水印(核心)
/api/v1/detectGET检测链接平台
/api/v1/platformsGET支持平台列表
/api/v1/key/infoGET查询 Key 用量
/api/v1/logsGET解析记录

7. 注意事项

网页解析接口(需登录)

GET /api/parse.php

首页在线解析使用此接口,需浏览器登录(Cookie Session),自动消耗账号配额。

获取 API Key

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

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

代码示例

PHP

$url = 'https://v.douyin.com/xxxxx/';
$apiKey = 'demo_key_1234567890abcdef';
$api = "https://qsy.aiwyuw.cn/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://qsy.aiwyuw.cn/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://qsy.aiwyuw.cn/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://qsy.aiwyuw.cn/api/v1/parse?url=https://v.douyin.com/xxxxx/"

错误码

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