CreateC2paSignTask - AI数智鉴密

介面說明

簽章類型

基礎簽章：使用平台自有憑證簽章，支援內容完整性驗證。
可信簽章：在完整性驗證基礎上，簽章憑證鏈可透過 C2PA 官方信任清單驗證。

本介面提供可信簽章。如需對圖片進行基礎簽章，請呼叫 SignUserImage。

請求說明

本介面用於為指定的單個 JPEG/JPG、PNG 或 MP4 檔案新增 C2PA 可信簽章，產生內容憑證（Content Credentials）。
建立成功僅表示請求已受理，不意味著檔案已完成簽章。呼叫方需儲存返回的TaskId並透過GetC2paSignResult查詢最終結果。
FileUrl必須是服務可存取的絕對 HTTP 或 HTTPS 位址，且不能包含 URL user info 部分。
URL 中的 query 參數不會影響檔案名稱識別，例如https://example.com/media/demo.mp4?token=xxx將被識別為demo.mp4。
服務不會跟隨 HTTP 3xx 重新導向，來源位址必須直接返回 HTTP 200 狀態碼。
檔案大小上限為 800 MiB，實際限制基於讀取位元組數而非回應標頭中的Content-Length。
JPEG、PNG 和 MP4 的實際可簽章範圍取決於後端組態，當前支援最大 800 MiB 的檔案。
業務參數透過 URL query 傳遞，POP 支援 GET 和 POST 方法，但產生的 Go 用戶端使用 GET 方法。
成功建立任務後，檔案下載、暫存或簽章過程仍可能非同步失敗，此類錯誤需透過GetC2paSignResult取得詳細資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

aideepsign:CreateC2paSignTask

create

*全部資源。

*

無

請求參數

名稱	類型	必填	描述	樣本值
FileUrl	string	是	待簽章 JPEG 或 PNG 檔案的絕對 HTTP 或 HTTPS 位址，最多 4096 個字元。	https://example.com/images/photo.png?token=xxx
SourceType	string	否	當前版本暫不支援。	trainedAlgorithmicMedia
SoftwareAgent	string	否	當前版本暫不支援。	Alibaba Cloud Qwen ImageGen

返回參數

名稱	類型	描述	樣本值
	object	建立任務返回結果。
RequestId	string	本次 OpenAPI 呼叫的請求 ID。	A1B2C3D4-E5F6-7890-ABCD-EF1234567890
TaskId	string	服務產生的不透明任務 ID，用於呼叫 GetC2paSignResult。	7093c29e-f472-4e1e-91c6-a43df7c7382e
Success	boolean	表示本次介面呼叫是否成功。	True
Message	string	附加資訊。請求成功時返回 success。	success
HttpStatusCode	integer	HTTP 狀態碼。請求成功時返回 200。	200
Code	string	業務錯誤碼。請求成功時返回 OK。	OK

樣本

正常返回樣本

JSON格式

{
  "RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
  "TaskId": "7093c29e-f472-4e1e-91c6-a43df7c7382e",
  "Success": true,
  "Message": "success",
  "HttpStatusCode": 200,
  "Code": "OK"
}

錯誤碼

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

變更歷史

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