透過 API 把影片傳送到 TikTok 創作者的草稿
TikTok 的 API 會透過上傳流程,把影片傳送到創作者的草稿:Content Posting API 的 /v2/post/publish/inbox/video/init/ 會在 video.upload 權限範圍下上傳影片,TikTok 隨後向創作者的收件箱發出通知,讓對方在 TikTok 應用程式內編輯並發佈。API for Business 也能達到相同效果:在 /business/video/publish/ 使用 upload_to_draft,或在相片貼文使用 is_draft。
easyCoexistence 可透過 publish_tiktok_post,從 Claude、ChatGPT 或你自己的平台發佈 TikTok 影片及相片貼文,可即時發佈,也可排程至 90 天後的指定日期和時間;每則排隊中的貼文都會顯示在 Posts 畫面,直至發出。
TikTok 定義的權限範圍:把內容以草稿形式分享到創作者帳戶,供其在 TikTok 內進一步編輯和發佈。
Content Posting API 在任何 24 小時期間內允許的待處理分享數量上限,此限制由 TikTok 設定,以減少濫發內容。
/business/publish/status/ 會回報草稿已上傳,且 TikTok 已通知創作者的收件箱。
每個使用者存取權杖可傳送至 Content Posting API 上傳端點的請求數量。
當 /business/video/publish/ 的 upload_to_draft 設為 true 時,post_info 其他欄位的處理方式。
草稿與直接發佈有何不同?
分別在於由誰按下發佈。直接發佈在 TikTok 處理完成後即時上線;草稿則會進入創作者的 TikTok 收件箱,只有創作者開啟、按自己的喜好編輯並發佈後才會上線。這個差別貫穿 TikTok 的兩種發佈 API:
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
Content Posting API 如何上傳草稿?
向 https://open.tiktokapis.com/v2/post/publish/inbox/video/init/ 發送 POST 請求,並附上持有 video.upload 的使用者存取權杖及 source_info 物件。PULL_FROM_URL 由 TikTok 從應用程式已驗證的網域或 URL 前綴擷取影片;FILE_UPLOAD 則會返回 upload_url,之後以 PUT 請求分段傳送檔案。返回的 publish_id 用於 /v2/post/publish/status/fetch/。相片則使用 /v2/post/publish/content/init/,並將 post_mode 設為 MEDIA_UPLOAD。TikTok 要求應用程式告知使用者開啟收件箱通知,以便在 TikTok 內繼續編輯:
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/Content Posting API 草稿有哪些限制?
TikTok 在上傳參考文件中列明以下限制,各項在適用時由初始化呼叫返回:
- 待處理草稿:任何 24 小時內最多 5 次待處理分享;超過時返回 HTTP 403 及
spam_risk_too_many_pending_share。 - 請求:每個使用者存取權杖每分鐘 6 次,超過時返回 HTTP 429 及
rate_limit_exceeded。 - 權限範圍:缺少 video.upload 的權杖會返回 HTTP 401 及
scope_not_authorized。 - 媒體:從應用程式未驗證的網域或前綴使用
PULL_FROM_URL,會返回 HTTP 403 及url_ownership_unverified。
API for Business 如何上傳草稿?
透過其發佈端點,並在 post_info 加入一個額外欄位。在 /business/video/publish/ 上,把 upload_to_draft 設為 true 會以草稿形式傳送影片,TikTok 會忽略 post_info 的其他欄位;在 /business/photo/publish/ 上,is_draft 只會保留標題和說明文字。兩者都需要帳戶的權杖具備 video.upload,可透過 /tt_user/token_info/get/ 查看;若缺少,擁有人需重新授權應用程式以批准草稿上傳。媒體仍須位於已驗證的網址,狀態會顯示 SEND_TO_USER_INBOX,創作者透過收件箱通知找到草稿:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'創作者會如何處理草稿?
在 TikTok 內完成。收件箱通知會在 TikTok 的編輯器中開啟已上傳的影片或相片,創作者可在其中檢視、編輯並發佈。在 Content Posting API 上,待創作者從草稿發佈後,狀態會由 SEND_TO_USER_INBOX 變為 PUBLISH_COMPLETE;TikTok 指出,一份草稿可產生多於一個貼文。
easyCoexistence 會傳送草稿嗎?
不會:publish_tiktok_post 會直接發佈。它呼叫 /business/video/publish/ 或 /business/photo/publish/ 時不附 upload_to_draft 或 is_draft,因此貼文在 TikTok 處理完成後即時上線。若要讓貼文暫緩以便審閱,可用 scheduled_at 排程,時間可設為 1 分鐘至 90 天後:貼文會在 Posts 畫面的「即將發佈」下等候,update_scheduled_post 可更改其時間、說明文字或相片貼文的標題,cancel_scheduled_post 則會在發出前停止排程。
常見錯誤
- 索取 video.publish 權限來傳送草稿。草稿需要 video.upload,即 TikTok 描述為把內容以草稿形式分享的權限範圍。
- 在 API for Business 上為影片草稿設定說明文字。當 upload_to_draft 為 true 時,TikTok 會忽略 post_info 的其餘欄位。
- 上傳草稿的速度超過創作者發佈的速度。Content Posting API 在 24 小時內最多 5 次待處理分享,超過會返回 spam_risk_too_many_pending_share。
- 沒有告知使用者如何找到收件箱。TikTok 要求應用程式告訴他們開啟收件箱通知,以完成貼文。
每個連接每月 US$ 9 至 US$ 0.75,連接越多,每個連接的費用越低,前 3 天免費試用。
常見問題
TikTok API 可以把影片儲存為草稿嗎?
可以。上傳流程會把影片放入創作者的 TikTok 收件箱,由創作者編輯並發佈;權杖需要 video.upload 權限範圍。
透過 API 傳送的草稿會出現在哪裡?
在 TikTok 應用程式中,位於收件箱通知之後;通知會在 TikTok 編輯器中開啟影片,供創作者完成。
TikTok 草稿能保留我的說明文字嗎?
在 API for Business 上,相片草稿會保留標題和說明文字,影片草稿則會捨棄 post_info 的其他欄位。
一份 TikTok 草稿能變成多於一個貼文嗎?
可以。TikTok 指出一份草稿可產生多於一個貼文;在 Content Posting API 上,待創作者從草稿發佈後,狀態會變為 PUBLISH_COMPLETE。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期