Prijeđi na sadržaj

Ideogram V3 Character

Integriraj

ID modela 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"

Ovaj zahtjev: 0,15 $ 150 API kredita · ≈ 15,82 ₽ Pokreni na ovoj stranici

Nabavi API ključ
Ideogram Uređivanje slika Referentni ulazi #character-consistency

Generiranje uz Ideogram V3 koje održava dosljednost lika koristeći referentnu sliku

Ideogram · Slika

Vaš prvi rezultat bit će ovdje

Izradite zahtjev u nastavku i pokrenite ga svojim API ključem. Izlazi se kopiraju u našu pohranu i čuvaju zauvijek ili 7 dana besplatno.

Izradi zahtjev

Kontrole se generiraju iz sheme modela. Kôd i cijena ažuriraju se dok ih mijenjate.

•obavezno

Prompt koji opisuje ispunu maskiranog područja slike.

•obavezno
Ispustite datoteku ili

Referentne slike lika u formatima JPEG, PNG ili WebP, s ukupnim ograničenjem od 10 MB za sve reference lika. Trenutačno je podržana samo 1 slika; dodatne slike se zanemaruju.

rendering_speed zadano BALANCED

Postavka brzine renderiranja.

image_size zadano square_hd

Razlučivost koju treba koristiti za izlaznu sliku.

num_images zadano 1

Broj slika koje treba izraditi.

Napredno negative_prompt · images · reference_mask_urls · style · seed · expand_prompt · style_codes · color_palette
zadano

Navedite neželjeni sadržaj slike; opisi u glavnom promptu imaju prednost pred ovim opisima negativnog prompta.

image_urls
Ispustite datoteku ili

Referentne slike stila u formatima JPEG, PNG ili WebP. Njihova ukupna veličina ne smije premašiti 10 MB.

Ispustite datoteku ili

Maske referenci lika u formatima JPEG, PNG ili WebP; ukupna veličina svih referenci lika ne smije premašiti 10 MB. Trenutačno se koristi samo 1 maska, a dodatne se zanemaruju.

style zadano AUTO

Vrsta stila korištena za generiranje; međusobno isključiva sa style_codes.

Početna vrijednost za generiranje nasumičnih brojeva.

Kodovi stila slike, navedeni kao heksadecimalni nizovi od po 8 znakova; izostavite i style_reference_images i style kada koristite ovaj popis.

Paleta boja korištena tijekom generiranja. Navedite unaprijed definiranu paletu putem name ili izričite heksadecimalne boje putem members, uz mogućnost uključivanja težina.

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

Pokreni ovaj zahtjev

Vaš ključ ostaje u ovom pregledniku: šalje se samo Doitong API-ju i sprema u localStorage samo ako označite Zapamti. Nabavite API ključ

O modelu Ideogram V3 Character

Generira slike lika iz parametra `prompt` i reference u `reference_image_urls` (koristi se samo 1 slika). Neobavezne stilske reference dodaju se u `image_urls`, uz `style_codes`, `color_palette` i `reference_mask_urls` za veću kontrolu. `rendering_speed` može biti TURBO, BALANCED ili QUALITY, a `num_images` može biti do 8.

Parametri

Pošaljite kanonski naziv ili izvorni naziv, ne oba. Kanonski nazivi

NazivVrsta ZadanoDopušteno Opis
image_urlsneobavezno images
Vrstaurl[] · image
Referentne slike stila u formatima JPEG, PNG ili WebP. Njihova ukupna veličina ne smije premašiti 10 MB.
rendering_speedneobavezno
Vrstaenum
ZadanoBALANCED
TURBOBALANCEDQUALITY
Postavka brzine renderiranja.
color_paletteneobavezno
Vrstaobject
Paleta boja korištena tijekom generiranja. Navedite unaprijed definiranu paletu putem name ili izričite heksadecimalne boje putem members, uz mogućnost uključivanja težina.
color_palette.membersneobavezno
Vrstaobject[]
Popis članova palete koji definira boje palete.
color_palette.members[].rgbobavezno
Vrstaobject
Boja člana palete izražena kao RGB.
color_palette.members[].color_weightneobavezno
Vrstanumber | null
Zadano0.5
0,05 – 1
Težina dodijeljena ovoj boji unutar palete.
color_palette.nameneobavezno
Vrstaenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Odabir unaprijed definirane palete boja.
style_codesneobavezno
Vrstastring[]
Kodovi stila slike, navedeni kao heksadecimalni nizovi od po 8 znakova; izostavite i style_reference_images i style kada koristite ovaj popis.
styleneobavezno
Vrstaenum
ZadanoAUTO
AUTOREALISTICFICTION
Vrsta stila korištena za generiranje; međusobno isključiva sa style_codes.
expand_promptneobavezno
Vrstaboolean
Zadanotrue
Prekidač za upotrebu MagicPrompta pri generiranju zahtjeva.
num_imagesneobavezno num_outputs
Vrstainteger
Zadano1
1 – 8
Broj slika koje treba izraditi.
seedneobavezno
Vrstainteger | null
Početna vrijednost za generiranje nasumičnih brojeva.
promptobavezno
Vrstastring
Prompt koji opisuje ispunu maskiranog područja slike.
image_sizeneobavezno
Vrstaobject
Zadanosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Razlučivost koju treba koristiti za izlaznu sliku.
negative_promptneobavezno
Vrstastring
Zadano
Navedite neželjeni sadržaj slike; opisi u glavnom promptu imaju prednost pred ovim opisima negativnog prompta.
reference_image_urlsobavezno
Vrstaurl[] · image
Referentne slike lika u formatima JPEG, PNG ili WebP, s ukupnim ograničenjem od 10 MB za sve reference lika. Trenutačno je podržana samo 1 slika; dodatne slike se zanemaruju.
reference_mask_urlsneobavezno
Vrstaurl[] · image
Maske referenci lika u formatima JPEG, PNG ili WebP; ukupna veličina svih referenci lika ne smije premašiti 10 MB. Trenutačno se koristi samo 1 maska, a dodatne se zanemaruju.
obavezno Kanonski naziv, također prihvaćen

Parametri datoteka prihvaćaju javni https:// URL, data: URI do 10 MB ili file_url prenesene datoteke. Datoteke

Izlaz

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"
  }
}
Vaše datoteke, vaš izborSvaki outputs[].url kopija je u našoj pohrani: čuva se zauvijek (naplaćuje se po GB-mjesecu) ili 7 dana besplatno, prema postavci računa ili ?storage=.
Isti oblik na svakom modelutype, url, content_type, width, height i duration za slike, videozapise i zvuk. output je vlastiti objekt rezultata modela.
Polja izlaza
images
array of object {url, content_type, file_name, file_size}
seed
integerPočetna vrijednost korištena za generiranje nasumičnih brojeva.

Više modela: Uređivanje slika

Za AI agente: ova je stranica u Markdownu dostupna na https://doitong.com/hr/developers/models/ideogram/character.md. Svi modeli i vodiči: https://doitong.com/developers/llms.txt