שפּרינגען צו אינהאַלט

Ideogram · v3 · Layerize Text

אינטעגרירן

מאָדעל־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.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"

דער דאָזיקער ריקוועסט: ⁨$ 0.09⁩ 90 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Ideogram בילד־עדיטירונג #stylized#transform#typography

צעטיילט אַ פֿלאַכן גראַפֿיק אין אַ טעקסט־פֿרײַען הינטערגרונט פּלוס רעדאַקטירבאַרע טעקסט־קאַנטיינערס און HTML

Ideogram · בילד

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

אָפּציאָנאַלער פּראָמפּט וואָס פירט די קאָנווערטירונג אין לייַערס.

•פארלאנגט image_url
לייגט אַרײַן אַ טעקע, אָדער

URL פֿון אַ פֿלאַכן גראַפֿישן בילד פֿאַר קאָנווערטירן אין לייַערס. אנגענומענע פֿאָרמאַטן: JPEG, PNG און WebP; מאַקסימום פֿײַל־גרייס: 10 MB.

פֿאָרגעשריטן 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 פֿון דער פֿאָנט־פֿײַל פֿאַר h1 טעקסט; נישט צוזאַמען מיט font_name_h1.

פֿאָנט־נאָמען פֿאַר h1 טעקסט; נישט צוזאַמען מיט font_file_h1_url.

URL פֿון דער פֿאָנט־פֿײַל פֿאַר h2 טעקסט; נישט צוזאַמען מיט font_name_h2.

פֿאָנט־נאָמען פֿאַר h2 טעקסט; נישט צוזאַמען מיט font_file_h2_url.

URL פֿון דער פֿאָנט־פֿײַל פֿאַר גוף־טעקסט; נישט צוזאַמען מיט font_name_body.

פֿאָנט־נאָמען פֿאַר גוף־טעקסט; נישט צוזאַמען מיט font_file_body_url.

URL פֿון דער פֿאָנט־פֿײַל פֿאַר קליינעם טעקסט; נישט צוזאַמען מיט font_name_small.

פֿאָנט־נאָמען פֿאַר קליינעם טעקסט; נישט צוזאַמען מיט font_file_small_url.

סיד גענוצט דורכן ראַנדאָם־צאָל־גענעראַטאָר.

POST /run/ideogram/v3/layerize-text?wait=20 פּרײַז → ⁨$ 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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Ideogram · v3 · Layerize Text

נעמט אַ פֿלאַכע גראַפֿיק (`image_url`, JPEG, PNG אָדער WebP, ביז 10MB) און גיט צוריק דעם הינטערגרונט אָן טעקסט, אַרויסגעצויגענע בילד־שיכטן, סטרוקטורירטע טעקסט־קאָנטיינערס און HTML־איבערלאַגערונגען פֿאַר נײַער צונויפֿשטעלונג. שריפֿטן פֿאַר h1, h2, הויפּטטעקסט און קליינעם טעקסט קען מען באַשטימען לויטן נאָמען אָדער אַ פֿײַל־URL. אַן אָפּציאָנאַלער `prompt` און `seed` ווערן אָנגענומען.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
URL פֿון אַ פֿלאַכן גראַפֿישן בילד פֿאַר קאָנווערטירן אין לייַערס. אנגענומענע פֿאָרמאַטן: JPEG, PNG און WebP; מאַקסימום פֿײַל־גרייס: 10 MB.
promptאָפּציאָנעל
טיפּstring | null
אָפּציאָנאַלער פּראָמפּט וואָס פירט די קאָנווערטירונג אין לייַערס.
seedאָפּציאָנעל
טיפּinteger | null
סיד גענוצט דורכן ראַנדאָם־צאָל־גענעראַטאָר.
font_file_h1_urlאָפּציאָנעל
טיפּstring | null
URL פֿון דער פֿאָנט־פֿײַל פֿאַר h1 טעקסט; נישט צוזאַמען מיט font_name_h1.
font_name_h1אָפּציאָנעל
טיפּstring | null
פֿאָנט־נאָמען פֿאַר h1 טעקסט; נישט צוזאַמען מיט font_file_h1_url.
font_file_h2_urlאָפּציאָנעל
טיפּstring | null
URL פֿון דער פֿאָנט־פֿײַל פֿאַר h2 טעקסט; נישט צוזאַמען מיט font_name_h2.
font_name_h2אָפּציאָנעל
טיפּstring | null
פֿאָנט־נאָמען פֿאַר h2 טעקסט; נישט צוזאַמען מיט font_file_h2_url.
font_file_body_urlאָפּציאָנעל
טיפּstring | null
URL פֿון דער פֿאָנט־פֿײַל פֿאַר גוף־טעקסט; נישט צוזאַמען מיט font_name_body.
font_name_bodyאָפּציאָנעל
טיפּstring | null
פֿאָנט־נאָמען פֿאַר גוף־טעקסט; נישט צוזאַמען מיט font_file_body_url.
font_file_small_urlאָפּציאָנעל
טיפּstring | null
URL פֿון דער פֿאָנט־פֿײַל פֿאַר קליינעם טעקסט; נישט צוזאַמען מיט font_name_small.
font_name_smallאָפּציאָנעל
טיפּstring | null
פֿאָנט־נאָמען פֿאַר קליינעם טעקסט; נישט צוזאַמען מיט font_file_small_url.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

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"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
image
object {url, content_type, file_name, file_size}באַקגראַונד־בילד נאָך דעם אַוועקנעמען פֿונעם טעקסט.
prompt
stringהאַלט דעם לייַעריזאַציע־פּראָמפּט נאָך דער MagicPrompt־אויסברייטונג, דערפֿאַר קען ער זיך אונטערשיידן פֿונעם אָריגינעלן אַרײַנגעבונג.
text_containers
array of object | nullטעקסט־קאַנטיינערס, אָרגאַניזירט ווי אַ כייעראַרקיע פֿון קאַנטיינערס, יטעמס און ספּאַנס.
text_html
string | nullגע־רענדערטער HTML־אָווערליי פֿאַר קאָמפּאָזירן טעקסט אויפֿן באַקגראַונד־בילד.
image_layers
array of objectבילד־לייַערס, אפֿגעטיילט פֿונעם דיזיין.
seed
integerSeed־ווערט פֿאַר טראַפצאָל־גענערירונג.

מער מאָדעלן: בילד־עדיטירונג

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/ideogram/v3/layerize-text.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt