透過 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 則會向你自己的程式提供權杖,以讀取帳戶允許的設定。
公開帳戶相片貼文的私隱選項: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 |
帳戶允許哪些設定?
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:帳戶可發布的最長影片;超過此長度則會失敗。
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 已驗證的媒體路徑轉送你的連結。
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 以草稿形式送至創作者的收件匣。
如何透過 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 監察
驗證日期