'1.0', 'info' => ['style' => 'RPC', 'product' => 'videorecog', 'version' => '2020-03-20'], 'directories' => [ [ 'children' => ['GenerateVideoCover', 'DetectVideoShot', 'RecognizeVideoCastCrewList', 'SplitVideoParts', 'EvaluateVideoQuality', 'GetAsyncJobResult'], 'type' => 'directory', 'title' => '视频理解', 'id' => 434555, ], ], 'components' => [ 'schemas' => [], ], 'apis' => [ 'DetectVideoShot' => [ 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'VideoUrl', 'in' => 'formData', 'schema' => ['description' => '视频URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videorecog/DetectVideoShot/DetectVideoShot2.mp4', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '0033B795-09C7-4EB9-A33C-EBA325192B0D'], 'Data' => [ 'description' => '返回的结果数据内容。'."\n" .'该数据需要在异步任务执行成功后,通过调用[GetAsyncJobResult](~~607824~~)接口,对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ 'ShotFrameIds' => [ 'description' => '1', 'type' => 'array', 'items' => ['description' => '解析结果,切分点帧号。', 'type' => 'integer', 'format' => 'int32', 'example' => '[0, 109, 185, 251, 341, 393, 468, 629, 715, 762, 1272, 1304, 1331, 1351, 1379, 1414, 1431, 1456, 1504, 1709, 1838, 1893, 1975, 2239, 2364, 2425, 2469, 2532, 2607, 2665, 2737, 2864, 2944, 2979, 2995]'], ], ], ], 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误,请检查参数值'], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败,请检查RAM权限配置,操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。 '], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"0033B795-09C7-4EB9-A33C-EBA325192B0D\\",\\n \\"Data\\": {\\n \\"ShotFrameIds\\": [\\n 0\\n ]\\n },\\n \\"Message\\": \\"该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 0033B795-09C7-4EB9-A33C-EBA325192B0D\\n 该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\n","errorExample":""}]', 'title' => '镜头解析', 'summary' => '镜头解析,对输入的视频按镜头进行切分,返回切分点。', 'description' => '## 功能描述'."\n" .'镜头解析能力可以对输入的视频按镜头进行切分,返回切分点。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videorecog&children=DetectVideoShot)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号:打开[阿里云官网](https://www.aliyun.com),在阿里云官网右上角,单击**立即注册**,按照操作提示完成账号注册。'."\n" .'2. 开通能力:请确保您已开通[视频理解服务](https://vision.aliyun.com/videorecog),若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videorecog_public_cn#/open)。'."\n" .'3. 创建AccessKey:请确保您已[创建AccessKey](~~175144~~),如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试(可选):您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videorecog/2020-03-20/DetectVideoShot?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideorecog%2FDetectVideoShot%2FDetectVideoShot1.mp4%22%7D&tab=DEMO)在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。'."\n" .'5. 开发接入步骤: '."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为视频理解(videorecog)类目的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码及最佳实践:该能力常用语言的示例代码及常见结果后续处理示例,请参见[镜头解析示例代码](~~465560~~),常用语言查询异步任务结果的示例代码,请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" ."\n" .'- 视频格式:MP4、RMVB、FLV、TS。'."\n" .'- 视频大小:不超过1 GB。'."\n" .'- 视频分辨率:不超过1080P。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" .'关于镜头解析的计费方式及报价,请参见[计费介绍](~~202485~~)。'."\n" ."\n" .'> 下方调试接口为付费接口。'."\n" ."\n" .'## 调用步骤'."\n" .'该能力为异步能力,需分两步进行调用。'."\n" .'第一步调用DetectVideoShot接口提交任务,请求成功后,得到一个任务ID。'."\n" .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果,根据任务ID查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## 查询结果'."\n" .'该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" .'阿里云视觉AI视频理解类目下的镜头解析能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为视频理解(videorecog)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码及最佳实践'."\n" .'该能力常用语言的示例代码及常见结果后续处理示例,请参见[镜头解析示例代码](~~465560~~),常用语言查询异步任务结果的示例代码,请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" .'关于镜头解析的错误码,详情请参见[常见错误码](~~159312~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。', 'changeSet' => [ ['createdAt' => '2022-10-17T02:07:20.000Z', 'description' => '响应参数发生变更'], ], 'ramActions' => [ [ 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-videorecog:DetectVideoShot', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], ], ], 'EvaluateVideoQuality' => [ 'summary' => '本文介绍视频理解(videorecog)类目下的视频画质评估EvaluateVideoQuality的语法及示例。', 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'VideoUrl', 'in' => 'formData', 'schema' => ['description' => '视频URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/Common/xxx/dont_delete/decaption/123.mp4', 'isFileTransferUrl' => true], ], [ 'name' => 'Mode', 'in' => 'formData', 'schema' => ['description' => '质量评估模式。取值如下:'."\n" .'- general(默认):基础质量评估。'."\n" .'- vqa_plus:基础质量评估及瑕疵质量评估。', 'type' => 'string', 'required' => false, 'example' => 'vqa_plus'], ], ], 'responses' => [ 200 => [ 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '1d33e538-c949-4fcd-83f6-4d57e4b31527'], 'Data' => [ 'description' => '返回的数据内容。'."\n" .'该数据需要在异步任务执行成功后,通过调用[GetAsyncJobResult](~~607824~~)接口,对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ 'JsonUrl' => ['description' => '质量评估详细报告(JSON文件)。'."\n" ."\n" .'> 该URL地址为临时地址,有效期为30分钟,过期后将无法访问。若需要长时间或者永久保存文件,请在30分钟内访问URL地址,下载文件转存到自己的OSS或者其他存储空间。'."\n", 'type' => 'string', 'example' => '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=LTAI****************&Signature=AiSsOsZ7rYfhf9w3Mxn%2Fq4GKKy****'], 'PdfUrl' => ['description' => '质量评估综合报告(PDF文件)。'."\n" ."\n" .'> 该URL地址为临时地址,有效期为30分钟,过期后将无法访问。若需要长时间或者永久保存文件,请在30分钟内访问URL地址,下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => '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=LTAI****************&Signature=xULlZzVuhoYWAXRbp9A4EzzZcS****'], 'VideoQualityInfo' => [ 'description' => '视频质量详情。', 'type' => 'object', 'properties' => [ 'CompressiveStrength' => ['description' => '压缩程度。', 'type' => 'number', 'format' => 'float', 'example' => '0.25'], 'NoiseIntensity' => ['description' => '噪声程度。', 'type' => 'number', 'format' => 'float', 'example' => '0.01'], 'Blurriness' => ['description' => '模糊程度。', 'type' => 'number', 'format' => 'float', 'example' => '0.15'], 'ColorContrast' => ['description' => '对比度。', 'type' => 'number', 'format' => 'float', 'example' => '0.55'], 'ColorSaturation' => ['description' => '饱和度。', 'type' => 'number', 'format' => 'float', 'example' => '0.17'], 'Luminance' => ['description' => '亮度。', 'type' => 'number', 'format' => 'float', 'example' => '0.51'], 'Colorfulness' => ['description' => '颜色丰富度。', 'type' => 'number', 'format' => 'float', 'example' => '0.48'], 'MosScore' => ['description' => '表示主观质量评分。', 'type' => 'number', 'format' => 'float', 'example' => '0.7048'], ], ], ], ], 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误,请检查参数值'], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败,请检查RAM权限配置,操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。 '], ], ], 'staticInfo' => ['returnType' => 'synchronous'], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1d33e538-c949-4fcd-83f6-4d57e4b31527\\",\\n \\"Data\\": {\\n \\"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&OSSAccessKeyId=LTAI****************&Signature=AiSsOsZ7rYfhf9w3Mxn%2Fq4GKKy****\\",\\n \\"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&OSSAccessKeyId=LTAI****************&Signature=xULlZzVuhoYWAXRbp9A4EzzZcS****\\",\\n \\"VideoQualityInfo\\": {\\n \\"CompressiveStrength\\": 0.25,\\n \\"NoiseIntensity\\": 0.01,\\n \\"Blurriness\\": 0.15,\\n \\"ColorContrast\\": 0.55,\\n \\"ColorSaturation\\": 0.17,\\n \\"Luminance\\": 0.51,\\n \\"Colorfulness\\": 0.48,\\n \\"MosScore\\": 0.7048\\n }\\n },\\n \\"Message\\": \\"该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 1d33e538-c949-4fcd-83f6-4d57e4b31527\\n 该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\n","errorExample":""}]', 'title' => '视频画质评估', 'description' => '## 功能描述'."\n" .'视频画质评估可对输入视频的画面质量进行评估,包括通用视频画质与瑕疵视频质量。通用视频画质包括:主观画质评分、客观画质评分(清晰度、点状噪声、压缩噪声)、颜色质量评分(饱和度、丰富度、对比度、亮度评估)等。瑕疵视频画质包括:场纹检测、划痕检测、异常帧检测(卡帧、闪烁、黑屏花屏)等。'."\n" .'能力使用典型样例请参见下表:'."\n" .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230223/yohg/EvaluateVideoQuality.png)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击[立即试用](https://vision.aliyun.com/experience/detail?tagName=videorecog&children=EvaluateVideoQuality)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" .'- 视频画质评估:标准化视频评估工具集,包括各类无参考指标各项子工具,可服务于视频转码、直播和增强等不同业务场景的画质监控。'."\n" .'- UGC画质审核:用户自定义上传内容画质把关,对UGC内容进行画面质量检测,对整体画质较低、存在部分显著问题的视频进行筛选过滤。'."\n" ."\n" .'## 特色优势'."\n" .'- 视频质量评估:涵盖各种主观/客观通用视频画质指标,提供全方面体系化的质量评估服务。'."\n" .'- 视频质量监测:涵盖视频中可能出现的各种技术瑕疵的画质监测,保障视频服务品质。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号:打开[阿里云官网](https://www.aliyun.com),在阿里云官网右上角,单击**立即注册**,按照操作提示完成账号注册。'."\n" .'2. 开通能力:请确保您已开通[视频理解服务](https://vision.aliyun.com/videorecog),若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videorecog_public_cn#/open)。'."\n" .'3. 创建AccessKey:请确保您已[创建AccessKey](~~175144~~),如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试(可选):您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videorecog/2020-03-20/EvaluateVideoQuality?lang=JAVA&useCommon=true)在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。'."\n" .'5. 开发接入步骤:'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为视频理解(videorecog)类目的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码:该能力常用语言的示例代码,请参见[视频画质评估示例代码](~~608851~~),常用语言查询异步任务结果的示例代码,请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" .'- 视频格式:MP4。'."\n" .'- 视频大小:不超过1 GB。'."\n" .'- 视频分辨率:不超过1080P,即长边不超过1920像素,短边不超过1080像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" .'关于视频画质评估的计费方式及报价,请参见[计费介绍](~~202485~~)。'."\n" ."\n" .'> 下方调试接口为付费接口。'."\n" ."\n" .'## 调用步骤'."\n" .'该能力为异步能力,需分两步进行调用。'."\n" .'第一步调用EvaluateVideoQuality接口提交任务,请求成功后,得到一个任务ID。'."\n" .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果,根据任务ID查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。', 'responseParamsDescription' => '## 查询结果'."\n" .'该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" .'阿里云视觉AI视频理解类目下的视频画质评估能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为视频理解(videorecog)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码,请参见[视频画质评估示例代码](~~608851~~),常用语言查询异步任务结果的示例代码,请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'## 视频画质评估各项得分解析'."\n" .'算法返回**JsonUrl**和**PdfUrl**两个字段,其中**PdfUrl**为该视频PDF格式的整体画质评估综合报告。**JsonUrl**为JSON格式的画质评估详细报告,包括各项画质评估指标的采样帧序列及各分镜/帧分项得分,方便细致分析、处理视频画质问题。'."\n" ."\n" .'## JsonUrl文件参数样例'."\n" ."\n" .'```'."\n" .'{'."\n" .' "fps": 25.0,'."\n" .' "frame_num": 252,'."\n" .' "duration": 10.08,'."\n" .' "task_id": "2",'."\n" .' "input_w": 640,'."\n" .' "input_h": 480,'."\n" .' "vqa_degradation_info": [{'."\n" .' "noise_degree": 0.01,'."\n" .' "blur_degree": 0.15,'."\n" .' "comp_degree": 0.24,'."\n" .' "clip": [0, 251],'."\n" .' "duration": ["00:00:00", "00:00:10"]'."\n" .' }],'."\n" .' "vqa_mos_info": ['."\n" .' [{'."\n" .' "frame idx": 36,'."\n" .' "image mos": 0.693'."\n" .' }, {'."\n" .' "frame idx": 72,'."\n" .' "image mos": 0.696'."\n" .' }, {'."\n" .' "frame idx": 108,'."\n" .' "image mos": 0.707'."\n" .' }, {'."\n" .' "frame idx": 144,'."\n" .' "image mos": 0.702'."\n" .' }, {'."\n" .' "frame idx": 180,'."\n" .' "image mos": 0.736'."\n" .' }]'."\n" .' ],'."\n" .' "vqa_color_quality_analysis_info": [{'."\n" .' "contrast_score": 0.55,'."\n" .' "luma_score": 0.49,'."\n" .' "color_saturation_score": 0.17,'."\n" .' "colorfulness_score": 0.45,'."\n" .' "clip": [36, 180],'."\n" .' "duration": ["00:00:01", "00:00:07"]'."\n" .' }],'."\n" .' "vqa_damaged_frame_info": {'."\n" .' "frame_list": [],'."\n" .' "confidence": 0.0'."\n" .' },'."\n" .' "vqa_interlace_frame_info": {'."\n" .' "frame_list": [],'."\n" .' "confidence": 0.0'."\n" .' },'."\n" .' "vqa_freeze_frame_info": {'."\n" .' "frame_list": [],'."\n" .' "confidence": 0.0'."\n" .' },'."\n" .' "vqa_flicker_frame_info": {'."\n" .' "frame_list": [],'."\n" .' "confidence": 0.0'."\n" .' },'."\n" .' "vqa_scratch_frame_info": {'."\n" .' "frame_list": [104],'."\n" .' "confidence": 0.012'."\n" .' }'."\n" .'}'."\n" .'```'."\n" ."\n" .'## JsonUrl文件参数描述说明'."\n" .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230224/hrdf/EvaluateVideoQualityjsonurl.png)'."\n" ."\n" .'## 视频画质评估参数取值说明'."\n" .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230224/tjrb/EvaluateVideoQualitycanshu.png)', 'extraInfo' => '## 错误码'."\n" .'关于视频画质评估的错误码,详情请参见[常见错误码](~~159312~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。', 'changeSet' => [], ], 'GenerateVideoCover' => [ 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'VideoUrl', 'in' => 'formData', 'schema' => ['description' => '视频URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videorecog/videorecog/videorecog1.mp4', 'isFileTransferUrl' => true], ], [ 'name' => 'IsGif', 'in' => 'formData', 'schema' => ['description' => '是否输出GIF格式的封面。true表示输出GIF格式封面,false表示输出普通图片封面。', 'type' => 'boolean', 'required' => true, 'example' => 'false'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '5B95B724-C5B9-4F77-A743-0CA4EA95CC82'], 'Data' => [ 'description' => '返回的结果数据内容。'."\n" .'该数据需要在异步任务执行成功后,通过调用[GetAsyncJobResult](~~607824~~)接口,对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ 'Outputs' => [ 'description' => '返回信息列表,每个元素是一张封面图,可能返回多张封面图。成功时有返回信息。'."\n" ."\n", 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'ImageURL' => ['description' => '输出封面图像的URL地址。'."\n" .'> 该URL地址为临时地址,有效期为30分钟,过期后将无法访问。', 'type' => 'string', 'example' => 'http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-cover/2020-05-11-07/pic_lOyxGGAqQYSANGxP.mp4_202_544_960_c9f88b2a5f75e17c093d1a65f5edff4d_beautified.png?Expires=1589185385&OSSAccessKeyId=LTAI****************&Signature=PAalKsfeZC4UQzYDTU%2F3D1G7Xt****'], 'Confidence' => ['description' => '置信度,值越高表示可信度越高。', 'type' => 'number', 'format' => 'float', 'example' => '6.1819260887924425'], ], 'description' => '', ], ], ], ], 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误,请检查参数值'], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败,请检查RAM权限配置,操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。 '], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"5B95B724-C5B9-4F77-A743-0CA4EA95CC82\\",\\n \\"Data\\": {\\n \\"Outputs\\": [\\n {\\n \\"ImageURL\\": \\"http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-cover/2020-05-11-07/pic_lOyxGGAqQYSANGxP.mp4_202_544_960_c9f88b2a5f75e17c093d1a65f5edff4d_beautified.png?Expires=1589185385&OSSAccessKeyId=LTAI****************&Signature=PAalKsfeZC4UQzYDTU%2F3D1G7Xt****\\",\\n \\"Confidence\\": 6.1819260887924425\\n }\\n ]\\n },\\n \\"Message\\": \\"该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 5B95B724-C5B9-4F77-A743-0CA4EA95CC82\\n 该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\n","errorExample":""}]', 'title' => '视频封面', 'summary' => '本文介绍视频封面GenerateVideoCover的语法及示例。', 'description' => '## 功能描述'."\n" .'视频封面能力可以检测输入的视频,输出多个视频封面。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击[立即试用](https://vision.aliyun.com/experience/detail?b&tagName=videorecog&children=GenerateVideoCover)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号:打开[阿里云官网](https://www.aliyun.com),在阿里云官网右上角,单击**立即注册**,按照操作提示完成账号注册。'."\n" .'2. 开通能力:请确保您已开通[视频理解服务](https://vision.aliyun.com/videorecog),若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videorecog_public_cn#/open)。'."\n" ."\n" .'3. 创建AccessKey:请确保您已[创建AccessKey](~~175144~~),如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试(可选):您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videorecog/2020-03-20/GenerateVideoCover?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideorecog%2Fvideorecog%2Fvideorecog1.mp4%22%2C%22IsGif%22%3Afalse%7D&tab=DEMO)在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。'."\n" ."\n" .'5. 开发接入步骤: '."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为视频理解(videorecog)类目的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码:该能力常用语言查询异步任务结果的示例代码,请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" ."\n" .'- 视频格式:MP4、RMVB、FLV、TS。'."\n" .'- 视频大小:不超过1 GB。'."\n" .'- 视频分辨率:不超过1080P。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" .'关于视频封面的计费方式及报价,请参见[计费介绍](~~202485~~)。'."\n" .'> 下方调试接口为付费接口。'."\n" ."\n" .'## 调用步骤'."\n" .'该能力为异步能力,需分两步进行调用。'."\n" .'第一步调用GenerateVideoCover接口提交任务,请求成功后,得到一个任务ID。'."\n" .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果,根据任务ID查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## 查询结果'."\n" .'该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" .'阿里云视觉AI视频理解类目下的视频封面能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为视频理解(videorecog)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言查询异步任务结果的示例代码,请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" .'关于视频封面的错误码,详情请参见[常见错误码](~~159312~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。'."\n", 'changeSet' => [], ], 'GetAsyncJobResult' => [ 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => ['operationType' => 'create'], 'parameters' => [ [ 'name' => 'JobId', 'in' => 'formData', 'schema' => ['description' => '输入异步接口返回的RequestId,输入后可以查询异步接口的真实请求结果。', 'type' => 'string', 'required' => true, 'example' => 'B6590005-5E7C-4A25-8F97-4479888D8271'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '0E448D84-1736-1BCD-BEA5-866C413515A1'], 'Data' => [ 'description' => '返回的数据内容。', 'type' => 'object', 'properties' => [ 'Status' => ['description' => '异步任务状态。包括:'."\n" ."\n" .'- QUEUING:任务排队中'."\n" .'- PROCESSING:异步处理中'."\n" .'- PROCESS_SUCCESS:处理成功'."\n" .'- PROCESS_FAILED:处理失败'."\n" .'- TIMEOUT_FAILED:任务超时未处理完成'."\n" .'- LIMIT_RETRY_FAILED:超过最大重试次数', 'type' => 'string', 'example' => 'PROCESS_SUCCESS'], 'ErrorMessage' => ['description' => '异步任务错误码信息。', 'type' => 'string', 'example' => 'paramsIllegal'], 'Result' => ['description' => '异步任务返回的真实请求结果。', 'type' => 'string', 'example' => '"{\\"jsonUrl\\":\\"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.json?Expires=1673425915&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=iW07EIZaqaiMNoF3RJZwsLVxOx****\\",\\"pdfUrl\\":\\"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.pdf?Expires=1673425916&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=BvZ3ayeTTxaR65ZvQ2%2FoE8W8Lr****\\"}"'], 'ErrorCode' => ['description' => '异步任务错误码。', 'type' => 'string', 'example' => 'InvalidParameter'], 'JobId' => ['description' => '异步任务ID。', 'type' => 'string', 'example' => 'A421D5F0-4F73-19F5-8D92-D509FAD281D2'], ], ], ], ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误,请检查参数值'], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败,请检查RAM权限配置,操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。 '], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"0E448D84-1736-1BCD-BEA5-866C413515A1\\",\\n \\"Data\\": {\\n \\"Status\\": \\"PROCESS_SUCCESS\\",\\n \\"ErrorMessage\\": \\"paramsIllegal\\",\\n \\"Result\\": \\"\\\\\\"{\\\\\\\\\\\\\\"jsonUrl\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.json?Expires=1673425915&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=iW07EIZaqaiMNoF3RJZwsLVxOx****\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"pdfUrl\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.pdf?Expires=1673425916&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=BvZ3ayeTTxaR65ZvQ2%2FoE8W8Lr****\\\\\\\\\\\\\\"}\\\\\\"\\",\\n \\"ErrorCode\\": \\"InvalidParameter\\",\\n \\"JobId\\": \\"A421D5F0-4F73-19F5-8D92-D509FAD281D2\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 0E448D84-1736-1BCD-BEA5-866C413515A1\\n \\n PROCESS_SUCCESS\\n A421D5F0-4F73-19F5-8D92-D509FAD281D2\\n {\\"jsonUrl\\":\\"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.json?Expires=1673425915&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=iW07EIZaqaiMNoF3RJZwsLVxOx****\\",\\"pdfUrl\\":\\"http://vibktprfx-prod-prod-damo-eas-cn-shanghai.oss-cn-shanghai.aliyuncs.com/eas-video-quality-assessment/2023-01-11-16/01%3A52-crxCR763VXTeY0bP.pdf?Expires=1673425916&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=BvZ3ayeTTxaR65ZvQ2%2FoE8W8Lr****\\"}\\n \\n","errorExample":""}]', 'title' => '查询异步任务结果', 'summary' => '本文介绍查询异步任务结果GetAsyncJobResult的语法及示例。', 'description' => '## 功能描述'."\n" .'针对异步接口,调用API接口后,返回的并不是真正的请求结果,您需要保存返回结果中的RequestId,然后调用GetAsyncJobResult来获取真正的请求结果。'."\n" ."\n" .'> - 异步任务的文件有过期时间,有效期是30分钟。如需长期使用,需及时将文件下载到本地服务器或存储在OSS中。有关OSS更多操作信息,请参见[上传文件](~~31886~~)。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 访问域名'."\n" .'| Region中文名称 | Region英文名称| 外网Endpoint | 支持HTTPS |'."\n" .'| ------ | ------ | ------ | ------ |'."\n" .'| 华东2(上海) | cn-shanghai | viapi.cn-shanghai.aliyuncs.com | 是 |', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" .'阿里云视觉AI能力推荐使用SDK调用,支持多种编程语言,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" .'关于查询异步任务结果的错误码,详情请参见[常见错误码](~~606865~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。'."\n", 'changeSet' => [], ], 'RecognizeVideoCastCrewList' => [ 'summary' => '本文介绍视频OCR RecognizeVideoCastCrewList的语法及示例。', 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'VideoUrl', 'in' => 'formData', 'schema' => ['description' => '视频URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'https://shanghai.oss-cn-shanghai.aliyuncs.com/download/xxxx.mp4', 'isFileTransferUrl' => true], ], [ 'name' => 'Params', 'in' => 'formData', 'style' => 'json', 'schema' => [ 'description' => '场景结果输出功能参数控制。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Type' => ['description' => '视频信息提取类型:'."\n" .'- subtitles:字幕提取。'."\n" .'- cast:演职员表提取。', 'type' => 'string', 'required' => false, 'example' => 'cast'], ], 'required' => false, 'description' => '', ], 'required' => false, ], ], ], 'responses' => [ 200 => [ 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'EE5B1A95-064F-1C5E-A6FE-FEE0D734A632'], 'Data' => [ 'description' => '返回的数据内容。'."\n" .'该数据需要在异步任务执行成功后,通过调用[GetAsyncJobResult](~~607824~~)接口,对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ 'OcrResults' => [ 'description' => '3帧/秒文本识别结果。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'DetailInfo' => [ 'description' => '详细内容。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Boxes' => [ 'description' => '文本位置矩形框坐标,坐标顺序为\\[xmin,ymin,xmax,ymax]。', 'type' => 'array', 'items' => ['description' => '文本位置矩形框坐标,坐标顺序为\\[xmin,ymin,xmax,ymax]。', 'type' => 'integer', 'format' => 'int32', 'example' => '[452,27,505,46]'], ], 'CharProbs' => [ 'description' => '文本单个字符对应识别置信度,取值范围0~1.0。', 'type' => 'array', 'items' => [ 'description' => '文本单个字符对应识别置信度,取值范围0~1.0。', 'type' => 'array', 'items' => ['description' => '文本单个字符对应识别置信度,取值范围0~1.0。', 'type' => 'number', 'format' => 'float', 'example' => '0.9405716061592102'], ], ], 'FrameIndex' => ['description' => '视频帧序号。', 'type' => 'integer', 'format' => 'int64', 'example' => '17'], 'Position' => [ 'description' => '文本位置矩形框点坐标\\[左上,右上,右下,左下]。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'X' => ['description' => '水平方向坐标,对应视频宽度,单位:像素。', 'type' => 'integer', 'format' => 'int64', 'example' => '266'], 'Y' => ['description' => '垂直方向坐标,对应视频高度,单位:像素。', 'type' => 'integer', 'format' => 'int64', 'example' => '440'], ], 'description' => '', ], ], 'Score' => ['description' => '文本识别结果置信度,取值范围:0~100。'."\n" ."\n" .'> Score=100×TextProb。', 'type' => 'number', 'format' => 'float', 'example' => '92.07685702563117'], 'TextProb' => ['description' => '文本识别结果置信度,取值范围:0~1.0。', 'type' => 'number', 'format' => 'float', 'example' => '0.9207685702563116'], 'TimeStamp' => ['description' => '视频帧时间戳,单位:秒。', 'type' => 'number', 'format' => 'float', 'example' => '0.28'], 'TrackId' => ['description' => '跟踪分配ID序号。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], 'Text' => ['description' => '文本识别结果。', 'type' => 'string', 'example' => '总策划'], ], 'description' => '', ], ], 'EndTime' => ['description' => '视频帧截止时间戳,单位:秒。', 'type' => 'number', 'format' => 'float', 'example' => '0.28'], 'StartTime' => ['description' => '视频帧开始时间戳,单位:秒。', 'type' => 'number', 'format' => 'float', 'example' => '0.28'], ], 'description' => '', ], ], 'VideoOcrResults' => [ 'description' => '视频clip级文本识别结果。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'DetailInfo' => [ 'description' => '详细内容。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Boxes' => [ 'description' => '文本位置矩形框坐标,坐标顺序为\\[xmin,ymin,xmax,ymax]。', 'type' => 'array', 'items' => ['description' => '文本位置矩形框坐标,坐标顺序为\\[xmin,ymin,xmax,ymax]。', 'type' => 'integer', 'format' => 'int64', 'example' => '[266,440,314,476]'], ], 'Position' => [ 'description' => '文本位置矩形框点坐标\\[左上,右上,右下,左下]。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'X' => ['description' => '水平方向坐标,对应视频宽度,单位:像素。', 'type' => 'integer', 'format' => 'int64', 'example' => '269'], 'Y' => ['description' => '垂直方向坐标,对应视频高度,单位:像素。', 'type' => 'integer', 'format' => 'int64', 'example' => '423'], ], 'description' => '', ], ], 'Score' => ['description' => '文本识别结果置信度,取值范围:0~100。', 'type' => 'number', 'format' => 'float', 'example' => '92.07685702563117'], 'Text' => ['description' => '文本识别结果。', 'type' => 'string', 'example' => '总顾问'], 'TextType' => ['description' => '文本类型。取值如下:'."\n" ."\n" .'- 0:正常字幕'."\n" .'- 1:滚动字幕'."\n" .'- 2:定长标识性字幕', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], ], 'description' => '', ], ], 'EndTime' => ['description' => '视频帧截止时间戳,单位:秒。', 'type' => 'number', 'format' => 'float', 'example' => '0.92'], 'StartTime' => ['description' => '视频帧开始时间戳,单位:秒。', 'type' => 'number', 'format' => 'float', 'example' => '0.92'], ], 'description' => '', ], ], 'SubtitlesResults' => [ 'description' => '字幕识别结果。', 'type' => 'array', 'items' => [ 'description' => '字幕识别结果。', 'type' => 'object', 'properties' => [ 'SubtitlesAllResults' => [ 'description' => '字幕识别中英文全部识别结果。', 'type' => 'object', 'additionalProperties' => ['type' => 'string', 'example' => '[]', 'description' => '字幕识别中英文全部识别结果。'], ], 'SubtitlesAllResultsUrl' => ['description' => '中英文字幕识别对应的标准SRT格式文件下载地址。', 'type' => 'string', 'example' => 'url'], 'SubtitlesChineseResults' => [ 'description' => '字幕识别中文识别结果。', 'type' => 'object', 'additionalProperties' => ['type' => 'string', 'description' => '字幕识别中文识别结果。', 'example' => '你好'], ], 'SubtitlesChineseResultsUrl' => ['description' => '中文字幕识别对应的标准SRT格式文件下载地址。', 'type' => 'string', 'example' => 'url1'], 'SubtitlesEnglishResults' => ['description' => '字幕识别英文识别结果。', 'type' => 'object', 'example' => 'hello'], 'SubtitlesEnglishResultsUrl' => ['description' => '英文字幕识别对应的标准SRT格式文件下载地址。', 'type' => 'string', 'example' => 'url2'], ], ], ], 'CastResults' => [ 'description' => '演职员表识别结果。', 'type' => 'array', 'items' => [ 'description' => '演职员表识别结果。', 'type' => 'object', 'properties' => [ 'DetailInfo' => [ 'description' => '详细内容。', 'type' => 'object', 'additionalProperties' => ['type' => 'string', 'description' => '详细内容。', 'example' => 'cast'], ], 'EndTime' => ['description' => '视频帧截止时间戳,单位:秒。', 'type' => 'number', 'format' => 'float', 'example' => '0.6'], 'StartTime' => ['description' => '视频帧截止时间戳,单位:秒。', 'type' => 'number', 'format' => 'float', 'example' => '0.6'], ], ], ], 'OcrResultsUrl' => ['description' => 'OcrResults结果的详细完整内容,即3帧/秒的识别结果。'."\n" .'> 该字段废弃,返回为空。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-media-ai-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-ocr/1665475907_bGHMygKsFw.json?Expires=1665477707&OSSAccessKeyId=LTAI****************&Signature=6KQb9OXQldsg30w%2FNurHwAbjiJs%3D'], 'OcrVideoResultsUrl' => ['description' => 'OcrVideoResults结果的详细完整内容。'."\n" .'> 该字段废弃,返回为空。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-media-ai-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-ocr/1665475907_VSRvetTHon.json?Expires=1665477707&OSSAccessKeyId=LTAI****************&Signature=wfQviVVSyVRLPVlHDKXi6cTefHY%3D'], ], ], 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误,请检查参数值'], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败,请检查RAM权限配置,操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。 '], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EE5B1A95-064F-1C5E-A6FE-FEE0D734A632\\",\\n \\"Data\\": {\\n \\"OcrResults\\": [\\n {\\n \\"DetailInfo\\": [\\n {\\n \\"Boxes\\": [\\n 0\\n ],\\n \\"CharProbs\\": [\\n [\\n 0.9405716061592102\\n ]\\n ],\\n \\"FrameIndex\\": 17,\\n \\"Position\\": [\\n {\\n \\"X\\": 266,\\n \\"Y\\": 440\\n }\\n ],\\n \\"Score\\": 92.07685702563117,\\n \\"TextProb\\": 0.9207685702563116,\\n \\"TimeStamp\\": 0.28,\\n \\"TrackId\\": 1,\\n \\"Text\\": \\"总策划\\"\\n }\\n ],\\n \\"EndTime\\": 0.28,\\n \\"StartTime\\": 0.28\\n }\\n ],\\n \\"VideoOcrResults\\": [\\n {\\n \\"DetailInfo\\": [\\n {\\n \\"Boxes\\": [\\n 0\\n ],\\n \\"Position\\": [\\n {\\n \\"X\\": 269,\\n \\"Y\\": 423\\n }\\n ],\\n \\"Score\\": 92.07685702563117,\\n \\"Text\\": \\"总顾问\\",\\n \\"TextType\\": 0\\n }\\n ],\\n \\"EndTime\\": 0.92,\\n \\"StartTime\\": 0.92\\n }\\n ],\\n \\"SubtitlesResults\\": [\\n {\\n \\"SubtitlesAllResults\\": {\\n \\"key\\": \\"[]\\"\\n },\\n \\"SubtitlesAllResultsUrl\\": \\"url\\",\\n \\"SubtitlesChineseResults\\": {\\n \\"key\\": \\"你好\\"\\n },\\n \\"SubtitlesChineseResultsUrl\\": \\"url1\\",\\n \\"SubtitlesEnglishResults\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n },\\n \\"SubtitlesEnglishResultsUrl\\": \\"url2\\"\\n }\\n ],\\n \\"CastResults\\": [\\n {\\n \\"DetailInfo\\": {\\n \\"key\\": \\"cast\\"\\n },\\n \\"EndTime\\": 0.6,\\n \\"StartTime\\": 0.6\\n }\\n ],\\n \\"OcrResultsUrl\\": \\"http://vibktprfx-prod-prod-media-ai-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-ocr/1665475907_bGHMygKsFw.json?Expires=1665477707&OSSAccessKeyId=LTAI****************&Signature=6KQb9OXQldsg30w%2FNurHwAbjiJs%3D\\",\\n \\"OcrVideoResultsUrl\\": \\"http://vibktprfx-prod-prod-media-ai-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-ocr/1665475907_VSRvetTHon.json?Expires=1665477707&OSSAccessKeyId=LTAI****************&Signature=wfQviVVSyVRLPVlHDKXi6cTefHY%3D\\"\\n },\\n \\"Message\\": \\"该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"\\n EE5B1A95-064F-1C5E-A6FE-FEE0D734A632\\n \\n \\n \\n \\n <0>0.9405716\\n \\n 17\\n \\n 266\\n 440\\n \\n 92.07686\\n 0.92076856\\n 0.28\\n 1\\n 总策划\\n \\n 0.28\\n 0.28\\n \\n \\n \\n \\n 269\\n 423\\n \\n 92.07686\\n 总顾问\\n 0\\n \\n 0.92\\n 0.92\\n \\n \\n \\n []\\n \\n url\\n \\n 你好\\n \\n url1\\n url2\\n \\n \\n \\n cast\\n \\n 0.6\\n 0.6\\n \\n http://vibktprfx-prod-prod-media-ai-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-ocr/1665475907_bGHMygKsFw.json?Expires=1665477707&OSSAccessKeyId=LTAI****************&Signature=6KQb9OXQldsg30w%2FNurHwAbjiJs%3D\\n http://vibktprfx-prod-prod-media-ai-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-ocr/1665475907_VSRvetTHon.json?Expires=1665477707&OSSAccessKeyId=LTAI****************&Signature=wfQviVVSyVRLPVlHDKXi6cTefHY%3D\\n \\n 该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\n","errorExample":""}]', 'title' => '视频OCR', 'description' => '## 功能描述'."\n" .'视频OCR能力可以识别视频中的文本,可涵盖新闻、影视剧、娱乐、体育等多场景的中英文、繁简体、比分等识别,支持普通字幕、定常字幕、滚动字幕、部分自然场景文字、竖排文字及艺术字等多种类型。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videorecog&children=RecognizeVideoCastCrewList)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" ."\n" .'- 影视字幕识别:对电影、电视剧等长视频中的配音字幕进行识别,包括时间戳与对应文本内容,从而实现外挂字幕生成、敏感内容识别审核等需求。'."\n" .'- 演职员表识别:识别影视剧内容片尾滚动字幕中的演职员表信息,用于视频信息校对、敏感人物查询等场景。'."\n" .'- 体育文字识别:在体育赛事场景中识别文本内容,包括比分、广告文字等,实现赛事状态分析、广告查询监播等场景。'."\n" ."\n" .'## 特色优势'."\n" ."\n" .'- 覆盖视频类型广:支持多种不同视频类型。'."\n" .'- 支持文字种类多:支持普通字幕、定常字幕、滚动字幕、部分自然场景文字、竖排文字及艺术字等多种类型。'."\n" .'- 识别准确性高:对低分辨率、复杂场景等均有较好的识别准确性。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号:打开[阿里云官网](https://www.aliyun.com),在阿里云官网右上角,单击**立即注册**,按照操作提示完成账号注册。'."\n" .'2. 开通能力:请确保您已开通[视频理解服务](https://vision.aliyun.com/videorecog),若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videorecog_public_cn#/open)。'."\n" .'3. 创建AccessKey:请确保您已[创建AccessKey](~~175144~~),如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试(可选):您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videorecog/2020-03-20/RecognizeVideoCastCrewList?lang=JAVA)在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。'."\n" .'5. 开发接入步骤:'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为视频理解(videorecog)类目的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码:该能力常用语言的示例代码,请参见[视频OCR示例代码](~~477832~~),常用语言查询异步任务结果的示例代码,请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" ."\n" .'- 视频格式:AVI、FLV、MKV、MPG、MP4、TS、MOV、MXF。'."\n" .'- 编码格式:MPEG-2、MPEG-4、H.264、H.265/HEVC。'."\n" .'- 视频大小:不超过10 GB。'."\n" .'- 视频分辨率:不低于240P。'."\n" .'- URL地址中不能包含中文字符。'."\n" .'- 建议输入的视频长度不超过30分钟,否则会容易导致处理超时报错。'."\n" ."\n" .'## 计费说明'."\n" .'关于视频OCR的计费方式及报价,请参见[计费介绍](~~202485~~)。'."\n" ."\n" .'> 下方调试接口为付费接口。'."\n" ."\n" .'## 调用步骤'."\n" .'该能力为异步能力,需分两步进行调用。'."\n" .'第一步调用RecognizeVideoCastCrewList接口提交任务,请求成功后,得到一个任务ID。'."\n" .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果,根据任务ID查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。', 'responseParamsDescription' => '## 查询结果'."\n" .'该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" .'阿里云视觉AI视频理解类目下的视频OCR能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为视频理解(videorecog)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码,请参见[视频OCR示例代码](~~477832~~),常用语言查询异步任务结果的示例代码,请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" .'关于视频OCR的错误码,详情请参见[常见错误码](~~159312~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。', 'changeSet' => [ ['createdAt' => '2022-10-17T02:07:20.000Z', 'description' => '响应参数发生变更'], ['createdAt' => '2022-10-12T01:52:43.000Z', 'description' => '响应参数发生变更'], ['createdAt' => '2022-09-29T08:01:40.000Z', 'description' => '请求参数发生变更'], ['createdAt' => '2022-09-27T09:42:20.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], ['createdAt' => '2022-06-28T06:39:56.000Z', 'description' => 'OpenAPI 下线'], ], 'ramActions' => [ [ 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-videorecog:RecognizeVideoCastCrewList', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], ], ], 'SplitVideoParts' => [ 'summary' => '本文介绍视频拆条SplitVideoParts的语法及示例。', 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'VideoUrl', 'in' => 'formData', 'schema' => ['description' => '视频URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ocr/xxxx.mp4', 'isFileTransferUrl' => true], ], [ 'name' => 'Template', 'in' => 'formData', 'schema' => ['description' => '拆条模板,当前只支持`live`模板。', 'type' => 'string', 'required' => false, 'example' => 'live'], ], [ 'name' => 'MinTime', 'in' => 'formData', 'schema' => ['description' => '拆条最小长度,单位为秒,用户可以根据实际业务需求进行灵活配置,也可以不配置。'."\n" .'> 该入参的设置,只对拆条结果SplitVideoPartResults(视频主题进行拆条)有效,不影响Elements(视频镜头转场维度)的结果。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'], ], [ 'name' => 'MaxTime', 'in' => 'formData', 'schema' => ['description' => ' 拆条最大长度,单位为秒,用户可以根据实际业务需求进行灵活配置,也可以不配置。'."\n" .'> 该入参的设置,只对拆条结果SplitVideoPartResults(视频主题进行拆条)有效,不影响Elements(视频镜头转场维度)的结果。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '20'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'A00A3C17-61D5-1489-860D-B709F83A7C40'], 'Data' => [ 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后,通过调用[GetAsyncJobResult](~~607824~~)接口,对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ 'Elements' => [ 'description' => '针对视频镜头转场维度进行拆条。', 'type' => 'array', 'items' => [ 'description' => '针对视频镜头转场维度进行拆条。', 'type' => 'object', 'properties' => [ 'BeginTime' => ['description' => '该片段的起始时刻,单位:秒。', 'type' => 'number', 'format' => 'float', 'example' => '10.06'], 'EndTime' => ['description' => '该片段的结束时刻,单位:秒。', 'type' => 'number', 'format' => 'float', 'example' => '17.3'], 'Index' => ['description' => '片段序号。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], ], ], ], 'SplitVideoPartResults' => [ 'description' => '针对视频主题进行拆条。', 'type' => 'array', 'items' => [ 'description' => '视频拆条结果。', 'type' => 'object', 'properties' => [ 'BeginTime' => ['description' => '拆条起始时间点。', 'type' => 'number', 'format' => 'float', 'example' => '0.33'], 'EndTime' => ['description' => '拆条结束时间点。', 'type' => 'number', 'format' => 'float', 'example' => '6.3'], 'Theme' => ['description' => '拆条主题。', 'type' => 'string', 'example' => 'you like to do my work in the world.'], 'Type' => ['description' => '拆条类型,电商直播场景暂时只返回默认值`直播`。', 'type' => 'string', 'example' => '直播'], 'By' => ['description' => '拆条采用的算法。', 'type' => 'string', 'example' => 'multimodal'], ], ], ], ], ], 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误,请检查参数值'], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败,请检查RAM权限配置,操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。 '], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A00A3C17-61D5-1489-860D-B709F83A7C40\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"BeginTime\\": 10.06,\\n \\"EndTime\\": 17.3,\\n \\"Index\\": 1\\n }\\n ],\\n \\"SplitVideoPartResults\\": [\\n {\\n \\"BeginTime\\": 0.33,\\n \\"EndTime\\": 6.3,\\n \\"Theme\\": \\"you like to do my work in the world.\\",\\n \\"Type\\": \\"直播\\",\\n \\"By\\": \\"multimodal\\"\\n }\\n ]\\n },\\n \\"Message\\": \\"该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"\\n A00A3C17-61D5-1489-860D-B709F83A7C40\\n 该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\n","errorExample":""}]', 'title' => '视频拆条', 'description' => '## 功能描述'."\n" .'视频拆条能力可以多维度对视频进行分析理解,将视频拆解为多个片段并返回每个片段的边界时间点(不返回具体视频片段),并对片段进行摘要描述,拆分维度包含镜头和主题等。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击[立即试用](https://vision.aliyun.com/experience/detail?spm=a2cvz.27764832.J_7524944390.8.5f1250b5aWPQQw&tagName=videorecog&children=SplitVideoParts)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" .'影视传媒素材生产:支持影视传媒视频的智能信息分析和片段拆分,可用于长视频完整片段拆分分发、快编素材生成和视频剪辑等场景。'."\n" ."\n" .'## 特色优势'."\n" ."\n" .'- 支持多维度信息提取:支持对多种信息维度进行信息提取,并基于该信息进行片段拆分。'."\n" .'- 拆分粒度细:可对素材进行秒级或帧级拆分。'."\n" .'- 支持素材摘要信息透出:可对拆分片段进行信息摘要描述。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号:打开[阿里云官网](https://www.aliyun.com),在阿里云官网右上角,单击**立即注册**,按照操作提示完成账号注册。'."\n" .'2. 开通能力:请确保您已开通[视频理解服务](https://vision.aliyun.com/videorecog),若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videorecog_public_cn#/open)。'."\n" .'3. 创建AccessKey:请确保您已[创建AccessKey](~~175144~~),如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试(可选):您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videorecog/2020-03-20/SplitVideoParts?lang=JAVA)在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。'."\n" .'5. 开发接入步骤:'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为视频理解(videorecog)类目的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码:该能力常用语言的示例代码,请参见[视频拆条示例代码](~~2261132~~),常用语言查询异步任务结果的示例代码,请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" .'- 视频格式:AVI、FLV、MKV、MPG、MP4、TS、MOV、MXF。'."\n" .'- 视频大小:小于4 GB。'."\n" .'- 视频时长限制:时长不超过3小时。'."\n" .'- 视频分辨率:大于等于240P,小于等于1440P。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" .'关于视频拆条的计费方式及报价,请参见[计费介绍](~~202485~~)。'."\n" ."\n" .'> 下方调试接口为付费接口。'."\n" ."\n" .'## 调用步骤'."\n" .'该能力为异步能力,需分两步进行调用。'."\n" .'第一步调用SplitVideoParts接口提交任务,请求成功后,得到一个任务ID。'."\n" .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果,根据任务ID查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。', 'responseParamsDescription' => '## 查询结果'."\n" .'该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" .'阿里云视觉AI视频理解类目下的视频拆条能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为视频理解(videorecog)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码,请参见[视频拆条示例代码](~~2261132~~),常用语言查询异步任务结果的示例代码,请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" .'关于视频拆条的错误码,详情请参见[常见错误码](~~159312~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。', 'changeSet' => [ ['createdAt' => '2023-03-14T02:32:18.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], ['createdAt' => '2022-10-17T02:07:20.000Z', 'description' => '响应参数发生变更'], ['createdAt' => '2022-05-13T02:14:26.000Z', 'description' => 'OpenAPI 下线'], ], ], ], 'endpoints' => [ ['regionId' => 'cn-shanghai', 'regionName' => '华东2(上海)', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'videorecog.cn-shanghai.aliyuncs.com', 'endpoint' => 'videorecog.cn-shanghai.aliyuncs.com', 'vpc' => 'videorecog-vpc.cn-shanghai.aliyuncs.com'], ], 'errorCodes' => [ ['code' => 'AuthFailed', 'message' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'http_code' => 403, 'description' => '授权失败,请检查RAM权限配置,操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], ['code' => 'ClientError.IllegalArgument', 'message' => '请检查参数,如参数值所代表的数据库是否存在', 'http_code' => 400, 'description' => '请检查参数,如参数值所代表的数据库是否存在'], ['code' => 'EntityNotExist.Role', 'message' => '没有Ram权限,请联系主账号给你添加AliyunVIAPIFullAccess权限,操作流程可参考https://help.aliyun.com/document_detail/145025.htm', 'http_code' => 403, 'description' => '没有Ram权限,请联系主账号给你添加AliyunVIAPIFullAccess权限,操作流程可参考https://help.aliyun.com/document_detail/145025.htm'], ['code' => 'IllegalUrlParameter', 'message' => 'Url不合法,请检查url能否正常打开', 'http_code' => 400, 'description' => 'Url不合法,请检查url能否正常打开 - 非上海OSS图片链接请参考:https://help.aliyun.com/document\\_detail/155645.html '], ['code' => 'InternalError', 'message' => 'An error occurred to the algorithm service.', 'http_code' => 500, 'description' => '算法服务报错,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。 '], ['code' => 'InternalError.Algo', 'message' => 'An algorithm error occurred.', 'http_code' => 500, 'description' => '算法服务报错,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。 '], ['code' => 'InternalError.Busy', 'message' => 'Server busy.', 'http_code' => 500, 'description' => '后台服务忙,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ['code' => 'InternalError.Decode', 'message' => 'Failed to decode the image.', 'http_code' => 500, 'description' => '图像解码失败,请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ['code' => 'InternalError.Env', 'message' => 'Failed to initilize the environment.', 'http_code' => 500, 'description' => '初始化环境失败。请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ['code' => 'InternalError.Model', 'message' => 'Failed to load the model.', 'http_code' => 500, 'description' => '模型加载错误,请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ['code' => 'InternalError.Process', 'message' => 'An error occurred during inference.', 'http_code' => 500, 'description' => '推理过程异常,请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ['code' => 'InternalError.Remote', 'message' => 'The request processing has failed due to some unknown error.', 'http_code' => 500, 'description' => '远程服务不可用,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ['code' => 'InternalError.Server', 'message' => 'The request processing has failed due to some unknown error.', 'http_code' => 500, 'description' => '系统内部错误,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ['code' => 'InternalError.Timeout', 'message' => '算法服务报错,请稍后重试', 'http_code' => 500, 'description' => '算法服务报错,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。 '], ['code' => 'InternalServerError', 'message' => 'A server error occurred while processing your request.', 'http_code' => 500, 'description' => '系统内部错误,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ['code' => 'InvalidAccessKeyId.Inactive', 'message' => 'AccessKeyId非法,请检查AccessKeyId是否被禁用,或者AccessKeyId和AccessKeySecret是否填写正确。', 'http_code' => 403, 'description' => 'AccessKeyId非法,请检查AccessKeyId是否被禁用,或者AccessKeyId和AccessKeySecret是否填写正确。请参考文档:https://help.aliyun.com/document\\_detail/175144.html,进入控制台,将对应的AccessKey启用。 '], ['code' => 'InvalidAccessKeyId.NotFound', 'message' => 'AccessKeyId未找到,请检查AccessKeyId和AccessKeySecret是否填写正确。', 'http_code' => 400, 'description' => 'AccessKeyId未找到,请检查AccessKeyId和AccessKeySecret是否填写正确。请参考文档:https://help.aliyun.com/document\\_detail/175144.html,进入控制台,找到对应的AccessKeyId和AccessKeySecret。如果AccessKeySecret未保存,主账号可以通过查看Secret找回,子账号无法找回,可以新建一个AccessKey。 '], ['code' => 'InvalidAccessKeySecret', 'message' => 'AccessKeyId或AccessKeySecret填写错误,请检查AccessKeyId和AccessKeySecret是否填写正确。', 'http_code' => 400, 'description' => 'AccessKeyId或AccessKeySecret填写错误,请检查AccessKeyId和AccessKeySecret是否填写正确。请参考文档:https://help.aliyun.com/document\\_detail/175144.html,进入控制台,找到对应的AccessKeyId和AccessKeySecret。如果AccessKeySecret未保存,主账号可以通过查看Secret找回,子账号无法找回,可以新建一个AccessKey。 '], ['code' => 'InvalidAction.NotFound', 'message' => '能力未找到,请检查类目与能力是否匹配,检查访问域名与能力是否匹配,关于访问域名可参考:https://help.aliyun.com/document_detail/143103.htm。SDK接入请参考:https://help.aliyun.com/document_detail/145033.html,选择合适编程语言根据实例代码作相关修改进行接入。', 'http_code' => 400, 'description' => '能力未找到,请检查类目与能力是否匹配,检查访问域名与能力是否匹配,关于访问域名可参考:https://help.aliyun.com/document_detail/143103.htm。SDK接入请参考:https://help.aliyun.com/document_detail/145033.html,选择合适编程语言根据实例代码作相关修改进行接入。'], ['code' => 'InvalidApi.ForbiddenInvoke', 'message' => '调用受限,请检查您调用的能力是否为受限能力,受限能力需要在控制台https://vision.console.aliyun.com/找到相应能力申请经过审批之后才能调用。如非上述情况,请检查账号是否欠费', 'http_code' => 400, 'description' => '调用受限,请检查您调用的能力是否为受限能力,受限能力需要在控制台https://vision.console.aliyun.com/找到相应能力申请经过审批或者手动激活之后才能调用。如非上述情况,请检查账号是否欠费 '], ['code' => 'InvalidApi.NotPurchase', 'message' => '产品未开通,请开通产品:https://common-buy.aliyun.com/?commodityCode=viapi_videorecog_public_cn#/open', 'http_code' => 400, 'description' => '产品未开通,请开通产品:https://common-buy.aliyun.com/?commodityCode=viapi_videorecog_public_cn#/open'], ['code' => 'InvalidApi.OutOfService', 'message' => '产品未开通,请开通产品:https://common-buy.aliyun.com/?commodityCode=viapi_videorecog_public_cn#/open', 'http_code' => 421, 'description' => '产品未开通,请开通产品:https://common-buy.aliyun.com/?commodityCode=viapi_videorecog_public_cn#/open'], ['code' => 'InvalidFile.Category', 'message' => 'Invalid file category.', 'http_code' => 400, 'description' => '文件内容类目不符合要求。'], ['code' => 'InvalidFile.Content', 'message' => 'The content format of the image or video is invalid.', 'http_code' => 400, 'description' => '请参考算法文档检查文件内容,更换包含符合算法要求的 '], ['code' => 'InvalidFile.Decode', 'message' => 'Failed to decode the file.', 'http_code' => 400, 'description' => '请检查文件是否能够正常打开 '], ['code' => 'InvalidFile.Download', 'message' => 'Failed to download the file.', 'http_code' => 400, 'description' => '文件无法下载,请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考:https://help.aliyun.com/document\\_detail/155645.html。请检查OSS链接是否过期等。 '], ['code' => 'InvalidFile.Region', 'message' => 'The URL format of the file is invalid.', 'http_code' => 400, 'description' => '文件链接地域不对,非上海OSS图片链接请参考:https://help.aliyun.com/document\\_detail/155645.html '], ['code' => 'InvalidFile.Resolution', 'message' => 'The resolution of the image or video is invalid.', 'http_code' => 400, 'description' => '文件分辨率超出限制,请检查文件分辨率和内容,修改文件分辨率后重试 '], ['code' => 'InvalidFile.Type', 'message' => 'The file type of the image or video is invalid.', 'http_code' => 400, 'description' => '文件类型错误,请检查文件类型 - 请参考算法API文档,使用算法支持的文件类型。阿里云视觉智能开放平台能够读取文件并获取真实的文件类型,不是通过文件后缀名进行类型判断,只看文件后缀名是无效的,关于更多文件类型判断和处理信息可参考:https://help.aliyun.com/document_detail/470250.html'], ['code' => 'InvalidFile.Unsafe', 'message' => 'Risky file URL.', 'http_code' => 400, 'description' => '不安全的文件链接,请确保上传的图片或文件来源符合相应的法律法规。'], ['code' => 'InvalidFile.URL', 'message' => 'The URL format of the file is invalid.', 'http_code' => 400, 'description' => '文件无法下载,请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考:https://help.aliyun.com/document\\_detail/155645.html。请检查OSS链接是否过期等。 '], ['code' => 'InvalidImage.Content', 'message' => '请参考算法文档检查图片内容,更换包含符合算法要求的', 'http_code' => 400, 'description' => '请参考算法文档检查图片内容,更换包含符合算法要求的'], ['code' => 'InvalidImage.Decode', 'message' => '请检查图片是否能够正常打开', 'http_code' => 400, 'description' => '请检查图片是否能够正常打开'], ['code' => 'InvalidImage.Download', 'message' => '图片无法下载,请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考:https://help.aliyun.com/document_detail/155645.html', 'http_code' => 400, 'description' => '图片无法下载,请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考:https://help.aliyun.com/document_detail/155645.html'], ['code' => 'InvalidImage.NotFoundFace', 'message' => '图像中没找到人脸,请检查您的图像中是否包含人脸或人脸太小', 'http_code' => 400, 'description' => '图像中没找到人脸,请检查您的图像中是否包含人脸或人脸太小'], ['code' => 'InvalidImage.REGION', 'message' => '图片链接地域不对,非上海OSS图片链接请参考:https://help.aliyun.com/document_detail/155645.html', 'http_code' => 400, 'description' => '图片链接地域不对,非上海OSS图片链接请参考:https://help.aliyun.com/document_detail/155645.html'], ['code' => 'InvalidImage.Resolution', 'message' => '文件分辨率超出限制,请检查文件分辨率和内容,修改文件分辨率后重试', 'http_code' => 400, 'description' => '文件分辨率超出限制,请检查文件分辨率和内容,修改文件分辨率后重试'], ['code' => 'InvalidImage.Timeout', 'message' => '图片下载超时,请检查链接是否可访问和本地网络情况', 'http_code' => 400, 'description' => '图片下载超时,请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考:https://help.aliyun.com/document\\_detail/155645.html。请检查OSS链接是否过期等。 '], ['code' => 'InvalidImage.Type', 'message' => '图片类型错误,请检查图片类型 - 请参考算法API文档,使用算法支持的图片类型', 'http_code' => 400, 'description' => '图片类型错误,请检查图片类型 - 请参考算法API文档,使用算法支持的图片类型'], ['code' => 'InvalidImage.URL', 'message' => '图片链接非法,请检查图片链接是否可访问 - 非上海OSS图片链接请参考:https://help.aliyun.com/document_detail/155645.html', 'http_code' => 400, 'description' => '图片链接非法,请检查图片链接是否可访问 - 非上海OSS图片链接请参考:https://help.aliyun.com/document_detail/155645.html'], ['code' => 'InvalidImageType', 'message' => 'Invalid image type.', 'http_code' => 400, 'description' => '无效的图片类型。请参考调用能力的文档输入文档中支持的图片类型。'], ['code' => 'InvalidParameter', 'message' => 'Invalid parameter value.', 'http_code' => 400, 'description' => '参数错误,请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。 '], ['code' => 'InvalidParameter.BadRequest', 'message' => 'The request parameter or the data has an error.', 'http_code' => 400, 'description' => '参数错误,请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。 '], ['code' => 'InvalidParameter.Format', 'message' => 'Invalid format.', 'http_code' => 400, 'description' => '入参格式错误。请参照文档检查入参格式是否是文档要求的。'], ['code' => 'InvalidParameter.NotFound', 'message' => 'Invalid parameter value.', 'http_code' => 400, 'description' => '参数错误,请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。'], ['code' => 'InvalidParameter.TooLarge', 'message' => '参数错误,文件大小超出限制,请参考算法API文档调整文件大小', 'http_code' => 400, 'description' => '参数错误,文件大小超出限制,请参考算法API文档调整文件大小'], ['code' => 'InvalidRamRole', 'message' => '没有Ram权限,请联系主账号给你添加AliyunVIAPIFullAccess权限,操作流程可参考https://help.aliyun.com/document_detail/145025.htm', 'http_code' => 403, 'description' => '没有Ram权限,请联系主账号给你添加AliyunVIAPIFullAccess权限,操作流程可参考https://help.aliyun.com/document_detail/145025.htm'], ['code' => 'InvalidResult', 'message' => '参数错误,请参考文档检查参数值,检查文件内容。请检查是否图片内容不完整或者太模糊等。', 'http_code' => 400, 'description' => '参数错误,请参考文档检查参数值,检查文件内容。请检查是否图片内容不完整或者太模糊等。'], ['code' => 'InvalidSide', 'message' => 'Specified parameter Side is not valid. 请参考文档填写正确的Side参数', 'http_code' => 400, 'description' => 'Specified parameter Side is not valid. 请参考文档填写正确的Side参数'], ['code' => 'InvalidTimeStamp.Expired', 'message' => 'The timestamp has expired. Please update the timestamp', 'http_code' => 400, 'description' => '时间戳过期,请更新时间戳。可以参考https://help.aliyun.com/document\\_detail/144904.html文档计算请求签名。如果您的语言比较常用,推荐使用SDK进行调用,详情可参考:https://help.aliyun.com/document\\_detail/145033.html '], ['code' => 'InvalidVersion', 'message' => 'Specified parameter Version is not valid', 'http_code' => 400, 'description' => '版本未找到,请检查SDK版本是否匹配,检查版本与类目和能力是否匹配,关于SDK版本可参考:https://help.aliyun.com/document_detail/145033.html'], ['code' => 'MissingAccessKeyId', 'message' => 'AccessKeyId未填写,请检查AccessKeyId和AccessKeySecret是否填写正确。', 'http_code' => 400, 'description' => 'AccessKeyId未填写,请检查AccessKeyId和AccessKeySecret是否填写正确。请参考文档:https://help.aliyun.com/document\\_detail/175144.html,进入控制台,找到对应的AccessKeyId和AccessKeySecret。如果AccessKeySecret未保存,主账号可以通过查看Secret找回,子账号无法找回,可以新建一个AccessKey。 '], ['code' => 'MissingFileURL', 'message' => 'FileURL is required for this operation.', 'http_code' => 400, 'description' => '缺少文件参数FileURL,该参数为文件URL地址,文件输入推荐使用华东2(上海)区域的OSS链接-非上海OSS文件链接请参考:'."\n" .'https://help.aliyun.com/document_detail/155645.html'], ['code' => 'MissingImageURL', 'message' => 'ImageURL is required for this operation.', 'http_code' => 400, 'description' => '缺少图像参数ImageURL,该参数为图片URL地址,文件输入推荐使用华东2(上海)区域的OSS链接-非上海OSS文件链接请参考:'."\n" .'https://help.aliyun.com/document_detail/155645.html'], ['code' => 'MissingLimit', 'message' => 'Limit is required for this operation', 'http_code' => 400, 'description' => '缺少Limit参数,该参数是接口必填参数。推荐使用对应类目的SDK进行调用:https://help.aliyun.com/document_detail/145033.html'], ['code' => 'MissingParameter', 'message' => 'A required parameter is not specified.', 'http_code' => 400, 'description' => '参数缺失,请参考文档检查参数值 '], ['code' => 'MissingTasks', 'message' => 'Tasks is required for this operation.', 'http_code' => 400, 'description' => '缺少Tasks参数,该参数是接口必填参数。推荐使用对应类目的SDK进行调用:https://help.aliyun.com/document_detail/145033.html'], ['code' => 'ParameterError', 'message' => 'The parameter is invalid. Please check again.', 'http_code' => 400, 'description' => '参数错误,请检查参数值'], ['code' => 'ServiceUnavailable', 'message' => 'The service is unavailable.', 'http_code' => 503, 'description' => '算法服务报错,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。 '], ['code' => 'SignatureDoesNotMatch', 'message' => '签名不正确,请重新计算签名。关于签名可参考文档:https://help.aliyun.com/document_detail/144904.html', 'http_code' => 400, 'description' => '签名不正确,请重新计算签名。可以参考https://help.aliyun.com/document\\_detail/144904.html文档计算请求签名。如果您的语言比较常用,推荐使用SDK进行调用,详情可参考:https://help.aliyun.com/document\\_detail/145033.html '], ['code' => 'SignatureNonceUsed', 'message' => '签名已经被使用过,请重新计算签名。关于签名可参考文档:https://help.aliyun.com/document_detail/144904.html', 'http_code' => 400, 'description' => '签名已经被使用过,请重新计算签名。可以参考https://help.aliyun.com/document\\_detail/144904.html文档计算请求签名。如果您的语言比较常用,推荐使用SDK进行调用,详情可参考:https://help.aliyun.com/document\\_detail/145033.html '], ['code' => 'Throttling', 'message' => 'The request was denied due to QPS limits.', 'http_code' => 400, 'description' => '调用被限流,请稍后再调用,或者购买QPS提升调用限制。关于QPS限制提升流程和处理请参考:https://help.aliyun.com/document_detail/604963.html。如果因业务需求需要更多QPS可通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群与平台取得联系。'], ['code' => 'Throttling.User', 'message' => 'The request was denied due to QPS limits.', 'http_code' => 400, 'description' => '调用被限流,请稍后再调用,或者购买QPS提升调用限制。关于QPS限制提升流程和处理请参考:https://help.aliyun.com/document_detail/604963.html。如果因业务需求需要更多QPS可通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群与平台取得联系。'], ['code' => 'Timeout', 'message' => 'The request has timed out.', 'http_code' => 408, 'description' => '请求超时,请稍后重试。如重试后还报错请通过钉钉搜索群号23109592,加入阿里云视觉智能开放平台咨询群,与平台取得联系。'], ['code' => 'Unauthorized', 'message' => '没有Ram权限,请联系主账号给你添加AliyunVIAPIFullAccess权限,操作流程可参考https://help.aliyun.com/document_detail/145025.htm', 'http_code' => 400, 'description' => '没有Ram权限,请联系主账号给你添加AliyunVIAPIFullAccess权限,操作流程可参考https://help.aliyun.com/document_detail/145025.htm'], ], 'changeSet' => [ [ 'apis' => [ ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'SplitVideoParts'], ], 'createdAt' => '2023-03-24T08:22:54.000Z', 'description' => '', ], [ 'apis' => [ ['description' => 'OpenAPI 下线', 'api' => 'RecognizeVideoCastCrewList'], ], 'createdAt' => '2022-10-17T02:12:05.000Z', 'description' => '首次发布上线', ], [ 'apis' => [ ['description' => '响应参数发生变更', 'api' => 'DetectVideoShot'], ['description' => '响应参数发生变更', 'api' => 'GenerateVideoCover'], ['description' => '响应参数发生变更', 'api' => 'RecognizeVideoCastCrewList'], ['description' => '响应参数发生变更', 'api' => 'SplitVideoParts'], ['description' => '响应参数发生变更', 'api' => 'UnderstandVideoContent'], ], 'createdAt' => '2022-10-17T02:07:32.000Z', 'description' => '修改异步任务Message为可见', ], [ 'apis' => [ ['description' => '响应参数发生变更', 'api' => 'RecognizeVideoCastCrewList'], ], 'createdAt' => '2022-10-12T01:52:52.000Z', 'description' => '新增出参参数', ], [ 'apis' => [ ['description' => '请求参数发生变更', 'api' => 'RecognizeVideoCastCrewList'], ], 'createdAt' => '2022-09-29T08:01:47.000Z', 'description' => '多url参数支持本地文件上传', ], [ 'apis' => [ ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'RecognizeVideoCastCrewList'], ], 'createdAt' => '2022-09-27T09:42:25.000Z', 'description' => '修改obj为可见', ], [ 'apis' => [ ['description' => 'OpenAPI 下线', 'api' => 'SplitVideoParts'], ], 'createdAt' => '2022-05-13T03:10:01.000Z', 'description' => '首次发布', ], ], 'ram' => [ 'productCode' => 'VisualIntelligenceAPI', 'productName' => '视觉智能开放平台', 'ramCodes' => ['viapi-imageseg', 'viapi-imageaudit', 'viapi-ocr', 'viapi-objectdet', 'viapi-imageenhan', 'viapi-videorecog', 'viapi-imageprocess', 'viapi', 'viapi-ekyc', 'viapi-imgsearch', 'viapi-goodstech', 'viapi-facebody', 'viapi-threedvision', 'viapi-videoenhan', 'viapi-imagerecog', 'viapi-videoseg', 'viapi-regen', 'viapi-aigen'], 'ramLevel' => '服务级', 'ramConditions' => [], 'ramActions' => [ [ 'apiName' => 'GetAsyncJobResult', 'description' => '查询异步任务结果', 'operationType' => 'create', 'ramAction' => [ 'action' => 'viapi-videorecog:GetAsyncJobResult', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'SplitVideoParts', 'description' => '视频拆条', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-videorecog:SplitVideoParts', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'EvaluateVideoQuality', 'description' => '视频画质评估', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-videorecog:EvaluateVideoQuality', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'GenerateVideoCover', 'description' => '视频封面', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-videorecog:GenerateVideoCover', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'DetectVideoShot', 'description' => '镜头解析', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-videorecog:DetectVideoShot', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'UnderstandVideoContent', 'description' => '视频内容理解', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-videorecog:UnderstandVideoContent', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'RecognizeVideoCastCrewList', 'description' => '视频OCR', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-videorecog:RecognizeVideoCastCrewList', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], ], 'resourceTypes' => [], ], ];