短视频去水印解析

接口概览

提交平台分享链接，或包含分享链接的文本，获取统一的内容数据。不同平台和上游通道的可用字段可能不同；已移植平台适配，不代表每个平台始终可用。

快速开始

请求参数

频率限制按密钥配置，默认每分钟 60 次，受保护的 API 请求共用该额度。超过限制返回 HTTP 429。调用日志只记录域名、状态、耗时等诊断字段。

可通过 Idempotency-Key 请求头避免同次请求重试重复扣点；同一账号内幂等键与参数绑定，结果保留 24 小时，过期键不会重新收费。响应头 X-Parse-Request-ID 为原始解析请求 ID，X-Billing-Source 为 member 或 points。通过 GET /api/v1/requests/{请求ID} 查询结果，GET /api/v1/billing 查询额度。接口同步返回解析结果。上游降级可能耗时较长，建议客户端设置 180 秒超时；停止等待不会中止服务端已开始的解析。

调用示例

curl -X POST "$BASE_URL/api/v1/watermark/parse" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"平台分享链接"}' 

const response = await fetch(
  baseUrl + "/api/v1/watermark/parse", {
    method: "POST",
    headers: {
      Authorization: "Bearer " + apiKey,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ text: shareUrl }),
  }
);
const result = await response.json();

import requests

response = requests.post(
    base_url + "/api/v1/watermark/parse",
    headers={"Authorization": f"Bearer {api_key}"},
    json={"text": share_url},
    timeout=180,
)
result = response.json()

返回结构

以下仅展示结构。视频、图集、音频按内容类型返回；没有对应内容的字段可以为空。

{
  "code": "OK",
  "message": "成功",
  "request_id": "唯一请求标识",
  "data": {
    "video_id": "内容 ID",
    "platform": "抖音",
    "title": "内容标题",
    "video_url": "https://媒体地址",
    "cover_url": null,
    "images": [],
    "audio_url": null,
    "author": {},
    "subtitles": null,
    "subtitle_status": 0
  }
}

调用记录

携带相同的 Bearer API Key，查询该密钥最近 50 次解析记录。记录包含请求 ID、平台、状态、耗时和时间。开发密钥不写入调用记录。

错误码说明

排查问题时请保留 request_id，避免在反馈中发送完整 API Key。