為OSS Bucket內指定前綴下的物件建立批次C2PA可信簽章任務,在完整性驗證基礎上,簽章憑證鏈可透過C2PA官方信任清單驗證。
介面說明
簽章類型
基礎簽章:使用平台自有憑證簽章,支援內容完整性驗證。
可信簽章:在完整性驗證基礎上,簽章憑證鏈可透過 C2PA 官方信任清單驗證。
本介面提供批次可信簽章,可透過 GetC2paSignResult 查詢任務狀態和結果。如需對單張圖片進行基礎簽章,請呼叫 SignUserImage。
請求說明
SourcePrefix必須位於ai-deepsign/或其子目錄下,並且不能與保留輸出前綴ai-deepsign-signed/重疊。目前版本支援 JPEG/JPG、PNG 和 MP4 格式檔案進行可信簽章,其他格式的物件將被標記為失敗但不會中斷整個任務。
單一任務預設最多可包含 20,000 個非目錄物件,每個物件大小限制在 800 MiB 以內。
服務會自動遞迴掃描指定前綴下的所有非目錄物件,無需設定目錄分隔符號。
建立任務時僅驗證權限及統計物件數量,實際處理還需確保讀取來源物件以及向目標位置寫入資料的權限。
推薦為關聯角色設定特定 OSS 權限以保證流程順利執行。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| BucketRegionId |
string |
是 |
使用者 OSS Bucket 所在區域,必須與 Bucket 的實際區域一致。 |
cn-hangzhou |
| BucketName |
string |
是 |
使用者 OSS Bucket 名稱。需事先授權服務連結角色 AliyunServiceRoleForAIDeepSign 存取。 |
example-bucket |
| SourcePrefix |
string |
是 |
來源物件前綴。必須為 ai-deepsign/或其子目錄,服務將遞迴處理其中副檔名為.jpg、.jpeg、.png 或.mp4 的物件。 |
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"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。