TikTok 错误 40100:请求过于频繁
TikTok 错误 40100 表示请求触发了频率限制:TikTok 在 HTTP 200 响应的正文中返回代码 40100,因此仅看状态码无法发现它。解决方法是暂停对该端点的调用:如果触发的是每分钟限额,则暂停 5 分钟;如果触发的是每日限额,则暂停至 00:00 UTC。之后,请发送更少但更大的请求。
easyCoexistence 会将 TikTok 的代码和消息返回给 Claude、ChatGPT 或您自己的代码,使您的 AI 能够区分频率限制与发布失败,并在再次尝试前等待。
TikTok 在触发频率限制后返回的代码,表示该请求已被限流。
TikTok 随返回代码一同发送的状态,包括 40100 在内;只有正文中的代码 0 表示成功。
针对每个已授权 TikTok 账户、每个端点的 Accounts API 频率限制。
每个开发者应用在 Basic 级别下,所有 Accounts API 端点合计的限额;更高级别允许 1,000。
TikTok 规定在触发每分钟限额后,需等待多久才能再次调用。
账户一天通过 API 最多可发布的视频数量,且每分钟最多 6 条。
错误 40100 是什么意思?
频率限制阻止了该请求。TikTok 的返回代码附录将 40100 描述为请求过于频繁,原因是该端点在开发者应用层面的限额已达到;其频率限制指南还说明,一旦达到限额,服务器即返回 40100。对该端点的调用必须暂停,直至暂停解除。
如何在代码中检测 40100?
通过正文中的代码判断,而非 HTTP 状态码。TikTok 随 HTTP 200 一同返回其返回代码,因此请检查每个响应中的 code:0 表示成功,40100 表示请求被限流。4xx 状态码表示路径或方法有误;遇到 5xx 时,TikTok 建议等待约 5 分钟后再重试:
// TikTok returns its error codes with HTTP 200: read code, not only the status.
async function callTikTok(url, accessToken) {
const res = await fetch(url, { headers: { "Access-Token": accessToken } });
if (res.status >= 500) return { retryInMs: 5 * 60_000 }; // TikTok: wait about 5 minutes
if (!res.ok) throw new Error("HTTP " + res.status + ": check the path and the method");
const body = await res.json();
if (body.code === 40100) return { retryInMs: 5 * 60_000 }; // throttled: pause this endpoint
if (body.code !== 0) throw new Error("TikTok " + body.code + ": " + body.message);
return { data: body.data };
}哪些限额会返回 40100?
TikTok 的频率限制指南称,一旦达到频率限制,服务器便返回 40100。每项限额单独计算,完整数值按应用层级列于频率限制页面。一次 Accounts API 调用会计入以下三项限额:
- 每个已授权账户在每个 Accounts API 端点上每分钟 40 次查询,在各应用层级均相同。
- 开发者应用在 Basic 级别下,Accounts API 合计每分钟 600 次查询,更高级别为 1,000 次。
- 按秒、分钟和天计算的各端点应用限额,由应用层级决定。
应该等待多久?
这取决于触发的是哪项限额。触发每分钟限额后,TikTok 要求等待 5 分钟再调用。触发每日限额后,则需等到次日,因为每日限额在 UTC 00:00:00 重置。TikTok 的指南补充说,端点专属限额相互独立,因此触及某个端点的限额不会阻止对其他端点的调用。
每天 15 条帖子的上限是同一种限额吗?
不是。发布上限以帖子计:每个账户、每个发布端点每分钟 6 条、每天 15 条。超出上限的帖子会在其发布状态中失败,报错为 spam_risk_too_many_posts,而非 40100。TikTok 针对该失败的建议是通过 TikTok 手机应用发布该帖子,相关说明见发布限制页面。
如何保持在限额之内?
TikTok 的建议是减少请求数量、增大每次请求的体量,并限制同时运行的请求数。在 Accounts API 上,即每次请求 /business/video/list/ 时读取最多 20 条帖子的一页,每次请求 /business/comment/list/ 时读取最多 30 条评论的一页,而不是逐条获取;用令牌桶控制调用间隔;或将调用加入队列,由固定数量的工作进程发送,失败的任务会在延迟后返回队列。
提高应用层级能否阻止 40100?
只有在触发的是应用限额时才有效。每个应用都从 Basic 开始,TikTok 会逐级提升,依次为 Advanced、Premium 和 Ultimate,需在 My Apps、App Detail、Authorization 页面下提交附有理由的申请。TikTok 的 Accounts API 指南将每个账户、每个端点每分钟 40 次的限额列为单一数值,与应用层级无关,因此,对于一个繁忙的账户,只需拉开其调用间隔即可解决。
常见错误
- 立即重试。在暂停解除之前,该端点仍处于限流状态,因此快速重试只会消耗调用次数,却无法成功。
- 逐条获取帖子或评论。一次列表调用最多返回 20 条帖子或 30 条评论的一页,且每次调用都计入每分钟 40 次的限额。
- 以紧密循环方式轮询发布状态。每次检查都是对 /business/publish/status/ 的一次调用,而帖子 ID 最长可能需要三分钟才会出现,因此应拉开检查间隔。
- 将 spam_risk_too_many_posts 当作频率限制。它统计的是过去 24 小时内通过 API 创建的帖子数,而非每分钟的调用次数,因此放慢调用速度并不能解决该问题。
其工具每页读取 30 条评论,每次最多读取 20 条帖子;publish_tiktok_post 会事先告知 AI,TikTok 对 API 发布的上限约为每个账户每天 15 条帖子。每个连接每月 US$ 9 至 US$ 0.75,连接越多单价越低,前 3 天免费试用。
常见问题
调用受到频率限制时,TikTok 会返回 HTTP 429 吗?
TikTok 的指南将受限的调用描述为 HTTP 200 响应正文中的代码 40100,未提及 429 状态码,因此请检查每个响应中的 code 字段。
TikTok 40100 限流会持续多久?
TikTok 称,触发每分钟限额后应等待 5 分钟。每日限额在 00:00:00 UTC 重置,届时解除。
easyCoexistence 会重试返回 40100 的调用吗?
不会自动重试。受限的工具调用会将代码 40100 和 TikTok 的消息返回给您的 AI;队列中受限的帖子会以该消息失败,并在“需要注意”下等待,直到您选择“重试”。
40100 与 40016 有何不同?
TikTok 附录对两者的描述相同,都是开发者应用层面的请求过于频繁,解决方法也相同:查阅频率限制指南。40133 对应广告主层级。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间