通過閱讀本文，您可以瞭解使用智能生產製作服務時常見的問題及解決方案。
目錄
FAQ
視訊剪輯時如何將成片輸出至VOD中？
在調用介面SubmitMediaProducingJob提交剪輯合成作業時，將參數OutputMediaTarget設定為vod-media，參數OutputMediaConfig中的StorageLocation和FileName欄位分別設定為VOD媒資檔案儲存體地址和檔案名稱。樣本如下所示：
"OutputMediaConfig": {
"StorageLocation": "outin-8e7*******.oss-cn-shanghai.aliyuncs.com",
"FileName": "vod-output.mp4"
}如何擷取合成任務的結果？
在調用介面SubmitMediaProducingJob提交剪輯合成作業後會返回JobId，可以通過調用介面GetMediaProducingJob並傳入JobId查詢剪輯合成作業，根據返回的Status判斷合成任務狀態。
一個合成任務需要花費多長時間？
通常情況下，合成時間與視頻的總時間長度相當，如：一個5min的成片，合成耗時也需要5min。但由於任務都需要必要的排隊、檔案分析、下載，即便再短的成片也需要15s以上完成。基於不同的複雜度，一個15s的短視頻，合成耗時在10s~2min內波動是正常現象，如果一次性提交大量任務（幾萬個），後台會排隊執行，如有提速需求，可提工單支援。
影響合成耗時的因素？
剪輯合成需要逐幀處理，一般成片解析度越大、成片時間長度越長，合成耗時就越長，如果成片中使用了大量特效、轉場，或對素材進行了縮放（如：把4k解析度素材縮放到480p）也會增加合成耗時。有時對時間軸錯誤的使用也會增加合成耗時，如果合成耗時不符合預期，可提工單找技術同學反饋，或加入我們的DingTalk答疑群諮詢：84650000851。
為什麼視頻輸出時間長度與預期不符？
轉場導致成片時間長度縮短：轉場（Transition）是從前一個素材到後一個素材的過渡，過渡過程中前後兩個素材會同時播放，導致後一個素材需要提前開始，故而會縮短成片時間長度。若要維持成片時間長度不變，您可以在對素材進行截取時預留出足夠的轉場時間長度。或者使用DLTransition在轉場過程中補幀，以保持成片時間長度不變。
使用AI_TTS導致整體時間長度延長： 當使用AI_TTS時，輸出的音軌素材片段的長度大於視頻軌的長度，導致輸出時間整體延長。您可以參考素材與素材時間長度自動對齊方案來解決這個問題。
時間軸（timeline）設定不當：沒有設定In和Out，僅設定了TimelineIn和TimelineOut會導致預設按照原始素材的時間長度進行處理，建議設定in = 0，out = timelineOut - timelineIn，化對素材的處理。
為什麼我合成的視頻在xx秒之後會出現黑屏現象？
視頻合成後出現黑屏現象，通常源於您的視頻素材持續時間長度小於軌道長度。例如，當您的視頻素材僅有6秒，而音軌長度是12s，這會導致6s之後都是黑屏。為解決這一問題，您可以設定視頻軌為主軌道來被其他軌道對齊，或者合理規劃其他軌道長度，以確保它們與視頻軌的長度相匹配。
為什麼調用合成任務OpenAPI時提示“TimelineFormatError”？
檢查Timeline格式是否符合定義，同時確保沒有JSON語法錯誤。關於Timeline格式詳情，請參見Timeline配置說明。更多Timeline樣本，請參見視頻/圖片混剪。
添加字幕後，輸出視頻種字幕不顯示、出現亂碼或顯示異常
如果您使用的是小語種（韓語、阿拉伯、蒙古語等），可能會出現由字型渲染引起的問題。您可以嘗試提交任務時使用預設字型（阿里巴巴普惠體），如果問題仍未解決，您可以通過DingTalk搜尋群號84650000851，加入智能媒體服務產品群聯絡我們。
圖文、字幕輸出位置與預期不符
確保輸出畫面尺寸與預覽一致。您可以使用0~1之間的相對位置值來調整效果，以保持一致的表現。
如果同一軌道上的素材在時間和位置上重疊，可能會觸發防碰撞機制，導致位置發生變化。您可以考慮將這些素材拆分放置在不同的軌道上，以更靈活地安排素材位置和時間。
字幕的FontSize與預覽或期望的效果不一致
如果您使用的是Effect Type:Text中的FontSize屬性，那麼該字型大小會根據素材尺寸和成片尺寸進行縮放。您可將FontSize修改為FixedFontSize將使字型大小保持不進行縮放調整。
您可以使用SubtitleTrackClip字幕軌來指定您的字幕內容。如果您指定了字幕字型，在某些字型上，字幕的渲染高度（像素）可能會小於字型大小。您可以通過調整SizeRequestType=Nominal來使字幕的渲染高度（像素值）等於字型大小。
指定預覽尺寸可確保輸出的字型大小與預覽時保持一致。例如，若期望輸出720P的成片，可指定預覽尺寸參數為FECanvas={"Height":720,"Width":1280}。
提交剪輯任務時遇到“Throttling.User”錯誤
智能媒體服務IMS的寫介面通常限制為30QPS。當客戶提交任務的並發量較高時，可能會遭遇限流情況。遇到此類情況時，可以選擇暫停1秒後再繼續提交任務。
以30QPS計算，一分鐘可以提交1800個任務，通常能夠滿足大部分客戶的需求。如果業務需求需要在30 QPS以上持續提交幾十分鐘的任務（例如在營運活動情境中，需要在半小時內合成幾百萬個視頻），可以通過提交工單來申請提高QPS。
索引狀態失敗如何處理？
在媒資管理頁面，選中需要重新分析的媒資後，單擊列表下方的索引分析即可重新發起索引分析任務。
調用合成介面提示許可權不足或 Forbidden.SubscriptionRequired，如何處理？
該類報錯分為兩種情況：
帳號許可權不足：為 RAM 使用者授予 AliyunICEFullAccess 或含 ice:SubmitMediaProducingJob 等 Action 的自訂策略，並確認專案所在地區與調用地區一致。
產品許可權未開通：報 Forbidden.SubscriptionRequired 說明尚未訂閱對應版本或未購買功能體驗包，訂閱後重試即可。
剪輯合成任務失敗率高，如何系統排查？
建議按以下順序排查：
檢查源檔案：使用 ffprobe 等工具確認音視頻流完整、metadata 無異常，且格式在支援範圍內。
檢查儲存地區：確保輸入輸出的 OSS Bucket 與智能媒體服務位於同一地區，部分地區（如廣州、成都）暫不支援。
檢查 Timeline 參數：對照 Timeline 配置說明校正結構與欄位名，確認 MediaId、時間長度等參數正確。
Timeline 配置有哪些高頻錯誤？
特效軌道不支援重疊：需將每個特效放入單獨的軌道，避免 EffectTracks 內特效時間重疊。
報軌道為空白（Both video tracks and audio tracks are empty）：Timeline 未按標準格式傳入，需對照文檔修正結構。
MediaId 需傳入真實媒資 ID，不能使用變數佔位格式；欄位名需首字母大寫。
轉場效果需在視頻片段中配置轉場參數，而非單獨建立轉場軌道。
不要混用智能語音產品的 SSML 標籤，AudioTrackClips 的 Content、Volume 等參數需符合智能媒體服務文檔規範。
一鍵成片如何控制輸出數量、標題樣式？
輸出視頻數量由 OutputConfig.Count 控制（取值 1~100，預設 1），適用於指令碼化自動成片與智能圖文匹配成片。
字間距異常時，在 SubHeadingConfig 中設定 ModifySpacing 為 true 並適當調小 Spacing 值。
單個標題僅支援一種顏色，需多顏色時可通過 TitleArray 配置多個標題並分別指定顏色。
文案含特殊字元導致產生失敗時，需按 SSML 要求對特殊字元轉義後重新提交。
進階（AE）模板上傳失敗的常見原因？
模板包需同時滿足：使用 .zip 格式（不支援 rar、7z）；包名不含中文或特殊符號；包內含 assets、config.json、datas、ui 四個根目錄；當前地區支援進階模板。另需注意，智能媒體服務不支援匯出 AE 工程，僅支援匯出 Premiere Pro 工程。
合成產生的媒資需要手動清理嗎？
通過 API 產生的成片會自動註冊為媒資併產生儲存與管理計費，不再使用時請調用 DeleteMediaInfos 刪除。同時避免兩個任務輸出到同一個儲存地址，防止相互覆蓋導致成片異常。
其他高頻問題速查
擷取成片地址：合成任務為非同步任務，提交後調用 GetMediaProducingJob 查詢任務狀態並擷取輸出成片地址，也可通過事件回調（訊息佇列）接收結果，注意勾選對應訊息類型。
合成後末尾黑屏：多為視頻軌與音頻軌長度未對齊，可調整最後一個素材的 ClipId 與 ReferenceClipId 使兩軌對齊。
自訂字型：上傳字型檔後系統會產生對應的 MediaId，在 customFontList 中傳入這些 MediaId 即可使用。
實景摳圖輸出透明背景：不傳背景圖參數時可輸出帶 Alpha 通道的 WEBM 檔案；實景摳圖需要純色背景，居家、戶外等複雜背景不適用。
直播自動剪輯切片：調用 SubmitLiveEditingJob 介面實現。
回調不即時：事件回調不保證與任務完成時刻嚴格同步，不建議將商務邏輯完全依賴回調。建議以“輪詢任務狀態為主、回調為輔”，輪詢間隔建議不低於 5 秒。
一鍵成片除素材外還能定義什麼：標題、片尾、標題、字幕、背景音樂、口播文案均可通過時間軸或模板參數定義。模板標識在控制台的模板工廠中查看，儲存空間的訪問網域名稱在Object Storage Service控制台的概覽頁查看。
如何定位剪輯任務失敗的具體原因？
先自行取到報錯資訊，再對照原因處理，無需等待人工查詢。
拿到提交任務時返回的 JobId（控制台工作清單也可查看）。
調用 GetMediaProducingJob 並傳入 JobId，先看 Status 判斷任務階段，再讀取返回中的報錯資訊。
按報錯內容對應處理：屬於帳號類（如 Forbidden.SubscriptionRequired、許可權不足、帳號欠費）先處理帳號狀態；屬於參數類（如 TimelineFormatError、軌道為空白、欄位類型錯誤）先修正參數；屬於素材類（格式不支援、流資訊異常）先校正源檔案。
提工單時請同時提供 JobId 與完整請求參數，僅提供“任務失敗”無法定位。
任務提交失敗，報 VideoTracks 或 AudioTracks 相關的參數錯誤？
時間軸中的 VideoTracks、AudioTracks、ImageTracks、SubtitleTracks 均為數群組類型，必須使用 [ ] 包裹。誤傳為對象 { } 時任務會直接失敗。只有一個軌道時也需寫成單元素數組，例如 "VideoTracks": [{"VideoTrackClips": [...]}]。
報“Track duration adaptation and material alignment cannot be used at the same time”如何處理？
軌道時間長度自適應與素材對齊是兩項互斥能力，不能在同一任務中同時使用。
軌道時間長度自適應：由 TrackShortenMode、TrackExpandMode 控制（如 AutoSpeed）。
素材對齊：由 ClipId、ReferenceClipId 控制。
處理方式：在時間軸中搜尋上述欄位，二選一刪除。需要自動調速對齊時保留 TrackShortenMode/TrackExpandMode；需要按指定素材對齊時保留 ReferenceClipId。
報“User not authorized to operate on the specified resource”或 403 如何處理？
該報錯指向輸入檔案地址無法被讀取，請按順序排查。
優先使用 https 開頭的完整地址傳參；部分自拼接的地址格式會在校正環節被拒絕。
確認儲存空間與智能媒體服務位於同一地區，且服務關聯角色已完成授權。
子帳號調用時，確認已獲得相應的Object Storage Service讀取許可權與角色扮演許可權。
任務長時間停留在處理中，如何判斷是否異常？
先對照耗時預期：合成耗時通常與成片時間長度相當，再短的成片也需 15 秒以上；一次性提交大量任務時後台會排隊。
處理中狀態不代表子任務全部正常。批量類任務存在主任務已完成、部分子任務失敗的情況，需逐個查詢子任務結果，不要只看匯總狀態。
若耗時明顯超出預期（如短片超過 30 分鐘仍未完成），提工單時請提供 JobId 與提交時間。
單個任務產生異常高額費用，如何提前避免？
最常見原因是時間軸參數設定不當，導致實際成片時間長度遠超預期（曾出現單任務成片時間長度達十萬秒量級的情況），而剪輯按處理時間長度計費。建議在批量提交前做兩項校正：
校正每個素材的 In、Out 與 TimelineIn、TimelineOut 是否成對設定。只設 TimelineIn/TimelineOut 會按原始素材時間長度處理。
在業務側加一道成片時間長度上限校正，超過預期閾值直接攔住不提交；先用 1～2 個任務試跑並核對賬單，再批量放量。
上傳的素材提交後失敗，對素材有什麼要求？
優先使用 MP4、MOV 等常見容器格式的音視頻檔案，並確認檔案可正常播放。提交前建議用 ffprobe 確認音視頻流完整、中繼資料無異常；編碼異常、缺少視頻流或使用小眾容器格式的檔案容易在分析階段失敗。圖片素材在部分智能成片情境下的效果不如視頻素材穩定，如成片未按預期使用全部圖片，可先改用視頻素材驗證。
刪除媒資後，儲存空間裡的檔案為何還在？
媒資記錄與物理檔案是兩個層面，刪媒資預設不會刪除Object Storage Service中的源檔案，儲存費用也不會自動停止。
需同步刪除物理檔案時，調用刪除介面時顯式指定刪除物理檔案的參數（如 DeletePhysicalFiles 設為 true）。
上傳類素材與合成產物的行為不完全一致：通過介面產生的合成成片會自動註冊為媒資，刪除時可能需要額外清理Object Storage Service中的輸出檔案。
批量清理建議的順序：先調用 DeleteMediaInfos 刪除媒資記錄，再在Object Storage Service側確認對應目錄已清空。