影片指南

將影片發布至 YouTube、Instagram、Facebook 與 Threads

上傳影片一次，然後為每個目標準備貼文。本指南涵蓋媒體檢查、平台選項、YouTube 隱私及檢查貼文是否上線。發布契約審核於 2026 年十月 20 日。

閱讀 Markdown

由 SosoAPI 團隊檢閱 · 2026-10-20

1. 準備一個就緒的影片素材

將本機影片上傳或將公開影片 URL 匯入工作空間。持續檢查該上傳或匯入，直到就緒，再在貼文中使用已登記的 asset_id 和標準 asset_url。

在平台有要求時，SosoAPI 會檢查影片的實際容器、長度、尺寸和編解碼器。檔名、呼叫端提供的 MIME 類型或可播放的預覽，都不足以證明符合資格。排程前，請檢查您對影片和音頻的使用權，以及所有必要的揭露要求。

將原始影片和封面素材保留在同一個已授權工作空間中。
檢查確切帳號和預期格式的完整草稿資格。
如果準備失敗，檢查現有狀態；不要僅因回應緩慢就重複啟動匯入。

2. 選擇目標的影片格式

選擇目標帳號支援的格式和選項。可重複使用已就緒素材，但每個平台都需要自己的 provider_payload。

影片發布選項
目標	provider_payload 選項	排程前審核
Instagram	platform：instagram；隨選使用 VIDEO、REELS 或 STORY_VIDEO。	專業帳號及已觀測到的能力；限時動態需要 Business 資格。Reels 專用選項必須僅用於 Reels。
Facebook Page	platform: facebook；依情況選用 VIDEO、REELS 或 STORY_VIDEO。	粉絲專頁身分、發布權限與 CREATE_CONTENT 任務；支援的媒體及格式選項。
Threads	platform：threads；VIDEO。	符合資格的發布帳號與已就緒影片；純文字附件不適用於 VIDEO 承載內容。
YouTube 頻道	platform: youtube；VIDEO。	明確的標題、類別、隱私和取消模式；原生排程需要管理權限。

3. 排程已審核的 YouTube 影片

使用 API 參考中的伺服器輔助函數。將 asset_id 替換為已登記的正整數，asset_url 替換為其標準 URL。選擇頻道的實際帳號 ID 和未來發布時間。

此範例請求在所選時間公開發布。執行前，請向使用者確認此可見性設定。將 contains_synthetic_media 設定為符合實際影片的值；false 僅為範例。UNSCHEDULE_KEEP_PRIVATE 要求 YouTube 在取消未發布的原生排程後仍將其保持為私享。

await sosoPost("/studio-api/scheduled-posts/create", {
  "workspace_id": "<workspace-uuid>",
  "social_account_id": "<youtube-channel-account-uuid>",
  "caption": null,
  "hashtags": [],
  "media": [
    {
      "kind": "video",
      "asset_id": "<ready-video-asset-id>",
      "url": "<canonical-video-asset-url>"
    }
  ],
  "provider_payload": {
    "platform": "youtube",
    "publish_options": {
      "post_type": "VIDEO",
      "title": "A reviewed product walkthrough",
      "description": "Our team introduces the product in one short walkthrough.",
      "category_id": "24",
      "privacy_status": "public",
      "cancellation_mode": "UNSCHEDULE_KEEP_PRIVATE",
      "contains_synthetic_media": false
    }
  },
  "scheduled_at": "<future-ISO-8601-instant-with-offset>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<stable-key-for-this-one-video-intent>"
});

發布 API 參考資料

4. 明確隱私設定、Shorts 和平台限制

YouTube 使用 post_type VIDEO。您可以設定 surface_expectation: SHORT，但上傳是否符合 Short 條件仍由 YouTube 決定。僅憑檔名或直式方向不足以證明。

上傳權限與管理原生排程的權限相互獨立。請檢查頻道是否支援縮略圖等選填功能；可用性可能未知。Google 的上傳參考說明了授權和中繼資料要求，而 SosoAPI 也會檢查自身支援的欄位及已連結帳號。

YouTube 及其他平台處理或審核影片可能需要時間，且其配額仍然適用。上傳已接受不代表影片已公開可見。

5. 驗證同一則貼文的最終結果

儲存排程貼文 ID，並檢查傳送進度與最終結果。可取得平台連結時，請開啟檢查。已排程或發布中表示最終結果仍待確認。

即使用戶端中斷連線，已接受排程仍會在伺服器上繼續。變更前，請先讀取同一則貼文。取消時使用目前版本及可用取消操作。刪除已發布影片適用不同規則。

跨平台重複使用影片時，請檢查各目標的要求。這些範例展示請求格式；本頁不會執行或發布影片。