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
粘贴链接，立即解析
支持分享短链和包含链接的完整分享文案。
正在识别平台并获取媒体信息…
解析失败
ONE ENDPOINT
面向真实业务的解析能力
解析器按平台独立维护，对外保持一致的数据结构。后台可随时关闭异常平台，不影响其他接口。
02
密钥与限流
每位客户独立管理 API Key，支持用户级、密钥级和平台级 QPS。
03
状态可控制
管理员可控制全局服务和单个平台，并配置客户有效期。
04
调用可追踪
记录平台、响应状态、错误码和耗时，快速定位解析异常。
OPEN SOURCE & DEPLOYMENT
完全开源自建，按需灵活落地
基于宽松的 MIT 协议开放，零商业授权门槛。解析引擎、业务数据与运行基础设施由部署者全权自主掌控。
MIT LICENSE
个人与轻量自用
适用于学习研究、个人工具开发与轻量级自动化集成
¥0
/ 永久开源
- 完整开放源码与标准 JSON 规范
- Docker Compose 单机快速启动
- 透明无暗桩，通过 GitHub 社区交流
SELF-HOSTED GATEWAY
团队私有网关
适合将解析能力部署为团队或业务系统的统一内部服务
开箱即用
/ 内置中台管控
- 租户、API Key、有效期与积分体系
- 用户 / 密钥 / 平台三级精细化流控
- 平台熔断开关、调用日志与用量统计
DATA PRIVACY & COMPLIANCE
私有自治与合规
私有网络独立运行，数据不过第三方，保障业务稳定与合规
自主掌控
/ 本地私有运行
- 私网独立部署，无第三方调用与数据泄露风险
- 目标平台 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。