SubmitAideoTaskAsync - 提交智能视频处理任务--视频点播-火山引擎

文档中心

视频点播

Aideo Agent

SubmitAideoTaskAsync - 提交智能视频处理任务

调用 SubmitAideoTaskAsync 接口提交一个异步的智能视频处理任务。

使用说明

本接口是 Aideo Agent 的核心入口，允许您通过 API 的方式，对指定的视频文件执行 AI 视频翻译、AI 字幕擦除、AI 视频理解或 AI 剪辑等操作。本接口支持以下两种任务提交方式：

任务提交方式	核心参数	说明
自然语言驱动	`Prompt`（必填）	您只需通过 `Prompt` 参数提供简单的自然语言指令，Agent 将自动理解您的意图，分析并调用底层的 AI 能力（如视频翻译、字幕擦除等）来完成任务。
指定技能驱动	`SkillType`（必填） `SkillParams`（是否必填取决于 `SkillType`）	您可以通过 `SkillType` 明确指定调用哪个具体的 AI 能力，并通过 `SkillParams` 传入该能力所需的精确参数。

注意

以上两种调用方式互斥，您必须选择其中一种，即要么设置 Prompt ，要么设置 SkillType + SkillParams。

任务提交后，系统将异步执行，您可以通过 GetAideoTaskResult 接口获取任务结果。

注意事项

开通视频智能处理 Aideo Agent：调用本接口前，您必须先前往视频点播控制台，开通视频点播-智能应用 Aideo Agent 并完成相关授权。
QPS 限制：本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

请求说明

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

调试

API Explorer

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

去调试

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`SubmitAideoTaskAsync`	接口名称。当前 API 的名称为 `SubmitAideoTaskAsync`。
Version	String	是	`2025-03-03`	接口版本。当前 API 的版本为 `2025-03-03`。

Body

参数	类型	是否必选	示例值	描述
SpaceName	String	是	`test-space`	点播空间名。您可通过以下方式获取空间名称：在视频点播控制台空间管理页面查看当前账号下所有空间的名称。调用 ListSpace 接口获取当前账号下所有空间的名称。
MultiInputs	Object[]	是	`-`	输入文件列表。用于指定一个或多个待处理的源文件。
Type	String	是	`Vid`	输入文件类型。当前仅支持取值为 `Vid`，表示 Vid 模式。此模式下，您还需设置 `Vid` 参数。
Vid	String	是	`v0ccfeg7007acsg***fog65ubr7niqng`	视频 ID (Vid) 或媒资 ID (Mid）。将音视频或图片上传至视频点播服务后，您可获取 Vid 或 Mid。
SkillType	String	否	`Highlight`	指定要调用的 AI 技能类型，用于直接调用对应的工作流而无需经过大模型意图理解。支持的技能类型如下所示。 `AITranslation`：AI 视频翻译 `Erase`：AI 字幕擦除 `Highlight`：AI 高光剪辑 `VCreative`：AI 剪辑 `Vision`：AI 视频理解
Prompt	String	否	`帮我翻译这个视频从中文翻译成英语。字幕和语音都要翻译，字幕压制到视频中。`	自然语言提示词，用于描述您希望 Agent 执行的任务。说明 Aideo Agent 当前仅支持执行 `SkillType` 中的列出的 AI 技能，因此 Prompt 中描述的任务必须与这些 AI 技能相关。为确保 API 调用能达到预期效果，强烈建议您先前往控制台 Aideo Agent 页面，通过对话交互充分测试和验证您的 Prompt，确认效果符合预期后，再将 Prompt 用于 API 调用。
SkillParams	String	否	`-`	技能参数，是一个 JSON 序列化后的字符串，包含了指定 `SkillType` 所需的详细参数。`SkillParams` 字符串需要根据不同的 `SkillType` 构造成对应的 JSON 结构。详见技能参数详解。

返回参数

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

参数	类型	示例值	描述
TaskId	String	`cc058a95-95e8-47a1-bf9e-4272***f9022`	异步智能处理任务的 ID。您需要使用此 ID 来调用 `GetAideoTaskResult` 接口查询任务状态和结果。

请求示例

以下示例演示如何提交 AI 视频翻译任务

POST https://vod.volcengineapi.com?Action=SubmitAideoTaskAsync&Version=2025-03-03
{
  "SpaceName": "test-space",
  "MultiInputs": [
    {
      "Vid": "v0ccfeg7007acsg***fog65ubr7niqng",
      "Type": "Vid"
    }
  ],
  "Prompt": "帮我翻译这个视频从中文翻译成英语。字幕和语音都要翻译，字幕压制到视频中。"
}

返回示例

AI 视频翻译任务提交结果

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "SubmitAideoTaskAsync",
    "Version": "2025-03-03",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "TaskId": "cc058a95-95e8-47a1-bf9e-4272***f9022"
  }
}

错误码

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

最近更新时间：2025.11.27 16:00:44

这个页面对您有帮助吗？

有用

无用

视频点播

使用说明 #

注意事项 #

请求说明 #

调试 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #