解說視頻

解說視頻

解說視頻使用 type: video。它可以根據主題、網頁或上傳文件生成帶旁白的完整視頻。

創建示例

{  "type": "video",  "prompt": "面向新员工解释客户问题升级流程",  "instructions": "按受理、分级、升级和复盘的顺序讲解，保留附件中的术语",  "input_file_ids": ["file_xxx"],  "max_credits": 300,  "video": {    "duration_seconds": 120,    "aspect_ratio": "16:9",    "language": "zh",    "voice_id": "voice_from_capabilities",    "template_id": "template_from_capabilities",    "expression_style_id": "style_from_capabilities"  }}

除了 type 與 prompt，video 對象必須存在。具體值以 GET /capabilities 當前返回為準。

模板與表達風格

• template_id 選擇適用場景，例如員工培訓、軟件教程或研究解讀。
• expression_style_id 選擇視覺表達，例如白板講解、簡潔信息圖或電影化紀錄。
• 兩者彼此獨立。選擇模板後仍可選擇另一個兼容風格。
• 不選擇時可以省略，讓系統根據內容自動設計。

時長、語言與音色

duration_seconds 使用 capabilities 返回的目標值，不是任意秒數。當前視頻固定為 16:9。language 和 voice_id 也應來自當前能力數據；如果沒有明確偏好，可以省略可選字段。

使用網頁和附件

• URL 可以直接寫在 prompt 中，解說視頻支持 URL Context。
• PDF、PPT、文檔、表格和圖片先通過 POST /files 上傳，再傳 input_file_ids。
• 附件只是來源，不會被複制到其他用戶或 Remix。
• 提示詞應說明受眾、必須保持準確的事實，以及希望觀眾最終理解什麼。

查詢大綱與進度

創建後持續查詢 GET /creations/{id}：

• planning：正在分析來源並設計內容。
• producing：正在生成。
• review：存在時，可展示安全的大綱與場景摘要。
• estimated_remaining_seconds：可靠時才顯示。
• estimated_credits：規劃完成並確定範圍後可能出現。
• ready：讀取 outputs 獲取視頻和其他可用交付。

繼續修改

完成後可以通過 messages 繼續提出自然語言修改，例如：

• 讓第三個場景更簡潔。
• 保留結構，把整體語氣改得更專業。
• 只更新選中場景中的數據說明。

修改仍然使用同一個 creation，並按新的狀態繼續查詢。