解说视频
解说视频使用 explainer_video,生成连续动态画面和旁白。
{ "type": "explainer_video", "prompt": "用连续动态画面讲清楚 MCP 是什么", "language": "zh", "aspect_ratio": "16:9", "duration_seconds": 30}
duration_seconds 只属于解说视频,并且必须符合 Catalog 返回的账号限制和步进规则。音色、风格与质量也从 Catalog 选择。
生成后可用 update_scene_narration 或 regenerate_scene 修改具体场景。
最适合的请求
当需要用一条连续旁白解释产品流程、课程概念、业务过程或技术机制时,选择解说视频。提示词中应写出受众、必须保持准确的知识,以及观众需要获得的结论。按顺序解释的请求通常比只有一个主题标签的提示词更可靠。
创建并读取结果
先读取 /catalog,选择当前支持的语言、比例、时长、音色、风格和质量。调用 POST /creations 后保留 job_id,轮询 GET /creations/jobs/{job_id}。任务成功后,读取 GET /creations/{creation_id},取得真实的 main_url、artifacts[]、scenes[] 和 editable_actions。
需要修正场景时,先确认详情返回的编辑动作,再使用 update_scene_narration 或 regenerate_scene。任务失败时,针对返回的参数、权益或提示词问题修正后再创建新结果。
