TikTok 视频下载 API

通过一次带鉴权的 POST 请求提交公开 TikTok 链接，获取直接播放和持久存储地址。

一个 POST 端点
持久存储地址
可设置 TTL
统一 JSON 响应
可预测的错误处理
五种语言示例

请求示例

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

响应示例

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

Downloaded TikTok media links with persistent storage.

{
  "expires_at": "2026-01-08T00:00:00Z",
  "file_size_mb": 15.2,
  "play_url": "https://example.com/play.mp4",
  "storage_url": "https://example.com/storage/video.mp4",
  "ttl": "1w",
  "video_id": "7050551461734042926"
}

功能特点

使用 TikTok 视频下载 API 获取并保存公开视频媒体，无需维护浏览器自动化、存储上传或过期链接处理逻辑。

一个 POST 端点

调用 POST /v1/tiktok/video/download，提交 Bearer API Key、一个公开 TikTok URL 和可选 TTL。每次操作独立计费，并支持幂等键。

持久存储地址

成功响应同时返回 storage_url 和 play_url，应用可分别用于较长期保存和立即播放。

可设置 TTL

ttl 可选 1d、3d、1w、1m、1y 或 5y。未提交时使用文档默认值，请按产品存储与合规需求选择。

统一 JSON 响应

返回 video_id、play_url、storage_url、ttl，以及可选的 file_size_mb 和 expires_at；公开契约不会暴露上游专有字段或凭据。

可预测的错误处理

400 修正请求，401 检查密钥，402 处理余额不足；502、503、504 属于临时错误，可使用退避策略重试。

五种语言示例

页面根据 OpenAPI 自动生成 curl、JavaScript、Python、Java 和 Go 示例，包含 POST 请求体和鉴权头。

使用步骤

创建 API Key，提交一个公开视频链接和保存期限，再从后端处理返回的媒体地址。

创建 API Key

在 AgentBody 控制台创建 API Key，并保存在服务端环境变量或可信密钥管理器中，不要打包到浏览器代码。

选择公开视频

复制公开 TikTok 视频链接。私密、已删除、受限或不可访问的视频无法处理，API 也不会接受 TikTok 账号凭据。

构造 POST 请求体

JSON 中 url 为必填字段；只有需要指定保存期限时才提交 ttl，可选值以页面生成的契约示例为准。

添加幂等键

每次逻辑下载使用唯一 Idempotency-Key。只有在相同请求发生不确定失败时，才复用原键进行安全重试。

解析 JSON

使用 storage_url 获取持久文件，使用 play_url 立即访问媒体；仅在业务需要时保存 video_id、ttl、file_size_mb 和 expires_at。

正确处理失败

400、401、402 需要先修正条件；上游或超时类临时错误应使用有限次数的指数退避。

常见问题

TikTok 视频下载 API 是什么？

它是 POST /v1/tiktok/video/download，接受一个公开 TikTok 视频链接，并返回直接播放和持久存储地址的带鉴权 API。

请求体需要哪些字段？

url 为必填的公开视频链接；ttl 为可选保存期限，支持 1d、3d、1w、1m、1y 和 5y。

成功响应有哪些字段？

响应包含 video_id、play_url、storage_url 和 ttl；在数据可用时还包含 file_size_mb 和 expires_at。

API 支持批量下载吗？

不提供批量数组参数。请每个视频发起一次请求，并在你的应用中管理并发、节奏、重试和幂等键。

下载失败后如何重试？

400、401、402 应先修正请求、密钥或余额。502、503、504 可退避重试；相同逻辑请求才复用同一幂等键。

API 保证无水印吗？

不保证。API 获取媒体，但不会承诺独立去水印或重新编码。请自行检查文件，并遵守 TikTok 条款和创作者权益。