01
多类型媒体
统一获取视频、图集、Live Photo、背景音频、封面及字幕。
API 服务正常
Star on GitHub
多平台媒体解析，
一个接口就够了。
输入任意支持平台的分享链接，统一获取视频、图集、封面、音频与作者信息。无需浏览器环境，既可在线使用，也可通过 API 接入你的业务。
✓ 统一 JSON 返回✓ API Key 鉴权✓ 独立 QPS 限制
GET /api/v1/parse
curl --get 'https://your-domain.com/api/v1/parse' \
--header 'Authorization: Bearer mp_xxx' \
--data-urlencode 'url=https://v.douyin.com/xxx/'
{
"succ": true,
"data": {
"platform": "抖音",
"video_url": "https://...",
"image_list": []
}
}
LIVE PARSER
粘贴链接，立即解析
支持分享短链和包含链接的完整分享文案。
正在识别平台并获取媒体信息…
解析失败
🎬 视频文件预览
🎵 背景音频
🖼️ 高清图集/封面 (0)
点击图片放大或悬浮复制单图直链未解析到可直观预览的多媒体资源
ONE ENDPOINT
面向真实业务的解析能力
解析器按平台独立维护，对外保持一致的数据结构。后台可随时关闭异常平台，不影响其他接口。
02
密钥与限流
每位客户独立管理 API Key，支持用户级、密钥级和平台级 QPS。
03
状态可控制
管理员可控制全局服务和单个平台，并配置客户有效期。
04
调用可追踪
记录平台、响应状态、错误码和耗时，快速定位解析异常。
OPEN SOURCE & DEPLOYMENT
开源自部署，按实际场景使用
项目代码基于 MIT 协议开放，不收取软件许可费。运行所需的服务器、网络和平台账号等资源由部署者自行准备。
MIT LICENSE
开源自部署
适用于学习研究、个人工具与自主可控的业务集成
¥0
/ 软件许可费
- 完整源码与标准 JSON 接口
- Docker Compose 一键启动
- 通过 GitHub Issues 参与社区维护
内置能力
SELF-HOSTED API
团队内部服务
适合将解析能力部署为团队或业务系统的内部 API
自主配置
/ 本地管理
- 账号、有效期与解析积分管理
- 用户、API Key 与平台三级 QPS 控制
- 服务开关、调用日志与用量统计
RESPONSIBILITY
资源与合规
实际可用性取决于部署环境、目标平台状态及必要的账号配置
自行负责
/ 部署运维
- 自行承担服务器与网络成本
- 部分平台能力可能需要配置 Cookie
- 遵守目标平台规则及当地法律法规
FREQUENTLY ASKED QUESTIONS
常见问题解答
解答你在对接与使用 Media Parser API 过程中的常见疑问。
解析出来的视频和图集是高清无水印的吗？
Media Parser 会尽量返回目标平台当前可获取的原始媒体地址，不主动对资源进行二次压缩。实际清晰度和水印情况取决于作品、平台接口、登录状态及平台后续调整，无法对所有链接作统一保证。
提取出的音视频/图片直链会过期或遭遇防盗链吗？
可能会。媒体地址通常由目标平台的 CDN 提供，可能包含时效签名、登录校验或防盗链策略，具体有效期由平台决定。对于拥有合法保存权且需要持久化的内容，请在解析后及时转存到自己的存储服务。
遇到目标平台改版导致解析失败怎么办？
请先更新到项目最新版本，并检查该平台是否需要 Cookie 等额外配置。如果问题仍然存在，可携带脱敏后的示例链接和错误日志提交 GitHub Issue。开源自部署实例不会自动热更新，升级前请先在自己的环境中验证。
如何获取和配置 API Key？
自部署后，首次访问 /auth/setup 创建管理员。用户登录控制台后可以创建和管理自己的 API Key；调用接口时推荐使用 Authorization: Bearer mp_xxx，也兼容 ?key=mp_xxx 查询参数。
QPS、有效期和解析积分如何配置？
这些限制均由自部署实例的管理员配置，并非固定商业套餐。默认新用户试用期为 7 天、初始积分为 100、账号限制为 2 QPS；管理员可在后台调整。触发 QPS 限制时返回 429，积分耗尽时返回 402，账号未开通或过期时返回 403。