DEVELOPER API · V1

媒体解析 API

把平台公开分享链接提交到统一接口，返回可用的视频或图片资源。正式工具应使用本接口，不要调用网页使用的匿名旧接口。

创建客户

管理员进入管理后台的“API 客户”，选择套餐并创建客户。

创建 API Key

选择允许平台和到期时间。完整 Key 只显示一次，请立即复制保存。

发起请求

把 Key 放入 Bearer 请求头，将公开分享链接作为 JSON 提交。

POST/v1/parse

url 必填；platform 建议保持 auto，系统会按链接域名识别平台。

curl -X POST "https://你的域名/v1/parse" \
  -H "Authorization: Bearer wm_live_替换成你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://平台公开分享链接","platform":"auto"}'

const response = await fetch("https://你的域名/v1/parse", {
  method: "POST",
  headers: {
    "Authorization": "Bearer wm_live_替换成你的密钥",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    url: "https://平台公开分享链接",
    platform: "auto"
  })
});

const result = await response.json();
if (!response.ok) throw new Error(`${result.code}: ${result.message}`);
console.log(result.data.assets);

import requests

response = requests.post(
    "https://你的域名/v1/parse",
    headers={"Authorization": "Bearer wm_live_替换成你的密钥"},
    json={
        "url": "https://平台公开分享链接",
        "platform": "auto",
    },
    timeout=40,
)
result = response.json()
response.raise_for_status()
print(result["data"]["assets"])

请求字段

url：平台公开分享链接，必填。
platform：省略或填 auto；手动填写时必须与链接匹配。

平台标识

douyinkuaishouxiaohongshutoutiaodoubaopipixpipigxjimengzuiyou

认证与配额

请求头格式：Authorization: Bearer <API_KEY>。
Key 不得放在 URL、前端网页源码、日志或公开仓库中。
响应头 RateLimit-* 表示分钟额度；429 时按 Retry-After 重试。
usage.remaining 是当前日配额的估算剩余量。

成功响应

{
  "request_id": "req_xxx",
  "code": "OK",
  "message": "解析成功",
  "data": {
    "platform": "doubao",
    "content_type": "video",
    "title": "",
    "author": null,
    "assets": [{"type": "video", "url": "https://..."}]
  },
  "usage": {"cost": 1, "remaining": 99}
}

真正需要下载的资源位于 data.assets。每个元素的 type 是 video 或 image，url 是资源地址。

常见错误

HTTP	code	处理方式
401	`INVALID_API_KEY`	检查 Key 是否复制完整、已吊销或客户已停用
401	`API_KEY_EXPIRED`	联系管理员创建新 Key
403	`PLATFORM_FORBIDDEN`	为 Key 增加该平台权限
422	`UNSUPPORTED_URL`	检查链接是否来自支持的平台及公开域名
422	`PLATFORM_MISMATCH`	改用 `auto` 或填写正确的平台标识
429	`RATE_LIMITED`	读取 `Retry-After`，稍后重试
429	`QUOTA_EXCEEDED`	日/月额度已用完，联系管理员调整套餐
502/503	`PARSE_FAILED` 等	保留 `request_id`，稍后重试或交给管理员排查

不要在浏览器公开页面中直接调用并暴露 API Key。浏览器扩展、桌面程序或服务器端工具应把 Key 存在安全配置中。

机器可读契约：OpenAPI 3.1