Ayrshare 透過 TikTok API 為個人或商業 TikTok 帳號提供 TikTok 影片直接發布、留言管理與進階分析取得等功能。TikTok 會以非同步方式處理影片與圖片,因此不論是立即發布或排程發布,JSON 回應的 status 都會是 “pending”。TikTok 處理完成後,會呼叫你註冊的 Scheduled Action webhook。
TikTok 影片貼文
直接發布的基本 TikTok 影片貼文 JSON 範例:TikTok Video Post
TikTok Video Post Response
- TikTok 目前不支援貼文文字中的換行。所包含的換行會被忽略。
- 每則貼文可發布一部影片或最多 35 張圖片。TikTok 不支援 影片與圖片混合發布。詳情請參閱下方說明。
- 如果影片的副檔名不是常見的影片格式,請使用 isVideo。
- TikTok 也支援發送不含貼文文字的媒體。如果你不想包含貼文文字,
請傳送空字串
post: ""。 - 更多資訊請參閱 TikTok 媒體指南 與 TikTok 授權。
TikTok 影片需求
- 請參閱 TikTok 影片需求。
- 影片必須以已知的影片副檔名(例如 mp4)結尾。你可以對該 URL 設置反向代理、 使用 CDN 建立 vanity URL,或使用 /media 端點。
- TikTok 貼文文字的字元上限為 2,200。
TikTok 將 API 影片發布限制為每分鐘 6 部影片,且每日上限為 15 部影片。
TikTok 圖片貼文
直接發布的基本 TikTok 圖片(照片)貼文 JSON 範例:TikTok Image Post
TikTok Image Post Response
- TikTok 目前不支援貼文文字中的換行。所包含的換行會被忽略。
- 每則貼文可發布一部影片或最多 35 張圖片。
- TikTok 不支援影片與圖片混合發布。詳情請參閱下方說明。
- 圖片必須為 JPG、JPEG 或 WEBP 格式。TikTok 不接受 PNG 媒體檔案。
- 你也可以透過
imageCoverIndex選擇其中一張圖片作為封面。預設情況下 會使用第一張圖片。詳情請參閱下方說明。
TikTok 圖片需求
- 請參閱 TikTok 圖片需求。
- 單則貼文最多可包含 35 張圖片,每張最大 20 MB。
- 圖片必須為 JPG、JPEG 或 WEBP 格式。TikTok 不接受 PNG 媒體檔案。
- TikTok 貼文文字的字元上限為 2,200。
TikTok 將 API 圖片發布限制為每分鐘 6 張照片,且每日上限為 15 張照片。
TikTok 處理
TikTok 以非同步方式處理影片與圖片,因此回應中的id 欄位會被設為 "pending"。
TikTok 處理完成(通常在 1 - 2 分鐘內)後,id 欄位會被更新為 TikTok 影片 id,並會新增 postUrl。
- 你可以使用 webhooks 或 /history 端點取得 TikTok 貼文的最終狀態,通常需要 1-2 分鐘才會可用。
- 當使用者在 TikTok 行動 App 中發布影片時,會發送一個 “scheduled” webhook,
其
subAction: "tikTokPublished"。 - TikTok 貼文的 首則留言 會延後發布:
留言會在
tikTokPublishedwebhook 解析出真正的影片id後才自動發布, 而非在發布時發布。影片的visibility必須為public,否則首則留言無法發布,並會回傳 留言錯誤。 - 如果發生錯誤(例如 TikTok 無法處理該影片,或 Ayrshare 內部檢查失敗),
id欄位會被設為 “failed”,errors欄位則會包含錯誤 細節。 idShare用於內部參照該待處理的影片。
TikTok 選項
在發布 TikTok 影片或圖片時,還有 其他可用選項。 影片發布範例:TikTok Video Publishing
TikTok Image Publishing
選項
以下選項適用於 TikTok 貼文。 請將這些選項加到tikTokOptions 物件中。
各選項的詳細說明請參閱下方。
TikTok Options
是否自動為貼文加入推薦音樂。
若將此欄位設為
true,你之後可以在 TikTok App 中變更音樂。適用媒體類型:image是否停用已發布貼文的留言功能。適用媒體類型:video、image
停用已發布影片的合拍(duet)功能。適用媒體類型:video
停用已發布影片的搶鏡(stitch)功能。適用媒體類型:video
是否為影片貼文啟用 AI 生成內容標示。若啟用此標示,你的影片一旦發布後就會被標為「Creator labeled as AI-generated」且無法變更。
「Creator labeled as AI-generated」標示表示該內容完全由 AI 生成或經 AI 大幅編輯。適用媒體類型:video
只要不違反 TikTok 的 社群
規範,開啟 AI 生成內容設定不會影響
影片的散布。
是否啟用 Branded Content 標示。若此欄位設為
true,該影片會被標為 Branded Content,表示你與某品牌有付費合作關係,影片上會加上「Paid partnership」標示。適用媒體類型:video、image是否啟用 Brand Organic Content 標示。若此欄位設為
true,該影片會被標為 Brand Organic Content,表示你正在推廣自己或自身的商業,影片上會加上「Promotional content」標示。適用媒體類型:video、imagemediaUrls 中要用作貼文封面的索引。適用媒體類型:image貼文標題。適用媒體類型:image
可見性選項
| 可見性 | 說明 |
|---|---|
| public | 所有 TikTok 使用者皆可見。 |
| private | 私人,只有帳號本身可見。 |
| followers | 只有帳號的追蹤者可見。 |
| friends | 只有互相追蹤的使用者可見。 |
pending 狀態,且在貼文轉為公開之前不會發送 TikTok webhook。
影片縮圖
為 TikTok 影片設定縮圖(也稱為封面圖片)有兩種方式:- 使用
thumbNailOffset參數設定縮圖影格。 - 使用
thumbNail參數以 URL 設定縮圖圖片。
縮圖 Offset
透過選擇 offset 影格為 TikTok 影片設定縮圖。TikTok Video Thumbnail Offset
0,即影片的第一格。
縮圖 URL
透過從 URL 上傳圖片為 TikTok 影片設定縮圖。TikTok Video Thumbnail URL
thumbNail 參數,thumbNailOffset 參數會被忽略。
更多資訊請參閱 TikTok 縮圖需求。
TikTok 提及
在貼文文字中加入@handle 即可提及其他 TikTok 使用者。例如:
TikTok Mention
TikTok 草稿貼文
為 TikTok 影片或圖片建立草稿貼文,讓你可以在發布前先編輯影片或圖片。TikTok Video Draft Post
postUrl 會維持在 pending 狀態。草稿貼文不支援首則留言。

授權重新整理
TikTok 必須「每年」透過 Social Accounts 頁面重新授權一次。- 授權到期前 15 天,會發送電子郵件與 webhook social action 通知。
- 你可以從 /user 端點取得授權到期日與 剩餘天數。
