创建指定OSS Bucket内对象的批量C2PA内容凭证签名任务。
接口说明
请求说明
本接口用于为指定 OSS Bucket 源前缀下的文件创建批量 C2PA 内容凭证签名任务，支持 JPEG/JPG、PNG、MP4、FLAC、M4A、MP3 和 WAV，可在同一前缀下混合处理。
SourcePrefix必须为ai-deepsign/或其子目录，且不能与输出前缀ai-deepsign-signed/重叠。单个任务默认最多处理 20000 个非目录对象。单个文件大小不得超过 800 MiB。
调用方的 RAM 身份需要具有本接口的调用权限；服务关联角色
AliyunServiceRoleForAIDeepSign需要具有指定 Bucket 和相关路径的访问权限。文件扩展名大小写不敏感。不支持格式的文件会记录为失败，但不会中止其他文件的处理。
签名结果写入同一 Bucket 的
ai-deepsign-signed/<TaskId>/目录，保留相对于SourcePrefix的子目录及源文件后缀，并在扩展名前增加_signed。处理报告为该任务目录下的c2pa_report.json。例如，当
SourcePrefix=ai-deepsign/images/时，源文件ai-deepsign/images/audio/demo.m4a的签名结果为ai-deepsign-signed/<TaskId>/audio/demo_signed.m4a。创建成功仅表示任务已受理，请通过
GetC2paSignResult查询结果。批量任务的SUCCEEDED不表示每个文件都签名成功，请结合最终统计和处理报告查看逐文件结果。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
aideepsign:CreateC2paBucketSignTask |
create |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| BucketRegionId |
string |
是 |
用户 OSS Bucket 所在地域，必须与 Bucket 的实际地域一致 |
cn-hangzhou |
| BucketName |
string |
是 |
用户 OSS Bucket 名称。需提前授权服务关联角色 AliyunServiceRoleForAIDeepSign 访问 |
example-bucket |
| SourcePrefix |
string |
是 |
源对象前缀。必须为 ai-deepsign/ 或其子目录，服务将递归处理该前缀下的对象。 |
ai-deepsign/images/ |
| SourceType |
string |
否 |
可选的内容来源类型，当前版本暂不支持 |
digitalCapture |
| SoftwareAgent |
string |
否 |
可选的生成内容软件名称，当前版本暂不支持 |
Adobe Photoshop 25.0 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
创建任务返回结果 |
||
| RequestId |
string |
请求 ID |
01A03DCE-4091-1A91-9810-692C3D783877 |
| TaskId |
string |
Bucket 批量签名任务 ID，可用于查询、暂停、恢复或终止任务 |
047b8305-9572-4eed-b7fb-8588b989b6e5 |
| Success |
boolean |
请求是否成功 |
true |
| Message |
string |
返回信息 |
success |
| HttpStatusCode |
integer |
HTTP 状态码 |
200 |
| Code |
string |
返回码 |
OK |
示例
正常返回示例
JSON格式
{
"RequestId": "01A03DCE-4091-1A91-9810-692C3D783877",
"TaskId": "047b8305-9572-4eed-b7fb-8588b989b6e5",
"Success": true,
"Message": "success",
"HttpStatusCode": 200,
"Code": "OK"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。