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

透過 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 畫面,直至發出。

video.upload

TikTok 定義的權限範圍:把內容以草稿形式分享到創作者帳戶,供其在 TikTok 內進一步編輯和發佈。

5 pending

Content Posting API 在任何 24 小時期間內允許的待處理分享數量上限,此限制由 TikTok 設定,以減少濫發內容。

SEND_TO_USER_INBOX

/business/publish/status/ 會回報草稿已上傳,且 TikTok 已通知創作者的收件箱。

6 a minute

每個使用者存取權杖可傳送至 Content Posting API 上傳端點的請求數量。

Ignored

當 /business/video/publish/ 的 upload_to_draft 設為 true 時,post_info 其他欄位的處理方式。

草稿與直接發佈有何不同?

分別在於由誰按下發佈。直接發佈在 TikTok 處理完成後即時上線;草稿則會進入創作者的 TikTok 收件箱,只有創作者開啟、按自己的喜好編輯並發佈後才會上線。這個差別貫穿 TikTok 的兩種發佈 API:

Draft (upload)Direct post
Who postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent 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 內繼續編輯:

Upload a video to the creator's inbox from a URL
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,創作者透過收件箱通知找到草稿:

Send a video to the creator's drafts on the API for Business
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 要求應用程式告訴他們開啟收件箱通知,以完成貼文。
使用 EasyCoexistence 完成這項設定

每個連接每月 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 監察

驗證日期