Sign in

v4

latestOpenAPI 3.0.22026-08-02109239415.7 KB
generate

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 10MB).

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

post/v1/ideogram-v3/layerize-text

Response

Text layers detected and extracted successfully.

base_image_urlstring uri required

URL of the image with all detected text removed.

original_image_urlstring uri nullable

URL of the original image with text intact.

seedinteger required

Random seed. Set for reproducible generation.

Example response

{
  "original_image_url": "https://openapi-generator.tech",
  "seed": 12345,
  "base_image_url": "https://openapi-generator.tech",
  "text_blocks": [
    {
      "role": "heading",
      "color": "#212121",
      "font_alternatives": [
        "font_alternatives",
        "font_alternatives"
      ],
      "font_size": 2,
      "font_name": "font_name",
      "line_height": 7.0614014,
      "x": 0,
      "width": 1,
      "y": 6,
      "angle": 5.637377,
      "text": "Hello World",
      "alignment": "left",
      "formatting": [
        "bold",
        "bold"
      ],
      "height": 5
    },
    {
      "role": "heading",
      "color": "#212121",
      "font_alternatives": [
        "font_alternatives",
        "font_alternatives"
      ],
      "font_size": 2,
      "font_name": "font_name",
      "line_height": 7.0614014,
      "x": 0,
      "width": 1,
      "y": 6,
      "angle": 5.637377,
      "text": "Hello World",
      "alignment": "left",
      "formatting": [
        "bold",
        "bold"
      ],
      "height": 5
    }
  ]
}