🪄更新自述文件

This commit is contained in:
Evil0ctal 2022-04-06 10:40:55 -07:00 committed by GitHub
parent e16e0049c1
commit baa558eabf
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

221
README.md
View File

@ -1,4 +1,4 @@
# 欢迎使用 `TikTokDownloader_PyWebIO` (抖音在线解析)
# 欢迎使用 `Douyin_TikTok_Download_API` (抖音/TikTok无水印解析API)
![](https://views.whatilearened.today/views/github/Evil0ctal/TikTokDownloader_PyWebIO.svg)
[![GitHub license](https://img.shields.io/github/license/Evil0ctal/TikTokDownloader_PyWebIO)](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/blob/main/LICENSE)
@ -6,27 +6,41 @@
[![GitHub forks](https://img.shields.io/github/forks/Evil0ctal/TikTokDownloader_PyWebIO)](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/network)
[![GitHub stars](https://img.shields.io/github/stars/Evil0ctal/TikTokDownloader_PyWebIO)](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/stargazers)
目录: [API](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO#%EF%B8%8Fapi%E4%BD%BF%E7%94%A8) [截图](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO#%E6%88%AA%E5%9B%BE) [部署](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO#%E9%83%A8%E7%BD%B2)
Language: [[English](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/README.en.md)] [[简体中文](https://github.com/Evil0ctal/Douyin_TikTok_Download_API/blob/main/README.md)]
Language: [[English](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/blob/main/README.en.md)] [[简体中文](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/blob/main/README.md)]
> Note: Words "TikTok" in this readme file mentioned stands for the Chinese version of TikTok.
> AKA [[Douyin](https://www.douyin.com/)] or [[抖音](https://www.douyin.com/)] , The US TikTok is now supported! (no gallery analysis function)
> Note: This API is applicable to Douyin and TikTok. Douyin is TikTok in China. The code of this repository cannot be used for any commercial purpose. You can distribute or modify the code at will, but please mark the original author.
> 注: 此API适用于Douyin和TikTokDouyin为中国区域的TikTok此仓库的代码不得用于任何商业目的你可以随意分发或修改代码但请标注原作者。
## 👻介绍
🚀演示地址:[https://douyin.wtf/](https://douyin.wtf/)
🛰API演示[https://douyin.wtf/api?url=https://v.douyin.com/R9bQKx4/](https://douyin.wtf/api?url=https://v.douyin.com/R9bQKx4/)
🛰API演示[https://api.douyin.wtf/](https://douyin.wtf/)
💾iOS快捷指令: [点击获取指令](https://www.icloud.com/shortcuts/e8243369340548efa0d4c1888dd3c170) 更新于2022/02/06
本项目使用 [PyWebIO](https://github.com/pywebio/PyWebIO)、[Requests](https://github.com/psf/requests)、[Flask](https://github.com/pallets/flask)利用Python实现在线批量解析抖音的无水印视频/图集。
本项目使用 [PyWebIO](https://github.com/pywebio/PyWebIO)、[Flask](https://github.com/pallets/flask)利用Python实现在线批量解析抖音的无水印视频/图集。
可用于下载作者禁止下载的视频,同时可搭配[iOS快捷指令APP](https://apps.apple.com/cn/app/%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4/id915249334)配合本项目API实现应用内下载。
快捷指令需要在抖音或TikTok的APP内选择你想要保存的视频点击分享按钮然后找到 "抖音TikTok无水印下载" 这个选项如遇到通知询问是否允许快捷指令访问xxxx (域名或服务器),需要点击允许才可以正常使用。
## 💡项目文件结构
```
.
└── Douyin_TikTok_Download_API/
├── Web/
│ ├── web_zh.py(网页入口)
│ ├── scraper.py(解析库)
│ └── logs.txt(错误日志)
└── API/
├── web_api.py(API)
├── scraper.py(解析库)
└── API_logs.txt(API调用日志)
```
## 💯已支持功能:
- 支持抖音视频/图集解析
@ -51,17 +65,42 @@ Language: [[English](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/blob
pip install -r requirements.txt
```
- 运行TikTok_ZH.py (Python版本需3.9以上)
- 网页解析
```text
python3 TikTok_ZH.py
# python3 TikTok_EN.py - English interface
# 运行web_zh.py (测试过的Python版本为3.8)
python3 web_zh.py
```
- 进入主页
- API
```text
http://localhost(服务器IP):80/
# 运行web_api.py (测试过的Python版本为3.8)
python3 web_api.py
```
- 调用解析库
```text
# 将scraper.py拷贝至你的项目目录(测试过的Python版本为3.8)
# 在该项目中导入scraper.py
from scraper import Scraper
api = Scraper()
# 解析Douyin视频/图集(返回字典)
douyin_data = api.douyin('抖音分享口令/链接')
print(douyin_data )
# 解析TikTok视频/图集(返回字典)
tiktok_data = api.tiktok('TikTok分享口令/链接')
print(tiktok_data )
```
- 入口
```text
网页入口:
http://localhost(服务器IP):5000/
API入口:
http://localhost(服务器IP):2333/
```
## 🗺️支持的提交格式:
@ -118,7 +157,7 @@ API可将请求参数转换为需要提取的无水印视频/图片直链,配
- 解析请求参数
```text
http://localhost(服务器IP):80/api?url="复制的(抖音/TikTok)口令/链接"
http://localhost(服务器IP):2333/api?url="复制的(抖音/TikTok)口令/链接"
```
- 返回参数
@ -127,13 +166,33 @@ http://localhost(服务器IP):80/api?url="复制的(抖音/TikTok)口令/链接"
```json
{
"Status": "Success",
"Type": "Video",
"video_author": "花花花菜",
"video_author_id": "Wobukunxixi",
"video_music": "https://sf3-cdn-tos.douyinstatic.com/obj/ies-music/6906830659719383822.mp3",
"video_title": "~猫跟你都想了解",
"video_url": "https://v3-dy-o.zjcdn.com/93e3a68e365ae83f4ce2b2bb9c253489/6191c9c3/video/tos/cn/tos-cn-ve-15/083012c589c842e69f5267803eb8e3a5/?a=1128&br=2262&bt=2262&cd=0%7C0%7C0&ch=96&cr=0&cs=0&cv=1&dr=0&ds=3&er=&ft=StecAhgM6BMM8b8NDtPDWodpeaQ&l=202111150945070102121380392D1AC2F5&lr=all&mime_type=video_mp4&net=0&pl=0&qs=0&rc=ajh5aTRseW95eTMzNGkzM0ApNjk1OTU6OWVlN2Q7ODo0N2cpaHV2fWVuZDFwekBvbTJjMDVrbmBfLS1eLS9zczRhXi9iLmFgYGBfLy1iLi46Y29zYlxmK2BtYmJeYA%3D%3D&vl=&vr="
"analyze_time":"1.9043s",
"api_url":"https://www.iesdouyin.com/web/api/v2/aweme/iteminfo/?item_ids=6918273131559881997",
"nwm_video_url":"http://v3-dy-o.zjcdn.com/23f0dec312ede563bef881af9a88bdc7/624dd965/video/tos/cn/tos-cn-ve-15/eccedcf4386948f5b5a1f0bcfb3dcde9/?a=1128&br=2537&bt=2537&cd=0%7C0%7C0%7C0&ch=0&cr=0&cs=0&cv=1&dr=0&ds=3&er=&ft=sYGC~3E7nz7Th1PZSDXq&l=202204070118030102080650132A21E31F&lr=&mime_type=video_mp4&net=0&pl=0&qs=0&rc=M3hleDRsODlkMzMzaGkzM0ApODpmNWc4ODs5N2lmNzg5aWcpaGRqbGRoaGRmLi4ybnBrbjYuYC0tYy0wc3MtYmJjNTM2NjAtNDFjMzJgOmNwb2wrbStqdDo%3D&vl=&vr=",
"original_url":"https://v.douyin.com/L4FJNR3/",
"platform":"douyin",
"status":"success",
"url_type":"video",
"video_author":"Real机智张",
"video_author_id":"Rea1yaoyue",
"video_author_signature":"",
"video_author_uid":"59840491348",
"video_aweme_id":"6918273131559881997",
"video_comment_count":"89145",
"video_create_time":"1610786002",
"video_digg_count":"2968195",
"video_hashtags":[
"百万转场变身"
],
"video_music":"https://sf3-cdn-tos.douyinstatic.com/obj/ies-music/6910889805266504461.mp3",
"video_music_author":"梅尼耶",
"video_music_id":"6910889820861451000",
"video_music_mid":"6910889820861451021",
"video_music_title":"@梅尼耶创作的原声",
"video_play_count":"0",
"video_share_count":"74857",
"video_title":"骑白马的也可以是公主#百万转场变身",
"wm_video_url":"https://aweme.snssdk.com/aweme/v1/playwm/?video_id=v0300ffe0000c01a96q5nis1qu5b1u10&ratio=720p&line=0"
}
```
@ -141,15 +200,40 @@ http://localhost(服务器IP):80/api?url="复制的(抖音/TikTok)口令/链接"
```json
{
"Status": "Success",
"Type": "Image",
"image_author": "三石壁纸(收徒)",
"image_author_id": "782972562",
"image_music": "https://sf6-cdn-tos.douyinstatic.com/obj/tos-cn-ve-2774/635efafc32694ffbb73fbe60eca4a99d",
"image_title": "#壁纸 #炫酷壁纸 #图集 每一张都是精选",
"image_url": [
"https://p3-sign.douyinpic.com/tos-cn-i-0813/4af91199ca154074a8a5a63c3c749c6f~noop.webp?x-expires=1639530000&x-signature=P446eJEt2yuyhf2yb58Be29UpBA%3D&from=4257465056&s=PackSourceEnum_DOUYIN_REFLOW&se=false&sh=&sc=&l=202111150954330102120702320620C75E&biz_tag=aweme_images"
]
"album_author":"治愈图集",
"album_author_id":"ZYTJ2002",
"album_author_signature":"取无水印图",
"album_author_uid":"449018054867063",
"album_aweme_id":"7015137063141920030",
"album_comment_count":"5436",
"album_create_time":"1633338878",
"album_digg_count":"193734",
"album_hashtags":[
"晚霞",
"治愈系",
"落日余晖",
"日落🌄"
],
"album_list":[
"https://p26-sign.douyinpic.com/tos-cn-i-0813/5223757a7bef4f8480cd25d0fa2d2d94~noop.webp?x-expires=1651856400&x-signature=K1VjJdWTHCAaYSz14y6NumjjtfI%3D&from=4257465056&s=PackSourceEnum_DOUYIN_REFLOW&se=false&biz_tag=aweme_images&l=202204070120460102101050412A210A47",
"https://p26-sign.douyinpic.com/tos-cn-i-0813/d99467672da840908acccf2d2b4b7ef7~noop.webp?x-expires=1651856400&x-signature=ncBb8Tt7z4PmpUyiCNr%2FJYnwRSA%3D&from=4257465056&s=PackSourceEnum_DOUYIN_REFLOW&se=false&biz_tag=aweme_images&l=202204070120460102101050412A210A47",
"https://p26-sign.douyinpic.com/tos-cn-i-0813/5c2562210b1a4d4c99d6d4dbd2f23f2b~noop.webp?x-expires=1651856400&x-signature=Rsmplb53IKfvKd3mmIb4iQNhlIE%3D&from=4257465056&s=PackSourceEnum_DOUYIN_REFLOW&se=false&biz_tag=aweme_images&l=202204070120460102101050412A210A47",
"https://p26-sign.douyinpic.com/tos-cn-i-0813/9bb74c0c6aff4217bd1491a077b2c817~noop.webp?x-expires=1651856400&x-signature=BLRyHoKP0ybIci57yneOca62dxI%3D&from=4257465056&s=PackSourceEnum_DOUYIN_REFLOW&se=false&biz_tag=aweme_images&l=202204070120460102101050412A210A47"
],
"album_music":"https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/6978805801733442341.mp3",
"album_music_author":"魏同学",
"album_music_id":"6978805810365271000",
"album_music_mid":"6978805810365270791",
"album_music_title":"@魏同学创作的原声",
"album_play_count":"0",
"album_share_count":"30717",
"album_title":"“山海自有归期 风雨自有相逢 意难平终将和解 万事终将如意”#晚霞 #治愈系 #落日余晖 #日落🌄",
"analyze_time":"1.0726s",
"api_url":"https://www.iesdouyin.com/web/api/v2/aweme/iteminfo/?item_ids=7015137063141920030",
"original_url":"https://v.douyin.com/Nb8jysN/",
"platform":"douyin",
"status":"success",
"url_type":"album"
}
```
@ -157,50 +241,74 @@ http://localhost(服务器IP):80/api?url="复制的(抖音/TikTok)口令/链接"
```JSON
{
"Status":"Success",
"Type":"Video",
"followerCount":18,
"followingCount":18,
"likes_recived":3000000,
"music_author":"❁ちゅらる❁",
"music_title":"オリジナル楽曲 - ♛",
"original_url":"https://vm.tiktok.com/TTPdkQvKjP/",
"video_author":"nemi__goro",
"video_author_id":"78903680178",
"video_count":203,
"video_music":"https://sf16-ies-music-sg.tiktokcdn.com/obj/tiktok-obj/6967616110887701250.mp3",
"video_title":"#ベルメイク",
"video_url":"https://v16m.tiktokcdn.com/65824a4bba45fbf4691d1ea2d040d2cc/6200e22c/video/tos/alisg/tos-alisg-pve-0037/6799cebe4a2248b98828788c94964a57/?a=1233&br=4118&bt=2059&cd=0%7C0%7C0%7C3&ch=0&cr=3&cs=0&cv=1&dr=0&ds=3&er=&ft=CvjiQnB4TJBS6BMyjOYNVKP&l=20220207031102010223065036144769B6&lr=all&mime_type=video_mp4&net=0&pl=0&qs=0&rc=M3NtaTo6Zjc5OTMzODgzNEApOWVmaTtlZDs7N2VlNjc8N2dzMjAzcjRfXzZgLS1kLy1zcy8wMS0uXi8uLjY2YGFjYDE6Yw%3D%3D&vl=&vr=",
"water_mark_url":"https://v16-webapp.tiktok.com/233cec8c26b1a7d46fb6caaf5b354621/6200efc0/video/tos/alisg/tos-alisg-pve-0037/a00cfbcc79f54b66824aac6a871777c8/?a=1988&br=3506&bt=1753&cd=0%7C0%7C1%7C0&ch=0&cr=0&cs=0&cv=1&dr=0&ds=3&er=&ft=XOQ9-3E7nz7ThxPVoDXq&l=202202070408580102231230340B4C6876&lr=tiktok&mime_type=video_mp4&net=0&pl=0&qs=0&rc=M3NtaTo6Zjc5OTMzODgzNEApO2k8aTw0M2Q0N2VoZ2VoOWdzMjAzcjRfXzZgLS1kLy1zc19eYWJgY2E0MmFjMjY2MWE6Yw%3D%3D&vl=&vr="
"analyze_time":"5.0863s",
"nwm_video_url":"https://v19.tiktokcdn-us.com/cfa357dadd8f913f013a6d0b0dca293f/624e20fa/video/tos/useast5/tos-useast5-ve-0068c003-tx/3296231486014755a1b81aa70c349a53/?a=1233&br=6498&bt=3249&cd=0%7C0%7C0%7C3&ch=0&cr=3&cs=0&cv=1&dr=0&ds=6&er=&ft=bY1KJnB4TJBS6BMy-L1iVKP&l=20220406172333010113135214232FAB56&lr=all&mime_type=video_mp4&net=0&pl=0&qs=0&rc=MzpsaGY6Zjo7PDMzZzczNEApNjY6ZTtkOzxpN2Q3PDo5OmdgZ2BtcjQwai9gLS1kMS9zczJhLTEzYjEuMTJeXzQyLmM6Yw%3D%3D&vl=&vr=",
"original_url":"https://www.tiktok.com/@oregonzoo/video/7080938094823738666",
"platform":"tiktok",
"status":"success",
"url_type":"video",
"video_author":"oregonzoo",
"video_author_SecId":"MS4wLjABAAAArWNQ8-AZN6CxWOkqdeWsMBUuLDmJt8TWUAk0S4aWDW5V5EoqRbuczhaLnxJHCGob",
"video_author_diggCount":94,
"video_author_followerCount":1800000,
"video_author_followingCount":39,
"video_author_heartCount":29700000,
"video_author_id":"6699816060206171141",
"video_author_nickname":"Oregon Zoo",
"video_author_videoCount":264,
"video_aweme_id":"7080938094823738666",
"video_comment_count":61,
"video_create_time":"1648659375",
"video_digg_count":11800,
"video_hashtags":[
"redpanda",
"boop",
"sunshine"
],
"video_music":"https://sf16.tiktokcdn-us.com/obj/ies-music-tx/7075363935741856558.mp3",
"video_music_author":"Gilderoy Dauterive",
"video_music_id":"7075363884613356330",
"video_music_title":"Be the Sunshine",
"video_music_url":"https://sf16.tiktokcdn-us.com/obj/ies-music-tx/7075363935741856558.mp3",
"video_play_count":60100,
"video_ratio":"720p",
"video_share_count":298,
"video_title":"Moshu ✨ #redpanda #boop #sunshine",
"wm_video_url":"https://v16m-webapp.tiktokcdn-us.com/0394b9183a5852d4392a7e804bf78c55/624e20f6/video/tos/useast5/tos-useast5-ve-0068c001-tx/fc63ae232e70466398b55ccf97eb3c67/?a=1988&br=6468&bt=3234&cd=0%7C0%7C1%7C0&ch=0&cr=0&cs=0&cv=1&dr=0&ds=3&er=&ft=XY53A3E7nz7Th-pZSDXq&l=202204061723290101131351171341B9BB&lr=tiktok_m&mime_type=video_mp4&net=0&pl=0&qs=0&rc=MzpsaGY6Zjo7PDMzZzczNEApOjo4aDMzZmRlN2loOWk6ZWdgZ2BtcjQwai9gLS1kMS9zczBhNGA0LTIwNjNiYDQ2YmE6Yw%3D%3D&vl=&vr="
}
```
- 下载视频请求参数
```text
http://localhost(服务器IP):80/video?url="复制的(抖音/TikTok)口令/链接"
#返回mp4文件
http://localhost(服务器IP):2333/video?url="复制的(抖音/TikTok)口令/链接"
# 返回无水印mp4文件
# 大量请求时很吃服务器内存,容易崩,慎用。
```
- 下载音频请求参数
```text
http://localhost(服务器IP):80/bgm?url="复制的(抖音/TikTok)口令/链接"
#返回mp3文件
http://localhost(服务器IP):2333/music?url="复制的(抖音/TikTok)口令/链接"
# 返回mp3文件
# 大量请求时很吃服务器内存,容易崩,慎用。
```
---
## 💾部署
> 最好将本项目部署至海外服务器,否则可能会出现奇怪的问题
> 注:
截图可能因更新问题与文字不符,一切请优先参照文字叙述。
> 最好将本项目部署至海外服务器,否则可能会出现奇怪的问题。
项目部署在国内服务器而人在美国点击结果页面链接报错403 目测与抖音CDN有关系。
> 使用宝塔Linux面板进行部署
- 首先要去安全组开放5000端口默认5000可以在文件底部修改。
- 在宝塔应用商店内搜索python并安装项目管理器
- 首先要去安全组开放5000和2333端口(Web默认5000API默认2333,可以在文件底部修改。)
- 在宝塔应用商店内搜索python并安装项目管理器 (推荐使用1.9版本)
![](https://raw.githubusercontent.com/Evil0ctal/TikTokDownloader_PyWebIO/main/Screenshots/BT_Linux_Panel_Deploy_1.png)
@ -211,10 +319,11 @@ http://localhost(服务器IP):80/bgm?url="复制的(抖音/TikTok)口令/链接"
- Python版本需要至少3以上(在左侧版本管理中自行安装)
- 框架修改为`Flask`
- 启动方式修改为`python`
- 启动文件选择`TikTok_ZH.py`
- Web启动文件选择`web_zh.py`
- API启动文件选择`web_api.py`
- 勾选安装模块依赖
- 开机启动随意
- 如果宝塔安装了`Nginx`等应用请将其停止或在`TikTok_ZH.py`底部修改端口(默认端口为5000)
- 如果宝塔运行了`Nginx`等其他服务时请自行判断端口是否被占用,运行端口可在文件底部修改。
![](https://raw.githubusercontent.com/Evil0ctal/TikTokDownloader_PyWebIO/main/Screenshots/BT_Linux_Panel_Deploy_2.png)
@ -222,6 +331,9 @@ http://localhost(服务器IP):80/bgm?url="复制的(抖音/TikTok)口令/链接"
## 🎉截图
> 注:
截图可能因更新问题与文字不符,一切请优先参照文字叙述。
- 主界面
![](https://github.com/Evil0ctal/TikTokDownloader_PyWebIO/blob/main/Screenshots/home.png)
@ -257,4 +369,3 @@ http://localhost(服务器IP):80/bgm?url="复制的(抖音/TikTok)口令/链接"
![](https://raw.githubusercontent.com/Evil0ctal/TikTokDownloader_PyWebIO/main/Screenshots/tiktok_API.png)
---