Ideogram

ideogram-v3-layerize-text

Image editby Ideogram

Ideogram Layerize takes an existing flat graphic, removes text, and returns structured text containers you can edit/recompose in html or json format.

images

Prices in credits (1 credit = $0.01).

Data schema

Field	Type	Description
seed	—	Seed for the random number generator.
prompt	—	Optional prompt to guide the layerization.
image_urlrequired	string	URL of the flat graphic image to layerize. Must be JPEG, PNG, or WebP (max 10MB).
sync_mode	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history.
font_name_h1	—	Name of the font to use for h1 text. Cannot be used with font_file_h1_url.
font_name_h2	—	Name of the font to use for h2 text. Cannot be used with font_file_h2_url.
font_name_body	—	Name of the font to use for body text. Cannot be used with font_file_body_url.
font_name_small	—	Name of the font to use for small text. Cannot be used with font_file_small_url.
font_file_h1_url	—	URL of the font file to use for h1 text. Cannot be used with font_name_h1.
font_file_h2_url	—	URL of the font file to use for h2 text. Cannot be used with font_name_h2.
font_file_body_url	—	URL of the font file to use for body text. Cannot be used with font_name_body.
font_file_small_url	—	URL of the font file to use for small text. Cannot be used with font_name_small.

Field	Type	Description
seed	integer	Seed used for the random number generator.
image	—	The background image with text removed.
prompt	string	The prompt used for layerization. May differ from the input prompt if MagicPrompt expanded it.
text_html	—	Rendered overlay HTML for compositing text over the background image.
image_layers	array	Image layers extracted from the design.
text_containers	—	Structured text containers with hierarchical text data (container -> items -> spans).