DocsICP FilingConsole
Documentation

SignUserImage - 图片基础签名

Updated at:
Copy as MD
Product
My Favorites

使用平台自有证书对图片进行C2PA基础签名，支持内容完整性验证，并返回已签名图片的下载地址。

接口说明

签名类型

  • 基础签名：使用平台自有证书签名，支持内容完整性验证。

  • 可信签名：在完整性验证基础上，签名证书链可通过 C2PA 官方信任列表验证。

本接口提供基础签名。如需可信签名，请调用 CreateC2paSignTask 创建任务，并通过 GetC2paSignResult 查询结果。

请求说明

  • ImageUrl 必填，且必须是公网可访问的 HTTP/HTTPS 地址。

  • 目前暂不支持外网图片，仅支持国内公网可访问的图片 URL。推荐先将图片上传到国内地域的阿里云 OSS Bucket，再使用图片预签名 URL 作为本接口入参。参考文档：如何获取单个或多个文件的 URL

  • 支持的图片格式：JPEG、PNG。不支持的格式会返回 C2PA_FORMAT_UNSUPPORTED 错误。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

aideepsign:SignUserImage

update

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
ClientToken

string

否

用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。

5A2CFF0E-5718-45B5-9D4D-70B3FF3898
ImageUrl

string

否

待签名图片的 URL 地址。支持 HTTP/HTTPS 链接。ImageUrl 与 ObjectKey 二选一，至少提供一个。

https://example.com/photo.jpg

返回参数

名称

类型

描述

示例值

object

  • Success: 请求是否成功。

  • Code: 业务错误码。请求成功时返回 "OK"。

  • Message: 附加信息。请求成功时返回 "success"。

  • HttpStatusCode: HTTP 状态码。请求成功时返回 200。

  • SignedImageUrl: 已签名图片的预签名下载地址，可在有效期内直接作为其他接口的 ImageUrl 入参。

  • CertificateSubject: 签名证书的主题（Subject）信息。

  • Algorithm: 签名使用的算法，如 ps256、es256 等。

  • SignTime: 签名时间（ISO 8601 格式），如 2026-01-15T08:30:00Z。

SignTime

string

签名时间（ISO 8601 格式），如 2026-01-15T08:30:00Z。

2026-06-18T10:30:00Z
RequestId

string

请求 ID。

A1B2C3D4-E5F6-7890-ABCD-EF1234567890
SignedImageUrl

string

已签名图片的预签名下载地址。

https://bucket.oss-cn-hangzhou.aliyuncs.com/deepsign/123456789/signed/abc12345.png?Expires=1718700000&OSSAccessKeyId=...
CertificateSubject

string

签名证书的主题（Subject）信息。

CN=AIDeepSign User Certificate,O=Alibaba Cloud
ObjectKey

string

已签名图片在 OSS 中的 ObjectKey，可用于后续接口调用。

deepsign/123456789/signed/abc12345-def6-7890-abcd-ef1234567890.png
Algorithm

string

签名使用的算法，如 ps256、es256 等。

ps256
Success

boolean

请求是否成功。

Message

string

附加信息。请求成功时返回 "success"。

success
HttpStatusCode

integer

HTTP 状态码。请求成功时返回 200。

200
Code

string

业务错误码。请求成功时返回 "OK"。

OK

示例

正常返回示例

JSON格式

{
  "SignTime": "2026-06-18T10:30:00Z",
  "RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
  "SignedImageUrl": "https://bucket.oss-cn-hangzhou.aliyuncs.com/deepsign/123456789/signed/abc12345.png?Expires=1718700000&OSSAccessKeyId=...",
  "CertificateSubject": "CN=AIDeepSign User Certificate,O=Alibaba Cloud",
  "ObjectKey": "deepsign/123456789/signed/abc12345-def6-7890-abcd-ef1234567890.png",
  "Algorithm": "ps256",
  "Success": true,
  "Message": "success",
  "HttpStatusCode": 200,
  "Code": "OK"
}

错误码

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.

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

变更历史

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

Previous：RAM authorizationNext：CreateC2paSignTask