比较图片相似度
比较两张图片并返回归一化视觉相似度分数。
POST /api/free/image-similarity在线比较图片相似度
上传、设置、预览与下载都不需要 API Key。
无需登录或 API Key
1. 上传与设置
无需 API Key 即可在线处理；只有点击运行后，文件才会发送到本站。
第一张图片 *
第二张图片 *
填写必填参数后即可运行工具。POST /api/free-online/image-similarity
2. 预览与下载
结果将在这里显示
包含预览、文件大小变化和下载按钮
通过 API 接入
仅程序调用需要 API Key；参数、响应和错误信息集中展示。
API 接口
POST /api/free/image-similarity在线使用免 Key；程序调用此接口时需要 APIAny Key。
工作原理
- 两张图片会被统一到相同的分析尺寸。
- 分数 1 表示归一化后的像素完全一致。
响应结果
请求成功后返回 json 类型响应，Content-Type 与本页说明一致。
常见错误
- 400
- 缺少文件或参数、值无效，或者超出页面标注的限制。
- 401
- 程序调用缺少 API Key，或 Key 无效、已停用。
- 429
- 在线或鉴权调用已达到共享限速。
参数与限制
| 参数 | 要求 | 默认值 | 可用值 |
|---|---|---|---|
imageA第一张图片 | 必填 | — | file |
imageB第二张图片 | 必填 | — | file |
API 调用示例
下面是用于程序代码的鉴权示例；上方在线 Playground 不会要求或暴露你的 API Key。
curl -X POST "https://apiany.ai/api/free/image-similarity" \ -H "Authorization: Bearer $API_KEY" \ -F "imageA=@a.png" \ -F "imageB=@b.png"
常见问题
使用 比较图片相似度 需要 API Key 吗？
在线 Playground 无需 Key；程序请求请通过 Authorization: Bearer 或 X-API-Key 发送 APIAny Key。
比较图片相似度 有哪些使用限制？
在线工具每分钟最多 3 次、每天 30 次；鉴权免费账户为 5 RPM，付费账户为 500 RPM，并在全部免费 API 间共享。
比较图片相似度 支持哪些输入？
请按参数表提供必填与选填字段；不支持的格式和超出范围的值会被拒绝。
比较图片相似度 返回什么？
成功请求返回 json 响应；失败时使用上方列出的 HTTP 状态码。
信息来源：APIAny 免费 API 目录与实际路由行为。内容复核日期：2026-07-17。