> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 抖音最高画质链接在哪？为什么保存后失效？

> 从 douyin.app.v3.fetch_video_high_quality_play_url 响应的 data.original_video_url 读取抖音最高画质播放地址，在本地核对 video_id，并在签名链接失效后按需重查。

抖音最高画质的视频地址在 `douyin.app.v3.fetch_video_high_quality_play_url` 响应的 `data.original_video_url`。对已选定的一条视频发请求，再保存**核对过作品编号的播放记录**，不要只把一个 URL 粘进表格。播放地址带签名，过后可能失效，之后需要时重新查询。本页最后用本地核对生成私有播放 JSON 和不含 URL 的审核摘要，不下载、不发布视频。

## 手里有什么，怎样避免重复花钱？

| 已有输入          | 提交方式                        | 不要做什么         |
| ------------- | --------------------------- | ------------- |
| 原始作品编号        | 字符串 `aweme_id`              | 不必另买分享链接解析    |
| 真实分享 URL，没有编号 | 用 `share_url` 替代 `aweme_id` | 不编造编号，也不传作者主页 |
| 已保存成功响应       | 运行下方本地核对                    | 不为重新排版再查一次    |

`region` 是请求出口国家的 ISO 代码，例如 CN、US、HK，不是内容语言或作者地域筛选。面向国内使用时明确传 CN；不传 `region` 时使用服务自身的出口。任何 `region` 取值都不保证每个 CDN 地址在每个地区都能播放。

10 条视频各查一次，共 10 次请求；每次刷新地址另算一次。当前单价见 [BeatAPI 价格页](https://beatapi.io/zh/pricing)。

## 怎样发起一次请求并保留证据？

把下面的 JSON 保存为 `request.json`，用真实编号替换占位符，只选一种输入。只有分享 URL 时，把 `aweme_id` 这一项换成 `share_url`。API Key 放在本机环境变量里，不写入 JSON 或共享文档。

```json
{"action":"douyin.app.v3.fetch_video_high_quality_play_url","params":{"aweme_id":"YOUR_REAL_VIDEO_ID","region":"CN"}}
```

```bash
mkdir playback-call &&
curl --fail-with-body -sS https://api.beatapi.io/v1/social-data/call \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @request.json \
  -D playback-call/headers.txt \
  -o playback-call/response.json
```

新目录防止覆盖上一次记录。HTTP 失败或响应 `status` 失败都是查询失败，不是可用的媒体结果；保留失败查询的 `request_id` 排查，不轮流换地区，也不循环付费刷新。

## 怎样核对编号并交付播放记录？

把下面的脚本保存为 `playback_record.py`，运行 `python3 playback_record.py playback-call/response.json YOUR_REAL_VIDEO_ID playback-review`。从分享 URL 查询时，先把返回的 `video_id` 和分享链接实际打开的作品核对。直接把响应里的编号抄作参数，只能证明响应内部一致，不能证明选对了作品。

```python
import hashlib,json,math,pathlib,sys
from urllib.parse import urlsplit
raw_path=pathlib.Path(sys.argv[1]);expected=sys.argv[2];out=pathlib.Path(sys.argv[3])
def video_id(value):
    return isinstance(value,str) and value.isascii() and value.isdigit() and any(c!='0' for c in value)
if not video_id(expected):raise ValueError('Expected original nonzero ASCII video ID')
raw=raw_path.read_bytes();response=json.loads(raw)
if not isinstance(response,dict) or response.get('status')!='succeeded' or response.get('action')!='douyin.app.v3.fetch_video_high_quality_play_url' or response.get('error') is not None:raise ValueError('Expected successful high-quality URL response')
rid=response.get('request_id');data=response.get('data')
if not isinstance(rid,str) or not rid.strip() or not isinstance(data,dict):raise ValueError('Missing request ID or data object')
if not video_id(data.get('video_id')) or data['video_id']!=expected:raise ValueError('Video identity does not match; do not use the URL')
url=data.get('original_video_url')
if not isinstance(url,str) or any(ord(c)<=32 or ord(c)==127 for c in url):raise ValueError('Missing or malformed URL')
u=urlsplit(url)
if u.scheme!='https' or not u.hostname or u.username is not None or u.password is not None or u.fragment or u.port not in (None,443):raise ValueError('Expected HTTPS media URL without credentials or fragment')
values={}
for field,kind in [('content_type',str),('file_size',str)]:
    value=data.get(field)
    if value is not None and not isinstance(value,kind):raise ValueError('Unexpected type: '+field)
    values[field]=value
size=data.get('file_size_in_mb')
if size is not None and (type(size) not in (int,float) or not math.isfinite(size) or size<0 or (type(size)==int and size>9007199254740991)):raise ValueError('Invalid megabyte value')
values['file_size_in_mb']=size
record={'video_id':expected,'request_id':rid,'original_video_url':url,**values,'source_sha256':hashlib.sha256(raw).hexdigest(),'source_file':str(raw_path.resolve()),'url_checked':False,'downloaded':False,'expires_at':None,'scope':'Saved response only; no network request, expiry inference or rights grant'}
summary={k:v for k,v in record.items() if k!='original_video_url'}
summary['media_host']=u.hostname;summary['url_omitted']=True
out.mkdir();(out/'raw-response.json').write_bytes(raw)
(out/'playback-private.json').write_text(json.dumps(record,ensure_ascii=False,indent=2),encoding='utf-8')
(out/'review-summary.json').write_text(json.dumps(summary,ensure_ascii=False,indent=2),encoding='utf-8')
print(str(out))
```

`playback-private.json` 保存完整签名 URL 和来源哈希，`raw-response.json` 保留原始响应字节，`playback-private.json` 与 `raw-response.json` 均作为私有工作文件保存。`review-summary.json` 去掉 URL，保留 `video_id`、`request_id`、`media_host`、元数据和 `source_sha256`；分享 `review-summary.json` 前，先核对作品编号、`request_id` 与域名是否适合提供给接收者。`playback_record.py` 不发 HTTP 请求、不打印签名 URL，`video_id` 不匹配即拒绝，已有输出目录不覆盖。

返回的元数据只对应单次响应：`content_type` 是返回的 MIME 标签，`file_size` 保持原字符串，`file_size_in_mb` 有值时保留数值。可选字段缺失就是 `null`，不补 0；两个大小值都没有和下载字节核对过。地址读 `data.original_video_url`，不用详情接口嵌套的 `play_addr` 路径；同一素材的多个镜像地址也不代表不同画质。

## 明天链接失效该怎么办？

播放地址带签名，`expires_at: null` 表示响应没有给出到期时间。第二天 `data.original_video_url` 返回 403 或 404 时，先打开原作品，核对作品是否还能访问。如果还需要播放地址，就用同一 `aweme_id` 重新查询，把新地址和查询时间存成新记录。每次重查按一次请求计费。

播放记录里的 `url_checked: false` 和 `downloaded: false` 是有意设置：本地核对不证明链接可达、画质、解码兼容或备份完成。不要把签名 URL 发布成长期网站素材。拿到播放地址不等于取得版权、转载许可、字幕或转写。本页流程交付的是核对后的元数据，不是视频归档。

[作品指标与来源核对](/zh/guides/douyin-share-snapshot) · [作品编号与分享链接](/zh/faq/douyin-video-id)

依据：`data:douyin.app.v3.fetch_video_high_quality_play_url` 动作合同；`playback_record.py` 在本地校验已保存响应，不发起网络请求。

## 不同平台的视频地址怎样交接？

先确认团队要看原作品、核对时长，还是读视频里说的话。抖音按本页步骤核对作品和地址；小红书视频见[视频文字与媒体](/zh/faq/xiaohongshu-video-text)，按实际返回保留描述和地址；视频号先用[账号与作品标识](/zh/faq/wechat-channels-identifiers)确认详情和媒体来源。每个平台都记录平台、作品 ID、获取时间、实际材料、是否验证可播放，以及是否取得字幕。审核表里优先放原作品链接和可回查的请求号，带访问凭证的原件留在内部记录。