登入開始免費試用
easyCoexistence 官方 API

透過 API 設定 TikTok 貼文:私隱、留言、Duet 及 Stitch

TikTok 商業 API 在發布呼叫中接受貼文的設定,大部分放在 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 可透過 publish_tiktok_post,由 Claude、ChatGPT 或你自己的程式發布 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

帳戶允許哪些設定?

GET /business/video/settings/ 配合 business_id 會回傳帳戶對其貼文的限制。發布前請先閱讀,因為 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 忽略 offset。相片貼文則以 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 以草稿形式送至創作者的收件匣。

如何透過 TikTok 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 監察

驗證日期