Image to Image Search | Coactive AI

1 curl -X POST https://api.coactive.ai/api/v1/search/image-to-image \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "dataset_id": "12345678-abcd-90ef-1234-56789abcdef0", 6 "offset": 0, 7 "limit": 100, 8 "public_url": "https://example.com/image.jpg", 9 "asset_type": "image" 10 }'

1 { 2 "data": [ 3 { 4 "created_user_id": "auth0|a1b2c3d4e5f6g7h8i9j0klmn", 5 "created_dt": "2025-02-19T18:58:05.634141Z", 6 "updated_user_id": "auth0|a1b2c3d4e5f6g7h8i9j0klmn", 7 "updated_dt": "2025-02-19T19:12:53.423655Z", 8 "coactive_image_id": "e4786f8c-1d4c-494e-84c3-cb97961aeeb3", 9 "path": "s3://bucket/assets/sunset1.jpg", 10 "id": null, 11 "metadata": null, 12 "moderation_score": null 13 }, 14 { 15 "created_user_id": "auth0|a1b2c3d4e5f6g7h8i9j0klmn", 16 "created_dt": "2025-02-19T18:58:05.643135Z", 17 "updated_user_id": "auth0|a1b2c3d4e5f6g7h8i9j0klmn", 18 "updated_dt": "2025-02-19T19:12:53.423655Z", 19 "coactive_image_id": "941b2bd8-5a0e-4a4c-af68-558b96089c29", 20 "path": "s3://bucket/assets/sunset2.jpg", 21 "id": null, 22 "metadata": null, 23 "moderation_score": null 24 } 25 ] 26 }

Get the images most similar to the image provided within the same dataset

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

dataset_idstringRequiredformat: "uuid4"

The unique identifier for the dataset

offsetinteger or any or nullOptional

Starting index to return

limitinteger or any or nullOptional

Max number of items to return

metadata_filtersobject or any or nullOptional

List of metadata filters to apply to the search

coactive_image_idstring or any or nullOptional

The image to search for represented with a CID

public_urlstring or any or nullOptional

The image to search for represented with a public http url

asset_typeenum or nullOptional

The asset type to filter results by. If no asset type is selected the endpoint will search over images and videos

Response

Successful Response

datalist of any

The paginated results

Authentication

Request

Response

Errors