本文介紹視頻理解(videorecog)類目下的視頻畫質評估EvaluateVideoQuality的語法及示例。

功能描述

視頻畫質評估可對輸入視頻的畫面質量進行評估,包括通用視頻畫質與瑕疵視頻質量。通用視頻畫質包括:主觀畫質評分、客觀畫質評分(清晰度、點狀噪聲、壓縮噪聲)、顏色質量評分(飽和度、豐富度、對比度、亮度評估)等。瑕疵視頻畫質包括:場紋檢測、劃痕檢測、異常幀檢測(卡幀、閃爍、黑屏花屏)等。

能力使用典型樣例請參見下表:

說明
  • 您可以進入在線咨詢獲取在線人工幫助。
  • 當前能力可在視覺智能開放平臺有完整的免費產品體驗,您可以單擊立即試用對該能力進行更直觀試用以及在線購買。
  • 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯系我們。

應用場景

  • 視頻畫質評估:標準化視頻評估工具集,包括各類無參考指標各項子工具,可服務于視頻轉碼、直播和增強等不同業務場景的畫質監控。
  • UGC畫質審核:用戶自定義上傳內容畫質把關,對UGC內容進行畫面質量檢測,對整體畫質較低、存在部分顯著問題的視頻進行篩選過濾。

特色優勢

  • 視頻質量評估:涵蓋各種主觀/客觀通用視頻畫質指標,提供全方面體系化的質量評估服務。
  • 視頻質量監測:涵蓋視頻中可能出現的各種技術瑕疵的畫質監測,保障視頻服務品質。

接入指引

1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。

2. 開通能力:請確保您已開通視頻理解服務,若未開通服務請立即開通

3. 創建AccessKey:請確保您已創建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權

4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。

5. 開發接入步驟:

  • SDK總覽中選擇您要接入使用的SDK語言。
  • 在對應語言的SDK文檔中找到AI類目為視頻理解(videorecog)類目的SDK包進行安裝。
  • 參考文檔中提供的示例代碼進行適當修改后調用。

6. 示例代碼:該能力常用語言的示例代碼,請參見視頻畫質評估示例代碼,常用語言查詢異步任務結果的示例代碼,請參見查詢異步任務結果示例代碼

7. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。

輸入限制

  • 視頻格式:MP4。
  • 視頻大小:不超過1 GB。
  • 視頻分辨率:不超過1080P,即長邊不超過1920像素,短邊不超過1080像素。
  • URL地址中不能包含中文字符。

計費說明

關于視頻畫質評估的計費方式及報價,請參見計費介紹

說明 下方調試接口為付費接口。

調用步驟

該能力為異步能力,需分兩步進行調用。

第一步調用EvaluateVideoQuality接口提交任務,請求成功后,得到一個任務ID。

第二步調用GetAsyncJobResult接口查詢結果,根據任務ID查詢任務執行狀態和結果。如果任務還在處理中,可稍等一段時間后再進行查詢。

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String EvaluateVideoQuality

系統規定參數。取值:EvaluateVideoQuality

VideoUrl String http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/Common/xxx/dont_delete/decaption/123.mp4

視頻URL地址。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理

Mode String vqa_plus

質量評估模式。取值如下:

  • general(默認):基礎質量評估。
  • vqa_plus:基礎質量評估及瑕疵質量評估。

返回數據

名稱 類型 示例值 描述
RequestId String 1d33e538-c949-4fcd-83f6-4d57e4b31527

請求ID。

Data Object

返回的數據內容。

該數據需要在異步任務執行成功后,通過調用GetAsyncJobResult接口,對其Result字段進行JSON反序列化之后得到。

JsonUrl String http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-13-10/31%3A08-cVeN9ZQlzIPfGqsa.json?Expires=1673578869&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=AiSsOsZ7rYfhf9w3Mxn%2Fq4GKKy****

質量評估詳細報告(JSON文件)。

說明 該URL地址為臨時地址,有效期為30分鐘,過期后將無法訪問。若需要長時間或者永久保存文件,請在30分鐘內訪問URL地址,下載文件轉存到自己的OSS或者其他存儲空間。
PdfUrl String http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-13-10/31%3A08-cVeN9ZQlzIPfGqsa.pdf?Expires=1673578869&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=xULlZzVuhoYWAXRbp9A4EzzZcS****

質量評估綜合報告(PDF文件)。

說明 該URL地址為臨時地址,有效期為30分鐘,過期后將無法訪問。若需要長時間或者永久保存文件,請在30分鐘內訪問URL地址,下載文件轉存到自己的OSS或者其他存儲空間。
VideoQualityInfo Object

視頻質量詳情。

CompressiveStrength Float 0.25

壓縮程度。

NoiseIntensity Float 0.01

噪聲程度。

Blurriness Float 0.15

模糊程度。

ColorContrast Float 0.55

對比度。

ColorSaturation Float 0.17

飽和度。

Luminance Float 0.51

亮度。

Colorfulness Float 0.48

顏色豐富度。

MosScore Float 0.7048

表示主觀質量評分。

Message String 該調用為異步調用,任務已提交成功,請以requestId的值作為jobId參數調用同類目下GetAsyncJobResult接口查詢任務執行狀態和結果。

提交異步任務后的提示信息。

查詢結果

該接口為異步接口,當前并未返回真實的請求結果,您需要通過返回的RequestId調用GetAsyncJobResult接口來獲取該接口的真實請求結果。詳情請參見GetAsyncJobResult

SDK參考

阿里云視覺AI視頻理解類目下的視頻畫質評估能力推薦使用SDK調用,支持多種編程語言,調用時請選擇AI類目為視頻理解(videorecog)的SDK包,文件參數通過SDK調用可支持本地文件及任意URL,具體可參見SDK總覽

示例代碼

該能力常用語言的示例代碼,請參見視頻畫質評估示例代碼,常用語言查詢異步任務結果的示例代碼,請參見查詢異步任務結果示例代碼

視頻畫質評估各項得分解析

算法返回JsonUrlPdfUrl兩個字段,其中PdfUrl為該視頻PDF格式的整體畫質評估綜合報告。JsonUrl為JSON格式的畫質評估詳細報告,包括各項畫質評估指標的采樣幀序列及各分鏡/幀分項得分,方便細致分析、處理視頻畫質問題。

JsonUrl文件參數樣例


{
	"fps": 25.0,
	"frame_num": 252,
	"duration": 10.08,
	"task_id": "2",
	"input_w": 640,
	"input_h": 480,
	"vqa_degradation_info": [{
		"noise_degree": 0.01,
		"blur_degree": 0.15,
		"comp_degree": 0.24,
		"clip": [0, 251],
		"duration": ["00:00:00", "00:00:10"]
	}],
	"vqa_mos_info": [
		[{
			"frame idx": 36,
			"image mos": 0.693
		}, {
			"frame idx": 72,
			"image mos": 0.696
		}, {
			"frame idx": 108,
			"image mos": 0.707
		}, {
			"frame idx": 144,
			"image mos": 0.702
		}, {
			"frame idx": 180,
			"image mos": 0.736
		}]
	],
	"vqa_color_quality_analysis_info": [{
		"contrast_score": 0.55,
		"luma_score": 0.49,
		"color_saturation_score": 0.17,
		"colorfulness_score": 0.45,
		"clip": [36, 180],
		"duration": ["00:00:01", "00:00:07"]
	}],
	"vqa_damaged_frame_info": {
		"frame_list": [],
		"confidence": 0.0
	},
	"vqa_interlace_frame_info": {
		"frame_list": [],
		"confidence": 0.0
	},
	"vqa_freeze_frame_info": {
		"frame_list": [],
		"confidence": 0.0
	},
	"vqa_flicker_frame_info": {
		"frame_list": [],
		"confidence": 0.0
	},
	"vqa_scratch_frame_info": {
		"frame_list": [104],
		"confidence": 0.012
	}
}

JsonUrl文件參數描述說明

視頻畫質評估參數取值說明

示例

請求示例

http(s)://videorecog.cn-shanghai.aliyuncs.com/?Action=EvaluateVideoQuality      //更多關于訪問域名(Endpoint)信息,請參見:http://bestwisewords.com/document_detail/143103.html
&VideoUrl=http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/Common/xxx/dont_delete/decaption/123.mp4
&Mode=vqa_plus
&公共請求參數

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<EvaluateVideoQualityResponse>
    <RequestId>1d33e538-c949-4fcd-83f6-4d57e4b31527</RequestId>
    <Message>該調用為異步調用,任務已提交成功,請以requestId的值作為jobId參數調用同類目下GetAsyncJobResult接口查詢任務執行狀態和結果。</Message>
</EvaluateVideoQualityResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "1d33e538-c949-4fcd-83f6-4d57e4b31527",
  "Message" : "該調用為異步調用,任務已提交成功,請以requestId的值作為jobId參數調用同類目下GetAsyncJobResult接口查詢任務執行狀態和結果。"
}

返回示例補充說明

//查詢結果:請求示例
http(s)://videorecog.cn-shanghai.aliyuncs.com/?Action=GetAsyncJobResult
&JobId=E75FE679-0303-4DD1-8252-1143B4FA8A27
&<公共請求參數>

//查詢結果:返回示例
{
  "RequestId" : "43A0AEB6-45F4-4138-8E89-E1A5D63200E3",
  "Data" : {
    "Status" : "PROCESS_SUCCESS",
    "JobId" : "186AC396-0EEC-46F1-AAA1-BF3585227427",
    "Result" : "{\"JsonUrl\" : \"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-13-10/31%3A08-cVeN9ZQlzIPfGqsa.json?Expires=1673578869&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=AiSsOsZ7rYfhf9w3Mxn%2Fq4GKKy****\",\"PdfUrl\" : \"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-13-10/31%3A08-cVeN9ZQlzIPfGqsa.pdf?Expires=1673578869&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=xULlZzVuhoYWAXRbp9A4EzzZcS****\",\"VideoQualityInfo\" : \"CompressiveStrength\" : 0.25,\"NoiseIntensity\" : 0.01,\"Blurriness\" : 0.15,\"ColorContrast\" : 0.55,\"ColorSaturation\" : 0.17,\"Luminance\" : 0.51,\"Colorfulness\" : 0.48,\"MosScore\" : 0.7048}"
  }
}

//Result反序列化
{
     "JsonUrl" : "http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-13-10/31%3A08-cVeN9ZQlzIPfGqsa.json?Expires=1673578869&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=AiSsOsZ7rYfhf9w3Mxn%2Fq4GKKy****",
    "PdfUrl" : "http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-13-10/31%3A08-cVeN9ZQlzIPfGqsa.pdf?Expires=1673578869&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=xULlZzVuhoYWAXRbp9A4EzzZcS****",
    "VideoQualityInfo" : [ {
      "CompressiveStrength" : 0.25,
      "NoiseIntensity" : 0.01,
      "Blurriness" : 0.15,
      "ColorContrast" : 0.55,
      "ColorSaturation" : 0.17,
      "Luminance" : 0.51,
      "Colorfulness" : 0.48,
      "MosScore" : 0.7048
    } ]
}

錯誤碼

關于視頻畫質評估的錯誤碼,詳情請參見常見錯誤碼

安全聲明

  • 請確保上傳的圖片或文件來源符合相應的法律法規。
  • 通過體驗調試上傳的臨時文件有效期為1小時,在24小時后會被系統自動清理刪除。