SignUserImage - AI数智鉴密

使用平台自有憑證對圖片進行 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": false,
  "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.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。