Saltar al cuntegna

Ideogram · v3 · Layerize Text

Integrar

ID dal model 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Questa dumonda: $0,09 90 credits API Lantschar sin questa pagina

Obtegna ina clav API
Ideogram · Maletg

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

Prompt opziunal che dirigia la conversiun en stresas.

•obligatori image_url
Trametta in datoteca u

URL d'in maletg grafic plat per la conversiun en stresas. Formats acceptads: JPEG, PNG e WebP; grondezza maximala: 10 MB.

Avanzà 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

URL da la datoteca da font per il text h1; incompatibel cun font_name_h1.

Num da la font per il text h1; incompatibel cun font_file_h1_url.

URL da la datoteca da font per il text h2; incompatibel cun font_name_h2.

Num da la font per il text h2; incompatibel cun font_file_h2_url.

URL da la datoteca da font per il text dal corp; incompatibel cun font_name_body.

Num da la font per il text dal corp; incompatibel cun font_file_body_url.

URL da la datoteca da font per il text pitschen; incompatibel cun font_name_small.

Num da la font per il text pitschen; incompatibel cun font_file_small_url.

Seed utilisà dal generatur da nums casuals.

POST /run/ideogram/v3/layerize-text?wait=20 calculaziun → $0,09
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Ideogram · v3 · Layerize Text

Prenda ina grafica plana (`image_url`, JPEG, PNG u WebP, fin a 10MB) e returna il fund senza text, ils layers da maletg extrads, containers da text structurads ed HTML da surposiziun per la recomposiziun. Las tipografias pon vegnir definidas per h1, h2, text ed il text pitschen tenor num u URL da datoteca. In `prompt` ed in `seed` èn opziunals.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
image_urlobligatori image
Tipurl · image
URL d'in maletg grafic plat per la conversiun en stresas. Formats acceptads: JPEG, PNG e WebP; grondezza maximala: 10 MB.
promptopziunal
Tipstring | null
Prompt opziunal che dirigia la conversiun en stresas.
seedopziunal
Tipinteger | null
Seed utilisà dal generatur da nums casuals.
font_file_h1_urlopziunal
Tipstring | null
URL da la datoteca da font per il text h1; incompatibel cun font_name_h1.
font_name_h1opziunal
Tipstring | null
Num da la font per il text h1; incompatibel cun font_file_h1_url.
font_file_h2_urlopziunal
Tipstring | null
URL da la datoteca da font per il text h2; incompatibel cun font_name_h2.
font_name_h2opziunal
Tipstring | null
Num da la font per il text h2; incompatibel cun font_file_h2_url.
font_file_body_urlopziunal
Tipstring | null
URL da la datoteca da font per il text dal corp; incompatibel cun font_name_body.
font_name_bodyopziunal
Tipstring | null
Num da la font per il text dal corp; incompatibel cun font_file_body_url.
font_file_small_urlopziunal
Tipstring | null
URL da la datoteca da font per il text pitschen; incompatibel cun font_name_small.
font_name_smallopziunal
Tipstring | null
Num da la font per il text pitschen; incompatibel cun font_file_small_url.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
image
object {url, content_type, file_name, file_size}Maletg dal fund suenter la stizzada da ses text.
prompt
stringCuntegna il prompt da stratificaziun suenter in'eventuala extensiun da MagicPrompt; el po pia differir da l'input original.
text_containers
array of object | nullConteneders da text organisads sco ierarchia da conteneders, elements e spans.
text_html
string | nullOverlay HTML renderisà utilisà per cumponer il text sin il maletg dal fund.
image_layers
array of objectStratis da maletg separadas dal design.
seed
integerValur semenza utilisada per la generaziun da numbers casuals.

Dapli models: Modificaziun da maletgs

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/ideogram/v3/layerize-text.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt