华为云用户手册

通过Intellij IDEA插件市场安装CodeArts 盘古助手 打开Intellij IDEA，选择“File”，单击“Settings”。 图1 打开设置界面 选择“Plugins”，单击“Marketplace”，并在搜索框中输入Huawei Cloud CodeArts 盘古助手。 图2 搜索CodeArts 盘古助手插件 单击“Install”按钮安装CodeArts 盘古助手插件，弹出需要安装Huawei Cloud Toolkit Platform 。 华为云插件依赖统一华为云开发者生态底座Huawei Cloud Toolkit Platform进行登录，此为必选项。 图3 确认依赖是否安装 单击“Install”继续安装。Intellij IDEA将下载并自动安装插件，等待插件安装完成后，单击“Restart IDE”，或手动重新启动IDE使插件安装生效。 重启IDE完成后，在IDE面板右侧，可以看到“CodeArts 盘古助手”工具窗口。 图4 安装完成后IDE界面

前提条件 CodeArts 盘古助手插件依赖华为云底座插件“Huawei Cloud Toolkit Platform”，请参考底座插件介绍，完成“Huawei Cloud Toolkit Platform”插件安装。 进入CodeArts 盘古助手申请试用说明页面，单击“申请试用”按钮（当前仅支持 IAM 租户进行申请），等待CodeArts 盘古助手服务支持授权试用。 已下载并安装IntelliJ IDEA 2021.3或更高版本。

通过本地文件方式安装CodeArts 盘古助手 进入JetBrains插件市场-CodeArts 盘古助手，在“Versions”标签页下选择最新版本，单击“Download”，下载离线安装包。 打开“Intellij IDEA”，选择“File”，单击“Settings”。 图5 打开设置界面 选择“Plugins”，单击齿轮图标，选择“Install Plugin from Disk…”。 图6 选择从磁盘安装 选择下载的安装包路径，选择CodeArts 盘古助手安装包，单击“OK”。 Intellij IDEA将会检查依赖，并完成安装。插件安装完成后，单击“Restart IDE”，或手动重新启动IDE使插件安装生效。 图7 安装完成后确认待重启IDE 重新启动IDE完成后，在IDE面板右侧，可以看到“CodeArts 盘古助手”工具窗口。 图8 安装完成后IDE界面

通过本地文件安装CodeArts 盘古助手 进入CodeArts IDE插件市场，查看“CodeArts 盘古助手”插件详情，单击“Download Extension”下载插件。 图1 CodeArts 盘古助手插件详情 在“CodeArts IDE”右上角单击“扩展”打开扩展管理。 图2 CodeArts IDE扩展管理 单击图标，选择从本地安装。 图3 选择从本地安装 在文件浏览器中选中“CodeArts 盘古助手”插件文件“huaweicloud.codearts-snap-2.0.1.carts”，单击“安装”。 图4 文件浏览器 CodeArts IDE弹出“非受信任扩展安装提示”，单击“去扩展市场查找”或“取消”跳出安装。单击“继续安装”进入下一步。 “CodeArts IDE”完成安装后弹出安装成功提示，同时弹出CodeArts 盘古助手免责声明。 图5 免责声明 根据您的意愿是否“同意”免责声明，同意即可使用插件，关闭将无法使用插件。

约束与限制 上传文档限制 本地文件：支持TXT、DOCX格式文件，单个文件最大支持20MB。 代码文件：仅支持JAVA、PYTHON、C、C++文件的ZIP格式，单个文件最大支持20MB，单个资产配额50MB。 入库配置限制 中文文本嵌入模型m3e-base：该模型是适用于中英文文本的通用型768维度的嵌入模型。 中文版文本表示模型bge-large-zh-v1.5：该模型适用于检索、分类、聚类或语义匹配等任务，目前仅支持中文文本。 向量计算模型paraphrase-multilingual-MiniLM-L12-v2：该模型适用于中英文文本，在文本相似度计算中表现优异，模型维度364。 华为自研代码专用模型VESO-v1.2：该模型在代码数据向量化、代码搜索任务中表现突出。 高级配置 切分器：不同的切分器的切片方式和结果不同，在不同的语言场景下可以选择不同的切分器，当前只支持中文切分器。 分段预计长度：分片长度的取值范围为50-1000，默认值为300。

创建知识库资产 单击已创建好的知识库卡片，可进入当前知识库新建资产页面。 单击页面左上角“新建资产”，弹出新建资产对话框。 图1 新建资产对话框 填写资产名称，上传相应的文档。当前上传文件只支持本地文件和代码文件两种文件类型。 单击下一步，进入入库配置页面。选择一个Embedding模型，对上传的文档进行向量化，当前提供四个模型可供选择。 图2 入库配置页面 在入库配置页面，按需配置“高级配置”中的“分段预计长度”。 单击“确定”，知识库资产创建完毕，如图3所示，为创建好的知识库资产列表。 图3 知识库资产列表

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 表3 请求Body参数 参数 是否必选 参数类型 描述 project_id 否 String 委托任务租户ID operate_type 是 String 操作标记 取值范围为[CREATED,CANCELED] CREATED：表示授权 CANCELED：表示取消授权

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

响应示例 状态码：200 查询转码模板组成功。 { "total" : 1, "template_group_list" : [ { "group_id" : "397565a34913415c91955254add0461a", "name" : "test_templageGroup", "template_ids" : [ 276195 ], "videos" : [ { "template_id" : 276195, "width" : 854, "height" : 480, "bitrate" : 500 } ], "audio" : { "output_policy" : "transcode", "codec" : 1, "bitrate" : 0, "sample_rate" : 1, "channels" : 2 }, "video_common" : { "output_policy" : "transcode", "codec" : 1, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "bframes_count" : 4, "frame_rate" : 0, "black_cut" : 0 }, "common" : { "PVC" : false, "hls_interval" : 5, "dash_interval" : 5, "pack_type" : 4 } } ] } 状态码：403 查询转码模板组失败。 { "error_code" : "MPC.10212", "error_msg" : "Operation failed." }

URI GET /v1/{project_id}/template_group/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 group_id 否 Array of strings 转码模板组ID，最多10个 group_name 否 Array of strings 转码模板组名，最多10个 page 否 Integer 分页编号。查询指定“group_id”时，该参数无效。 默认值：0。 size 否 Integer 每页记录数。取值范围：[1,100]，指定group_id时该参数无效。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 objects Array of ObsObject objects 返回的OBS对象组详情 表5 ObsObject 参数 参数类型 描述 file_name String 对象的key size Long 文件大小 last_modified String 文件的最后修改时间 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 notifications Array of Notification objects 事件通知模板信息 total Integer 事件通知模板总数 表4 Notification 参数 参数类型 描述 event_name String 消息事件的名称 status String 事件通知模板选中状态 topic String 事件通知主题的URN msg_type Integer 订阅消息类型 状态码：400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码：200 查询转码服务端事件通知配置成功。 { "total" : 7, "notifications" : [ { "event_name" : "RemuxComplete", "status" : "on", "topic" : "urn: smn:region1:tenantId:topic", "msg_type" : 3 }, { "event_name" : "AnimatedGraphicsComplete", "status" : "on", "topic" : "urn: smn:region1:tenantId:topic", "msg_type" : 3 }, { "event_name" : "TranscodeComplete", "status" : "on", "topic" : "urn: smn:region1:tenantId:topic", "msg_type" : 3 }, { "event_name" : "ThumbnailComplete", "status" : "off", "topic" : "urn: smn:region1:tenantId:topic", "msg_type" : 3 }, { "event_name" : "TranscodeStart", "status" : "on", "topic" : "urn: smn:region1:tenantId:topic", "msg_type" : 3 }, { "event_name" : "ParseComplete", "status" : "on", "topic" : "urn: smn:region1:tenantId:topic", "msg_type" : 3 }, { "event_name" : "EditingComplete", "status" : "on", "topic" : "urn: smn:region1:tenantId:topic", "msg_type" : 3 } ] } 状态码：400 查询转码服务端事件通知配置失败。 { "error_code" : "MPC.10208", "error_msg" : "Failed to verify the tenant ID." }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 表3 请求Body参数 参数 是否必选 参数类型 描述 input 否 ObsObjInfo object 源文件信息。 说明： 在转动图、同步解析、同步截图等场景，暂不支持m3u8格式的视频。 output 否 ObsObjInfo object 输出文件信息。 user_data 否 String 用户自定义数据。 output_param 否 AnimatedGraphicsOutputParam object 动图输出参数。 表4 ObsObjInfo 参数 是否必选 参数类型 描述 bucket 是 String OBS的bucket名称。 location 是 String OBS桶所在的区域，且必须与使用的MPC区域保持一致。 object 是 String OBS对象路径，遵守OSS Object定义。 当用于指示input时，需要指定到具体对象。 当用于指示output时，只需指定到转码结果期望存放的路径。 在字幕场景下，字幕文件名称中禁止携带特殊符号，否则会导致转码任务失败，如：[ 正确示例: demo.srt 错误示例: [demo.srt file_name 否 String 文件名，文件名长度不能超过180个字符。 当指定了此参数时，输出的对象名为object/file_name。 当不指定此参数时，输出的对象名为object/xxx，其中xxx由MPC指定。 在作为输出文件名时： 在转封装场景有效，需要指定输出文件名称 在转码场景下，如果需要指定输出的文件名称，请使用output_filenames参数 在解析场景有效，解析场景如果指定文件名，则将解析参数写入指定文件名，通过查询接口响应json数据获取文件元数据信息 在截图场景无效 在转动图场景无效 输出文件为HLS格式时，文件名称不能命名为index，示例：index.m3u8，否则会导致播放失败。 表5 AnimatedGraphicsOutputParam 参数 是否必选 参数类型 描述 format 是 String 动图格式，目前仅支持取值 gif width 是 Integer 输出动图的宽。 取值范围：0，-1或[32,3840]之间2的倍数。 说明： 若设置为-1， 则宽根据高来自适应，此时“height”不能取-1或0。 若设置为0，则取原始视频的宽，此时“height”只能取0。 height 是 Integer 输出动图的高。 取值范围：0，-1或[32,2160]之间2的倍数。 说明： 若设置为-1， 则高根据宽来自适应，此时“width”不能取-1或0。 若设置为0，则取原始视频的高，此时“width”只能取0。 start 是 Integer 起始时间。 单位：毫秒 end 是 Integer 结束时间。 单位：毫秒。 end、start差值最多60秒。 frame_rate 否 Integer 动图帧率。 取值范围：[1,75]

请求示例 创建动图任务，用于将完整的视频文件或视频文件中的一部分转换为动态图文件，暂只支持输出GIF文件。 POST https://{endpoint}/v1/{project_id}/animated-graphics { "input" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-path/input.mp4" }, "output" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-path/output", "file_name" : "test_mpc.gif" }, "output_param" : { "format" : "gif", "width" : 480, "height" : 360, "frame_rate" : 15, "start" : 100, "end" : 250 } }

响应示例 状态码：200 查询转封装任务成功。 { "total" : 1, "tasks" : [ { "task_id" : 10743, "error_code" : "MPC.10218", "status" : "SUCCEED", "create_time" : 20201117021558, "start_time" : 20201117021558, "end_time" : 20201117021559, "description" : "The task has completed.", "input" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-path/input.flv" }, "output" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-path/output.mp4", "file_name" : "bf00ba898a3dfb3560a292fd87f790db.mp4" }, "user_data" : 1795687, "output_param" : { "format" : "MP4", "segment_duration" : 5, "remove_meta" : false }, "complete_ratio" : 100, "output_metadata" : { "size" : 3189068, "duration_ms" : 25.48, "duration" : 25, "format" : "mp4", "bitrate" : 977, "video" : [ { "width" : 1920, "height" : 1080, "bitrate" : 977, "bitrate_bps" : 1001277, "frame_rate" : 25, "codec" : "H.264" } ], "audio" : [ { "sample" : 48000, "channels" : 2, "bitrate" : 0, "bitrate_bps" : 0 } ] } } ] } 状态码：400 查询转封装任务失败。 { "error_code" : "MPC.10202", "error_msg" : "Invalid request parameter." }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 total Integer 任务总数 tasks Array of RemuxTask objects 任务列表 表5 RemuxTask 参数 参数类型 描述 task_id String 任务ID status String 任务状态。 取值如下： INIT：初始状态。 WAITING：等待启动。 PRO CES SING：处理中。 SUCCEED：处理成功。 FAILED：处理失败。 CANCELED：已取消。 create_time String 任务创建时间 start_time String 任务启动时间 end_time String 任务结束时间 error_code String 任务的返回码。 description String 错误描述 user_data String 用户数据。 input ObsObjInfo object 源文件信息 output ObsObjInfo object 输出文件信息 output_param RemuxOutputParam object 输出参数 complete_ratio Integer 任务完成进度百分比值。 output_metadata MetaData object 转封装出文件的元数据信息。 表6 ObsObjInfo 参数 参数类型 描述 bucket String OBS的bucket名称。 location String OBS桶所在的区域，且必须与使用的MPC区域保持一致。 object String OBS对象路径，遵守OSS Object定义。 当用于指示input时，需要指定到具体对象。 当用于指示output时，只需指定到转码结果期望存放的路径。 在字幕场景下，字幕文件名称中禁止携带特殊符号，否则会导致转码任务失败，如：[ 正确示例: demo.srt 错误示例: [demo.srt file_name String 文件名，文件名长度不能超过180个字符。 当指定了此参数时，输出的对象名为object/file_name。 当不指定此参数时，输出的对象名为object/xxx，其中xxx由MPC指定。 在作为输出文件名时： 在转封装场景有效，需要指定输出文件名称 在转码场景下，如果需要指定输出的文件名称，请使用output_filenames参数 在解析场景有效，解析场景如果指定文件名，则将解析参数写入指定文件名，通过查询接口响应json数据获取文件元数据信息 在截图场景无效 在转动图场景无效 输出文件为HLS格式时，文件名称不能命名为index，示例：index.m3u8，否则会导致播放失败。 表7 RemuxOutputParam 参数 参数类型 描述 format String 输出格式。取值范围： HLS MP4 segment_duration Integer 分片时长，仅当“format”为“HLS”时有效。 参考取值范围：[2，10]。 默认值： 5。 单位：秒。 说明： 若设置的分片时长不在取值范围内，则自动调整为5。 remove_meta Boolean 输出媒体是否去除片源的中metadata自定义信息。默认值：false 表8 MetaData 参数 参数类型 描述 size Long 文件大小。 单位：byte。 duration_ms Double 视频时长，带小数位显示。 单位：秒。 duration Long 视频时长。 单位：秒。 format String 文件封装格式。 md5 String 视频的 md5 值。 bitrate Long 总码率。 单位：bit/秒 video Array of VideoInfo objects 视频流元数据。 audio Array of AudioInfo objects 音频流元数据。 表9 VideoInfo 参数 参数类型 描述 width Integer 视频宽度 height Integer 视频高度 bitrate Integer 视频码率。 单位: kbit/s 说明： 视频解析接口2024年8月7日做了如下变更： 变更前：视频解析任务，如果为同步解析，即sync参数配置为1时，解析响应VideoInfo中的参数bitrate单位实际为bit/s。 变更后：视频解析任务同步解析响应VideoInfo中的参数bitrate单位变更为kbit/s。 上述更新，可能会影响历史用户的转码业务判断，请关注并及时调整业务。 bitrate_bps Long 视频码率。 单位: bit/s frame_rate Integer 帧率。 取值范围：0或[5,60]，0表示自适应。 单位：帧每秒。 说明： 若设置的帧率不在取值范围内，则自动调整为0，若设置的帧率高于片源帧率，则自动调整为片源帧率。 codec String 视频编码格式 duration String 视频流时长，单位：秒 duration_ms String 视频流时长，单位：毫秒 rotate Float 视频拍摄时的选择角度，单位：度。 表10 AudioInfo 参数 参数类型 描述 codec String 音频编码格式 sample Integer 音频采样率 channels Integer 音频信道 bitrate Integer 音频码率。 单位: kbit/s bitrate_bps Long 音频码率。 单位: bit/s duration String 音频流时长，单位：秒 duration_ms String 音频流时长，单位：毫秒 状态码：400 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

URI GET /v1/{project_id}/remux 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 task_id 否 Array of strings 任务ID。一次最多10个 status 否 String 任务执行状态。 取值如下： INIT：初始状态 WAITING：等待启动 PROCESSING：处理中 SUCCEED：处理成功 FAILED：处理失败 CANCELED：已取消 start_time 否 String 起始时间。格式为yyyymmddhhmmss。必须是与时区无关的UTC时间，指定task_id时该参数无效 end_time 否 String 结束时间。格式为yyyymmddhhmmss。必须是与时区无关的UTC时间，指定task_id时该参数无效 input_bucket 否 String 源文件存储桶。 input_object 否 String 源对象名称. page 否 Integer 分页编号。查询指定“task_id”时，该参数无效。 默认值：0。 size 否 Integer 每页记录数。查询指定“task_id”时，该参数无效。 取值范围：[1,100]。 默认值：10。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

URI GET /v1/{project_id}/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 task_id 否 Array of longs 转码服务接受任务后产生的任务ID。一次最多10个 status 否 String 任务执行状态。 取值如下： WAITING：等待启动 TRANSCODING：转码中 SUCCEEDED：转码成功 FAILED：转码失败 CANCELED：已删除 NEED_TO_BE_AUDIT：片源待审核 start_time 否 String 起始时间 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间，指定task_id时该参数无效 end_time 否 String 结束时间 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间，指定task_id时该参数无效 page 否 Integer 分页编号。查询指定“task_id”时，该参数无效。 默认值：0。 size 否 Integer 每页记录数。查询指定“task_id”时，该参数无效。 取值范围：[1,100]。 默认值：10。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 x-language 否 String 客户端语言 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

响应示例 状态码：200 查询转码任务成功。 { "is_truncated" : 0, "total" : 1, "task_array" : [ { "task_id" : 22123973, "status" : "SUCCEEDED", "create_time" : 20200310031605, "end_time" : 20200310031623, "trans_template_id" : [ 4 ], "input" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-input.mp4" }, "output" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-output.mp4" }, "output_file_name" : [ "example_480X270.m3u8" ], "transcode_detail" : { "multitask_info" : [ { "template_id" : 4, "output_file" : { "duration" : 59, "duration_ms" : 0, "format" : "HLS", "size" : 2180, "video_info" : { "width" : 480, "height" : 270, "bitrate" : 231, "bitrate_bps" : 0, "frame_rate" : 25000, "codec" : "H264" }, "audio_info" : [ { "codec" : "HEAAC", "sample" : 44100, "channels" : 2, "bitrate" : 64, "bitrate_bps" : 0 } ] } } ], "input_file" : { "duration" : 59, "duration_ms" : 0, "format" : "MOV", "size" : 2494653, "video_info" : { "width" : 480, "height" : 270, "bitrate" : 199, "bitrate_bps" : 0, "frame_rate" : 25000, "codec" : "HEVC" }, "audio_info" : [ { "codec" : "AAC", "sample" : 48000, "channels" : 2, "bitrate" : 128, "bitrate_bps" : 0 } ] } } } ] } 状态码：400 查询转码任务失败。 { "error_code" : "MPC.10202", "error_msg" : "Invalid request parameter" }

请求示例 新建水印模板，水印模板目前默认支持创建100000个。 POST https://{endpoint}/v1/{project_id}/template/watermark { "template_name" : "watermark_1920*1080_10*10_ BottomLeft", "type" : "Image", "image_process" : "Grayed", "width" : "1920", "height" : "1080", "dx" : "10", "dy" : "10", "referpos" : "BottomLeft", "timeline_start" : "6", "timeline_duration" : "8" }

功能介绍 自定义水印模板，水印模板目前默认支持创建100000个。 在视频内容中嵌入可见的水印，水印有多种应用场景和内容类型，例如:"赞助商或合作伙伴Logo"、"质量或认证标志"等。 水印模板是预设的一系列参数集合，用于定义水印的位置、大小等关键属性。通过使用水印模板，开发者可以简化水印应用的开发流程，实现快速、一致的水印添加效果。 水印模板只适用于图片水印，不适用于文字水印。文字水印请在CreateTranscodingTask - 新建转码任务接口中指定WaterMarks参数。 水印模板仅包含水印的位置、大小属性，不包含水印素材。水印素材需要在提交媒资转码任务时添加。 水印模板可以通过控制台，或调用 CreateWatermarkTemplate - 新建水印模板。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 表3 请求Body参数 参数 是否必选 参数类型 描述 dx 否 String 水印图片起点相对输出视频顶点的水平偏移量。 设置方法有如下两种： 整数型：表示图片起点水平偏移视频顶点的像素值，单位px。取值范围：[0，4096] 小数型：表示图片起点相对于视频分辨率宽的水平偏移比率。取值范围：(0，1)，支持4位小数，如0.9999，超出部分系统自动丢弃。 示例：输出视频分辨率宽1920，设置“dx”为“0.1”，“referpos”为“TopRight”（右上角），则水印图片右上角到视频右顶点在水平方向上偏移距离为192。 dy 否 String 水印图片起点相对输出视频顶点的垂直偏移量。 设置方法有如下两种：整数型：表示图片起点垂直偏移视频顶点的像素值，单位px。取值范围：[0，4096] 小数型：表示图片起点相对于视频分辨率高的垂直偏移比率。取值范围：(0，1)，支持4位小数，如0.9999，超出部分系统自动丢弃。 示例：输出视频分辨率高1080，设置“dy”为“0.1”，“referpos”为“TopRight”（右上角），则水印图片右上角到视频右顶点在垂直方向上的偏移距离为108。 referpos 否 String 水印的位置。 取值如下： TopRight：右上角。 TopLeft：左上角。 BottomRight：右下角。 BottomLeft：左下角。 ClockWise：顺时针 AntiClockWise：逆时针 Random：随机跳转 timeline_start 否 String 水印开始时间，与“timeline_duration”配合使用。 取值范围：数字。 单位：秒。 timeline_duration 否 String 水印持续时间，与“timeline_start”配合使用。 取值范围：[数字，ToEND]。“ToEND”表示持续到视频结束。 默认值：ToEND。 random_time_min 否 Float 轮转间隔时间最小值，单位：秒 random_time_max 否 Float 轮转间隔时间最大值，单位：秒 image_process 否 String 图片水印处理方式，type设置为Image时有效。 取值如下： Original：只做简单缩放，不做其他处理。 Grayed：图像灰度化处理。 Transparent：保持原始透明图像的透明化效果。如果原始图像中存在透明区域，这些区域在转码处理后仍将保持透明，允许底层的背景或图像透过这些区域显示出来，从而实现图像与背景的无缝融合。 width 否 String 水印图片宽，值有两种形式： 整数型代水印图片宽的像素值，范围[8，4096]，单位px。 小数型代表相对输出视频分辨率宽的比率，范围(0,1)，支持4位小数，如0.9999，超出部分系统自动丢弃。 height 否 String 水印图片高，值有两种形式： 整数型代表水印图片高的像素值，范围[8，4096]，单位px。 小数型代表相对输出视频分辨率高的比率，范围(0，1)，支持4位小数，如0.9999，超出部分系统自动丢弃。 base 否 String 水印叠加母体 取值如下： input ：水印叠加在输入片源上，转码输出视频中的水印实际大小按视频图像的大小进行等比例缩放。 output ：水印叠加在转码输出文件上，转码输出视频中的水印实际大小不会随着视频图像的大小进行等比例缩放。 template_id 否 Integer 水印模板ID template_name 否 String 水印模板名称，最大支持64个字符。 type 否 String 水印类型，当前只支持Image（图片水印）。后续根据需求再支持Text（文字水印）。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //IAM用户名 "password": $ADMIN_PASS, //IAM用户密码，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 "domain": { "name": "domainname" //IAM用户所属账号名 } } } }, "scope": { "project": { "name": "xxxxxxxx" //项目名称 } } } } 获取Token 后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFG....”，则调用接口时将“X-Auth-Token: ABCDEFG....”加到请求消息头即可，如下所示。 1 2 3 POST https://iam.cn-north-4.myhuaweicloud.com/v3.0/OS-USER/users Content-Type: application/json X-Auth-Token: ABCDEFG.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。