概览/OpenAPI/解说视频

解说视频

连续动态画面与旁白的解说视频请求。

解说视频

解说视频使用 explainer_video,生成连续动态画面和旁白。

{  "type": "explainer_video",  "prompt": "用连续动态画面讲清楚 MCP 是什么",  "language": "zh",  "aspect_ratio": "16:9",  "duration_seconds": 30}

duration_seconds 只属于解说视频,并且必须符合 Catalog 返回的账号限制和步进规则。音色、风格与质量也从 Catalog 选择。

生成后可用 update_scene_narrationregenerate_scene 修改具体场景。

最适合的请求

当需要用一条连续旁白解释产品流程、课程概念、业务过程或技术机制时,选择解说视频。提示词中应写出受众、必须保持准确的知识,以及观众需要获得的结论。按顺序解释的请求通常比只有一个主题标签的提示词更可靠。

创建并读取结果

先读取 /catalog,选择当前支持的语言、比例、时长、音色、风格和质量。调用 POST /creations 后保留 job_id,轮询 GET /creations/jobs/{job_id}。任务成功后,读取 GET /creations/{creation_id},取得真实的 main_urlartifacts[]scenes[]editable_actions

需要修正场景时,先确认详情返回的编辑动作,再使用 update_scene_narrationregenerate_scene。任务失败时,针对返回的参数、权益或提示词问题修正后再创建新结果。

关联文档