Find similar indexed images

curl --request POST \
  --url https://api.lightdrift.ai/v1/similar \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "asset_id": "<string>"
}
'

import requests

url = "https://api.lightdrift.ai/v1/similar"

payload = { "asset_id": "<string>" }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({asset_id: '<string>'})
};

fetch('https://api.lightdrift.ai/v1/similar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "query_id": "q_db7b4305df746986bd859ae0",
  "results": [
    {
      "asset_id": "stocksnap:BAVURMUHRD",
      "score": 0.74583352,
      "title": "car auto",
      "source": "stocksnap",
      "ai_generated": false,
      "width": 5000,
      "height": 4000,
      "file": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:BAVURMUHRD",
      "thumb": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:BAVURMUHRD?v=thumb",
      "rights": {
        "license": "cc0",
        "license_verbatim": "CC0 1.0",
        "commercial": true,
        "attribution_required": false,
        "derivatives": true,
        "share_alike": false,
        "attribution": null,
        "provenance_url": "https://stocksnap.io/photo/car-auto-BAVURMUHRD",
        "basis": "as-declared by source; verify for critical use"
      }
    },
    {
      "asset_id": "stocksnap:77BA6D52D0",
      "score": 0.7300238,
      "title": "red car",
      "source": "stocksnap",
      "ai_generated": false,
      "width": 5035,
      "height": 3339,
      "file": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:77BA6D52D0",
      "thumb": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:77BA6D52D0?v=thumb",
      "rights": {
        "license": "cc0",
        "license_verbatim": "CC0 1.0",
        "commercial": true,
        "attribution_required": false,
        "derivatives": true,
        "share_alike": false,
        "attribution": null,
        "provenance_url": "https://stocksnap.io/photo/red-car-77BA6D52D0",
        "basis": "as-declared by source; verify for critical use"
      }
    },
    {
      "asset_id": "wm_quality:153180537",
      "score": 0.71327692,
      "title": "2024 Międzylesie, ul. Waryńskiego 11.jpg",
      "source": "wm_quality",
      "ai_generated": false,
      "width": 3222,
      "height": 2838,
      "file": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/wm_quality:153180537",
      "thumb": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/wm_quality:153180537?v=thumb",
      "rights": {
        "license": "cc-by-sa",
        "license_verbatim": "CC BY-SA 4.0",
        "commercial": true,
        "attribution_required": true,
        "derivatives": true,
        "share_alike": true,
        "attribution": "\"2024 Międzylesie, ul. Waryńskiego 11.jpg\" by Jacek Halicki, wm_quality, CC BY-SA",
        "provenance_url": "https://commons.wikimedia.org/wiki/File:2024_Mi%C4%99dzylesie,_ul._Wary%C5%84skiego_11.jpg",
        "basis": "as-declared by source; verify for critical use"
      }
    },
    {
      "asset_id": "stocksnap:UOYLKV7K27",
      "score": 0.69847137,
      "title": "car auto",
      "source": "stocksnap",
      "ai_generated": false,
      "width": 4898,
      "height": 3265,
      "file": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:UOYLKV7K27",
      "thumb": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:UOYLKV7K27?v=thumb",
      "rights": {
        "license": "cc0",
        "license_verbatim": "CC0 1.0",
        "commercial": true,
        "attribution_required": false,
        "derivatives": true,
        "share_alike": false,
        "attribution": null,
        "provenance_url": "https://stocksnap.io/photo/car-auto-UOYLKV7K27",
        "basis": "as-declared by source; verify for critical use"
      }
    },
    {
      "asset_id": "wm_quality:75913777",
      "score": 0.69786596,
      "title": "2001 Rover Mini Cooper Sport 1.3 Rear.jpg",
      "source": "wm_quality",
      "ai_generated": false,
      "width": 3840,
      "height": 2479,
      "file": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/wm_quality:75913777",
      "thumb": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/wm_quality:75913777?v=thumb",
      "rights": {
        "license": "cc-by-sa",
        "license_verbatim": "CC BY-SA 4.0",
        "commercial": true,
        "attribution_required": true,
        "derivatives": true,
        "share_alike": true,
        "attribution": "\"2001 Rover Mini Cooper Sport 1.3 Rear.jpg\" by Vauxford, wm_quality, CC BY-SA",
        "provenance_url": "https://commons.wikimedia.org/wiki/File:2001_Rover_Mini_Cooper_Sport_1.3_Rear.jpg",
        "basis": "as-declared by source; verify for critical use"
      }
    }
  ],
  "latency_ms": 72,
  "timing_ms": {
    "retrieve": 72
  },
  "ranking": "none",
  "mode": "none",
  "pool_size": 99,
  "reranked": 0,
  "backend": "voyage"
}

POST

similar

Find similar indexed images

curl --request POST \
  --url https://api.lightdrift.ai/v1/similar \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "asset_id": "<string>"
}
'

import requests

url = "https://api.lightdrift.ai/v1/similar"

payload = { "asset_id": "<string>" }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({asset_id: '<string>'})
};

fetch('https://api.lightdrift.ai/v1/similar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "query_id": "q_db7b4305df746986bd859ae0",
  "results": [
    {
      "asset_id": "stocksnap:BAVURMUHRD",
      "score": 0.74583352,
      "title": "car auto",
      "source": "stocksnap",
      "ai_generated": false,
      "width": 5000,
      "height": 4000,
      "file": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:BAVURMUHRD",
      "thumb": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:BAVURMUHRD?v=thumb",
      "rights": {
        "license": "cc0",
        "license_verbatim": "CC0 1.0",
        "commercial": true,
        "attribution_required": false,
        "derivatives": true,
        "share_alike": false,
        "attribution": null,
        "provenance_url": "https://stocksnap.io/photo/car-auto-BAVURMUHRD",
        "basis": "as-declared by source; verify for critical use"
      }
    },
    {
      "asset_id": "stocksnap:77BA6D52D0",
      "score": 0.7300238,
      "title": "red car",
      "source": "stocksnap",
      "ai_generated": false,
      "width": 5035,
      "height": 3339,
      "file": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:77BA6D52D0",
      "thumb": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:77BA6D52D0?v=thumb",
      "rights": {
        "license": "cc0",
        "license_verbatim": "CC0 1.0",
        "commercial": true,
        "attribution_required": false,
        "derivatives": true,
        "share_alike": false,
        "attribution": null,
        "provenance_url": "https://stocksnap.io/photo/red-car-77BA6D52D0",
        "basis": "as-declared by source; verify for critical use"
      }
    },
    {
      "asset_id": "wm_quality:153180537",
      "score": 0.71327692,
      "title": "2024 Międzylesie, ul. Waryńskiego 11.jpg",
      "source": "wm_quality",
      "ai_generated": false,
      "width": 3222,
      "height": 2838,
      "file": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/wm_quality:153180537",
      "thumb": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/wm_quality:153180537?v=thumb",
      "rights": {
        "license": "cc-by-sa",
        "license_verbatim": "CC BY-SA 4.0",
        "commercial": true,
        "attribution_required": true,
        "derivatives": true,
        "share_alike": true,
        "attribution": "\"2024 Międzylesie, ul. Waryńskiego 11.jpg\" by Jacek Halicki, wm_quality, CC BY-SA",
        "provenance_url": "https://commons.wikimedia.org/wiki/File:2024_Mi%C4%99dzylesie,_ul._Wary%C5%84skiego_11.jpg",
        "basis": "as-declared by source; verify for critical use"
      }
    },
    {
      "asset_id": "stocksnap:UOYLKV7K27",
      "score": 0.69847137,
      "title": "car auto",
      "source": "stocksnap",
      "ai_generated": false,
      "width": 4898,
      "height": 3265,
      "file": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:UOYLKV7K27",
      "thumb": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/stocksnap:UOYLKV7K27?v=thumb",
      "rights": {
        "license": "cc0",
        "license_verbatim": "CC0 1.0",
        "commercial": true,
        "attribution_required": false,
        "derivatives": true,
        "share_alike": false,
        "attribution": null,
        "provenance_url": "https://stocksnap.io/photo/car-auto-UOYLKV7K27",
        "basis": "as-declared by source; verify for critical use"
      }
    },
    {
      "asset_id": "wm_quality:75913777",
      "score": 0.69786596,
      "title": "2001 Rover Mini Cooper Sport 1.3 Rear.jpg",
      "source": "wm_quality",
      "ai_generated": false,
      "width": 3840,
      "height": 2479,
      "file": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/wm_quality:75913777",
      "thumb": "https://api.lightdrift.ai/v1/asset/q_db7b4305df746986bd859ae0/wm_quality:75913777?v=thumb",
      "rights": {
        "license": "cc-by-sa",
        "license_verbatim": "CC BY-SA 4.0",
        "commercial": true,
        "attribution_required": true,
        "derivatives": true,
        "share_alike": true,
        "attribution": "\"2001 Rover Mini Cooper Sport 1.3 Rear.jpg\" by Vauxford, wm_quality, CC BY-SA",
        "provenance_url": "https://commons.wikimedia.org/wiki/File:2001_Rover_Mini_Cooper_Sport_1.3_Rear.jpg",
        "basis": "as-declared by source; verify for critical use"
      }
    }
  ],
  "latency_ms": 72,
  "timing_ms": {
    "retrieve": 72
  },
  "ranking": "none",
  "mode": "none",
  "pool_size": 99,
  "reranked": 0,
  "backend": "voyage"
}

Authorizations

X-API-Key

string

header

required

Your Lightdrift API key. Usage is metered per query.

Headers

Idempotency-Key

string

default:""

Body

application/json

asset_id

string

required

integer

default:10

Required range: 1 <= x <= 100

ann_k

integer

default:100

Required range: 1 <= x <= 1000

ann_ef

integer

default:2048

Required range: 64 <= x <= 4096

explain

boolean

default:false

filters

Filters · object

Show child attributes

client_session

string | null

Response

Search results and source-declared rights.

query_id

string

results

object[]

Show child attributes

latency_ms

integer

timing_ms

object

Show child attributes

mode

string

ranking

string

text, image, multimodal, none, or none (degraded). Multimodal scores fuse similarity and text ranks; scores are not probabilities.

pool_size

integer

reranked

integer

backend

string

Search responses report voyage.

degraded

string

Reranker unavailable; results are in retrieval order. Successful billed response.

relaxed

string[]

Default filters relaxed to fill results; explicit constraints are not relaxed.

query_type

enum<string>

Input modality for /v1/search.

Available options:

text,

image,

image_text

Getting started

Endpoints

Find similar indexed images

Authorizations

Headers

Body

Response