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

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 跟進帖文狀態。

35

單一相片帖文經 TikTok 相片發布端點可容納的最多圖片數量。

20 MB

相片帖文中每張圖片的最大檔案大小,格式必須為 JPG、JPEG 或 WebP。

1080 x 1920

相片帖文圖片的最高解析度(以像素計),橫向圖片則為 1920 x 1080。

90

相片帖文標題可容納的 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 會以第一張圖片作為封面。
使用 EasyCoexistence 完成這項設定

相片帖文亦可按你設定的日期及時間發出,並由其專屬佇列處理。每個連接每月 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 監察

驗證日期