上一篇
广州工业视觉智能API使用限制是什么？如何突破调用频率限制
广州工业视觉智能API旨在为制造业、物流及质检领域提供高精度的图像识别与分析能力，为了确保服务的稳定性、公平性以及防止资源滥用，平台对API调用实施了严格的限制策略,以下是对各项使用限制的详细说明。
并发与频率限制
系统根据用户账户的等级（如免费试用版、标准版、企业版）设定了不同的请求配额,这些限制主要包含以下两个维度：
- QPS（每秒查询率）限制：指单个API接口在每秒内允许的最大请求次数，超出此限制后,后续请求将被拒绝或排队等待。
- QPM（每分钟查询率）限制：指单个API接口在一分钟内允许的最大请求总量。
| 账户类型 | 单接口 QPS 限制 | 单接口 QPM 限制 | 备注 |
|---|---|---|---|
| 免费试用版 | 2 | 60 | 仅限基础功能测试 |
| 标准商业版 | 10 | 300 | 适用于中小规模生产线 |
| 企业定制版 | 50+ | 1500+ | 支持高并发工业场景，需申请 |
注：具体数值可能随平台政策调整而变化，请以控制台实时显示为准。
图像规格与格式限制
工业视觉场景对输入图像的质量有明确要求，不符合规范的图像将被直接驳回,不计入调用次数但会返回错误码。
- 格式支持：仅支持 JPEG、PNG、BMP 格式，不支持 GIF、WebP 或其他动态或特殊编码格式。
- 文件大小：单张图像文件大小不得超过 10MB。
- 分辨率要求：
- 最小边长不得小于 100 像素。
- 最大边长不得超过 8192 像素。
- 对于缺陷检测类接口，建议图像分辨率不低于 2MP（200万像素）,以确保细微缺陷的识别精度。
- ：图像必须清晰、无严重模糊、无过度曝光或欠曝光，禁止上传包含人脸、车牌等隐私敏感信息的图像,除非已获得相关授权并开通特定权限。
业务逻辑与内容安全限制
- 调用间隔：同一用户ID在短时间内连续发起相同参数的请求，可能会被系统判定为恶意刷量,建议在生产环境中加入合理的随机延迟或重试机制。
- 内容合规：上传的图像不得包含违法、违规、擦边、暴力或侵犯他人知识产权的内容，系统内置内容安全检测模块,违规图像将被拦截并可能导致账户封禁。
- 并发连接数：单个账户在同一时刻建立的活跃TCP连接数有限制，通常默认为 100 个,超过限制的新连接将被拒绝。
错误处理与重试机制
当触发限制时，API 将返回特定的 HTTP 状态码或业务错误码：
- HTTP 429 Too Many Requests：表示触发了 QPS 或 QPM 限制。
- 业务错误码 10001：表示图像格式或大小不符合要求。
- 业务错误码 10002安全审核未通过。
建议的重试策略：
- 遇到 429 错误时，应采用指数退避算法（Exponential Backoff）进行重试，第一次等待 1 秒，第二次等待 2 秒，第三次等待 4 秒，以此类推，最大等待时间不超过 60 秒。
- 避免在重试时立即发起相同请求，应适当增加随机抖动（Jitter）以避免“惊群效应”。
数据隐私与存储限制
- 数据保留：平台默认不长期存储用户上传的原始图像及分析结果，分析完成后，数据将在 24 小时内自动删除，如需长期存储,需购买额外的数据存储服务。
- 传输加密：所有 API 请求必须通过 HTTPS 协议进行,以确保数据传输过程中的安全性。
- 本地化处理选项：对于对数据隐私要求极高的客户，平台提供私有化部署方案,此时使用限制将根据本地服务器资源单独协商。
相关问题与解答
问题 1：如果在生产环境中遇到“429 Too Many Requests”错误，除了增加等待时间外，还有什么架构层面的优化建议？
解答：
除了客户端实施指数退避重试机制外,建议从架构层面进行以下优化：
- 引入消息队列：将图像采集与AI分析解耦，使用 Kafka 或 RabbitMQ 等消息队列作为缓冲层，将图像请求放入队列，由后端消费者以稳定的速率拉取并调用API，这样可以平滑流量峰值,避免瞬间并发超过QPS限制。
- 负载均衡与多账户策略：如果业务量极大，可以考虑申请多个API账户，并在网关层通过负载均衡算法将请求分发到不同账户,从而叠加总的QPS上限。
- 边缘计算预处理：在工业相机端或边缘网关进行初步的图像筛选（如去除模糊、无效图像），减少无效请求发送到云端,节省配额并提高有效调用率。
问题 2：我的工业相机拍摄的图片是RAW格式，可以直接调用API吗？如果不能，该如何处理？
解答：
不可以直接调用，广州工业视觉智能API目前仅支持 JPEG、PNG、BMP 等常见格式，不支持 RAW 格式。
处理建议：
- 格式转换：在图像传输到API之前，必须在本地或边缘设备上进行格式转换，可以使用 OpenCV、PIL (Python Imaging Library) 或相机SDK自带的功能，将 RAW 数据解码并转换为 JPEG 或 PNG 格式。
- 优化转换参数：在转换过程中，注意控制压缩质量（如 JPEG 的 quality 参数设为 80-90），以平衡图像文件大小和细节保留，对于工业缺陷检测，建议尽量保留高保真度,避免过度压缩导致细微缺陷丢失。
- 批量处理：如果相机输出频率高，建议在边缘端建立缓冲区，批量进行格式转换和压缩，再统一发送,以提高网络传输效率。
