顶层字段

字段	类型	说明
code	string	响应标识。0001 / 200 表示成功；失败常见 300
msg	string	成功 / 失败消息，如「成功」
title	string	作品标题
desc	string	作品简介 / 描述（可能与 title 相同）
cover	string	封面图链接
playAddr	string	视频链接。图集/实况场景下可能为 ""
pics	array	图集图片 URL 列表；纯视频时多为 []
liveAddr	array	实况视频 URL 列表。仅部分平台有（如小红书 live）；视频号等可能没有该字段
video_backup	array	备用视频链接（可选，有则优先 playAddr 失败后再试）
type	number	内容类型：1=视频，2=图集，3=实况
platform	string	来源平台，如「视频号」「小红书」「抖音」
source	string	本站声明文案（学习交流等）
author	object	作者信息对象，见下表；各子字段可能为空字符串

author（作者信息）

字段	类型	说明
author.nickname	string	昵称
author.name	string	名字 / 展示名
author.avatar	string	头像链接
author.author_id	string	作者 ID（部分平台为空）

type 怎么用

type	含义	建议取用字段
1	视频	主要用 playAddr；pics 常为空数组
2	图集	主要用 pics；playAddr 可能为空
3	实况	主要用 liveAddr（与 pics 常一一对应）；无 liveAddr 时不要当实况处理

示例 A · 视频号视频（type=1，通常无实况）

{
  "code": "0001",
  "msg": "成功",
  "title": "作品标题",
  "desc": "作品描述",
  "cover": "https://example.com/cover.jpg",
  "playAddr": "https://example.com/video.mp4",
  "pics": [],
  "type": 1,
  "source": "本接口内容供学习交流使用，欢迎交流",
  "platform": "视频号",
  "author": {
    "nickname": "作者昵称",
    "name": "作者名字",
    "avatar": "https://example.com/avatar.jpg",
    "author_id": ""
  }
}

注意：此类返回往往没有 liveAddr 字段，读取前请判断。

示例 B · 小红书实况（type=3，含 liveAddr）

{
  "code": "0001",
  "msg": "成功",
  "title": "作品标题",
  "desc": "作品描述",
  "cover": "https://example.com/cover.jpg",
  "playAddr": "",
  "pics": [
    "https://example.com/1.jpg",
    "https://example.com/2.jpg"
  ],
  "type": 3,
  "source": "本接口内容供学习交流使用，欢迎交流",
  "platform": "小红书",
  "liveAddr": [
    "https://example.com/live1.mp4",
    "https://example.com/live2.mp4"
  ],
  "author": {
    "nickname": "",
    "name": "",
    "avatar": "",
    "author_id": ""
  }
}

常见问题

如何获取 UID / KEY？ 注册并登录后，本页「在线调试」会自动填入；也可在控制台查看。

type 填什么？ 填本页编码 txxw，不要填 custom 等调用方式名。

如何计费？ 成功调用扣 1 点，失败不扣；可在本页「立即购买」开通包点或包月。

有免费额度吗？ 新用户注册即可免费测试：每个独立计费产品赠送 20 次调用额度（失败不扣点），用完后需购买套餐。「共用默认池」产品与短视频共用同一份额度。