文档首页/ 数字内容生产线 MetaStudio/ 常见问题/ API和SDK使用/ 使用API创建或更新剧本后,在控制台中剧本异常怎么办?
更新时间:2025-06-26 GMT+08:00

使用API创建或更新剧本后,在控制台中剧本异常怎么办?

控制台编辑和API调用同时使用的限制,如下所示:

  • 剧本封面仅作为通过控制台编辑当前剧本的参考,非实际合成效果。
  • 因为API接口的各参数间可能存在逻辑上的联系,使用API创建的剧本可能因传参错误或不严谨导致生成封面或剧本异常,需要根据相关API文档检查传入的参数。
  • 控制台编辑和API调用是两种使用方法,不建议混用。

    由API传入的不规范参数创建的剧本,在控制台加载时可能会导致控制台异常。请使用控制台编辑,或规范传参。

API调用可能会引起控制台异常原因,如下所示:

  • 使用了接口文档中不存在的字段。
  • 缺少渲染所需的必要参数。
  • 参数赋值有误,如:类型错误、取值超出范围等。
  • 场景顺序有误,如:shoot_scripts中的sequence_no需要从0开始依次递增。
  • 图层顺序有误,如:layer_config中的layer_index需要从1开始依次递增。
  • 图层的位置、大小不符合实际,如:文本图层大小计算有误、将图层置于画布外等问题。
  • 使用了不存在的资产或资产类型有误。