通过 API 设置 TikTok 发布选项:隐私、评论、Duet 与 Stitch
TikTok 的 API for Business 在发布调用中接收帖子设置,大多位于 post_info 内。视频接受 disable_comment、disable_duet 和 disable_stitch,封面可通过 thumbnail_offset 或 custom_thumbnail_url 指定,并可设置 is_brand_organic、is_branded_content 标签和 is_ai_generated。照片帖子接受 privacy_level、disable_comment、相同的品牌标签以及 auto_add_music。GET /business/video/settings/ 返回每个账户允许的取值。
easyCoexistence 可从 Claude、ChatGPT 或您自己的代码中,通过 publish_tiktok_post 发布 TikTok 视频和照片帖子,设置文案、照片帖子的标题以及是否开启评论;并通过 get_social_credentials 为您自己的代码提供用于读取账户允许设置的令牌。
公开账户照片帖子的隐私选项:PUBLIC_TO_EVERYONE、MUTUAL_FOLLOW_FRIENDS 和 SELF_ONLY。
私密账户在 PUBLIC_TO_EVERYONE 位置获得的隐私级别:仅其粉丝可见。
disable_comment、disable_duet 和 disable_stitch 的默认值,因此除非另行设置,评论、Duet 和 Stitch 均保持开启。
视频自定义封面图片:至少 360 x 360 像素,最大 20 MB。
is_branded_content 所添加的标签;当 is_brand_organic 同时为 true 时,以它为准。
照片帖子 post_info 中的必填字段,取值仅限于 GET /business/video/settings/ 为该账户返回的选项。
每个发布端点接受哪些设置?
/business/video/publish/ 与 /business/photo/publish/ 有部分设置相同,也有部分不同。大多数设置位于 post_info 内,而 custom_thumbnail_url 与 photo_cover_index 位于请求体的顶层。下表按 TikTok 参考文档的列出方式并列展示;端点未记录某项设置时,显示为 No field:
| Video post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_draft |
账户允许哪些取值?
使用 business_id 调用 GET /business/video/settings/ 可返回该账户对其帖子的限制。发布前请先读取,因为 TikTok 只接受其列出的取值:
privacy_level_options:公开账户为PUBLIC_TO_EVERYONE、MUTUAL_FOLLOW_FRIENDS和SELF_ONLY;私密账户为FOLLOWER_OF_CREATOR、MUTUAL_FOLLOW_FRIENDS和SELF_ONLY。comment_disabled:账户不接受任何人评论时为 true,此时disable_comment只接受 true。duet_disabled与stitch_disabled:当账户将 Duet 或 Stitch 限制为仅自己可用,或账户为私密时,为 true;对应开关此时只接受 true。max_video_post_duration_sec:账户可发布的最长视频时长;超出则发布失败。
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"comment_disabled": false,
"duet_disabled": false,
"max_video_post_duration_sec": 600,
"privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"stitch_disabled": false
}
}谁能看到帖子?
对于照片帖子,取决于您发送的 privacy_level:PUBLIC_TO_EVERYONE 面向 TikTok 内外的所有人,MUTUAL_FOLLOW_FRIENDS 面向账户回关的粉丝,FOLLOWER_OF_CREATOR 面向私密账户的粉丝,SELF_ONLY 仅自己可见。视频端点没有隐私字段,因为它发布的是公开视频帖子。设为“好友”或“仅自己”的帖子也无法通过其 embed_url 观看。
评论、Duet 与 Stitch 如何运作?
每项都是一个开关,设为 true 时关闭对应功能。disable_comment 同时存在于两个端点;disable_duet 与 disable_stitch 仅存在于视频端点。它们默认均为 false,即保持功能开启,但仍受账户自身隐私设置约束:不接受任何人评论的账户,或将 Duet 或 Stitch 限制为仅自己的账户,只能在将对应开关设为 true 的情况下发布。
如何选择封面?
视频封面有两种方式。post_info.thumbnail_offset 按毫秒时间选取一帧,默认为 0,并向上取整到最接近的帧;超出视频结尾的时间会发送失败 Webhook,视频也不会发布。位于请求体顶层的 custom_thumbnail_url 则改用一张图片,并使 TikTok 忽略偏移量。照片帖子则通过 photo_cover_index 从第 0 张开始选择其中一张图片。
- 自定义封面图片:JPG、JPEG、WebP 或 PNG,最大 20 MB。
- 尺寸:从 360 x 360 像素至 1080 x 1920,或 1920 x 1080 像素。
- 位置:需为应用已验证的域名或 URL 前缀,与视频本身相同。
品牌标签代表什么?
这些是 TikTok 在帖子上显示的披露标识。is_brand_organic 设为 true 时,帖子会被标注为推广内容,适用于推广账户自身业务的帖子。is_branded_content 设为 true 时,帖子会被标注为付费合作,适用于与品牌付费合作发布的帖子;两者同时为 true 时以 is_branded_content 为准。对于带有 is_branded_content 的视频,tto_invite_link 可将帖子关联到账户已加入的 TikTok One Creator Marketplace 活动。
post_info 中还有哪些选项?
还有几项,每项都在接受它的端点上有说明:
is_ai_generated(仅视频):将帖子标注为创作者标注的 AI 生成内容,发布后无法更改。location_id与location_name:通过 GET /business/publish/location/ 查找到的位置标签。music_sound_info:按 ID 指定的商业音效;视频还可设置其音量(0 至 100)以及以毫秒计的开始与结束时间。auto_add_music(仅照片帖子):添加推荐音乐,之后可在 TikTok 应用中更改。upload_to_draft或is_draft:使用 video.upload 权限范围,将帖子连同视频一并发送到创作者收件箱作为草稿。is_ads_only(仅视频):发布一条仅在广告中显示的帖子,不会出现在个人主页上。
publish_tiktok_post 设置哪些选项?
三项来自您的请求:文案、照片帖子的标题,以及 disable_comment。easyCoexistence 将 is_brand_organic 与 is_branded_content 设为 false,以第一张图片作为封面、以 PUBLIC_TO_EVERYONE 发布照片帖子,并省略视频的其余设置,因此适用 TikTok 默认值:disable_duet 与 disable_stitch 为 false,thumbnail_offset 为 0,is_ai_generated 为 false。
如何发送其他设置?
由您自己的代码调用,使用 get_social_credentials 返回的账户令牌和 business_id,访问 business/ 下的 Business API 路径。GET business/video/settings/ 可读取账户限制。POST business/video/publish/ 或 business/photo/publish/ 可携带完整的已记录请求体,并原样发送至 TikTok,包括媒体 URL,因此这些 URL 必须位于应用已验证的域名或 URL 前缀上;publish_tiktok_post 则是通过 easyCoexistence 已验证的媒体路由转发您的链接的调用。
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>常见错误
- 期望 privacy_level 能用于视频。视频端点只发布公开帖子,其参考文档中没有隐私字段;照片帖子才接受 privacy_level。
- 为不接受评论的账户开启评论。comment_disabled 为 true 时,TikTok 只接受 disable_comment 为 true。
- 将 thumbnail_offset 设为超出视频结尾的时间。TikTok 会发送失败 Webhook,视频也不会发布。
- 为私密账户发送 PUBLIC_TO_EVERYONE。其 privacy_level_options 改为列出 FOLLOWER_OF_CREATOR、MUTUAL_FOLLOW_FRIENDS 和 SELF_ONLY。
每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
能否通过 API 发布私密 TikTok 视频?
视频端点只能发布公开帖子,无法做到。照片帖子可使用 privacy_level,包括 SELF_ONLY;视频也可通过 upload_to_draft 发送到创作者收件箱作为草稿。
如何通过 API 关闭 Duet 和 Stitch?
在 /business/video/publish/ 上将 post_info.disable_duet 和 post_info.disable_stitch 设为 true。如果账户已限制它们,TikTok 只接受 true。
能否通过 TikTok API 添加位置标签?
可以。post_info 接受 location_id 与 location_name,位置标签通过 GET /business/publish/location/ 查找。
is_brand_organic 与 is_branded_content 有何区别?
is_brand_organic 为账户自身业务添加推广内容标签;is_branded_content 添加付费合作标签,两者同时为 true 时以 is_branded_content 为准。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间