Pereiti prie turinio

Ideogram V3 Character

Integruoti

Modelio id ideogram/character
# 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?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",
    "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"

Ši užklausa: 0,15 $ 150 API kreditų · ≈ 15,70 ₽ Paleisti šiame puslapyje

Gauti API raktą
Ideogram Vaizdo redagavimas Nuorodų įvestys #character-consistency

Ideogram V3 generavimas, išlaikantis veikėjo nuoseklumą pagal pamatinį vaizdą

Ideogram · Vaizdas

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma

Kaukėtos vaizdo srities užpildymą aprašantis raginys.

•privaloma
Įmeskite failą arba

JPEG, PNG arba WebP formato personažų nuorodiniai vaizdai; bendras visų personažų nuorodų limitas – 10 MB. Šiuo metu palaikomas tik 1 vaizdas; papildomi vaizdai ignoruojami.

rendering_speed numatytoji BALANCED

Atvaizdavimo spartos nustatymas.

image_size numatytoji square_hd

Išvesties vaizdui naudojama raiška.

num_images numatytoji 1

Kuriamų vaizdų skaičius.

Išplėstiniai negative_prompt · images · reference_mask_urls · style · seed · expand_prompt · style_codes · color_palette
numatytoji

Nurodykite nepageidaujamą vaizdo turinį; pagrindinio raginio aprašymai turi pirmenybę prieš šiuos neigiamo raginio aprašymus.

image_urls
Įmeskite failą arba

JPEG, PNG arba WebP formato stiliaus nuorodiniai vaizdai. Bendras jų dydis negali viršyti 10 MB.

Įmeskite failą arba

JPEG, PNG arba WebP formato personažų nuorodų kaukės; bendras visų personažų nuorodų dydis negali viršyti 10 MB. Šiuo metu naudojama tik 1 kaukė, papildomos ignoruojamos.

style numatytoji AUTO

Generavimui naudojamas stiliaus tipas; nesuderinamas su style_codes.

Atsitiktinių skaičių generavimo pradžios reikšmė.

Vaizdo stiliaus kodai, pateikiami kaip 8 simbolių šešioliktainės eilutės; naudojant šį sąrašą, praleiskite ir style_reference_images, ir style.

Generuojant naudojama spalvų paletė. Nurodykite pavadinimu pasirinktą išankstinį nustatymą arba aiškias šešioliktaines spalvas per members, pasirinktinai įtraukdami svorius.

POST /run/ideogram/character?wait=20 kaina → 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?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",
    "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"

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Ideogram V3 Character

Generuoja veikėjo vaizdus pagal `prompt` ir pamatinį vaizdą iš `reference_image_urls` (naudojamas tik 1 vaizdas). Pasirinktiniai stiliaus pamatiniai vaizdai pateikiami per `image_urls`, o papildomai kontrolei naudojami `style_codes`, `color_palette` ir `reference_mask_urls`. `rendering_speed` gali būti TURBO, BALANCED arba QUALITY, o `num_images` – iki 8.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
image_urlsneprivalomas images
Tipasurl[] · image
JPEG, PNG arba WebP formato stiliaus nuorodiniai vaizdai. Bendras jų dydis negali viršyti 10 MB.
rendering_speedneprivalomas
Tipasenum
Numatytoji reikšmėBALANCED
TURBOBALANCEDQUALITY
Atvaizdavimo spartos nustatymas.
color_paletteneprivalomas
Tipasobject
Generuojant naudojama spalvų paletė. Nurodykite pavadinimu pasirinktą išankstinį nustatymą arba aiškias šešioliktaines spalvas per members, pasirinktinai įtraukdami svorius.
color_palette.membersneprivalomas
Tipasobject[]
Paletės narių sąrašas, apibrėžiantis paletės spalvas.
color_palette.members[].rgbprivaloma
Tipasobject
Paletės nario spalva, išreikšta RGB.
color_palette.members[].color_weightneprivalomas
Tipasnumber | null
Numatytoji reikšmė0.5
0,05 – 1
Šiai spalvai paletėje priskirtas svoris.
color_palette.nameneprivalomas
Tipasenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Spalvų paletės išankstinio nustatymo pasirinkimas.
style_codesneprivalomas
Tipasstring[]
Vaizdo stiliaus kodai, pateikiami kaip 8 simbolių šešioliktainės eilutės; naudojant šį sąrašą, praleiskite ir style_reference_images, ir style.
styleneprivalomas
Tipasenum
Numatytoji reikšmėAUTO
AUTOREALISTICFICTION
Generavimui naudojamas stiliaus tipas; nesuderinamas su style_codes.
expand_promptneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
MagicPrompt naudojimo užklausai generuoti jungiklis.
num_imagesneprivalomas num_outputs
Tipasinteger
Numatytoji reikšmė1
1 – 8
Kuriamų vaizdų skaičius.
seedneprivalomas
Tipasinteger | null
Atsitiktinių skaičių generavimo pradžios reikšmė.
promptprivaloma
Tipasstring
Kaukėtos vaizdo srities užpildymą aprašantis raginys.
image_sizeneprivalomas
Tipasobject
Numatytoji reikšmėsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Išvesties vaizdui naudojama raiška.
negative_promptneprivalomas
Tipasstring
Numatytoji reikšmė
Nurodykite nepageidaujamą vaizdo turinį; pagrindinio raginio aprašymai turi pirmenybę prieš šiuos neigiamo raginio aprašymus.
reference_image_urlsprivaloma
Tipasurl[] · image
JPEG, PNG arba WebP formato personažų nuorodiniai vaizdai; bendras visų personažų nuorodų limitas – 10 MB. Šiuo metu palaikomas tik 1 vaizdas; papildomi vaizdai ignoruojami.
reference_mask_urlsneprivalomas
Tipasurl[] · image
JPEG, PNG arba WebP formato personažų nuorodų kaukės; bendras visų personažų nuorodų dydis negali viršyti 10 MB. Šiuo metu naudojama tik 1 kaukė, papildomos ignoruojamos.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/character",
  "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",
    "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"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
images
array of object {url, content_type, file_name, file_size}
seed
integerAtsitiktinių skaičių generavimui naudojama pradžios reikšmė.

Daugiau modelių: Vaizdo redagavimas

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/ideogram/character.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt