调用火山引擎视觉类api前须校验图片大小是否≤20971520字节（20mb），超限直接返回400错误；可通过文件属性、命令行stat/get-item或代码file.length()/os.path.getsize()等轻量预检，避免无效http请求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在调用火山引擎 ImageX 或异常图片检测等视觉类 API 前，必须确认待识别图片文件大小未超出服务端硬性限制，否则会直接返回 400 错误且不触发任何检测逻辑。
查本地文件大小（Windows/macOS/Linux 通用）
右键点击图片文件 → 选择「属性」（Windows）或「显示简介」（macOS）→ 在「常规」或「通用」页签中查看「大小」数值。
这一步操作起来很简单，直接把文件拖进去就行。注意：显示的「大小」是实际字节数，而「占用空间」可能因磁盘簇大小产生偏差，务必以「大小」为准。
用命令行快速验证（推荐批量检查）
打开终端（macOS/Linux）或 PowerShell（Windows），执行以下命令：
macOS/Linux：stat -f "%z" image.png → 返回纯数字字节数；
Windows PowerShell：(Get-Item "image.png").Length → 返回字节数，支持通配符如 "*.jpg" 批量检查。
别用 ls -lh 或 dir 看带单位的显示结果——它会四舍五入，比如 20.1MB 显示为 20MB，但火山引擎对 20MB 是严格截断的，【超过 20971520 字节（即 20MB）将被拒绝】。
上传前做轻量预检（Java/Python 示例）
方法一：Java 中用 File.length() 获取字节数，与 20 * 1024 * 1024 比较；
方法二：Python 中用 os.path.getsize("image.jpg") 判断；
方法三：Node.js 中用 fs.statSync("image.jpg").size ；
这三步都不依赖网络请求，可在 SDK 初始化前就拦截超限文件。如果跳过这步，等到 tos.putObject() 或 imagex.upload() 时才报错，会浪费一次 HTTP 请求和重试成本。
通过火山引擎控制台查看历史失败原因
登录火山引擎控制台 → 进入「ImageX」或「TOS」服务 → 左侧导航栏点击「访问日志」或「API 调用监控」；
筛选时间范围 + 状态码 400 + 接口名含 inspect 或 upload；
在日志详情中查找 "errorMessage":"file size exceeds limit" 字段，确认是否因大小超标被拒；
若该错误高频出现，说明前端或采集端未做前置校验，需立即补上字节级判断逻辑。
