某音去水印解析,支持解析图文、短视频和实况作品,支持短链接和长链接参数。响应:作者信息,视频原画,备用画质,作品统计(播放量、点赞数、收藏数、评论数等9个作品统计数据),作品标签等等
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| url | string | 是 | 某音url链接 | https://v.douyin.com/xYCi-HV1d6k/ |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "url",
"type": "string",
"required": true,
"description": "某音url链接",
"example": "https://v.douyin.com/xYCi-HV1d6k/"
}
]
{
"openapi": "3.1.1",
"info": {
"title": "某音解析V1【原画】",
"description": "某音去水印解析,支持解析图文、短视频和实况作品,支持短链接和长链接参数。响应:作者信息,视频原画,备用画质,作品统计(播放量、点赞数、收藏数、评论数等9个作品统计数据),作品标签等等",
"version": "1.0.0"
},
"paths": {
"\/api\/jiexi\/douyin\/V1\/dyjx.php": {
"get": {
"summary": "某音解析V1【原画】",
"description": "某音去水印解析,支持解析图文、短视频和实况作品,支持短链接和长链接参数。响应:作者信息,视频原画,备用画质,作品统计(播放量、点赞数、收藏数、评论数等9个作品统计数据),作品标签等等",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "url",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "https:\/\/v.douyin.com\/xYCi-HV1d6k\/"
},
"description": "某音url链接"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "某音解析V1【原画】",
"description": "某音去水印解析,支持解析图文、短视频和实况作品,支持短链接和长链接参数。响应:作者信息,视频原画,备用画质,作品统计(播放量、点赞数、收藏数、评论数等9个作品统计数据),作品标签等等",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "url",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "https:\/\/v.douyin.com\/xYCi-HV1d6k\/"
},
"description": "某音url链接"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https:\/\/www.xsapi.com",
"description": "当前访问入口(https)"
}
]
}
{
"code": 200,
"msg": "解析成功-eo",
"data": {
"type": "video",
"title": "如果是你在那支队伍里,能走多远?烽绘山河|长征,一场信仰的远征!#同心同行长征路#红星照耀中国",
"desc": "如果是你在那支队伍里,能走多远?烽绘山河|长征,一场信仰的远征!#同心同行长征路#红星照耀中国",
"author": {
"name": "中国军号",
"id": "79513381117",
"avatar": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_5f76434cd2bb4ffcb662d3c98f919dab.jpeg?from=327834062"
},
"cover": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-p-0015/okUAwhORAWlBDpEV75sCBQVfWIgRgKLwie3seG~tplv-dy-360p.jpeg?lk3s=138a59ce&x-expires=1794366000&x-signature=A3it0Ivn29TO0b2D6qXnbYYItvE%3D&from=327834062&s=PackSourceEnum_YUMME_DETAIL&se=false&sc=origin_cover&biz_tag=aweme_video&l=202610281144019B6B7958A514336F8EE4",
"url": "https://v3-dy-a-x.ixigua.com/afeb76b149f8e79a10e17df064e09f24/6af3e4a2/video/tos/cn/tos-cn-v-0015c001/o00DBQwAqDAaU2gYBeFEgwDQA2A9ZAzEE5fDNA/?mime_type=video_mp4",
"quality": "original",
"duration": 33.414,
"size": 51167316,
"size_label": "48.8MB",
"create_time": 1792548009,
"publish_time": "2026-10-21 10:00:09",
"video_backup": [
{
"size": 14670327,
"size_label": "13.99MB",
"label": "1080P高清",
"quality": "1080p",
"url": "https://v3-chameleon.usergrowth.com.cn/0b4c1c078bb32e2a580fae12f2a07304/6ae17db2/video/tos/cn/tos-cn-ve-15/os2A2BEBPpDb9sgQyrfoFTYAf0CgbqIAIKQoYQ/?a=1767&ch=0&cr=3&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C3&cv=1&br=3430&bt=3430&cs=0&ds=4&ft=rd.tGXxhWH6BMXOi.Jr0PD1IN&mime_type=video_mp4&qs=0&rc=OzhkZTM4NGVpZzo2ZzZpZ0BpajtvdXQ5cmQ0ZTMzNGkzM0AvMWEzMWMxNl8xLTZhYTU0YSNhNS1eMmQ0bWBhLS1kLS9zcw%3D%3D&btag=80000e00018000&dy_q=1793159041&feature_id=37f92ebd2877ae8e7eba995d406c5150&l=20261028114401FFD81C7B14C79BD2FBA4",
"bit_rate": 3512378,
"width": 1080,
"height": 1920,
"format": "mp4",
"codec": "h264",
"quality_type": 8,
"gear_name": ""
},
{
"size": 10626985,
"size_label": "10.13MB",
"label": "720P高清",
"quality": "720p",
"url": "https://v3-chameleon.usergrowth.com.cn/cb295f58af0cb9919d839058a833cd61/6ae17db2/video/tos/cn/tos-cn-ve-15/oUAI4bHKgiELn4VYqaBsIQPcyP6tQgUXAiIIF/?a=1767&ch=0&cr=3&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C3&cv=1&br=2484&bt=2484&cs=0&ds=3&ft=rd.tGXxhWH6BMXOi.Jr0PD1IN&mime_type=video_mp4&qs=0&rc=NTM7Mzc4Ojc7ZTNpNzw4O0BpajtvdXQ5cmQ0ZTMzNGkzM0AuYzIxYjQwNi0xX181YzYxYSNhNS1eMmQ0bWBhLS1kLS9zcw%3D%3D&btag=80000e00018000&dy_q=1793159041&feature_id=f5241e7604dff1d9d6c943fd20bd51a2&l=20261028114401FFD81C7B14C79BD2FBA4",
"bit_rate": 2544319,
"width": 720,
"height": 1280,
"format": "mp4",
"codec": "h264",
"quality_type": 4,
"gear_name": ""
},
{
"size": 10679191,
"size_label": "10.18MB",
"label": "576P",
"quality": "576p",
"url": "https://v9-qingtao.douyinvod.com/809695f39221db78e6699ab2dfc2e714/6ae17db2/video/tos/cn/tos-cn-ve-15/o4Yq2gDoQABEUm0ffAAgI8XFKBwoJ2Qyg8r9CO/?a=392139&ch=270&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=2496&bt=2496&cs=0&ds=6&ft=GZhrM4LasuuD.WNOan2Vvjp~fytLjrKQ0VZuRka-dfcpejVhWL6&mime_type=video_mp4&qs=0&rc=NTdmODxoZzQ1aWRmOjQ6NkBpajtvdXQ5cmQ0ZTMzNGkzM0BhNmMxNjYvXzAxMzYxYS8tYSNhNS1eMmQ0bWBhLS1kLS9zcw%3D%3D&btag=c0000e00018000&dy_q=1793159041&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=202610281144019B6B7958A514336F8EE4",
"bit_rate": 10679191,
"width": 576,
"height": 1024,
"format": "",
"codec": "h264",
"quality_type": 0,
"gear_name": "standard_h264"
},
{
"size": 10679191,
"size_label": "10.18MB",
"label": "540P",
"quality": "540p",
"url": "https://v3-chameleon.usergrowth.com.cn/3ab65448bfa89c2d4e7dcc8a821ed1ab/6ae17db2/video/tos/cn/tos-cn-ve-15/o4Yq2gDoQABEUm0ffAAgI8XFKBwoJ2Qyg8r9CO/?a=1767&ch=0&cr=3&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C3&cv=1&br=2496&bt=2496&cs=0&ds=6&ft=rd.tGXxhWH6BMXOi.Jr0PD1IN&mime_type=video_mp4&qs=0&rc=NTdmODxoZzQ1aWRmOjQ6NkBpajtvdXQ5cmQ0ZTMzNGkzM0BhNmMxNjYvXzAxMzYxYS8tYSNhNS1eMmQ0bWBhLS1kLS9zcw%3D%3D&btag=80000e00018000&dy_q=1793159041&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20261028114401FFD81C7B14C79BD2FBA4",
"bit_rate": 2556818,
"width": 576,
"height": 1024,
"format": "mp4",
"codec": "h264",
"quality_type": 0,
"gear_name": ""
}
],
"images": [],
"live_photo": [],
"music": {
"title": "@中国军号创作的原声",
"author": "中国军号",
"url": "https://sf26-sign.douyinstatic.com/ies-music/7698917334764817190.mp3?x-expires=1793245441&x-signature=yV2rEchKz%2FMfKsXLTJbfLwAihjI%3D",
"cover": "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_5f76434cd2bb4ffcb662d3c98f919dab.jpeg?from=327834062"
},
"extra": {
"aweme_id": "7698935058064772403",
"sec_item_id": "MS4wLjAAAAAAcgSbOGEJQ1nfzLcM9hTdte0eqLhAjxkK7HIViVpgfhObswvFXA7RqtY1XfqNJuL8",
"create_time": 1792548009,
"region": "",
"duration_ms": 33414,
"share_url": "https://qingtao.douyin.com/video/7698935058064772403?app=yumme&utm_source=copy_link",
"statistics": {
"digg_count": 41860,
"comment_count": 3247,
"collect_count": 1245,
"share_count": 987,
"admire_count": 0,
"play_count": 935231
},
"hashtags": [
{
"name": "同心同行长征路",
"id": "7631561190104205363",
"type": 1
},
{
"name": "红星照耀中国",
"id": "1604967266519043",
"type": 1
}
],
"video_tags": [
{
"name": "时政社会",
"id": "2018",
"level": 1
},
{
"name": "政务宣传",
"id": "2018006",
"level": 2
},
{
"name": "宣教科普",
"id": "2018006001",
"level": 3
},
{
"name": "社会时政",
"id": "609",
"level": 1
},
{
"name": "国内社会时政",
"id": "60906",
"level": 2
},
{
"name": "党政国史",
"id": "6090603",
"level": 3
}
],
"author_extra": {
"uid": "79513381117",
"sec_uid": "MS4wLjABAAAAdGSbTdgq_DbLUkHqM2oR0BWTFxw9pe88wXZKG4-2F6c",
"unique_id": "jfjxwcbzx",
"short_id": "831645047",
"signature": "",
"follower_count": 57162599,
"favoriting_count": 128,
"total_favorited": 1080583917
},
"play_count_source": "douyin",
"categories": [
{
"level1": "2018",
"level2": "2018006",
"level3": "2018006001",
"tag_name_level1": "时政社会",
"tag_name_level2": "政务宣传",
"tag_name_level3": "宣教科普"
},
{
"level1": "609",
"level2": "60906",
"level3": "6090603",
"tag_name_level1": "社会时政",
"tag_name_level2": "国内社会时政",
"tag_name_level3": "党政国史"
}
],
"category_name": "社会时政",
"show_tag": "视频"
},
"width": 1080,
"height": 1920,
"bit_rate": 12250878,
"real_bit_rate": 12250878,
"fps": 30,
"format": "mp4",
"codec": "h264",
"video_id": "v0200fg10000dbc1pa7og65qar0l88dg",
"label": "原画",
"quality_type": 64
},
"platform": "douyin",
"_bugpkCache": {
"cached": true,
"cachedAt": "2026-10-28T03:44:02.087842713Z",
"expiresAt": "2026-10-28T03:54:02.087842713Z",
"hit": false,
"remainingSeconds": 600,
"status": "STORED",
"ttlSeconds": 600
},
"requestId": "gw_1ecc673201deba43cc3e888edf10b1ba"
}
某音去水印解析接口,支持解析图文、短视频和实况作品,兼容短链接与长链接参数。适用于需要获取某音作品原画视频、备用画质、作者信息及作品统计数据的场景。
https://xsapi.com/api/jiexi/douyin/V1/dyjx.php
支持 GET 与 POST 两种请求方式,参数以 Query 形式传递即可。
本接口必须携带调用密钥,密钥通过 Query 参数 key 传递,例如:
https://xsapi.com/api/jiexi/douyin/V1/dyjx.php?key=你的密钥&url=https://v.douyin.com/xYCi-HV1d6k/
缺少 key 或密钥无效时请求将被拒绝。本接口免费调用,频率限制约为每分钟 150 次。
调用地址:https://xsapi.com/api/jiexi/douyin/V1/dyjx.php,请求方式:GET 或 POST。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥,通过 Query 参数传递,即 key=… |
| url | string | 是 | 某音作品链接,支持短链接与长链接,如 https://v.douyin.com/xYCi-HV1d6k/ |
参数取值说明:
url 需为完整的某音链接,可包含分享文案中的短链接形式,也可直接使用作品长链接;链接需指向图文、短视频或实况作品。key 为必填项,缺失或无效时无法完成解析。{
"code": 200,
"msg": "解析成功",
"platform": "douyin",
"requestId": "gw_1ecc673201deba43cc3e888edf10b1ba",
"data": {
"type": "video",
"title": "如果是你在那支队伍里,能走多远?烽绘山河|长征,一场信仰的远征!#同心同行长征路#红星照耀中国",
"desc": "如果是你在那支队伍里,能走多远?烽绘山河|长征,一场信仰的远征!#同心同行长征路#红星照耀中国",
"author": {
"name": "中国军号",
"id": "79513381117",
"avatar": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_5f76434cd2bb4ffcb662d3c98f919dab.jpeg"
},
"cover": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-p-0015/okUAwhORAWlBDpEV75sCBQVfWIgRgKLwie3seG~tplv-dy-360p.jpeg",
"url": "https://v3-dy-a-x.ixigua.com/afeb76b149f8e79a10e17df064e09f24/6af3e4a2/video/tos/cn/tos-cn-v-0015c001/o00DBQwAqDAaU2gYBeFEgwDQA2A9ZAzEE5fDNA/?mime_type=video_mp4",
"quality": "original",
"label": "原画",
"duration": 33.414,
"size": 51167316,
"size_label": "48.8MB",
"width": 1080,
"height": 1920,
"bit_rate": 12250878,
"real_bit_rate": 12250878,
"fps": 30,
"format": "mp4",
"codec": "h264",
"video_id": "v0200fg10000dbc1pa7og65qar0l88dg",
"quality_type": 64,
"create_time": 1792548009,
"publish_time": "2026-10-21 10:00:09",
"video_backup": [
{
"size": 14670327,
"size_label": "13.99MB",
"label": "1080P高清",
"quality": "1080p",
"url": "https://v3-chameleon.usergrowth.com.cn/0b4c1c078bb32e2a580fae12f2a07304/6ae17db2/video/tos/cn/tos-cn-ve-15/os2A2BEBPpDb9sgQyrfoFTYAf0CgbqIAIKQoYQ/?mime_type=video_mp4",
"bit
## 错误响应示例
调用失败时,接口统一返回如下结构的 JSON 文本:`code` 固定为 `0`,`errcode` 为业务错误码,`msg` 为可读的错误说明。调用方应先判断 `code`,再根据 `errcode` 定位具体原因。
未携带调用密钥:
{"code":0,"msg":"未提供调用密钥","errcode":11001}
密钥错误:
{"code":0,"msg":"密钥错误","errcode":11002}
积分余额不足:
{"code":0,"msg":"积分余额不足","errcode":11004}
请求过于频繁:
{"code":0,"msg":"请求过于频繁,请稍后再试","errcode":11005}
接口不存在:
{"code":0,"msg":"接口不存在","errcode":11013}
请求方式不允许:
{"code":0,"msg":"请求方式不允许","errcode":11018}
## 业务错误码说明
| errcode | 含义 | 说明 |
| --- | --- | --- |
| 11001 | 未提供调用密钥 | 请求中未携带 `key` 参数 |
| 11002 | 密钥错误 | `key` 不存在或与本站签发的密钥不一致 |
| 11003 | 密钥已禁用 | 该密钥已被停用,无法继续调用 |
| 11004 | 积分余额不足 | 账户可用积分不足以支付本次调用 |
| 11005 | 请求过于频繁(QPM 限制) | 超过每分钟约 150 次的调用频率上限 |
| 11006 | 接口维护中 | 接口处于维护状态,暂时停止对外服务 |
| 11007 | 接口已禁用 | 接口已被关闭,不再对外提供调用 |
| 11008 | 接口不可用 | 接口当前无法正常提供服务 |
| 11009 | 密钥校验暂不可用 | 密钥校验环节暂时不可用,稍后重试 |
| 11010 | 积分系统暂不可用 | 积分扣减环节暂时不可用,稍后重试 |
| 11011 | 收费接口须提供有效密钥 | 该接口为收费接口,必须携带有效密钥 |
| 11012 | 鉴权方式错误 | 未按首选鉴权方式(Query 传 `key`)提交密钥 |
| 11013 | 接口不存在 | 请求的接口路径不存在或已下线 |
| 11014 | 目标地址无效 | 待处理的目标地址格式不合法或无法识别 |
| 11015 | 目标地址不允许 | 目标地址不在允许访问的范围内 |
| 11016 | 目标请求失败 | 向目标地址发起请求未获得有效结果 |
| 11017 | 服务暂不可用 | 服务整体暂时不可用,请稍后重试 |
| 11018 | 请求方式不允许 | 仅支持 GET、POST 两种请求方式 |
| 11019 | 当前IP不在白名单内 | 调用来源 IP 未在密钥绑定的白名单中 |
| 11020 | 启用出口通道须提供有效密钥 | 使用出口通道能力时必须携带有效密钥 |
| 11021 | 未配置可用出口通道 | 当前没有可用的出口通道配置 |
| 11022 | 出口通道不可用 | 出口通道当前不可用,请稍后重试 |
| 11023 | 密钥已过期 | 密钥超出有效期,需更换有效密钥 |
| 11024 | 令牌分配积分不足 | 令牌可分配的积分额度不足 |
| 11025 | 该密钥无权调用此接口 | 密钥有效,但未获得本接口的调用权限 |
## 调用示例
### 终端 curl(bash)
```bash
curl -G "https://xsapi.com/api/jiexi/douyin/V1/dyjx.php" \
--data-urlencode "key=你的密钥" \
--data-urlencode "url=https://v.douyin.com/xYCi-HV1d6k/"
// PHP 示例
$params = [
'key' => '你的密钥',
'url' => 'https://v.douyin.com/xYCi-HV1d6k/',
];
$url = 'https://xsapi.com/api/jiexi/douyin/V1/dyjx.php?' . http_build_query($params);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
key 参数附加在 URL 查询串中,例如 ?key=你的密钥&url=...。请勿将密钥写入前端页面、公开仓库、截图或日志中,避免被他人直接复用;建议在服务端保存并转发调用。https://xsapi.com/api/jiexi/douyin/V1/dyjx.php,请勿降级为 HTTP,以免密钥与解析结果在传输过程中被截获。url 参数取值:需传入某音作品链接,支持短链接(如 https://v.douyin.com/xYCi-HV1d6k/)与长链接。请传入完整链接,不要截断或额外拼接无关参数;链接需为可正常访问的公开作品,私密、已删除或地区受限的作品可能解析失败。url 需做 URL 编码:链接本身含 ?、&、= 等字符,作为参数值传递时应进行 URL 编码,否则可能被截断导致解析错误。data.type 标识作品类型,视频类作品的播放地址在 data.url(原画),备用画质在 data.video_backup 数组中;图文作品的图片在 data.images,实况作品在 data.live_photo。请按 type 分支读取,不要假定所有字段恒有值。data.url、video_backup[].url、music.url、cover 等均为带签名的临时地址,过期后无法访问。请勿长期缓存这些地址,需要持久使用时应在获取后尽快转存。data.quality 与 data.label 表示当前主地址的画质(如 original / 原画),video_backup 中各项带有 quality、label、width、height、bit_rate 等字段,可按需挑选。部分备用项 format 可能为空,使用前建议校验。extra.statistics 中的播放量、点赞、评论、收藏、分享等数值为解析时刻的快照,会随作品热度变化,不宜作为长期统计依据。code 为 200 表示解析成功,其他取值表示失败,可结合 msg 判断原因(如链接无效、作品不可访问等)。请对失败情况做兜底处理,不要将错误信息直接透传给终端用户。某音去水印解析接口,支持解析图文、短视频和实况作品,兼容短链接与长链接参数。适用于需要获取作品原画视频、备用画质、作者信息及作品统计数据的场景。
https://xsapi.com/api/jiexi/douyin/V1/dyjx.php
支持 GET 与 POST 两种方式,参数可放在查询字符串或表单中提交。
调用本接口必须携带密钥,密钥通过 Query 参数 key 传递,例如:
https://xsapi.com/api/jiexi/douyin/V1/dyjx.php?key=你的密钥&url=某音链接
未携带或密钥无效时无法完成解析。本接口免费调用,频率限制约为每分钟 150 次。
调用地址:https://xsapi.com/api/jiexi/douyin/V1/dyjx.php,请求方式:GET 或 POST。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥,通过 Query 参数传递(?key=…) |
| url | string | 是 | 某音作品链接,支持短链接与长链接,如 https://v.douyin.com/xYCi-HV1d6k/ |
参数取值说明:
url 需为完整的某音作品链接,支持短视频、图文、实况作品;短链接与长链接均可直接传入,无需预先展开。key 为必填项,缺失或无效时无法返回解析结果。其他说明:本接口免费调用,频率限制约每分钟 150 次。
{
"code": 200,
"msg": "解析成功-eo",
"data": {
"type": "video",
"title": "如果是你在那支队伍里,能走多远?烽绘山河|长征,一场信仰的远征!#同心同行长征路#红星照耀中国",
"desc": "如果是你在那支队伍里,能走多远?烽绘山河|长征,一场信仰的远征!#同心同行长征路#红星照耀中国",
"author": {
"name": "中国军号",
"id": "79513381117",
"avatar": "https://p26.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_5f76434cd2bb4ffcb662d3c98f919dab.jpeg?from=327834062"
},
"cover": "https://p5-ex-gddgtc-sign.douyinpic.com/tos-cn-p-0015/okUAwhORAWlBDpEV75sCBQVfWIgRgKLwie3seG~tplv-dy-360p.jpeg",
"url": "https://v3-dy-a-x.ixigua.com/afeb76b149f8e79a10e17df064e09f24/6af3e4a2/video/tos/cn/tos-cn-v-0015c001/o00DBQwAqDAaU2gYBeFEgwDQA2A9ZAzEE5fDNA/?mime_type=video_mp4",
"quality": "original",
"duration": 33.414,
"size": 51167316,
"size_label": "48.8MB",
"create_time": 1792548009,
"publish_time": "2026-10-21 10:00:09",
"video_backup": [
{
"size": 14670327,
"size_label": "13.99MB",
"label": "1080P高清",
"quality": "1080p",
"url": "https://v3-chameleon.usergrowth.com.cn/0b4c1c078bb32e2a580fae12f2a07304/6ae17db2/video/tos/cn/tos-cn-ve-15/os2A2BEBPpDb9sgQyrfoFTYAf0CgbqIAIKQoYQ/?mime_type=video_mp4",
"bit_rate": 3512378,
"width": 1080,
"height": 1920,
"format": "mp4",
"codec": "h264",
"quality_type": 8,
"gear_name": ""
}
],
"images": [],
"live_photo": [],
"music": {
"title": "@中国军号创作的原声",
"author": "中国军号",
"url": "https://sf26-sign.douyinstatic.com/ies-music/7698917334764817190.mp3",
"cover": "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c001_5f76434cd2bb4ffcb662d3c98f919dab.jpeg?from=327834062"
},
"extra": {
"aweme_id": "7698935058064772403",
"sec_item_id": "MS4wLjAAAAAAcgSbOGEJQ1nfzLcM9hTdte0eqLhAjxkK7HIViVpgfhObswvFXA7RqtY1XfqNJuL8",
"create_time": 1792548009,
"region": "",
"duration_ms": 33414,
"share_url": "https://qingtao.douyin.com/video/7698935058064772403",
"statistics": {
"digg_count": 41860,
"comment_count": 3247,
"collect_count": 1245,
"share_count": 987,
"admire_count": 0,
"play_count": 935231
},
"hashtags": [
{
"name": "同心同行长征路",
"id": "7631561190104205363",
"type": 1
}
],
"video_tags": [
{
"name": "时政社会",
"id": "2018",
"level": 1
}
],
"author_extra": {
"uid": "79513381117",
"sec_uid": "MS4wLjABAAAAdGSbTdgq_DbLUkHqM2oR0BWTFxw9pe88wXZKG4-2F6c",
"unique_id": "jfjxwcbzx",
"short_id": "831645047",
"signature": "",
"follower_count": 57162599,
"favoriting_count": 128,
"total_favorited": 1080583917
},
"play_count_source": "douyin",
"categories": [
{
"level1": "2018",
"level2": "2018006",
"level3": "2018006001",
"tag_name_level1": "时政社会",
"tag_name_level2": "政务宣传",
"tag_name_level3": "宣教科普"
}
],
"category_name": "社会时政",
"show_tag": "视频"
},
"width": 1080,
"height": 1920,
"bit_rate": 12250878,
"real_bit_rate": 12250878,
"fps": 30,
"format": "mp4",
"codec": "h264",
"video_id": "v0200fg10000dbc1pa7og65qar0l88dg",
"label": "原画",
"quality_type": 64
},
"platform": "douyin",
"requestId": "gw_1
## 错误响应示例
当请求未通过校验或处理失败时,接口返回统一的 JSON 结构,`code` 为业务状态码,`msg` 为可读提示,`errcode` 为具体错误编号。以下为未提供调用密钥时的响应示例:
```json
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}
密钥错误时的响应示例:
{
"code": 0,
"msg": "密钥错误",
"errcode": 11002
}
请求过于频繁时的响应示例:
{
"code": 0,
"msg": "请求过于频繁",
"errcode": 11005
}
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
| 11025 | 该密钥无权调用此接口 |
curl -G "https://xsapi.com/api/jiexi/douyin/V1/dyjx.php" \
--data-urlencode "key=你的密钥" \
--data-urlencode "url=https://v.douyin.com/xYCi-HV1d6k/"
// PHP 示例
$params = [
'key' => '你的密钥',
'url' => 'https://v.douyin.com/xYCi-HV1d6k/',
];
$url = 'https://xsapi.com/api/jiexi/douyin/V1/dyjx.php?' . http_build_query($params);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
key 传递,请妥善保管,不要写入前端页面、公开仓库或客户端安装包,避免被他人盗用导致额度被消耗。url 需传入完整的某音作品链接,短链接(如 https://v.douyin.com/xxxx/)与长链接均可,传入前请确认链接未过期、未被截断。data.url 为原画地址,data.video_backup 为备用画质列表,这些地址通常带有有效期签名,请及时下载或转存,不要长期保存链接后再次使用。data.images、data.live_photo,视频类作品该两项可能为空数组,请按 data.type 判断后再取用对应字段。data.extra.statistics 中的播放量、点赞数等统计值随作品实时变化,仅代表请求时刻的数据,不宜作为长期存档依据。curl -G 'https://xsapi.com/api/jiexi/douyin/V1/dyjx.php' \
--data-urlencode 'key=YOUR_API_KEY' \
--data-urlencode 'url=https://v.douyin.com/xYCi-HV1d6k/'