火山引擎不支持超长截图端到端识别，须手动按逻辑或视觉断点分段后逐段调用接口；否则因尺寸＞4096×4096像素或文件＞5MB被静默拒绝（空响应或422错误）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
火山引擎不支持直接上传超长截图进行端到端识别，必须先将长图按逻辑区域或视觉断点手动分段，再逐段调用图像识别或主体识别接口，否则会因尺寸超限（宽×高＞4096×4096）或文件＞5 MB被拒绝，返回空响应或422错误。
确认长图是否超出火山引擎限制
用任意图片查看器打开截图→右键属性→查看“尺寸”和“大小”两项数值。若任一条件成立：【宽×高像素积＞16777216（即4096×4096）】 或 【文件体积＞5 MB】，就必须拆分，不可跳过此判断直接上传。
注意：火山引擎视觉类接口（如主体识别、通用实体识别）对输入图有硬性约束，超限后不报错也不提示，仅静默返回空结果或status=422，极易误判为API故障。
用系统自带工具快速分段（Windows/macOS通用）
方法一：Windows 截图工具+画图（免安装）
打开截图工具→点击“新建”→选择“矩形截图”→拖选第一段内容（如顶部导航栏+首屏信息）→Ctrl+C复制→打开画图→Ctrl+V粘贴→Ctrl+S另存为 segment_01.png；重复该流程截取下一段，命名递增。
方法二：macOS 预览App自动分割
双击打开长图→顶部菜单栏点“工具”→“调整大小”→取消勾选“缩放比例”，在“宽度”填入你希望的单段宽度（建议1200～1600px）→点“确定”→此时整图被等比压缩，但未解决超长问题；接着点“工具”→“选取”→框选第一屏高度范围→Cmd+C→新建窗口→Cmd+N→Cmd+V粘贴→Cmd+S保存为 segment_01.png；向下滚动视图，重复选取→复制→新建→粘贴→保存。
用Python脚本批量裁切（适合3段以上长图）
第一步：安装Pillow库→执行 pip install Pillow
第二步：准备以下代码，替换 image_path 为你本地长图路径，height_per_segment 设为你希望每段的高度（单位像素，例如800）：
from PIL import Image
image_path = "your_long_screenshot.png"
img = Image.open(image_path)
width, total_height = img.size
height_per_segment = 800
for i, top in enumerate(range(0, total_height, height_per_segment)):
bottom = min(top + height_per_segment, total_height)
if bottom segment = img.crop((0, top, width, bottom))
segment.save(f"segment_{i+1:02d}.png")
print("共生成", i+1, "张分段图")
运行后会在同目录生成 segment_01.png、segment_02.png 等文件。这一步不能跳过尺寸校验——如果原始图高度不是 height_per_segment 的整数倍，最后一段会自动适配剩余高度，避免内容被截断。
分段后调用火山引擎API的正确姿势
每张分段图单独构造一次请求体，不可拼成数组一次性提交。以主体识别为例：
① 对 segment_01.png 调用主体识别接口，获取其返回的 person_count、has_human 等字段；
② 对 segment_02.png 重新发起 POST 请求，body 中只含这张图的 base64 编码；
③ 依此类推，直到所有 segment_xxx.png 全部处理完毕。
关键提醒：不要把多张图的 base64 拼进一个 JSON 字段里传给火山引擎——它不支持批量图像输入，这样做会导致 400 Bad Request 错误，且错误信息不明确，排查耗时。
