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

## Changes

- **2026-08-28** `d4cec35f719f` — 1 info
  - api operation id `post-layerize-text-v-3` removed and replaced with `post_layerize_text_v3`
- **2026-08-21** `5b667dae2a60` — 2 warning
  - the `seed` request property's max was set to `2147483647.00`
  - the `seed` request property's min was set to `0.00`

[Change history](https://skmtc.dev/ideogram/apis/api-reference/changes/v1/ideogram-v3/layerize-text/post.md)

---

[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)