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

Ideogram V3 Character Remix

אינטעגרירן

מאָדעל־id ideogram/character/remix
# 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/character/remix?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",
    "reference_image_urls": [
      "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.15⁩ 150 API־קרעדיטן · ≈ ⁨₽ 15.82⁩ לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Ideogram בילד־עדיטירונג רעפֿערענץ־אײַנגאַבעס #character-consistency

Ideogram V3 רעמיקס פון אַן אַרײַנגאַנגסבילד אין נײַע סטילן אָדער סצענעס, בשעת אַ רעפֿערענץ־כאַראַקטער ווערט אפגעהיטן

Ideogram · בילד

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

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

בויען אַ בעטן

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

•פארלאנגט

פּראָמפּט גענוצט צו פֿירן דעם בילד־רעמיקס.

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

URL פֿונעם בילד וואָס ווערט געמישט ווידער.

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

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

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

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

image_size סטאַנדאַרט square_hd

רעזאָלוציע צו נוצן פֿאַרן רעזולטאַט־בילד.

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

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

פֿאָרגעשריטן negative_prompt · images · reference_mask_urls · style · strength · seed · expand_prompt · style_codes · color_palette
סטאַנדאַרט

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

image_urls
לייגט אַרײַן אַ טעקע, אָדער

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

לייגט אַרײַן אַ טעקע, אָדער

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

style סטאַנדאַרט AUTO

סטיל־טיפּ גענוצט פֿאַר גענערירונג; קעגנזײַטיק אויסשליסנדיק מיט style_codes.

סטאַנדאַרט 0.8

השפּעה פֿונעם קוואַל־בילד אויף דעם רעמיקס.

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

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

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

POST /run/ideogram/character/remix?wait=20 פּרײַז → ⁨$ 0.15⁩
# 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/character/remix?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",
    "reference_image_urls": [
      "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 Character Remix

מישט `image_url` איבער מיט אַ `prompt`, בשעת דער כאַראַקטער פֿון `reference_image_urls` ווערט געהאַלטן (1 בילד ווערט גענוצט). `strength` (0.01-1, פעליק 0.8) קאָנטראָלירט דעם איינפֿלוס פון אַרײַנגאַנגסבילד. שטיצט `image_size`־פּרעסעץ, סטיל־רעפֿערענצן, `style` פון AUTO, REALISTIC אָדער FICTION, און ביז 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 ווען איר ניצט די ליסטע.
styleאָפּציאָנעל
טיפּenum
סטאַנדאַרטAUTO
AUTOREALISTICFICTION
סטיל־טיפּ גענוצט פֿאַר גענערירונג; קעגנזײַטיק אויסשליסנדיק מיט style_codes.
expand_promptאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
MagicPrompt באַניץ־באַשטימער פֿאַר בקשה־גענערירונג.
num_imagesאָפּציאָנעל num_outputs
טיפּinteger
סטאַנדאַרט1
1 – 8
צאָל בילדער צו שאַפֿן.
seedאָפּציאָנעל
טיפּinteger | null
זוימען־ווערט פֿאַר צופֿעליקער נומער־גענערירונג.
promptפארלאנגט
טיפּstring
פּראָמפּט גענוצט צו פֿירן דעם בילד־רעמיקס.
image_urlפארלאנגט image
טיפּurl · image
URL פֿונעם בילד וואָס ווערט געמישט ווידער.
strengthאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.8
0.01 – 1
השפּעה פֿונעם קוואַל־בילד אויף דעם רעמיקס.
image_sizeאָפּציאָנעל
טיפּobject
סטאַנדאַרטsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
רעזאָלוציע צו נוצן פֿאַרן רעזולטאַט־בילד.
negative_promptאָפּציאָנעל
טיפּstring
סטאַנדאַרט
ספּעציפֿיצירט אומגעוווּנטשטן בילד־אינהאַלט; די באַשרײַבונגען אינעם הויפּט־פּראָמפּט האָבן בילכערקייט איבער די נעגאַטיווע־פּראָמפּט־באַשרײַבונגען.
reference_image_urlsפארלאנגט
טיפּurl[] · image
כאַראַקטער־רעפֿערענץ־בילדער אין JPEG, PNG אָדער WebP פֿאָרמאַט, מיט אַ צונויפֿגעשטעלטער גרענעץ פֿון 10 MB פֿאַר אַלע כאַראַקטער־רעפֿערענצן. דערווייל איז געשטיצט בלויז 1 בילד; נאָך בילדער ווערן איגנאָרירט.
reference_mask_urlsאָפּציאָנעל
טיפּurl[] · image
כאַראַקטער־רעפֿערענץ־מאַסקס אין JPEG, PNG אָדער WebP פֿאָרמאַט; די גאַנצע גרייס פֿון אַלע כאַראַקטער־רעפֿערענצן טאָר נישט איבערגיין 10 MB. דערווייל ווערט גענוצט בלויז 1 מאַסקע; נאָך מאַסקס ווערן איגנאָרירט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/character/remix",
  "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": 150,
    "usd": "0.15",
    "charged": 150,
    "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",
    "reference_image_urls": [
      "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/character/remix.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt