微信视频号解密服务 - 部署文档

环境要求

• Python 3.8+
• 依赖包
• 代码包下载: https://qyapi.ipaybuy.cn/upload/wx_down.zip

安装依赖

pip install fastapi uvicorn httpx pydantic

目录结构

├── sph-decrypt          # 主程序
├── downloads/           # 加密视频临时目录
├── decrypted/          # 解密后视频目录
├── logs/                # 日志目录
│   └── sph-decrypt.log  # 日志文件

启动服务

python sph-decrypt

服务启动后显示：

==================================================
微信视频号解密服务 - FastAPI 版本
==================================================
日志文件: d:\api\GolandProjects\goVideoWatermarking\download\py\logs\sph-decrypt.log
服务地址: http://0.0.0.0:9888
API文档:  http://0.0.0.0:9888/docs
==================================================

配置说明

在 sph-decrypt 文件中可修改以下配置：

• 宝塔用户可按图片操作，1、在python项目下，选择对应的项目和入口文件 2、选择依赖安装文件，点击确认后等待安装，3、配置域名和https（ssl）

启动完成好后，到项目的配置文件Nginx配置去添加以下内容

# HTTP反向代理相关配置开始 >>>
    location / {
        proxy_pass http://127.0.0.1:9888;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
        
        # 超时设置
        proxy_connect_timeout 500s;
        proxy_send_timeout 500s;
        proxy_read_timeout 500s;
    }
  

微信视频号解密服务 - API接口文档说明

基础信息

• 基础URL：http://{host}:9888
• API文档（Swagger）：http://{host}:9888/docs

1. 解密视频

解密并获取视频，支持多种返回模式。

请求

GET /decrypt

参数

sync 参数说明

示例

同步解密（小文件推荐）

curl "http://localhost:9888/decrypt?encrypted_url=https://example.com/video.mp4&decode_key=abc123&sync=1"

响应示例（sync=1/2）

{
  "success": true,
  "video_id": "20260506143025_abc123",
  "message": "解密完成",
  "video_url": "http://localhost:9888/video/20260506143025_abc123",
  "file_size": 1048576
}

流式返回（sync=3）

• 直接返回视频文件流（MP4格式）
• 支持断点续传和进度条拖动

重定向模式（sync=4）

• 返回 HTTP 302 重定向
• 下载并解密成功后自动跳转到视频地址

缓存说明

• 同一 decode_key 的视频解密后会被缓存
• 再次请求相同 decode_key 时，直接返回已解密视频
• 视频文件名格式：{时间戳}_{decode_key}.mp4

2. 获取视频

通过 video_id 获取已解密的视频文件。

请求

GET /video/{video_id}

示例

curl "http://localhost:9888/video/20260506143025_abc123"

参数

响应

• 200 OK：视频流或文件
• 404 Not Found：视频不存在或还在处理中

3. 查询状态

查询视频的处理状态。

请求

GET /status/{video_id}

示例

curl "http://localhost:9888/status/20260506143025_abc123"

响应示例

{
  "status": "ready",
  "video_url": "/video/20260506143025_abc123"
}

status 状态说明

4. 服务健康检查

请求

GET /

响应示例

{
  "message": "微信视频号解密服务",
  "version": "1.0.0",
  "endpoints": ["/decrypt", "/video/{video_id}"]
}

使用流程（可根据场景选择合适的）

方式一：同步解密（小文件推荐）

1. GET /decrypt?encrypted_url=xxx&decode_key=yyy&sync=1
2. 返回 video_url
3. 通过 GET /video/{video_id} 播放或下载

方式二：一次搞定（小文件推荐）

1. GET /decrypt?encrypted_url=xxx&decode_key=yyy&sync=3
2. 直接返回视频流

方式三：异步解密（大文件推荐）

1. GET /decrypt?encrypted_url=xxx&decode_key=yyy&sync=2
2. 返回 video_url
3. 通过 GET /video/{video_id} 播放或下载

方式四：重定向模式（小文件推荐）

1. GET /decrypt?encrypted_url=xxx&decode_key=yyy&sync=4
2. 自动重定向到视频页面

错误码