跨平台發佈影片
只需上傳一次影片，為每個平台撰寫專屬說明，並選擇適合的格式。
步驟
- 取得影片。 使用者提供一個公開的 MP4 檔案連結。使用
url呼叫upload_media_from_url。影片會在背景匯入：使用回傳的media_id呼叫get_media，直到media_status變成"ready"。如果狀態變成"failed"，則以白話告訴使用者error_message。絕不要附加尚未準備好的影片。如果影片已在媒體庫中，使用list_media與type: "video"來尋找。 - 檢查規則。 呼叫
get_platform_rules，並將影片與每個平台的長度、大小與長寬比限制進行比較。get_media會顯示影片的詳細資訊。如果影片違反某個平台的規則，則排除該平台並告知使用者原因。 - 選擇帳號。 呼叫
list_accounts。使用使用者指定的帳號，或所有狀態正常的影片平台帳號。跳過任何無法發文的帳號，並說明原因。 - 為每個平台撰寫說明。 在
content中放入通用說明，並在platform_content中設定各平台專屬內容：- TikTok：
{"tiktok": {"content": "..."}}。簡短、鉤子在前、主題標籤在結尾。 - Instagram Reels：
{"instagram": {"content": "...", "contentType": "Reels"}}。主題標籤在結尾。 - YouTube Shorts：
{"youtube": {"content": "<description>", "contentType": "Short", "settings": {"title": "<title>"}}}。標題最多 100 個字元，YouTube 不允許<或>。在描述的前兩行說明影片內容。對於一般的 YouTube 影片，使用"contentType": "Video"。 - LinkedIn：
{"linkedin": {"content": "..."}}。第一行要能吸引點擊，段落要簡短。 - Facebook Reels：
{"facebook": {"content": "...", "contentType": "Reels"}}。 如果有的話，遵循使用者的品牌語調（請見brand-voice）。不要虛構影片相關事實；如果不確定影片內容，請詢問使用者。
- TikTok：
- 顯示草稿。 為每個平台顯示：格式、標題（YouTube）、說明與時間。請使用者確認。
- 建立貼文。 使用
content、account_ids、media_ids: [<media_id>]、platform_content以及draft: true呼叫create_post，除非使用者已明確表示要立即發佈或已指定此貼文的發佈時間。 - 發佈或排程。 使用者確認後，使用
post_id與scheduled_for（附帶timezone）或publish_now: true呼叫schedule_post。 - 檢查結果。 影片在各平台上需要幾分鐘處理。短暫等待後呼叫
get_post_results，並回報已發佈的平台（附連結）以及任何失敗原因（以白話說明，請見fix-failed-posts）。
好用預設值
- 直式影片（9:16）適合 TikTok、Reels 與 Shorts。對於寬版影片，在選擇短格式之前，請先檢查
get_platform_rules。 - 每次發佈一支影片。若要發佈兩支影片，請建立兩篇貼文。