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

Ideogram V3 Edit

אינטעגרירן

מאָדעל־id ideogram/v3/edit
# 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/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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"

דער דאָזיקער ריקוועסט: ⁨$ 0.06⁩ 60 API־קרעדיטן · ≈ ⁨₽ 6.39⁩ לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Ideogram · בילד

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

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

בויען אַ בעטן

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

•פארלאנגט

פּראָמפּט וואָס באַשרײַבט דעם fill פֿאַר דער געמאסקירטער געגנט פֿונעם בילד.

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

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

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

Inpainting מאַסקע צוגעשטעלט דורך URL; סײַ ברייט סײַ הייך מוזן גענוי גלײַכן די קאָרעספּאָנדירנדיקע דימענסיעס פֿונעם אַרײַנגעבענעם בילד.

rendering_speed סטאַנדאַרט BALANCED

גיכקייט־באַשטעטיקונג פֿאַר רענדערינג.

num_images סטאַנדאַרט 1

צאָל בילדער צו שאַפֿן.

פֿאָרגעשריטן images · style_preset · seed · expand_prompt · style_codes · color_palette
image_urls
לייגט אַרײַן אַ טעקע, אָדער

סטיל־רעפֿערענץ־בילדער אין JPEG, PNG אָדער WebP פֿאָרמאַט. זייער צונויפֿגעשטעלטע גרייס טאָר נישט איבערגיין 10 MB.

סטיל־פּרעסעט וואָס פירט די בילד־גענערירונג.

זוימען־ווערט פֿאַר צופֿעליקער נומער־גענערירונג.

בילד־סטיל־קאָדן, צוגעשטעלט ווי העקסאַדעצימאַלע סטרינגס פֿון 8 אותיות; לאָזט אויס סײַ style_reference_images סײַ style ווען איר ניצט די ליסטע.

קאָליר־פּאַלעט גענוצט בעת גענערירונג. ספּעציפֿיצירט אָדער אַ פּריסעט דורך נאָמען, אָדער בפֿירוש העקסאַדעצימאַלע קאָלירן דורך members, אָפּציאָנאַל מיט וואָגונגען.

POST /run/ideogram/v3/edit?wait=20 פּרײַז → ⁨$ 0.06⁩
# 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/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "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"

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

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

וועגן Ideogram V3 Edit

פֿילט אַ מאַסקירטע געגנט אין אַ בילד לויט אַ `prompt`. דאָס בילד (`image_url`) און די מאַסקע (`mask_url`) מוזן האָבן די זעלבע דימענסיעס. דעם סטיל קענען פֿירן רעפֿערענץ־בילדער, `style_codes`, אַ `color_palette` אָדער אַ `style_preset`. רענדערינג־גיכקייט איז TURBO, BALANCED אָדער QUALITY, און מען קען צוריקגעבן 1 ביז 8 בילדער.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlsאָפּציאָנעל images
טיפּurl[] · image
סטיל־רעפֿערענץ־בילדער אין JPEG, PNG אָדער WebP פֿאָרמאַט. זייער צונויפֿגעשטעלטע גרייס טאָר נישט איבערגיין 10 MB.
rendering_speedאָפּציאָנעל
טיפּenum
סטאַנדאַרטBALANCED
TURBOBALANCEDQUALITY
גיכקייט־באַשטעטיקונג פֿאַר רענדערינג.
color_paletteאָפּציאָנעל
טיפּobject
קאָליר־פּאַלעט גענוצט בעת גענערירונג. ספּעציפֿיצירט אָדער אַ פּריסעט דורך נאָמען, אָדער בפֿירוש העקסאַדעצימאַלע קאָלירן דורך members, אָפּציאָנאַל מיט וואָגונגען.
color_palette.membersאָפּציאָנעל
טיפּobject[]
פּאַלעט־מיטגלידער־ליסטע וואָס באַשטימט די קאָלירן פֿון דער פּאַלעט.
color_palette.members[].rgbפארלאנגט
טיפּobject
קאָליר פֿון אַ פּאַלעט־מיטגליד אויסגעדריקט ווי RGB.
color_palette.members[].color_weightאָפּציאָנעל
טיפּnumber | null
סטאַנדאַרט0.5
0.05 – 1
וואָג צוגעטיילט דער קאָליר אין דער פּאַלעט.
color_palette.nameאָפּציאָנעל
טיפּenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
פּריסעט־אויסקלײַב פֿאַר דער קאָליר־פּאַלעט.
style_codesאָפּציאָנעל
טיפּstring[]
בילד־סטיל־קאָדן, צוגעשטעלט ווי העקסאַדעצימאַלע סטרינגס פֿון 8 אותיות; לאָזט אויס סײַ style_reference_images סײַ style ווען איר ניצט די ליסטע.
expand_promptאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
MagicPrompt באַניץ־באַשטימער פֿאַר בקשה־גענערירונג.
num_imagesאָפּציאָנעל num_outputs
טיפּinteger
סטאַנדאַרט1
1 – 8
צאָל בילדער צו שאַפֿן.
seedאָפּציאָנעל
טיפּinteger | null
זוימען־ווערט פֿאַר צופֿעליקער נומער־גענערירונג.
style_presetאָפּציאָנעל
טיפּenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 נאָךCOLORING_BOOK_ICOLORING_BOOK_IICUBISMDARK_AURADOODLEDOUBLE_EXPOSUREDRAMATIC_CINEMAEDITORIALEMOTIONAL_MINIMALETHEREAL_PARTYEXPIRED_FILMFLAT_ARTFLAT_VECTORFOREST_REVERIEGEO_MINIMALISTGLASS_PRISMGOLDEN_HOURGRAFFITI_IGRAFFITI_IIHALFTONE_PRINTHIGH_CONTRASTHIPPIE_ERAICONICJAPANDI_FUSIONJAZZYLONG_EXPOSUREMAGAZINE_EDITORIALMINIMAL_ILLUSTRATIONMIXED_MEDIAMONOCHROMENIGHTLIFEOIL_PAINTINGOLD_CARTOONSPAINT_GESTUREPOP_ARTRETRO_ETCHINGRIVIERA_POPSPOTLIGHT_80SSTYLIZED_REDSURREAL_COLLAGETRAVEL_POSTERVINTAGE_GEOVINTAGE_POSTERWATERCOLORWEIRDWOODBLOCK_PRINT
סטיל־פּרעסעט וואָס פירט די בילד־גענערירונג.
promptפארלאנגט
טיפּstring
פּראָמפּט וואָס באַשרײַבט דעם fill פֿאַר דער געמאסקירטער געגנט פֿונעם בילד.
image_urlפארלאנגט image
טיפּurl · image
גענערירונג־קוואַל צוגעשטעלט ווי אַ בילד־URL; סײַ ברייט סײַ הייך מוזן גענוי גלײַכן די קאָרעספּאָנדירנדיקע דימענסיעס פֿון דער מאַסקע.
mask_urlפארלאנגט mask
טיפּurl · image
Inpainting מאַסקע צוגעשטעלט דורך URL; סײַ ברייט סײַ הייך מוזן גענוי גלײַכן די קאָרעספּאָנדירנדיקע דימענסיעס פֿונעם אַרײַנגעבענעם בילד.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3/edit",
  "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": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "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
      }
    ],
    "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"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
images
array of object {url, content_type, file_name, file_size}
seed
integerזוימען־ווערט גענוצט פֿאַר צופֿעליקער נומער־גענערירונג.

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

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