- 接口名称:豆包去水印解析
- 接口 ID:194
- 接口路径:
/doubao - 功能描述:解析豆包对话生图、视频分享链接,获取无水印媒体直链。
- 响应类型:
auto_upstream(透传上游原始响应)
URL 构造
表格
| 项目 | 值 |
|---|---|
| API Base URL | https://api.xiaotuo.net |
| 调试调用路径 | /api/v1/calls/invoke |
| 接口路径 | /doubao |
| 站点地址 | https://api.xiaotuo.net |
请求 URL 由 Base URL、调用路径、接口路径拼接而成,最终拼接规则以平台调用规范为准。
鉴权方式
鉴权类型:hybrid 混合鉴权,支持两种凭证方式二选一。
1. API Key 鉴权
- API Key 不可为空,缺失返回
100(HTTP 401) - API Key 必须有效、未过期、已绑定本接口,无效返回
101(HTTP 401) - 请求 IP 需要通过白名单校验,不通过返回
102(HTTP 403)
2. APP_ID + APP_SECRET 鉴权
需要同时传入 APP_ID(也可使用 USER_ID)和 APP_SECRET:
APP_ID为空 →130(HTTP 401)APP_SECRET为空 →131(HTTP 401)APP_ID不存在 / 已禁用 →132(HTTP 401)APP_SECRET不匹配 →133(HTTP 401)
额外账号校验类错误:实名认证、企业认证、邮箱绑定、账号封禁、IP 封禁等,见下方错误码表。
注意:文档元数据未明确鉴权参数放置位置(Header / Query / Body),参数传递位置以平台实际调用约定为准。
请求参数
表格
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 示例 | 说明 |
|---|---|---|---|---|---|---|
url |
query | string | 否 | 示例豆包分享链接 | https://www.doubao.com/video-sharing?source_type=mobile&share_id=52137621563288578&video_id=v0269cg10004d81f0ealjht1q4b4sacg |
待解析的豆包分享链接 |
说明:
url非必填,不传则使用默认示例链接;- 参数可见,调试时可直接传入分享链接测试。
请求方法
元数据中未指定固定 HTTP 请求方式,GET/POST 适配以平台实际调用规则为准。
响应结构
响应类型为透传上游数据 auto_upstream。
成功响应示例
{
"_bugpkCache": {
"cached": true,
"cachedAt": "2026-10-23T08:58:16.813735573Z",
"expiresAt": "2026-10-23T09:08:16.813735573Z",
"hit": false,
"remainingSeconds": 600,
"status": "STORED",
"ttlSeconds": 600
},
"code": 200,
"data": {
"author": {
"avatar": "",
"id": "",
"name": ""
},
"cover": "https://p26-sign.douyinpic.com/tos-cn-p-9ecd54/o8q1oO4Q0d4AZC6sk8egcEpDAZ9RIQAhXKAh0I~tplv-noop.image?cquery=101W&dy_q=1792745896&l=20261023165816D82ED5054F814BB6D86E&x-expires=1792832306&x-signature=zwvjfli2aK9TPH%2BU%2BsDf%2FTLrRu0%3D",
"create_time": 0,
"desc": "Doubao video",
"duration": 10.08,
"extra": {
"vid": "v0269cg10004d81f0ealjht1q4b4sacg",
"video_id": "v0269cg10004d81f0ealjht1q4b4sacg"
},
"images": [],
"live_photo": [],
"music": {},
"publish_time": "",
"quality": "original",
"size": 6032859,
"size_label": "5.75MB",
"title": "Doubao video",
"type": "video",
"url": "https://v26-default.365yg.com/c63faffaac03dc31ecaa442591094553/6adb2fc2/video/tos/cn/tos-cn-v-9ecd54/ccaa8b58a2404a03bb28991deec3ee18/?a=0&ch=0&cr=4&dr=0&er=0&lr=unwatermarked&net=5&cd=0%7C1%7C0%7C4&cv=1&br=4689&bt=4689&cs=0&ds=3&ft=AJkaB0-8RR0sT1C4-Dv2Nc.xBiGNbLRIwORU_4guxYcJNv7TGW&mime_type=video_mp4&qs=13&rc=amQ3NzRrb2hpOzczNGY5M0BpamQ3NzRrb2hpOzczNGY5M0BgcF9ucWdeLS5hLS1kNi9zYSNgcF9ucWdeLS5hLS1kNi9zcw%3D%3D&btag=80000e00008000&cquery=106H&dy_q=1792745896&l=2026102316581682BDFA814CE7C5CFE3BE"
},
"msg": "解析成功",
"requestId": "gw_1612b0ec1ea794195340332c93eefc4a"
}
顶层返回字段说明
表格
| 字段 | 类型 | 说明 |
|---|---|---|
code |
number | 状态码,200 代表解析成功 |
msg |
string | 返回提示信息 |
requestId |
string | 请求唯一 ID,用于排查日志 |
data |
object | 解析后的媒体资源数据 |
_bugpkCache |
object | 缓存相关元信息 |
data 内部字段说明
表格
| 字段 | 类型 | 说明 |
|---|---|---|
author |
object | 作者信息(头像、ID、昵称) |
cover |
string | 视频封面地址 |
create_time |
number | 创建时间戳 |
desc |
string | 媒体描述文案 |
duration |
number | 视频时长,单位秒 |
extra |
object | 扩展信息,包含 vid、video_id |
images |
array | 图片资源列表 |
live_photo |
array | 实况图片列表 |
music |
object | 背景音乐信息 |
publish_time |
string | 发布时间 |
quality |
string | 资源质量标识,original 为原画质 |
size |
number | 文件大小,单位字节 |
size_label |
string | 格式化后的文件大小 |
title |
string | 媒体标题 |
type |
string | 资源类型,video/image |
url |
string | 去水印直链地址 |
_bugpkCache 缓存字段说明
表格
| 字段 | 类型 | 说明 |
|---|---|---|
cached |
boolean | 是否启用缓存 |
cachedAt |
string | 缓存写入时间 |
expiresAt |
string | 缓存过期时间 |
hit |
boolean | 是否命中缓存 |
remainingSeconds |
number | 缓存剩余有效秒数 |
status |
string | 缓存状态 |
ttlSeconds |
number | 缓存总有效期 |
错误码对照表
表格
| 错误码 | HTTP 状态 | 说明 |
|---|---|---|
| 100 | 401 | API Key 不能为空 |
| 101 | 401 | API Key 无效、过期或未绑定接口 |
| 102 | 403 | IP 不在白名单 |
| 103 | 403 | 需要完成实名认证 |
| 104 | 403 | 需要企业认证 |
| 105 | 403 | 接口不可用、未开放 / 停用 |
| 106 | 403 | 账户余额不足 |
| 107 | 403 | 订阅套餐已到期 |
| 108 | 403 | 套餐调用次数耗尽 |
| 109 | 403 | 账号已禁用 |
| 110 | 403 | IP 被封禁 |
| 113 | 403 | 需要绑定邮箱 |
| 114 | 429 | 子 Key 当日调用限额已满 |
| 130 | 401 | APP_ID 不能为空 |
| 131 | 401 | APP_SECRET 不能为空 |
| 132 | 401 | APP_ID 不存在或已禁用 |
| 133 | 401 | APP_SECRET 校验失败 |
| 10004 | 404 | 接口路径不存在 |
| 20001 | 502 | 上游服务请求失败 |
| 20002 | 504 | 上游请求超时 |
| 20003 | 502 | 上游返回异常状态码 |
计费说明
- price 值为 0;
- 文档元数据未返回明确计费配置;
- 接口支持按次、订阅、套餐包模式,实际计费规则以平台后台配置为准。
限流说明
- 元数据无全局限流参数;
- 支持子 API Key 每日限额,当日到达上限返回
114(429)。
重要备注
- 返回示例中的资源直链带有时效签名,链接会过期,仅作调试参考;
- 域名、鉴权参数位置、请求方式、计费限流数值,以平台最新配置为准;
- 📌 免责声明:本文档仅用于技术学习交流,禁止用于盗爬、侵权、商用分发第三方媒体资源,接口使用者自行承担使用带来的全部法律风险。