豆包去水印解析 API 文档

简介: 豆包去水印解析接口(ID:194),支持解析豆包分享链接,快速获取无水印视频/图片直链。采用auto_upstream透传响应,兼容API Key或APP_ID+SECRET混合鉴权,免费调用,直链带时效签名,仅限技术学习使用。
  • 接口名称:豆包去水印解析
  • 接口 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)。

重要备注

  1. 返回示例中的资源直链带有时效签名,链接会过期,仅作调试参考;
  2. 域名、鉴权参数位置、请求方式、计费限流数值,以平台最新配置为准;
  3. 📌 免责声明:本文档仅用于技术学习交流,禁止用于盗爬、侵权、商用分发第三方媒体资源,接口使用者自行承担使用带来的全部法律风险。
相关文章
|
2天前
|
云安全 安全 网络安全
|
2天前
|
JavaScript 安全 前端开发
Nodejs Brotli decoder 代码执行漏洞 (CVE-2026-111497)10629
Node.js发布安全更新修复Brotli解码器高危RCE漏洞(CVE-2026-111497),建议受影响版本用户立即升级。
1683 1
|
8天前
|
人工智能 API 开发工具
DeepSeek Harness 神插件:白嫖 13 家大厂模型
`dsh-our-free-model` 是 DeepSeek Harness 神级插件:零配置、零API Key、零账号,聚合13家大厂免费模型(含DeepSeek V4.1 Flash、Kimi K3等),支持本地网关、用量看板与自动降级,真正实现“白嫖即用”。
1422 31
|
2天前
|
安全 应用服务中间件 Go
PHP2Shell 漏洞拆解:WordPress 与 nginx 为何中招
PHP2Shell 双 RCE 已遭在野利用:WordPress、Drupal 全在射程内,nginx 其实另有洞。拆成因与修复顺序
PHP2Shell 漏洞拆解:WordPress 与 nginx 为何中招
|
13天前
|
存储 人工智能 安全
千问办公官网入口网页版登录:qwenwork.cn 注册送2000积分、登录送100积分
阿里云千问办公(QwenWork)是AI智能工作平台,支持一句话生成PPT、表格、网页、视频及数据分析。个人免费版送2000积分+每日登录赠100分,含1GB存储、5个发布页;企业版198元/席/月起。阿里千问办公QwenWork官网:https://t.aliyun.com/U/0VCTGt 阿里AI工作平台,一句话完成数据分析、PPT 生成、视频剪辑、网页搭建等复杂任务
|
10天前
|
安全 Linux 芯片
【万字长文】Ollama下载、安装、配置、使用保姆级教程(2026最新图解)
Ollama 是一款免费开源的本地大模型运行工具,支持 DeepSeek、Qwen 等主流模型,一条命令即可下载运行。2026 最新版 v0.35.1 官方安装包(1.47GB)已提供国内直连下载,纯本地、离线可用、无广告、无隐私泄露风险。
935 2
|
8天前
|
人工智能 开发者
Qoder CN 大使计划正式开启|无限创造,等你一起
全年免费积分、优先内测、活动支持与更多共创机会,邀请用 Qoder 把想法变成现实的你。
642 6
|
1月前
|
人工智能 JSON API
全网刷屏的 Jev 模型正式开放!一手实战测评 + 保姆级教程
全网爆火的 Jev 模型是什么?有什么用?怎么使用?怎么接入 AI 编程工具?效果真的好么?傻子可懂的 Jev 保姆级实战教程 + 项目实战测评来啦
10152 33
|
8天前
|
存储 弹性计算 双11
2026阿里云双11优惠活动全解析:服务器收费价格、优惠券与代理渠道购买指南
本文由重庆典名科技(阿里云旗舰级代理、钉钉六星级服务商)撰写,详解2026双11阿里云服务器真省钱逻辑:38/99/199元三档锚点价不降,核心优惠在满减券叠加与授权代理渠道折扣(官网价再降15%–35%),并强调“续费同价”锁定长期成本。
634 0

热门文章

最新文章