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

標準 URL： https://sosoapi.ai/zh-tw/docs/video-publishing

上傳影片一次，然後為每個目標準備貼文。本指南涵蓋媒體檢查、平台選項、YouTube 隱私及檢查貼文是否上線。發布契約審核於 2026 年十月 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。 | Page 身分、發布權限和 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 參考資料](https://sosoapi.ai/zh-tw/docs/publishing-api-reference)

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

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

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

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

- [Google：YouTube videos.insert 參考資料](https://developers.google.com/youtube/data/reference/rest/v3/videos/insert)

- [帳號與格式能力對照表](https://sosoapi.ai/zh-tw/docs/publishing-capabilities)

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

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

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

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

- [自有代理程式審核流程](https://sosoapi.ai/zh-tw/docs/claude-code-codex-social-publishing)

- [發布 API 參考資料](https://sosoapi.ai/zh-tw/docs/publishing-api-reference)