本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
以下几个部分提供了使用 Amazon Rekognition 时的准则和配额。有两种配额。无法更改设置的配额,例如最大图像大小。AWS 服务限额页面上列出的默认限额可通过 默认限额 部分中描述的步骤进行更改。
支持的区域
有关可用 Amazon Rekognition 的 AWS 区域列表,请参阅《亚马逊网络服务通用参考》中的 AWS 区域和终端节点。
设置配额
以下是 Amazon Rekognition 中不可更改的限制列表。有关您可更改的限制的信息,例如每秒事务数 (TPS) 限制,请参阅 默认限额。
有关 Amazon Rekognition Custom Labels 限制,请参阅 Amazon Rekognition Custom Labels 中的准则和配额。
Amazon Rekognition Image
-
存储为 Amazon S3 对象的最大图像大小限制为 15 MB。
-
DetectModerationLabels
最大图像尺寸的宽和高均为 10K 像素。 -
DetectLabels
最大图像尺寸的宽和高均为 10K 像素。 -
要被检测到,人脸在 1920X1080 像素的图像中的大小不得小于 40x40 像素。对于尺寸大于 1920X1080 像素的图像,人脸的尺寸也需要相应增加。
-
最小图像尺寸的高和宽均为 80 像素。
DetectProtectiveEquipment
最小图像尺寸的高和宽均为 64 像素。 DetectProtectiveEquipment
最大图像尺寸的宽和高均为 4096 像素。要被
DetectProtectiveEquipment
检测到,人脸在 800x1300 像素的图像中的大小不得小于 100x100 像素。对于尺寸大于 800x1300 像素的图像,最小人脸的尺寸也需要相应增加。-
作为参数传入 API 的最大图像大小(原始字节数)为 5 MB。
DetectProtectiveEquipment
API 的限制为 4 MB。 -
Amazon Rekognition 支持 PNG 和 JPEG 图像格式。也就是说,您作为输入提供给各种 API 操作(例如
DetectLabels
和IndexFaces
)的图像必须采用受支持的格式之一。 -
一个人脸集合中可存储的人脸向量最大数目为 2000 万。
-
一个人脸集合中可存储的人脸向量的默认最大数目为 1000 万。
-
搜索 API 返回的最大匹配人脸向量为 4096。
-
搜索 API 返回的最大匹配用户向量为 4096。
-
DetectText
可以检测图像中最多 100 个单词。 DetectProtectiveEquipment
最多可以检测到 15 个人身上的个人防护设备。
有关图像和人脸比较的最佳实践信息,请参阅传感器、输入图像和视频的最佳实践。
Amazon Rekognition Image 批量分析
-
Amazon Rekognition Image 批量分析可以分析多达 1 万张图像。
-
Amazon Rekognition Image 批量分析支持大小不超过 50MB 的输入清单。
Amazon Rekognition Video 存储视频
Amazon Rekognition Video 可以分析存储的大小不超过 10 GB 的视频。
Amazon Rekognition Video 可以分析长达 6 小时的存储视频。
Amazon Rekognition Video 最多支持每个账户 20 个并发任务。
存储视频必须使用 H.264 编解码器进行编码。支持的文件格式为 MPEG-4 和 MOV。
-
任何分析音频数据的 Amazon Rekognition Video API 仅支持 AAC 音频编解码器。
分页标记的生存时间 (TTL) 期间为 24 小时。分页标记位于 Get 操作返回的
NextToken
字段中,例如GetLabeldetection
。
Amazon Rekognition Video 流视频
-
一个 Kinesis Video 输入流最多可关联一个 Amazon Rekognition Video 流处理器。
-
一个 Kinesis Data 输出流最多可关联一个 Amazon Rekognition Video 流处理器。
-
与一个 Amazon Rekognition Video 流处理器关联的 Kinesis Video 输入流和 Kinesis Data 输出流无法由多个处理器共享。
-
任何分析音频数据的 Amazon Rekognition Video API 仅支持 ACC 音频编解码器。
默认限额
默认配额列表可在 AWS
服务限额中找到。这些限制为默认值,可以更改。要请求提高限制,请创建案例。要查看您当前的配额限制(应用的配额值),请参阅 Amazon Rekognition 服务限额
计算 TPS 限额更改
您要求的新限额是多少? 每秒事务数 (TPS) 在预期工作负载达到峰值时最为相关。了解工作负载峰值时的最大并发 API 调用量和响应时间(5-15 秒)非常重要。请注意,最少应为 5 秒。下面是两个示例:
示例 1:我预计在最繁忙时段开始时的最大并发面部认证 (CompareFaces API) 用户数为 1000。这些响应将在 10 秒钟内传播。因此,我所在的相关地区的 CompareFaces API 所需的 TPS 为 100 (1000/10)。
示例 2:在我最繁忙的时段开始时,预计的最大并发对象检测 (DetectLabels API) 调用数为 250。这些响应将在 5 秒钟内传播。因此,我所在的相关地区的 DetectLabels API 所需的 TPS 为 50 (250/5)。
TPS 限额的最佳实践
每秒事务数 (TPS) 的推荐最佳实践包括平滑峰值流量、配置重试次数以及配置指数回退和抖动。
平稳的峰值流量。流量激增会影响吞吐量。要获得分配的每秒事务数 (TPS) 的最大吞吐量,请使用队列无服务器架构或其他机制来“平滑”流量,使其更加一致。有关使用 Rekognition 进行无服务器大规模图像和视频处理的代码示例和参考,请参阅使用 Amazon Rekognition 进行大规模图像和视频处理
。 配置重试次数。请遵循 错误处理 中的准则,为允许出现的错误配置重试次数。
配置指数回退和抖动。在配置重试次数时配置指数回退和抖动可以提高可实现的吞吐量。请参阅中的错误重试和指数退避。 AWS
创建更改 TPS 配额的案例
要创建案例,请前往创建案例
您是否实施了TPS 限额的最佳实践来平滑流量峰值并配置重试次数、指数回退和抖动?
您是否计算过所需的 TPS 配额变更? 如果不是,请参阅计算 TPS 限额更改。
您是否查看了 TPS 使用历史记录,以便更准确地预测未来的需求? 要查看您的 TPS 使用历史记录,请参阅 Amazon Rekognition 服务限额页面
。 您的使用案例是什么?
APIs 你打算用什么?
你打算 APIs 在哪些地区使用这些?
您能否将负载分散到多个区域?
您每天处理多少张图片?
您预计这个交易量能维持多久(是一次性激增还是持续增长)?
您是如何被默认限制阻止的? 查看以下异常表以确认您遇到的情况。
错误代码 例外 消息 这表示什么? 是否可以重试? HTTP 状态代码 400 ProvisionedThroughputExceededException
超出了预配置的速率。
表示节流。您可以重试或评估提高限额的请求。
是 HTTP 状态代码 400
ThrottlingException 减慢;请求速率突然增加。
您可能会发送峰值流量并遇到节流。您应该调整流量,使其更加流畅和一致。然后配置其他重试次数。请参见最佳实践。 是 HTTP 状态代码 5xx ThrottlingException (HTTP 500) 服务不可用 表示后端正在纵向扩展以支持该操作。您应该重试该请求。
是 要详细了解错误代码,请参阅错误处理。
注意
这些限制取决于您所在的区域。请求更改限制会影响您请求的区域中的 API 操作。其他 API 操作和区域不受影响。