MODEL IDideogram-layerize-text

live

Ideogram Layerize Text

by IdeogramApril 1, 2026

Ideogram Layerize Text analyzes an image, detects readable text regions, and turns each line into structured editable text blocks with position, styling, and font information. It also returns a text-erased base image, making it useful for posters, social graphics, packaging, book covers, and other design workflows where copy needs to change without regenerating the whole composition.

API Options

Platform-level options for task execution and delivery.

taskType stringrequiredvalue: imageInference: Identifier for the type of task being performed

taskUUID stringrequiredUUID v4: UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

outputType stringdefault: URL: Image output type.
Allowed values3 values

outputFormat stringdefault: JPG

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

`JPG`: Best for photorealistic images with smaller file sizes (no transparency).
`PNG`: Lossless compression, supports high quality and transparency (alpha channel).
`WEBP`: Modern format providing superior compression and transparency support.

**Transparency**: If you are using features like background removal or LayerDiffuse that require transparency, you must select a format that supports an alpha channel (e.g., `PNG`, `WEBP`, `TIFF`). `JPG` does not support transparency.

Allowed values3 values

outputQuality integermin: 20max: 99default: 95: Compression quality of the output. Higher values preserve quality but increase file size.

webhookURL stringURI

Specifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

Learn more1 resource

Webhooks
PLATFORM

deliveryMethod stringdefault: sync

Determines how the API delivers task results.

Allowed values2 values

: Returns complete results directly in the API response.
: Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

Learn more1 resource

Task Polling
PLATFORM

uploadEndpoint stringURI

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

Common use cases:

Cloud storage: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
CDN integration: Upload to content delivery networks for immediate distribution.

// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg

The content data will be sent as the request body to the specified URL when generation is complete.

safety object

Content safety checking configuration for image generation.

Properties1 property

safety » checkContent checkContent booleandefault: false: Enable or disable content safety checking.

ttl integermin: 60: Time-to-live (TTL) in seconds for generated content. Only applies when outputType is URL.

includeCost booleandefault: false: Include task cost in the response.

Inputs

Input resources for the task (images, audio, etc). These must be nested inside the inputs object.

inputs » image image stringrequired: Image input (UUID, URL, Data URI, or Base64).

Core Parameters

Primary parameters that define the task output.

numberResults integermin: 1max: 20default: 1: Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

model stringrequiredvalue: ideogram-layerize-text: Identifier of the model to use for generation.

positivePrompt string: An optional text description of the image. If not provided, a description will be auto-generated from the image.

seed integermin: 0max: 2147483647: Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.

taskType stringrequiredvalue: imageInference: Identifier for the type of task this response belongs to.

taskUUID stringrequiredUUID v4: UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

imageUUID stringrequiredUUID v4: UUID of the output image.

imageURL stringURI: URL of the output image.

imageBase64Data string: Base64-encoded image data.

imageDataURI stringURI: Data URI of the output image.

seed integer: The seed used for generation. If none was provided, shows the randomly generated seed.

NSFWContent boolean: Flag indicating if NSFW content was detected.

cost float: Task cost in USD. Present when includeCost is set to true in the request.

outputs object

Generated output artifacts.

Properties1 property

outputs » textBlocks textBlocks array of objects

Detected text regions with position, content, styling, and font metadata.

Properties14 properties

outputs » textBlocks » width width integer: Width of the text block bounding box, in pixels.

outputs » textBlocks » height height integer: Height of the text block bounding box, in pixels.

outputs » textBlocks » alignment alignment string: Text alignment within the block.

outputs » textBlocks » angle angle float: Rotation angle of the text block in degrees.

outputs » textBlocks » color color string: Text color as a hex value.

outputs » textBlocks » fontAlternatives fontAlternatives array of strings: Alternative font names that visually match the detected text style.

outputs » textBlocks » fontName fontName string: Primary font file name detected for the text block.

outputs » textBlocks » fontSize fontSize float: Font size in pixels.

outputs » textBlocks » formatting formatting array of strings: Text formatting styles applied to the block.

outputs » textBlocks » lineHeight lineHeight float: Line height as a multiplier of the font size.

outputs » textBlocks » role role string: Semantic role assigned to the text block, such as heading or body.

outputs » textBlocks » text text string: The detected text content, including line breaks.

outputs » textBlocks » x x integer: Horizontal offset of the text block from the left edge, in pixels.

outputs » textBlocks » y y integer: Vertical offset of the text block from the top edge, in pixels.