抖音视频下载 API

一次带鉴权的 POST 把公开抖音视频链接转成已保存的 MP4——视频直链加规范化元数据（标题、作者、互动数），干净 JSON 返回。

单一 REST 端点
全链接格式
规范化元数据
互动数据内置
幂等的计费写入
可预期的错误码

请求示例

curl -X POST "https://api.agentbody.io/v1/douyin/video/download" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"url":"YOUR_URL"}'

响应示例

来自 OpenAPI 规范的已文档化响应。

Downloaded Douyin media link and normalized public video metadata.

{
  "author_name": "盗月社食遇记",
  "collect_count": 855021,
  "comment_count": 162235,
  "digg_count": 4037193,
  "duration_seconds": 1082.5,
  "id": "7577614489533680959",
  "share_count": 5135670,
  "text": "这个贵州五线小城市…",
  "title": "贵州美食探店",
  "url": "https://www.douyin.com/video/7577614489533680959",
  "video_content_type": "video/mp4",
  "video_size_bytes": 215476832,
  "video_url": "https://api.apify.com/v2/key-value-stores/example/records/7577614489533680959.mp4"
}

功能特点

用抖音视频下载 API 搭建内容存档、出海调研管线和媒体工作流——URL 进，MP4 链接和数据出。

单一 REST 端点

带 bearer API 密钥和公开视频 URL 调用 POST /v1/douyin/video/download。API 保存 MP4 并返回视频直链——无需逆向签名、无需设备农场、无需维护爬虫。

全链接格式

url 字段接受 douyin.com 视频链接、iesdouyin 分享链、v.douyin.com 短链和纯数字视频 ID。集成侧用户粘什么都能解析，省一步归一化。

规范化元数据

每个响应把 video_url 与 id、title、text、author_name、时长、文件类型和大小配对——管线可直接存储的稳定字段，无需逐请求解析。

互动数据内置

响应在文件链接之外还带 digg_count、comment_count、share_count、collect_count——一次请求同时归档视频和它的传播快照。

幂等的计费写入

视频保存是按量计费操作。重试时带 Idempotency-Key 头，中断的响应不会重复计费同一视频——同键的相同重复请求返回原始结果。

可预期的错误码

用文档化状态码处理失败：400 请求无效、401 密钥缺失或错误、409 幂等冲突、502/503/504 暂时性上游问题——每类对应明确的修复或重试动作。

使用步骤

按以下步骤调用抖音视频下载 API：创建密钥，构造 POST 请求，处理返回的 MP4 链接。

创建 API 密钥

创建 AgentBody 账号并在控制台生成 API 密钥。密钥放在服务端环境或受认可的密钥库，以 bearer 令牌发送——绝不进浏览器代码或客户端包。

构造请求

向 /v1/douyin/video/download 发送 POST，带必填的 url——douyin.com 链接、iesdouyin 分享链、v.douyin.com 短链或数字视频 ID。生成示例展示五种语言的确切请求。

加幂等键

给每个可能重试的下载附 Idempotency-Key 头——超时、断连、worker 重启。同键的重复相同请求返回原始响应，不重复计费。

密钥留在服务端

从后端、serverless 函数或定时任务调用端点。若终端用户触发下载，经你自己的端点代理，让密钥和计额掌控在你手里。

解析 JSON 响应

读取返回的 video_url、id、title、author_name、时长、大小和互动计数。把链接和元数据一起存储，或把 URL 直接交给存储层——字段跨请求稳定。

正确处理错误

400 修请求体，401 配好密钥，409 按文档化幂等键行为处理。502/503/504 同键带退避重试。

常见问题

抖音视频下载 API 是什么？

一个带鉴权的 POST 端点 /v1/douyin/video/download，把一条公开抖音视频保存为 MP4，返回视频直链和规范化元数据——id、标题、作者、时长、文件大小和互动计数——以结构化 JSON 交付。

抖音下载 API 的价格怎么算？

每次视频保存是消耗账号额度的按量计费操作。价格由网关管理，而非本页写死的数字——在控制台查看当前单价，并用幂等键确保重试不双重计费。

抖音 API 接受哪些 URL 格式？

url 字段接受 douyin.com 视频链接、iesdouyin 分享链、v.douyin.com 短链和纯数字视频 ID——用户粘什么，同一请求结构都能解析。

API 能下载私密抖音视频吗？

不能。端点只读取公开视频——私密、仅好友可见和已删除视频不会解析，也不会索要抖音凭据来绕过限制。

视频链接附带哪些元数据？

id、url、title、text、author_name、duration_seconds、video_content_type、video_size_bytes，以及点赞、评论、分享、收藏计数——足以把视频和它的传播快照一起归档。

怎么处理 API 错误？

400 修请求体，401 修 bearer 密钥，409 按文档化幂等键行为处理。把 502、503、504 当作暂时性上游故障，同键带退避重试。