登录开始免费试用
easyCoexistence 官方 API

通过 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 为您自己的代码提供用于读取账户允许设置的令牌。

3 levels

公开账户照片帖子的隐私选项:PUBLIC_TO_EVERYONE、MUTUAL_FOLLOW_FRIENDS 和 SELF_ONLY。

FOLLOWER_OF_CREATOR

私密账户在 PUBLIC_TO_EVERYONE 位置获得的隐私级别:仅其粉丝可见。

false

disable_comment、disable_duet 和 disable_stitch 的默认值,因此除非另行设置,评论、Duet 和 Stitch 均保持开启。

1080 x 1920

视频自定义封面图片:至少 360 x 360 像素,最大 20 MB。

Paid partnership

is_branded_content 所添加的标签;当 is_brand_organic 同时为 true 时,以它为准。

privacy_level

照片帖子 post_info 中的必填字段,取值仅限于 GET /business/video/settings/ 为该账户返回的选项。

每个发布端点接受哪些设置?

/business/video/publish/ 与 /business/photo/publish/ 有部分设置相同,也有部分不同。大多数设置位于 post_info 内,而 custom_thumbnail_url 与 photo_cover_index 位于请求体的顶层。下表按 TikTok 参考文档的列出方式并列展示;端点未记录某项设置时,显示为 No field:

Video postPhoto post
Who sees itNo privacy field: the endpoint publishes public video postsprivacy_level, required
Commentsdisable_commentdisable_comment
Duet and Stitchdisable_duet, disable_stitchNo field
Covercustom_thumbnail_url or thumbnail_offsetphoto_cover_index
Brand labelsis_brand_organic, is_branded_contentis_brand_organic, is_branded_content
AI labelis_ai_generatedNo field
Musicmusic_sound_info, video_original_sound_volumeauto_add_music, music_sound_info
Locationlocation_id with location_namelocation_id with location_name
Draftupload_to_draftis_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:账户可发布的最长视频时长;超出则发布失败。
Read an account's post settings
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 已验证的媒体路由转发您的链接的调用。

Reading the settings from your own code
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。
使用 EasyCoexistence 完成这些操作

每个连接每月 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 监控

验证时间