跨平台發布影片
一次上傳影片,為每個平台撰寫專屬說明,並為每個平台選擇正確的格式。
步驟
- 取得影片。 使用者提供一個公開的 MP4 檔案連結。使用
upload_media_from_url並提供url來上傳。影片會背景匯入:持續呼叫get_media並傳入回傳的media_id,直到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)、說明與時間。請使用者確認。
- 建立貼文。 呼叫
create_post,並傳入content、account_ids、media_ids: [<media_id>]、platform_content與draft: true,除非使用者已明確指示要立即發布或已指定此貼文的發布時間。 - 發布或排程。 使用者確認後,呼叫
schedule_post並傳入post_id與scheduled_for(包含timezone)或publish_now: true。 - 檢查結果。 影片在各平台上需要幾分鐘處理。短暫等待後呼叫
get_post_results,回報哪些平台已成功發布(附上連結),並用白話說明任何失敗原因(請參閱fix-failed-posts)。
良好預設值
- 直式影片(9:16)適合 TikTok、Reels 與 Shorts。若是橫式影片,請在選擇短格式之前先檢查
get_platform_rules。 - 每則貼文僅限一部影片。若要發布兩部影片,請建立兩則貼文。