You need to enable JavaScript to run this app.
视频点播

视频点播

请输入
  • 文档首页
    • 视频点播视频 AI 应用OpenAPI 参考AI 智剪GetVCreativeTaskResult - 获取 AI 智剪任务结果
复制全文
我的收藏
AI 智剪
GetVCreativeTaskResult - 获取 AI 智剪任务结果
复制全文
我的收藏
GetVCreativeTaskResult - 获取 AI 智剪任务结果

调用 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
是
20251022v20******dd28d49019ebd42cf878cetob
AI 智剪任务 ID。可在
AsyncVCreativeTask 接口的返回参数中获取。

返回参数

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

参数
类型
示例值
描述
Uploader
String
your_space_name
任务产物的上传空间。AI 处理生成的视频将被上传至此点播空间。
ParamObj
String
{ "input": "vid://v022****ht0dseracvg", "space_name": "your_space_name", "style": "漫画风", "resolution": "720p" }

与指定 Scene 强相关的剪辑参数，以 JSON 序列化后的字符串形式传入。不同场景所需的参数不同，详见以下文档：

Scene
String
videostyletrans

AI 智剪场景，不同的取值对应不同的 AI 处理能力。当前支持的场景如下：

  • videostyletrans：AI 漫剧转绘
  • aigclongvideo：AI 文字成片
Status
String
failed_run

任务的当前处理状态。

  • start: 执行中
  • success: 执行成功
  • failed_run: 执行失败
OutputJson
String
OutputJson

任务的输出结果，是一个 JSON 格式的字符串您需要对其进行 JSON 解析以获取内部字段。其内部结构取决于任务所执行的场景类型，详见以下文档：

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",
    "Status": "failed_run",
    "OutputJson": "OutputJson",
    "CallbackArgs": "your_callback_args",
    "RequestId": "2025102220****C78ADC30A0418952624D",
    "ParamObj": {
      "input": "vid://v022****ht0dseracvg",
      "space_name": "your_space_name",
      "style": "漫画风",
      "resolution": "720p"
    },
    "Scene": "videostyletrans"
  }
}

错误码

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

状态码错误码错误信息说明
400InvalidParameter.InvalidParamparamater error参数错误
最近更新时间：2025.12.19 16:48:39
这个页面对您有帮助吗？
有用
有用
无用
无用