CreateWatermarkExtractTask - 创建暗水印提取任务-AI 数智鉴密(AI DeepSign )-阿里云帮助中心

接口说明

请求说明

FileUrl 必须是公网可访问的 HTTP/HTTPS 地址。目前暂不支持外网文件，仅支持国内公网可访问的文件 URL。推荐先将文件上传到国内地域的阿里云 OSS Bucket，再使用文件预签名 URL 作为本接口入参。参考文档：如何获取单个或多个文件的 URL
FileType 必须与嵌入时一致：确保提取的文件类型（图片/视频）与嵌入水印时使用的文件类型相同。
文件规格限制：视频文件需在 10 分钟以内且大小不超过 100MB；图片文件大小同样不得超过 100MB。
处理时效：大约为文件实际播放时间的一倍，例如一个 10 秒长的视频预计需要约 10 秒来完成水印提取过程。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
ClientToken	string	否	预留幂等字段，暂不支持。传入不会报错，但当前不产生幂等效果。	5A2CFF0E-5718-45B5-9D4D-70B3FF3898
FileType	string	是	文件类型，取值：`image`（图片）、`video`（视频）。必须与嵌入该水印时的 `FileType` 一致。	video
FileUrl	string	否	待提取水印文件的 URL 地址，支持图片和视频，仅支持 `http/https` 协议；视频仅支持 10 分钟以内、100MB 以内。	https://example.com/demo.mp4
Reserved	string	否	预留字段，当前无有效取值，建议调用时不传。	""

返回参数

名称	类型	描述	示例值
	object	Schema of Response
Code	string	业务错误码。请求成功时返回 OK。	OK
HttpStatusCode	string	HTTP 状态码。请求成功时返回 `200`。	200
Message	string	附加信息。请求成功时返回 "success"。	success
RequestId	string	请求 ID。	A1B2C3D4-E5F6-7890-ABCD-EF1234567890
Success	boolean	请求是否成功。	true
TaskId	string	暗水印提取任务 ID，用于调用 GetWatermarkExtractTaskResult 查询结果。	f47ac10b-58cc-4372-a567-0e02b2c3d479

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": "200",
  "Message": "success",
  "RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
  "Success": true,
  "TaskId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}

错误码

HTTP status code	错误码	错误信息	描述
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。