TikTok 转 MP4 转换 API
一次 POST 把 TikTok 视频转成 MP4——返回保留期存储地址、直接播放地址和文件元数据。
- 一次 POST，一个 MP4
- 保留期存储地址
- 附直接播放地址
- TTL 可控
- 幂等键支持
- 服务端持 key
请求示例
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.video_download 操作下载一条公开 TikTok 视频的媒体文件。API key 放在你的服务端；端点一次调用返回保留期存储地址和直接播放地址。
一次 POST，一个 MP4
向 /v1/tiktok/video/download 发 POST，带 TikTok 视频链接。成功的 200 返回 video_id、play_url、storage_url、file_size_mb、ttl、expires_at——媒体流水线需要的全在一个响应里。
保留期存储地址
storage_url 指向完整保存的 MP4 文件，在所选 TTL 保留期内有效——不是会过期的 CDN 跳转。交给队列 worker，几小时后再取也不用重新转换。
附直接播放地址
除了保留文件，响应还带 play_url 用于立即播放或流式传输。预览用 play_url，下载用 storage_url——同一次调用都给你。
TTL 可控
可选 ttl 参数选择存储文件的保留时长。响应回显 TTL 和精确的 expires_at 时间戳，流水线始终知道下载截止时间。
幂等键支持
带 Idempotency-Key 头可以安全重试失败请求，不会重复扣费。网关按键去重——网络重试不会触发同一视频的第二次下载。
服务端持 key
端点需要放在你服务端的 AgentBody API key。绝不要把 key 写进客户端代码——所有调用走你的后端，保证 key 安全、用量可追踪。
使用步骤
三步把 TikTok 转 MP4 集成进你的系统。
获取 API key
注册免费 AgentBody 账户，在控制台生成 API key。key 用于认证每个请求并按余额计量。
POST 视频链接
向 /v1/tiktok/video/download 发 POST，请求体带 TikTok 视频链接。可选 ttl 设置存储保留期，带 Idempotency-Key 头安全重试。
拿到下载地址
成功的 200 返回 storage_url 和 play_url，附视频 ID、文件大小和过期时间戳。从 storage_url 下载 MP4，或用 play_url 直接播放。
常见问题
TikTok 转 MP4 API 怎么工作？
向 /v1/tiktok/video/download 发 POST，带 TikTok 视频链接。API 下载视频媒体文件并存入保留存储，返回存储地址、直接播放地址、视频 ID、文件大小和过期时间戳。
url 参数支持什么格式？
url 接受 TikTok 视频链接——完整 tiktok.com 视频 URL 或分享短链。API 会把链接解析到底层公开视频。私密或已删除视频返回 400 或 502。
存储地址有效期多久？
storage_url 在 ttl 参数选择的保留期内有效；响应回显 ttl 和精确的 expires_at 时间戳。过期前下载，或用新幂等键重新转换。
端点返回哪些错误码？
400 表示链接格式错误或不支持，401 表示 key 缺失或无效，409 表示幂等冲突，502/503/504 表示上游故障。失败不计费；上游错误用同一幂等键重试。
API 去水印或重新编码吗？
不。API 按平台提供的媒体文件原样保存，不重新编码，也不承诺去水印。拿到的 MP4 与源流一致——请在 TikTok 条款和创作者权利范围内使用。
能批量转换吗？
每次调用只转一条视频。批量场景循环你的 URL 列表，每条一次 POST、各自独立幂等键。单次价格固定，见定价页。