---
title: "Find images similar to a run's worst validation images"
method: GET
path: "/api/models/{owner}/{project}/{model}/similar-images"
tags: ["Models"]
---

# Find images similar to a run's worst validation images

`GET /api/models/{owner}/{project}/{model}/similar-images`

## Request

- Base URL: `https://platform.ultralytics.com`
- URL: `https://platform.ultralytics.com/api/models/{owner}/{project}/{model}/similar-images`
- Auth: HTTP bearer

Returns images from public datasets and your own and team datasets that look like the ones this training run scored worst on, drawn from each worst image's nearest neighbors in turn and excluding images the training dataset already holds. Empty when the run recorded no per-image results.

## Path parameters

- `owner` string, required
- `project` string, required
- `model` string, required

## Query parameters

- `hashes` string

## Response `200`

Similar images with filenames and dimensions

- SimilarImagesResponse
  - `images` object[], required
    - `name` string, required
    - `hash` string, required
    - `width` integer, required
    - `height` integer, required
    - `id` string, required
    - `thumbnailUrl` string, uri, required
    - `imageUrl` string, uri
    - `dataset` object, required
      - `owner` string, required
      - `dataset` string, required
      - `license` 'None' | 'CC0-1.0' | 'PDM-1.0' | 'CC-BY-2.5' | 'CC-BY-3.0' | 'CC-BY-4.0' | 'CC-BY-NC-2.0' | 'CC-BY-NC-3.0' | 'CC-BY-NC-4.0' | 'CC-BY-SA-3.0' | 'CC-BY-SA-4.0' | 'CC-BY-NC-SA-3.0' | 'CC-BY-NC-SA-4.0' | 'CC-BY-ND-4.0' | 'CC-BY-NC-ND-2.0' | 'CC-BY-NC-ND-4.0' | 'Apache-2.0' | 'MIT' | 'BSD-3-Clause' | 'AGPL-3.0' | 'GPL-2.0' | 'GPL-3.0' | 'LGPL-3.0' | 'ODbL-1.0' | 'DbCL-1.0' | 'Research-Only' | 'Other', required: Dataset license identifier
    - `score` number, required: Cosine similarity rescaled to 0-1 as (1 + cos) / 2

## Other responses

- `400`: Invalid path or hashes outside the captured worst cohort
- `401`: Missing or invalid authentication
- `404`: Model not found, has no validated run, or none of its selected worst images are embedded
- `429`: Rate limit exceeded

## Changes

- **2026-09-17** `51981d882390`: 4 info
  - added the required property `images/items/hash` to the response with the `200` status
  - added the required property `images/items/height` to the response with the `200` status
  - added the required property `images/items/name` to the response with the `200` status
  - added the required property `images/items/width` to the response with the `200` status
- **2026-09-08** `e34b739f5675`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ultralytics/apis/ultralytics-platform-api/changes/api/models/:owner/:project/:model/similar-images/get.md)

---

[API](https://skmtc.dev/ultralytics/apis/ultralytics-platform-api.md) - [All operations](https://skmtc.dev/ultralytics/apis/ultralytics-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ultralytics/apis/ultralytics-platform-api/revisions/9c562e23b0e4?raw)