调用 CreateDramaScriptTask 接口创建剧本还原任务。

使用说明

本接口为异步接口，调用成功后会返回一个任务 ID。您可通过以下方式获取处理结果：

• 调用 QueryDramaScriptTask 接口主动查询。
• 配置剧本还原任务完成事件。

注意事项

• 该接口仅支持白名单用户调用。使用前请提交工单联系火山引擎技术支持团队申请开通。
• 本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。
• 短剧视频限制：
  • 视频总时长：单次任务处理的所有视频累计时长不超过 90 分钟（约等于一部 45 集的短剧）。
  • 分辨率一致性：提交的多个视频，其分辨率（宽高）必须保持一致。
  • 字幕要求：视频必须包含内嵌字幕（硬字幕）。暂不支持无字幕或外挂字幕的视频。
  • 格式限制：暂不支持 HLS（M3U8）格式的视频。
  • 存储限制：暂不支持处理挂载在对象存储桶中的视频。

请求说明

• 请求方式：POST
• 请求地址：https://vod.volcengineapi.com?Action=CreateDramaScriptTask&Version=2025-03-03

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

Query

Body

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

请求示例

POST https://vod.volcengineapi.com?Action=CreateDramaScriptTask&Version=2025-03-03
{
  "SpaceName": "test",
  "Vids": [
    "vid1",
    "vid2",
    "vid3"
  ]
}

返回示例

{
  "ResponseMetadata": {
    "Action": "CreateDramaScriptTask",
    "Region": "cn-north-1",
    "Service": "vod",
    "Version": "2025-03-03",
    "RequestId": "20230604110420****100232280022D31"
  },
  "Result": {
    "TaskId": "v02bbbg1006***kbdminbj659kvikr0g"
  }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。