解说视频

解说视频

解说视频使用 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，并按新的状态继续查询。