先确定坐标属于哪一张图

模型给出的点偏离原图目标,可能是识别误差,也可能是坐标系用错。至少区分原图、你裁出的局部图,以及模型实际看到的内容尺寸;不能只拿原图宽度乘一个猜测比例。

当前官方坐标指南说明,返回坐标对应模型处理后的图像,缩放与填充会影响使用方式。本文只演算自行已确认的裁切和缩放,不实现服务端尺寸推断,也不测模型定位准确率。

用一个已知预处理案例手算

虚构原图中裁切框左上为(200,100),宽600、高400。你把裁切内容缩放为300×200,并已经确认后续没有再次缩放。给定内容坐标点为(150,100),它位于缩放内容正中。

先分别乘回宽高比例:150乘600/300等于300,100乘400/200等于200;再加原图裁切偏移,得到原图点(500,300)。这三个步骤的顺序不能省略。

局部点回到原图的链路;原图中的裁切框:左200、上100,尺寸600×400;已知缩放内容:300×200;给定点150,100;分别放大再加偏移:(150×2+200, 100×2+100);回映结果:原图点500,300;仍需目视确认
本站原创示意图:局部点回到原图的链路。已知预处理的虚构算术;不是服务端尺寸推断器。查看大图 ↗

填充不能当作内容宽高

官方指南说明其填充位于底部和右侧,不移动原点;回映应以缩放后的内容宽高为分母,而不是包含填充的尺寸。示例中的300×200指有效内容,不是带边框的显示容器。

如果你自己的图像流程在左侧或顶部增加留白,公式要先去除自己加的偏移,本文函数并未实现该情况。不能把自己应用的居中留白,和服务端底部/右侧填充混成一种处理。

运行只做坐标换算的函数

代码保存为crop-coordinate-map.mjs,用Node.js 24 LTS执行:node crop-coordinate-map.mjs --demo,应得到x为500、y为300。参数来自给定案例,不来自实际Claude响应。

函数拒绝负尺寸、非有限数字以及有效内容范围之外的点,而不是自动把异常点当成目标。实际系统可以按官方建议选择夹取策略,但要记录原始值与修正值,不能静默隐藏识别偏差。

真实请求前还要确认什么

确认模型对应的图像处理规则和实际内容尺寸;若存在服务端缩放,应按当前官方实现求尺寸或预先处理后验证。不要手写一个固定最大边长比例,就声称适用于所有模型和长宽比。

PDF服务器栅格化尺寸无法由你任意假定;需要可靠坐标映射时,应先自己将页面转成尺寸已知的图片,再处理。旋转、镜像、截图逻辑像素与物理像素也需要各自变换,不在这个裁切公式里。

验收应画回图上看

对给定点算术通过后,仍要在原图叠加标记并人工核对目标。若用于点击或业务写入,坐标存在并不构成动作授权,也不证明定位准确。

本地测试验证了中点、原点、越界与非法尺寸拒绝;未调用视觉API、未真实裁切图片、未测OCR或自动点击。图中是教学坐标链路,不是产品截图或识别结果。

参考资料与核验范围

资料核对日期:2026年10月20日。以下为官方原始资料;产品入口和可用范围仍以当前账户为准。

1. [官方资料1](https://platform.claude.com/docs/en/build-with-claude/vision-coordinates)

2. [官方资料2](https://platform.claude.com/docs/en/build-with-claude/vision)