TikTok 相片帖文與輪播(透過 API):最多 35 張圖片
TikTok 商業 API 發布的相片帖文可包含 1 至 35 張圖片,每張須為 JPG、JPEG 或 WebP 檔案,大小不超過 20 MB,任一方向都不得超過 1080 by 1920 像素。TikTok 會從已驗證的網址下載圖片。帖文可附標題(最多 90 個 UTF-16 碼位)、說明文字、隱私級別及封面圖片。
easyCoexistence 可透過 Claude、ChatGPT 或你自己的程式碼,以 publish_tiktok_post 發布 TikTok 相片帖文:傳送 1 至 35 個圖片連結、標題及說明文字,然後以 get_tiktok_publish_status 跟進帖文狀態。
單一相片帖文經 TikTok 相片發布端點可容納的最多圖片數量。
相片帖文中每張圖片的最大檔案大小,格式必須為 JPG、JPEG 或 WebP。
相片帖文圖片的最高解析度(以像素計),橫向圖片則為 1920 x 1080。
相片帖文標題可容納的 UTF-16 碼位數目;說明文字最多可達 4,000。
相片帖文包含哪些內容?
一次呼叫 POST /business/photo/publish/ 會同時傳送圖片及帖文詳情:
photo_images:最多 35 個圖片網址,須位於已驗證的網域或網址前綴下。photo_cover_index:用作封面的圖片,從 0 起計,預設值為 0。post_info.title:最多 90 個 UTF-16 碼位。post_info.caption:最多 4,000 個 UTF-16 碼位,可含 #話題標籤,以及最多 30 個 @提及。post_info.privacy_level:誰可以看到帖文,須為該帳戶設定所允許的選項之一。post_info.disable_comment:關閉帖文的留言功能。
哪些圖片檔案可用?
JPG、JPEG 或 WebP,每個最大 20 MB,尺寸不超過 1080 by 1920 像素,橫向圖片則為 1920 by 1080。TikTok 只會在下載檔案後才檢查格式,因此不支援的格式會稍後以 file_format_check_failed 失敗。publish_tiktok_post 會在發送任何內容之前,拒絕網址以 .png、.gif、.bmp、.heic、.avif 或 .svg 結尾的圖片。
標題與說明文字有何分別?
兩者是獨立的欄位,各有不同上限。標題最多 90 個 UTF-16 碼位。說明文字即帖文的描述,最多 4,000,可含 #話題標籤,以及互相追蹤的用戶之 @提及,最多 30 個。兩者均以 UTF-16 碼位計算,因此一個表情符號可佔兩個或以上。publish_tiktok_post 會將兩者分別作為 title 及 caption 接收。
誰可以看到帖文,以及人們可否留言?
privacy_level 決定誰可以看到帖文,可選 PUBLIC_TO_EVERYONE、MUTUAL_FOLLOW_FRIENDS、FOLLOWER_OF_CREATOR 或 SELF_ONLY,但須符合 GET /business/video/settings/ 為該帳戶回傳的選項。TikTok 只為公開帳戶列出 PUBLIC_TO_EVERYONE,而這也是 publish_tiktok_post 所設定的級別。除非 disable_comment 為 true,否則留言功能保持開啟;不接受任何人留言的帳戶,則只接受 true。
呼叫之後會發生什麼事?
TikTok 會回傳 share_id,並在背景下載圖片。get_tiktok_publish_status 接受該 share_id,並回報:TikTok 下載圖片時為 PROCESSING_DOWNLOAD;帖文通過審核後為 PUBLISH_COMPLETE;失敗時為 FAILED,並附原因,例如 photo_pull_failed。TikTok 透過此端點限制每個帳戶的相片帖文,每分鐘最多 6 則,每日最多 15 則。
常見錯誤
- 傳送 PNG 圖片。TikTok 相片帖文只接受 JPG、JPEG 或 WebP,因此發布前須先轉換檔案。
- 按肉眼所見的字符計算標題長度。TikTok 以 UTF-16 碼位計算,含表情符號的標題會更快達到 90。
- 使用超過 1080 by 1920 像素的圖片。這是 TikTok 相片帖文的最大解析度,因此須先縮小較大的圖片。
- 將封面放在第一張以外的位置。publish_tiktok_post 會以第一張圖片作為封面。
相片帖文亦可按你設定的日期及時間發出,並由其專屬佇列處理。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。
常見問題
一個 TikTok 帖文透過 API 最多可有多少張相片?
最多 35 張,每張須為不超過 20 MB 的 JPG、JPEG 或 WebP 檔案。
TikTok 相片帖文可以使用 PNG 圖片嗎?
不可以。相片端點只接受 JPG、JPEG 及 WebP,TikTok 在下載 PNG 後才會令其失敗,並回傳 file_format_check_failed。
相片帖文的標題可以有多長?
最多 90 個 UTF-16 碼位。說明文字為獨立欄位,最多可達 4,000。
哪張圖片會成為封面?
由 photo_cover_index 指定的圖片,從 0 起計。publish_tiktok_post 會保留預設值 0,因此第一張圖片即為封面。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期