皮皮搞笑无水印解析接口文档与示例代码

一、前言：为什么要做皮皮搞笑无水印解析

皮皮搞笑作为一款主打搞笑短视频的社区 App，里面有大量优质段子、达人作品。很多运营者和自媒体作者在二次创作时，希望去除视频上的水印，得到更干净的原始素材。本文整理了一份通用的「皮皮搞笑无水印解析接口文档」，并附带可直接运行的示例代码，方便快速对接。

提示：本文仅讨论公开的接口对接方式与示例代码，请勿用于任何违反平台协议或法律法规的用途，例如批量盗取他人原创视频、商业倒卖未授权内容等。

二、接口基本信息

2.1 接口地址

通用的解析接口通常以 HTTP POST 形式提交视频链接，服务端返回 JSON 数据。示例地址如下：

• 接口 URL：https://api.example.com/video/pipigaoxiao/parse
• 请求方式：POST
• 数据格式：application/x-www-form-urlencoded �� application/json
• 字符编码：UTF-8

2.2 必填请求参数

2.3 签 sign 生成规则

1. 将除 sign 之外的所有参数按参数名 ASCII 升序排列；
2. 使用 key=value&key=value 形式拼接；
3. 在拼接结果末尾追加服务商提供的 appsecret；
4. 对整段字符串做 MD5，得到的 32 位小写结果即为 sign。

三、返回字段说明

成功返回示例（JSON）：

{ "code": 0, "msg": "ok", "data": { "title": "搞笑日常", "cover": "https://img.example.com/cover.jpg", "video_url": "https://v.example.com/no_watermark.mp4", "duration": 32 } }

四、示例代码

4.1 Python 示例

import hashlib
import time
import requests

APPKEY = "your_appkey"
APPSECRET = "your_appsecret"
VIDEO_URL = "https://h5.pipigaoxiao.com/share/xxxxx"

def make_sign(params, appsecret):
    items = sorted(params.items())
    raw = "&".join([f"{k}={v}" for k, v in items]) + appsecret
    return hashlib.md5(raw.encode("utf-8")).hexdigest()

ts = int(time.time())
params = {
    "url": VIDEO_URL,
    "appkey": APPKEY,
    "timestamp": ts,
}
params["sign"] = make_sign(params, APPSECRET)

resp = requests.post(
    "https://api.example.com/video/pipigaoxiao/parse",
    data=params,
    timeout=15,
)
result = resp.json()
print(result)

4.2 PHP 示例

<?php
$appkey    = "your_appkey";
$appsecret = "your_appsecret";
$videoUrl  = "https://h5.pipigaoxiao.com/share/xxxxx";
$timestamp = time();

$params = [
    "url"       => $videoUrl,
    "appkey"    => $appkey,
    "timestamp" => $timestamp,
];
ksort($params);
$raw = http_build_query($params) . $appsecret;
$sign = md5($raw);

$params["sign"] = $sign;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.example.com/video/pipigaoxiao/parse");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);
?>

五、常见问题与排查思路

• 返回 code 为 1001：通常是 appkey 或 appsecret 填写错误，请到服务商后台核对。
• 返回 code 为 1002：签名 sign 不一致，检查参数排序、拼接顺序以及是否做了 URL 编码。
• 返回 code 为 2001：视频链接无效，确认链接是否完整、是否包含中文字符未编码。
• 返回 code 为 3001：调用频率过高，可在代码中加入缓存或降低并发。
• 解析成功但下载失败：检查 video_url 是否带防盗链，必要时在请求头��上 Referer。

六、使用建议

1. 在服务端做接口调用，避免在前端暴露 appsecret；
2. 对解析结果做缓存，相同链接可设置 24 小时缓存，减少重复请求；
3. 下载到本地后建议使用 ffmpeg 等工具再做一次转码，统一分辨率和码率；
4. 尊重原作者署名权，二次发布时务必标注来源。

七、温馨提示

本文提供的接口文档与示例代码仅用于学习和技术研究，请勿用于批量爬取、盗用他人原创作品或任何违反《网络安全法》《著作权法》及皮皮搞笑平台协议的行为。合规使用接口，才能让技术更好地服务于内容创作。