MEDIA CLEAN PARSER API
API 开发文档
每个客户应在“API 账户”创建自己的 Key。请不要把 Key 写进前端公开代码或分享给他人。
解析媒体
POST https://你的域名/api/parse
Content-Type: application/json
X-API-Key: mcp_xxx
{ "url": "https://www.youtube.com/watch?v=..." }成功返回 media(视频格式)、audio(音频格式)、lowest、highest 和服务端 downloadUrl。
Apple 快捷指令
GET https://你的域名/api/shortcut?url=[URL编码后的分享链接] X-API-Key: mcp_xxx
读取 video.highest.downloadUrl 或 audio.best.downloadUrl。免费套餐还会返回 billing.adRequired 和 billing.adUrl。
套餐与计次
- Pro:5 元 / 30 天,每期 300 次,每日最多 10 次,请求上限 10 次 / 分钟。
- Pro+:10 元 / 30 天,每期 1,500 次,每日最多 50 次,请求上限 20 次 / 分钟。
- Ultra:20 元 / 30 天,月次数不限,每日最多 200 次,请求上限 30 次 / 分钟。
- 注册试用:每期 5 次 API 解析,每日最多 3 次,请求上限 3 次 / 分钟。
- 所有解析平台、API Key、
/api/parse与/api/shortcut共享账户额度。每日按北京时间零点重置;每期从开通时起计算 30 天,余额不结转。 - 仅
ok=true且downloadable=true的成功解析扣 1 次;失败不扣。重试成功仍计次,同一解析结果中的多个下载格式不额外扣次。 - 请求频率限制包含失败请求。并发请求会预占额度,解析失败后释放。
- 同档续费增加 30 天,当前用量不重置。换档即刻开启新的 30 天有效期,保留已用次数,不自动折算剩余时长。到期退回试用额度。
- API 套餐适用于 API Key 调用;网页免费解析额度单独计算。
- 月次数不限仍受每日额度与请求频率限制。套餐不保证平台内容始终可用;私密、失效、受平台限制的链接可能解析失败。
在线支付通道启用后,可选择微信或支付宝付款,由服务端校验支付通知后自动开通;通道未启用时采用人工收款开通。付款结果以账户实际权益与服务器订单状态为准。
错误与用量
- 无效、停用或已撤销 Key:
401 API_KEY_REQUIRED。 - 超过请求频率:
429 RATE_LIMITED。 - 达到每日额度:
429 DAILY_LIMIT_REACHED。 - 达到本期额度:
429 MONTHLY_LIMIT_REACHED。 - 429 响应包含
Retry-After秒数,重试前请等待。 GET /api/account/usage携带X-API-Key可查询账户当前套餐与用量;查询不扣额度。- 密钥请通过请求头传入。下载链接在解析后 30 分钟过期。
快捷指令:弹窗广告后自动保存相册
- “获取 URL 内容”请求
/api/shortcut。 - 读取
billing.adRequired。若为真,用“显示通知”或“显示提醒”展示广告文案;可选“打开 URL”进入billing.adUrl。 - 读取
video.highest.downloadUrl,再次使用“获取 URL 内容”。 - 最后添加“存储到照片相簿”。iOS 会在首次运行时请求相册权限。
系统快捷指令无法把第三方网页广告嵌进原生弹窗;广告页应使用你的广告联盟或赞助页面。完整配置请见 SHORTCUTS.md。