抖音视频/图文解析服务端源码分享

• 这是一个“抖音解析的后端服务源码分享”，输入分享文案，输出作品资源 URL（不下载）。

• 核心流程：解析短链 → 提取 aweme_id → 调用抖音 Web API → 选择最高质量资源。

• Web API 来自 Web 端真实请求（非公开接口），需要 Cookie + ABogus 才能访问。

• 最高质量只依赖 Web API 质量字段（width/height/bitrate），并在响应里可证明。

1. 项目目标

• 输入：抖音分享文案（含短链）

• 输出：作品资源 URL（视频/音频/封面/头像/图文图片）

• 约束：不提供下载，仅返回 URL

2. 系统架构（分层设计）

• 负责 HTTP 输入/输出与状态码

• 路由：/v1/douyin/resolve、/v1/douyin/inspect

• 统一错误结构：success/error/error_type

• 解析、网络请求、资源选择

• 统一异常体系：DouyinError 子类

• 核心数据用 @dataclass(slots=True)

3. 核心流程

3.1 Resolve（轻量解析）

1. 从分享文本中提取第一个 URL

2. 访问该 URL 并跟随跳转，得到最终落地页 URL

3. 从落地 URL 提取 aweme_id

4. 生成候选链接列表（用于排障/重试）

• extracted_url / resolved_url / aweme_id / candidate_urls

3.2 Inspect（资源获取）

1. 调用 resolve 获取 aweme_id

2. 调用 Web API 获取作品详情 JSON

3. 解析资源（video/audio/image/cover/avatar）

4. 选择“最高质量”资源

5. 返回完整资源列表 + 质量信息

4. 抖音内部的Wwb API

✅ 使用的 Web API

✅ 请求关键要素

1. Cookie（必须）

• 服务端固定读取 www.douyin.com_cookies.txt

• Cookie 失效后更新文件即可（无需重启容器）

1. ABogus 参数（必须）

• 通过 f2.utils.abogus 动态生成

• 必须与请求 UA/指纹一致

1. 关键参数（示例）

• aweme_id

• device_platform=webapp

• browser_* / screen_width / screen_height

• version_code / version_name

说明：该接口不是公开 API，需要 Cookie + ABogus。

Cookie获取

✅ 如何“拿到”这个 Web API（真实过程）

1. 打开抖音 Web 页面（PC 端）

2. F12 打开开发者工具 → Network

3. 找到请求 aweme/detail 的接口

4. 观察它的必需参数（aweme_id、浏览器信息、abogus）

5. 把这套请求结构搬到服务端实现

5. 最高质量判定

• selected_video_quality

• max_video_quality

6. 视频 vs 图文（note）

• content_kind = video | note

• 图文作品通常没有视频资源（只返回图片/封面/头像）

• 视频作品返回视频/音频/封面/头像

7. 错误策略

• missing_cookie_file

• WebApiEmptyError

• VideoQualityMissingError

8. 部署要点

• 容器端口：1314

• 健康检查：GET /healthz

9. 总结

• 解析分享文案 → aweme_id

• Cookie + ABogus 调用 Web API

• 仅使用 Web API 质量字段选择最高质量

• 输出完整资源 URL 供前端/调用方使用

附：源码分享

• 名称：douyinapi.zip

• 链接：https://pan.quark.cn/s/12493d315367

• 提取码：PgMM