視頻點播提供了支持視頻、音頻、圖片、文本等全方位的媒體審核服務,可幫助用戶發現媒體資源中的暴恐、涉政、涉黃、廣告、辱罵、不良場景等風險內容或元素,降低人工審核成本,提升內容質量,改善平臺秩序和用戶體驗。本文提供了Java SDK媒體審核相關的API調用示例,包含提交智能審核(即機器審核)作業、獲取智能審核結果、提交人工審核等。
接口調用說明
本文提供的接口調用示例均通過AccessKey初始化客戶端實例。
接口的參數解釋和返回字段的詳細說明請訪問阿里云OpenAPI門戶,在各接口右側的文檔頁簽查看。
本文僅提供部分復雜接口的代碼示例,其余接口的SDK代碼示例,可以通過阿里云OpenAPI門戶獲取。訪問阿里云OpenAPI門戶,在接口的左側參數配置頁簽,填寫需要的參數信息并發起調用后,在右側的SDK示例頁簽,選擇SDK版本,選擇目標語言,查看并下載示例代碼。
本文均以V1.0版本的SDK為例進行接口調用,如需獲取V2.0版本的SDK示例,請在通過阿里云OpenAPI門戶獲取SDK示例時,指定到對應的SDK版本。
初始化客戶端
使用前請先初始化客戶端,請參見初始化。
提交智能審核作業
調用SubmitAIMediaAuditJob接口,完成提交智能審核作業功能。
阿里云OpenAPI門戶地址:SubmitAIMediaAuditJob。
查詢智能審核作業
調用GetAIMediaAuditJob接口,完成查詢智能審核作業功能。
阿里云OpenAPI門戶地址:GetAIMediaAuditJob。
獲取智能審核結果摘要
調用GetMediaAuditResult接口,完成獲取智能審核結果摘要功能。
阿里云OpenAPI門戶地址:GetMediaAuditResult。
獲取智能審核結果詳情
調用GetMediaAuditResultDetail接口,完成獲取智能審核結果詳情功能。
阿里云OpenAPI門戶地址:GetMediaAuditResultDetail。
獲取智能審核結果時間線
調用GetMediaAuditResultTimeline接口,完成獲取智能審核結果時間線功能。
阿里云OpenAPI門戶地址:GetMediaAuditResultTimeline。
人工審核
調用CreateAuditRequest接口,完成人工審核功能。
阿里云OpenAPI門戶地址:CreateAuditRequest。
調用示例如下:
import com.aliyuncs.auth.AlibabaCloudCredentials;
import com.aliyuncs.auth.EnvironmentVariableCredentialsProvider;
import com.aliyuncs.vod.model.v20170321.CreateAuditRequest;
import com.aliyuncs.vod.model.v20170321.CreateAuditResponse;
import com.alibaba.fastjson.JSONObject;
/**
*讀取AccessKey信息
*/
public static DefaultAcsClient initVodClient() throws ClientException {
String regionId = "cn-shanghai"; // 點播服務接入地域
// 阿里云賬號AccessKey擁有所有API的訪問權限,建議您使用RAM用戶進行API訪問或日常運維。
// 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
// 本示例通過從環境變量中讀取AccessKey,來實現API訪問的身份驗證。運行代碼示例前,請配置環境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
DefaultProfile profile = DefaultProfile.getProfile(regionId, System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
DefaultAcsClient client = new DefaultAcsClient(profile);
return client;
}
/**
* 構建審核內容
*/
public static String buildAuditContent() throws Exception {
List<JSONObject> auditContents = new ArrayList<>();
JSONObject auditContent = new JSONObject();
auditContent.put("VideoId", "3ebc10160bda481ca9b6858a0b58****"); // 視頻ID
auditContent.put("Status", "Blocked"); // 審核狀態
auditContent.put("Reason", "含有淫穢色情內容"); // 若審核狀態為屏蔽時,需給出屏蔽的理由,最長支持128字節
auditContents.add(auditContent);
return auditContents.toString();
}
/**
* 人工審核
*/
public static CreateAuditResponse createAudit(DefaultAcsClient client) throws Exception {
CreateAuditRequest request = new CreateAuditRequest();
// 設置審核內容
request.setAuditContent(buildAuditContent());
// 返回結果
return client.getAcsResponse(request);
}
/**
* 以下為調用示例
* @param args
*/
public static void main(String[] args) throws Exception {
DefaultAcsClient client = initVodClient();
try {
// 提交人工審核結果
CreateAuditResponse response = createAudit(client);
// 打印請求ID
System.out.println("ResquestId:" + response.getRequestId());
} catch (Exception e) {
System.out.println("ErrorMessage:" + e.getLocalizedMessage());
}
}
獲取人工審核歷史
調用GetAuditHistory接口,完成獲取人工審核歷史功能。
阿里云OpenAPI門戶地址:GetAuditHistory。
設置審核安全IP
調用SetAuditSecurityIp接口,完成設置審核安全IP功能。
阿里云OpenAPI門戶地址:SetAuditSecurityIp。
獲取審核安全IP列表
調用ListAuditSecurityIp接口,完成獲取審核安全IP列表功能。
阿里云OpenAPI門戶地址:ListAuditSecurityIp。