随机快手美女视频V1

# 随机美女短视频 API 文档 ## API描述 基于第三方视频源封装的随机美女短视频接口，支持**完全随机**（无参数）或**指定分类**返回短视频内容。支持MP4直链跳转和JSON数据返回两种模式，所有JSON响应均经过美化格式化，便于阅读。 **特点：** - 🎲 **零参数随机**：不传递任何参数时自动随机选择分类并返回视频 - 🏷️ **分类丰富**：16种视频分类可选 - 📱 **双模式输出**：支持直接播放(MP4)或JSON数据返回 - ✨ **响应美化**：JSON格式自动美化，带中文分类名称 --- ## 请求地址 ``` GET https://站点域名/api/sjspks/ksvideo.php ``` --- ## 请求参数 (JSON格式) ```json [ { "name": "id", "type": "string", "required": false, "description": "视频分类ID，不传则随机。可选值：jk(JK制服)、YuMeng(欲梦)、NvDa(女大学生)、NvGao(女高中生)、ReWu(热舞)、QingCun(清纯)、YuZu(玉足)、SheJie(蛇姐)、ChuanDa(穿搭)、GaoZhiLiangXiaoJieJie(高质量小姐姐)、HanFu(汉服)、HeiSi(黑丝)、BianZhuang(变装)、LuoLi(萝莉)、TianMei(甜妹)、BaiSi(白丝)" }, { "name": "type", "type": "string", "required": false, "description": "返回格式，不传默认mp4。可选值：mp4(直接跳转视频)、json(返回JSON数据)" } ] ``` --- 响应示例 (JSON格式) 1. 默认无参数请求（直接跳转视频） 请求： `GET /api/sjspks/ksvideo.php` 行为： 自动随机选择分类，HTTP 302跳转到视频直链 --- 2. 指定分类+MP4格式（直接跳转） 请求： `GET /api/sjspks/ksvideo.php?id=jk&type=mp4` 行为： 直接302跳转到对应分类视频 --- 3. JSON格式响应（美化后） 请求： `GET /api/sjspks/ksvideo.php?id=jk&type=json` 响应： ```json { "code": 200, "message": "success", "data": { "video_info": { "url": "https://txmov2.a.kwimgs.com/upic/2023/12/17/17/xxxxx.mp4", "direct_play": "https://txmov2.a.kwimgs.com/upic/2023/12/17/17/xxxxx.mp4" }, "category": { "id": "jk", "name": "JK制服" }, "request_params": { "id": "jk", "type": "json" }, "raw_response": { "status": "success", "link": "https://txmov2.a.kwimgs.com/..." } } } ``` --- 4. 错误响应示例 ```json { "code": 400, "message": "无效的分类ID", "data": { "available_categories": [ "jk", "YuMeng", "NvDa", "NvGao", "ReWu", "QingCun", "YuZu", "SheJie", "ChuanDa", "GaoZhiLiangXiaoJieJie", "HanFu", "HeiSi", "BianZhuang", "LuoLi", "TianMei", "BaiSi" ], "tip": "不传id参数将随机返回所有分类" } } ``` --- 使用场景 | 场景 | 请求示例 | 说明 | | :--- | :--- | :--- | | 完全随机视频 | `/api/sjspks/ksvideo.php` | 每次刷新随机分类 | | 指定JK视频 | `/api/sjspks/ksvideo.php?id=jk` | 直接播放JK分类 | | 获取JSON数据 | `/api/sjspks/ksvideo.php?id=jk&type=json` | 获取视频链接信息 | | 热舞分类 | `/api/sjspks/ksvideo.php?id=ReWu` | 直接播放热舞视频 | --- 注意事项 1. 默认行为：无任何参数时随机返回视频，适合作为"试试手气"功能 2. 视频来源：上游接口来自 `api.mmp.cc`，如上游失效本接口也会受影响 3. 缓存建议：视频URL具有时效性，建议前端不要长期缓存返回的链接 4. 合规使用：请确保使用场景符合当地法律法规