Ayrshare 提供 直接发布 TikTok 视频、评论管理,以及使用 TikTok API 检索个人或商业 TikTok 账户的高级分析。TikTok 异步处理视频和照片,因此对于立即和已安排的帖子,JSON 响应都将为 status: “pending”。TikTok 完成处理后,你已注册的 Scheduled Action webhook 将被调用。
TikTok 视频帖子
直接发布的基本 TikTok 视频帖子的 JSON:TikTok Video Post
TikTok Video Post Response
- TikTok 目前不支持帖子文本中的换行。包含的换行将被 忽略。
- 可以发布一个视频或最多 35 张图片。TikTok 不支持 视频和图片组合。详情请见下方。
- 如果视频不以已知的扩展名结尾,请使用 isVideo。
- TikTok 还支持发送无帖子文本的媒体。如果你不希望包含帖子文本,
请发送空字符串
post: ""。 - 更多信息请参见 TikTok 媒体指南 和 TikTok 授权。
TikTok 视频要求
- 请参见 TikTok 视频要求。
- 视频必须以已知的视频扩展名(如 mp4)结尾。请对 URL 进行反向代理, 使用 CDN 添加虚荣 URL, 或使用 /media 端点。
- TikTok 的帖子文本字符限制为 2,200。
TikTok 限制 API 视频发布为每分钟 6 个视频,每天上限为 15 个视频。
TikTok 图片帖子
直接发布的基本 TikTok 图片(照片)帖子的 JSON:TikTok Image Post
TikTok Image Post Response
- TikTok 目前不支持帖子文本中的换行。包含的换行将被 忽略。
- 可以发布一个视频或最多 35 张图片。
- TikTok 不支持视频和图片的组合。详情请见下方。
- 图片必须为 JPG、JPEG 或 WEBP 类型。TikTok 不接受 PNG 媒体文件。
- 你还可以使用
imageCoverIndex选择其中一张图片作为封面照片。默认情况下, 使用第一张图片。详情请见下方。
TikTok 图片要求
- 请参见 TikTok 图片要求。
- 一个帖子最多可以包含 35 张图片,每张图片 20 MB。
- 图片必须为 JPG、JPEG 或 WEBP 类型。TikTok 不接受 PNG 媒体文件。
- TikTok 的帖子文本字符限制为 2,200。
TikTok 限制 API 视频发布为每分钟 6 张照片,每天上限为 15 张
照片。
TikTok 处理
TikTok 对视频和图片进行异步处理,因此响应将会有id 字段设置为 "pending"。
在 TikTok 完成处理后(通常在 1-2 分钟内),id 字段将被更新为 TikTok 视频的 id,并添加 postUrl。
- 你可以使用 webhook 或 /history 端点检索 TikTok 帖子的最终状态,通常需要 1-2 分钟才可用。
- 当用户在 TikTok 移动应用中发布视频时,将发送一个 “scheduled” webhook,
携带
subAction: "tikTokPublished"。 - TikTok 帖子上的 首个评论 被延迟:它在
tikTokPublishedwebhook 解析真实视频id时自动发布,而不是在发布 时间发布。视频visibility必须为public,否则无法发布首个评论,并返回 评论错误。 - 如果发生错误,例如 TikTok 无法处理视频或 Ayrshare 内部测试
失败,
id字段将设置为 “failed”,errors字段将包含错误 详情。 idShare用于内部引用待处理的视频。
TikTok 选项
发布 TikTok 视频或图片时,可以使用附加选项。 视频发布示例:TikTok Video Publishing
TikTok Image Publishing
选项
TikTok 帖子可用以下选项。 它们应添加到tikTokOptions 对象中。
每个选项的详情请见下方。
TikTok Options
是否自动向帖子添加推荐音乐。
如果将此字段设为
true,你可以稍后在 TikTok 应用中更改音乐。媒体类型:image是否禁用已发布帖子的评论。媒体类型:video, image
禁用已发布视频的合拍。媒体类型:video
禁用已发布视频的拼接。媒体类型:video
是否为视频帖子启用 AI 生成的内容开关。如果启用该开关,你的视频将在发布后被标记为 “Creator labeled as AI-generated”,且无法更改。
“Creator labeled as AI-generated” 标签表示内容完全由 AI 生成或经过 AI 大幅编辑。媒体类型:video
只要你的视频不违反 TikTok 的 社区
准则,开启 AI 生成内容设置不会影响视频的分发
。
是否启用 品牌内容 开关。如果将此字段设为
true,视频将被标记为品牌内容,表明你与品牌有付费合作。视频上会附加 “Paid partnership” 标签。媒体类型:video, image是否启用品牌自然内容开关。如果将此字段设为
true,视频将被标记为品牌自然内容,表明你在推广自己或你的企业。视频上会附加 “Promotional content” 标签。媒体类型:video, image用作帖子封面的
mediaUrls 索引。媒体类型:image帖子的标题。媒体类型:image
可见性选项
| 可见性 | 描述 |
|---|---|
| public | 对所有 TikTok 用户可见。 |
| private | 私有,仅账户本身可见。 |
| followers | 仅账户的关注者可见。 |
| friends | 仅相互关注者可见。 |
pending 状态,在帖子公开之前不会发送 TikTok webhook。
视频缩略图
有两种方式为 TikTok 视频设置缩略图(也称为封面照片):- 使用
thumbNailOffset参数设置缩略图帧。 - 使用
thumbNail参数从 URL 设置缩略图图片。
缩略图偏移量
通过选择偏移帧为 TikTok 视频设置缩略图。TikTok Video Thumbnail Offset
0,即视频的第一帧。
缩略图 URL
通过从 URL 上传图片为 TikTok 视频设置缩略图。TikTok Video Thumbnail URL
thumbNail 参数,thumbNailOffset 参数将被忽略。
更多信息请参见 TikTok 缩略图要求。
TikTok 提及
通过在帖子文本中添加@handle 来提及其他 TikTok 用户。例如:
TikTok Mention
TikTok 草稿帖子
为 TikTok 视频或图片创建草稿帖子,允许你在发布前编辑视频或图片。TikTok Video Draft Post
postUrl 将保持在 pending 状态,直到视频发布。草稿帖子不支持首个评论。

授权刷新
TikTok 必须_每年_通过 Social Accounts 页面重新授权。- 在授权到期前 15 天,将发送电子邮件和 webhook 社交操作通知。
- 可以从 /user 端点检索所需的刷新日期和剩余天数。
