Detect and remove reference logos from an image | Ideogram

Detects caller-supplied reference logos in a flat design image, inpaints them out, and returns the cleaned image together with the matched bounding boxes (each tagged with the matching reference’s REF_<n>).

Authentication

Api-Keystring

API key for access control. Use in the header with the name “Api-Key”

Request

A request to detect image-reference matches in a flat design image.

design_imagefileRequired

The flat design image to analyze. The image should be in JPEG, PNG, or WebP format (max size 25MB).

reference_imagesfilesRequired

Reference image assets to match against logos and image elements detected in design_image. Each entry is assigned a ref_id of REF_0, REF_1, … in the order it appears in the request (maximum 10 images). The images should be in JPEG, PNG, or WebP format.

Response

Detection completed (may contain zero matches).

base_image_urlstringformat: "uri"

URL of the design image with all detected reference images inpainted out.

layerslist of objects

Matched reference images, each with its bounding box on the original design.

Errors

400

Bad Request Error

429

Too Many Requests Error

$	curl -X POST https://api.ideogram.ai/v1/layerize-logos \
>	-H "Api-Key: <apiKey>" \
>	-H "Content-Type: multipart/form-data" \
>	-F design_image=@<file1> \
>	-F reference_images=@<file2> \
>	-F reference_images=@<file3>

1	{
2	"base_image_url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89",
3	"layers": [
4	{
5	"x": 832,
6	"y": 96,
7	"width": 220,
8	"height": 88,
9	"ref_id": "REF_0"
10	}
11	]
12	}