GetVCreativeTaskResult - 获取 AI 智剪任务结果--视频点播-火山引擎

文档中心

立即注册

导航

视频点播

GetVCreativeTaskResult - 获取 AI 智剪任务结果

最近更新时间：2025.11.13 17:43:47首次发布时间：2025.11.03 19:38:08

调用 GetVCreativeTaskResult 接口通过任务 ID 查询 AI 智剪任务的执行状态和结果。

注意事项

本接口的单用户 QPS 限制为10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 API QPS 限制。

请求说明

请求方式：GET
请求地址：https://vod.volcengineapi.com?Action=GetVCreativeTaskResult&Version=2018-01-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`GetVCreativeTaskResult`	接口名称。当前 API 的名称为 `GetVCreativeTaskResult`。
Version	String	是	`2018-01-01`	接口版本。当前 API 的版本为 `2018-01-01`。
VCreativeId	String	是	`20251022v20xxxxxxxdd28d49019ebd42cf878cetob`	AI 智剪任务 ID。可在 `AsyncVCreativeTask` 接口的返回参数中获取。

返回参数

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

参数	类型	示例值	描述
Uploader	String	`edit_test`	任务产物的上传空间。AI 处理生成的视频将被上传至此点播空间。
ParamJson	String	`{"input":"vid://v022d2g10065d3rk***vg","space_name":"your_space_name","style":"漫画风","resolution":"720p"}`	与指定 `WorkflowId` 强相关的剪辑参数，以 JSON 序列化后的字符串形式传入。不同工作流所需的参数不同。
WorkflowId	String	`loki://154160112`	AI 工作流 ID。不同的 ID 对应不同的 AI 处理能力。当前支持： `loki://154160112`: AI 漫剧转绘工作流。
Status	String	`failed_run`	任务的当前处理状态。 `start`: 执行中 `success`: 执行成功 `failed_run`: 执行失败
OutputJson	String	`OutputJson`	任务的输出结果，是一个 JSON 格式的字符串您需要对其进行 JSON 解析以获取内部字段。其内部结构取决于任务所执行的工作流类型。详见 AI 漫剧转绘工作流结果说明。
CallbackArgs	String	`Your_Callback_Args`	自定义回调参数。
RequestId	String	`2025102220****C78ADC30A0418952624D`	请求 ID。

请求示例

GET https://vod.volcengineapi.com?Action=GetVCreativeTaskResult&Version=2018-01-01&VCreativeId=20251022v20xxxxxxxdd28d49019ebd42cf878cetob

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Service": "vod",
    "Region": "cn-north-1",
    "Action": "GetVCreativeTaskResult",
    "Version": "2018-01-01"
  },
  "Result": {
    "Uploader": "your_space_name",
    "ParamJson": "ParamJson",
    "WorkflowId": "WorkflowId",
    "Status": "failed_run",
    "OutputJson": "OutputJson",
    "CallbackArgs": "YourCallbackArgs",
    "RequestId": "2025102220****C78ADC30A0418952624D"
  }
}

错误码

下表列举了本接口特有的错误码。如需了解更多错误码，详见视频点播公共错误码。

状态码	错误码	错误信息	说明
400	InvalidParameter.InvalidParam	paramater error	参数错误