---
title: "Logo recognition + inpainting (internal)"
method: POST
path: "/v1/layerize-logos"
tags: ["generate"]
---

# Logo recognition + inpainting (internal)

`POST /v1/layerize-logos`

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>`).

Internal-only; not surfaced on public Fern docs (path is excluded from the
Fern path allowlist in `openapi/fern-content/create_public_spec.py`). Uses
the default `Api-Key` security scheme — required because the underlying
sampling-coordinator submission carries user/org context, even though this
endpoint itself does not bill.

## Response `200`

Detection completed (may contain zero matches).

- LayerizeLogosResponse — Results of image-reference recognition. The `base_image_url` points at the design with the detected reference images inpainted out. The `layers` array lists each matched reference and its bounding box on the original image; it is empty when no reference image was matched. Image links are available for a limited period of time; if you would like to keep the image, you must download it.
  - `base_image_url` string, uri, required — URL of the design image with all detected reference images inpainted out.
  - `layers` ImageLayerV3[], required — Matched reference images, each with its bounding box on the original design.
    - `x` integer, required — The x coordinate of the layer.
    - `y` integer, required — The y coordinate of the layer.
    - `width` integer, required — The width of the layer.
    - `height` integer, required — The height of the layer.
    - `ref_id` string — Reference ID matching a provided reference image (e.g., "REF_0"), or -1 if no match.

## Other responses

- `400` — Invalid input provided.
- `429` — Too many requests.

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/versions/bd40f367a834/schema)