Skip to content

Ideogram · v3 · Layerize Text

Integrate

Model id ideogram/v3/layerize-text
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/v3/layerize-text?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $0.09 90 API credits · ≈ ₽9.59 Run it on this page

Get API key
Ideogram · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

Optional prompt that guides conversion into layers.

•required image_url
Drop a file, or

Flat graphic image URL for conversion into layers. Accepted formats are JPEG, PNG, and WebP; maximum file size is 10 MB.

Advanced font_file_h1_url · font_name_h1 · font_file_h2_url · font_name_h2 · font_file_body_url · font_name_body · font_file_small_url · font_name_small · seed

Font file URL for h1 text; mutually exclusive with font_name_h1.

Font name for h1 text; mutually exclusive with font_file_h1_url.

Font file URL for h2 text; mutually exclusive with font_name_h2.

Font name for h2 text; mutually exclusive with font_file_h2_url.

Font file URL for body text; mutually exclusive with font_name_body.

Font name for body text; mutually exclusive with font_file_body_url.

Font file URL for small text; mutually exclusive with font_name_small.

Font name for small text; mutually exclusive with font_file_small_url.

Seed used by the random-number generator.

POST /run/ideogram/v3/layerize-text?wait=20 quote → $0.09
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ideogram/v3/layerize-text?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Ideogram · v3 · Layerize Text

Takes a flat graphic (`image_url`, JPEG, PNG or WebP, up to 10MB) and returns the background with text removed, extracted image layers, structured text containers and overlay HTML for recompositing. Fonts can be set for h1, h2, body and small text by name or by file URL. An optional `prompt` and `seed` are accepted.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urlrequired image
Typeurl · image
Flat graphic image URL for conversion into layers. Accepted formats are JPEG, PNG, and WebP; maximum file size is 10 MB.
promptoptional
Typestring | null
Optional prompt that guides conversion into layers.
seedoptional
Typeinteger | null
Seed used by the random-number generator.
font_file_h1_urloptional
Typestring | null
Font file URL for h1 text; mutually exclusive with font_name_h1.
font_name_h1optional
Typestring | null
Font name for h1 text; mutually exclusive with font_file_h1_url.
font_file_h2_urloptional
Typestring | null
Font file URL for h2 text; mutually exclusive with font_name_h2.
font_name_h2optional
Typestring | null
Font name for h2 text; mutually exclusive with font_file_h2_url.
font_file_body_urloptional
Typestring | null
Font file URL for body text; mutually exclusive with font_name_body.
font_name_bodyoptional
Typestring | null
Font name for body text; mutually exclusive with font_file_body_url.
font_file_small_urloptional
Typestring | null
Font file URL for small text; mutually exclusive with font_name_small.
font_name_smalloptional
Typestring | null
Font name for small text; mutually exclusive with font_file_small_url.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3/layerize-text",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 90,
    "usd": "0.09",
    "charged": 90,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "prompt": "string",
    "text_containers": [
      {}
    ],
    "text_html": "string",
    "image_layers": [
      {}
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
image
object {url, content_type, file_name, file_size}Background image after removal of its text.
prompt
stringContains the layerization prompt after any MagicPrompt expansion, so it may not match the original input.
text_containers
array of object | nullText containers organized as a hierarchy of containers, items, and spans.
text_html
string | nullRendered HTML overlay used to composite text onto the background image.
image_layers
array of objectImage layers separated out of the design.
seed
integerSeed value used for random number generation.

More models: Image Editing

For AI agents: this page as Markdown is at https://doitong.com/en-US/developers/models/ideogram/v3/layerize-text.md. All models and guides: https://doitong.com/developers/llms.txt