# 下载平台

**Repository Path**: deardhp/download-platform

## Basic Information

- **Project Name**: 下载平台
- **Description**: 已经支持抖音、快手、哔哩哔哩、TikTok、YouTube、X、Instagram视频下载
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-25
- **Last Updated**: 2026-04-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视频解析下载服务

FastAPI 架构的多平台短视频解析后端服务。

## 支持的平台

| 平台 | 链接格式 |
|------|----------|
| 抖音 | `https://v.douyin.com/xxx` |
| 哔哩哔哩 | `https://www.bilibili.com/video/BVxxx` |
| TikTok | `https://www.tiktok.com/@user/video/xxx` |
| 快手 | `https://v.kuaishou.com/xxx` |
| Instagram | `https://www.instagram.com/reel/xxx` |
| X | `https://x.com/user/status/xxx` |
| YouTube | `https://www.youtube.com/watch?v=xxx` |

## 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 启动服务

Windows:
```bash
start.bat
```

Linux/Mac:
```bash
bash start.sh
```

或直接运行:
```bash
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
```

### 3. 访问API文档

打开浏览器访问: http://localhost:8000/docs

## API 接口

### 解析视频

**POST /api/parse**

```json
{
    "url": "https://v.douyin.com/xxx"
}
```

响应:
```json
{
    "success": true,
    "message": "解析成功",
    "data": {
        "title": "视频标题",
        "video_url": "https://example.com/video.mp4",
        "cover_url": "https://example.com/cover.jpg",
        "platform": "douyin"
    }
}
```

**GET /api/parse?url=xxx**

GET方式同样支持。

### 获取支持的平台

**GET /api/platforms**

## 项目结构

```
下载平台-server/
├── app/
│   ├── api/
│   │   └── video.py          # API路由
│   ├── core/
│   │   └── config.py         # 配置
│   ├── services/
│   │   ├── parser.py         # 解析器统一入口
│   │   ├── base.py           # 基类
│   │   ├── douyin_service.py # 抖音
│   │   ├── bilibili_service.py # B站
│   │   ├── tiktok_service.py  # TikTok
│   │   ├── kuaishou_service.py # 快手
│   │   ├── instagram_service.py # Instagram
│   │   ├── x_service.py       # X
│   │   └── youtube_service.py # YouTube
│   └── main.py               # 应用入口
├── requirements.txt          # 依赖
├── start.bat                 # Windows启动脚本
├── start.sh                  # Linux启动脚本
└── README.md
```

## 前端调用示例

```javascript
// 小程序/前端调用
uni.request({
    url: 'http://localhost:8000/api/parse',
    method: 'POST',
    data: {
        url: 'https://v.douyin.com/xxx'
    },
    success: (res) => {
        if (res.data.success) {
            const { video_url, cover_url } = res.data.data;
            // 使用video_url播放视频
            // 使用cover_url显示封面
        }
    }
});
```

## 注意事项

1. 部分平台可能需要网络代理才能访问
2. 请勿用于商业用途
3. 解析结果仅供个人学习使用