分享链接解析

抖音、快手、微博等平台的分享链接 → 无水印视频直链、封面、作者信息。同步返回，按次计费。

POST /v1/extract/share-url

curl -X POST https://api.gomiservice.com/v1/extract/share-url \
  -H "Authorization: Bearer sk-gomi-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "7.43 复制打开抖音，看看【某某的作品】 https://v.douyin.com/xxxxxxx/"
  }'

字段	必填	说明
`url`	是	分享链接。短链、完整链接、整段分享口令文本都可以，服务端会从文本里找出链接、按域名识别平台

这个接口同步返回结果，不是任务，不用轮询。慢的时候要等几十秒，客户端超时请设到 2 分钟。

响应

{
  "source": "douyin",
  "title": "作品标题",
  "video_url": "https://…无水印直链…",
  "cover_url": "https://…封面…",
  "music_url": "https://…背景音乐…",
  "image_urls": [],
  "author": {
    "uid": "…",
    "name": "作者昵称",
    "avatar_url": "https://…"
  },
  "points_charged": 20,
  "duration_ms": 15300,
  "width": 1080,
  "height": 1920
}

字段	说明
`source`	平台标识，取值见下方平台清单
`video_url`	无水印视频直链。图集帖这里为空、`image_urls` 非空——两者不会同时有值，按这个区分视频帖和图集帖
`image_urls`	图集帖的图片直链，视频帖是 `[]`
`music_url`	背景音乐，有的平台没有，为空串
`points_charged`	这次扣了多少点。`0` 表示这个团队之前为这条内容付过费，这次是免费重新解析
`duration_ms` / `width` / `height`	视频时长（毫秒）和尺寸。平台没提供时是 `0`，图集帖三个都是 `0`

直链带平台的过期签名，几分钟到几小时后会失效（表现为 403）。要留存请拿到后尽快下载转存，不要只存链接。失效了就再解析一次——同一条内容不会重复扣费。

计费

按次计费，价格按平台定，跟芯剪网页上的「分享解析」一样
同一个团队、同一条内容只收一次费：按平台的内容编号认，不按链接字符串认——短链、长链、重新分享的口令都算同一条。网页上解析过的内容，用 API 再解析也是免费的，反过来也一样
解析失败不扣费
扣的是 Key 所属团队的点数，这把 Key 的用量里也记这一笔（免费重新解析不记）

GET /v1/extract/sources

支持的平台清单。

curl https://api.gomiservice.com/v1/extract/sources \
  -H "Authorization: Bearer sk-gomi-你的Key"

{
  "sources": [
    { "source": "douyin", "name": "抖音", "hosts": ["v.douyin.com", "www.douyin.com", "www.iesdouyin.com", "douyin.com"] },
    { "source": "kuaishou", "name": "快手", "hosts": ["v.kuaishou.com"] }
  ]
}

hosts 是这个平台分享链接的域名（精确匹配）。提交前可以先按它判断链接能不能解析；域名不在清单里的会被拒成 EXTRACT_URL_UNSUPPORTED，不扣费。平台会陆续增加，以这个接口的返回为准。

常见错误

code	HTTP	何时	处理
`EXTRACT_URL_UNSUPPORTED`	400	链接不属于任何支持的平台	对照平台清单检查链接
`EXTRACT_URL_INVALID`	400	平台认识，但这条内容取不到：链接残缺、作品已删除或设为私密	换一条链接
`EXTRACT_CONTENT_BLOCKED`	400	内容有版权或地区限制，暂时解析不了	换链接也没用，换一条内容
`EXTRACT_IN_PROGRESS`	409	同一条内容正在被你们团队的另一个请求解析	等几十秒再试，那时多半直接免费返回
`EXTRACT_UPSTREAM_FAILED`	503	平台接口暂时请求失败	稍后重试（失败不扣费）
`INSUFFICIENT_BALANCE`	400	团队点数不足	充值

全部错误码见错误码。

POST /v1/extract/share-url

响应

计费

GET /v1/extract/sources

常见错误

本页目录