---
title: "Layerize Text"
method: POST
path: "/v1/ideogram-v3/layerize-text"
tags: ["generate"]
---

# Layerize Text

`POST /v1/ideogram-v3/layerize-text`

Analyzes an image to detect text regions, then returns each detected text block with its position, content, font information, and styling.

The response includes a text-erased base image (background with all text removed) and a flat list of detected text blocks.

Supported image formats include JPEG, PNG, and WebP (max size 25MB).

Image links are available for a limited period of time; if you would like to keep the image, you must download it.

## Headers

- `Api-Key` string, required

## Response `200`

Text layers detected and extracted successfully.

- LayerizeTextResponse — The response containing detected text blocks and a text-erased base image. 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 image with all detected text removed.
  - `original_image_url` string, uri, nullable — URL of the original image with text intact.
  - `seed` integer, required — Random seed. Set for reproducible generation.

## Other responses

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

---

[API](https://skmtc.dev/ideogram/apis/api-reference.md) · [All operations](https://skmtc.dev/ideogram/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ideogram/api-reference/revisions/d4cec35f719f/schema)