TikTok 视频要求:API 的格式、大小与时长
通过 TikTok API for Business 发布的视频,必须是最大 1 GB 的 MP4、MOV 或 WebM 文件,时长为 3 至 600 秒(或账户的较低上限),画面的高度和宽度至少为 360 像素,帧率为每秒 23 至 60 帧。TikTok 会自行下载文件,因此视频 URL 必须位于发布应用已验证的域名或 URL 前缀之下。
easyCoexistence 可通过 Claude、ChatGPT 或您自己的代码,使用 publish_tiktok_post 发布 TikTok 视频:传入文件的 HTTPS 链接、文案以及是否开启评论,它会通过自有的已验证媒体路由将文件提供给 TikTok。
发布端点可接受的最大视频,采用 MP4、MOV 或 WebM 容器。
TikTok 为通过 API 发布所记录的最短和最长视频时长。
已发布视频的最小高度和宽度,并需要每秒 23 至 60 帧。
TikTok 建议视频 URL 保持有效的最短时间,因为 TikTok 会自行下载文件。
视频必须符合哪些要求?
TikTok 对通过 POST /business/video/publish/ 发布的视频的规范,TikTok 在下载文件后进行检查:
- 容器:MP4、MOV 或 WebM。
- 大小:最大 1 GB。
- 时长:至少 3 秒,至多 600 秒;若账户自身的上限更低,则以该上限为准。
- 画面:高度和宽度均至少为 360 像素。
- 帧率:每秒 23 至 60 帧。
每个账户都能发布 600 秒的视频吗?
不一定。GET /business/video/settings/ 会返回 max_video_post_duration_sec,即账户自身可发布的最长视频,超出该时长的视频会发布失败。同一请求还会返回账户设置是否允许其帖子接受评论、Duet 和 Stitch。使用 easyCoexistence 时,您自己的代码可凭 get_social_credentials 返回的令牌和 business_id 读取该信息。
视频必须位于哪里?
位于公开的 HTTP 或 HTTPS URL 上,TikTok 会自行获取该文件,并建议该 URL 至少保持 30 分钟有效。自 2023 年 11 月 16 日起,TikTok 还会拒绝未经验证的视频 URL:开发者需通过 DNS TXT 记录证明对某个域名的所有权,或通过放置在某 URL 前缀之下的签名文件证明对该前缀的所有权,之后,任何以已验证前缀开头的 URL 都可用于发布。
easyCoexistence 如何将您的文件交给 TikTok?
通过其自有的已验证 URL 前缀。publish_tiktok_post 接收您的 HTTPS 链接,向 TikTok 提供 easyCoexistence 媒体路由下的签名链接,该链接 6 小时后失效,并在 TikTok 下载文件时从您的链接中流式传输文件,过程中不存储任何内容。您的链接无需自行验证,但必须为 HTTPS,并且在帖子发布前无需登录即可访问。
TikTok 下载视频后会发生什么?
TikTok 会检查文件并进行转码,并提示已发布的帖子所显示的分辨率和比特率可能低于原始文件,具体取决于观看者的设备和网络。违反规则的文件不会发布:其状态显示为 FAILED,并附带原因,例如 file_format_check_failed、frame_rate_check_failed 或 picture_size_check_failed,并且 TikTok 将这些情况标记为不可使用同一文件重试。
常见错误
- 发送 http:// 链接。publish_tiktok_post 只接受 HTTPS 链接,会在 TikTok 收到请求前拒绝该调用。
- 导出帧率低于每秒 23 帧。TikTok 下载文件后发现帧率过低,会以 frame_rate_check_failed 导致帖子发布失败。
- 假设所有账户都能发布 600 秒视频。超过账户 max_video_post_duration_sec 的视频会发布失败,因此应先检查该值。
- 调用后立即下架文件。TikTok 在接受请求后才下载文件,若链接失效,则会以 video_pull_failed 失败。
每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
TikTok 的 API 接受哪些视频格式?
MP4、MOV 和 WebM 文件,最大 1 GB,时长 3 至 600 秒,每边至少 360 像素,帧率为每秒 23 至 60 帧。
我能从电脑上传视频文件吗?
不能通过此端点上传。它接收 video_url,并从该 URL 下载文件,因此视频需先有一个公开的 HTTPS 链接。
TikTok 为什么要求已验证的 URL?
TikTok 表示,验证 URL 所有权有助于其遵守关于版权内容和用户安全的政策;自 2023 年 11 月 16 日起,它已拒绝未经验证的视频 URL。
TikTok 会降低通过 API 发布的视频画质吗?
可能会。TikTok 会对视频进行转码,帖子所显示的分辨率和比特率可能低于原文件,具体取决于观看者的设备和网络连接。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间