Preskoči na vsebino

Ideogram V3 Character

Integracija

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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ta zahteva: 0,15 $ 150 API kreditov Zaženi na tej strani

Pridobi ključ API
Ideogram Urejanje slik Referenčni vnosi #character-consistency

Ustvarjanje z Ideogram V3, ki z uporabo referenčne slike ohrani doslednost lika

Ideogram · Slika

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno

Poziv, ki opisuje zapolnitev maskiranega območja slike.

•obvezno
Spustite datoteko ali

Referenčne slike lika v obliki JPEG, PNG ali WebP, s skupno omejitvijo 10 MB za vse reference lika. Trenutno je podprta 1 slika; dodatne slike se prezrejo.

rendering_speed privzeto BALANCED

Nastavitev hitrosti upodabljanja.

image_size privzeto square_hd

Ločljivost izhodne slike.

num_images privzeto 1

Število slik za ustvarjanje.

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

Določite neželeno vsebino slike; opisi v glavnem pozivu imajo prednost pred opisi v negativnem pozivu.

image_urls
Spustite datoteko ali

Referenčne slike sloga v obliki JPEG, PNG ali WebP. Njihova skupna velikost ne sme presegati 10 MB.

Spustite datoteko ali

Maske referenc lika v obliki JPEG, PNG ali WebP; skupna velikost vseh referenc lika ne sme presegati 10 MB. Trenutno se uporablja samo 1 maska, dodatne pa se prezrejo.

style privzeto AUTO

Vrsta sloga za generiranje; medsebojno izključuje style_codes.

Vrednost semena za generiranje naključnih števil.

Kode sloga slike, podane kot šestnajstiški nizi po 8 znakov; pri uporabi tega seznama izpustite style_reference_images in style.

Barvna paleta, uporabljena pri generiranju. Določite prednastavitev prek name ali izrecne šestnajstiške barve prek members, po želji z utežmi.

POST /run/ideogram/character?wait=20 cena → 0,15 $
# 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/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu Ideogram V3 Character

Ustvari slike lika iz `prompt` in reference v `reference_image_urls` (uporabi se samo 1 slika). Izbirne slogovne reference se dodajo v `image_urls`, za več nadzora pa so na voljo `style_codes`, `color_palette` in `reference_mask_urls`. `rendering_speed` je TURBO, BALANCED ali QUALITY, `num_images` pa je lahko največ 8.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
image_urlsneobvezno images
Vrstaurl[] · image
Referenčne slike sloga v obliki JPEG, PNG ali WebP. Njihova skupna velikost ne sme presegati 10 MB.
rendering_speedneobvezno
Vrstaenum
PrivzetoBALANCED
TURBOBALANCEDQUALITY
Nastavitev hitrosti upodabljanja.
color_paletteneobvezno
Vrstaobject
Barvna paleta, uporabljena pri generiranju. Določite prednastavitev prek name ali izrecne šestnajstiške barve prek members, po želji z utežmi.
color_palette.membersneobvezno
Vrstaobject[]
Seznam članov palete, ki določa njene barve.
color_palette.members[].rgbobvezno
Vrstaobject
Barva člana palete, izražena kot RGB.
color_palette.members[].color_weightneobvezno
Vrstanumber | null
Privzeto0.5
0,05 – 1
Utež, dodeljena tej barvi v paleti.
color_palette.nameneobvezno
Vrstaenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Izbira prednastavitve barvne palete.
style_codesneobvezno
Vrstastring[]
Kode sloga slike, podane kot šestnajstiški nizi po 8 znakov; pri uporabi tega seznama izpustite style_reference_images in style.
styleneobvezno
Vrstaenum
PrivzetoAUTO
AUTOREALISTICFICTION
Vrsta sloga za generiranje; medsebojno izključuje style_codes.
expand_promptneobvezno
Vrstaboolean
Privzetotrue
Preklop uporabe MagicPrompt pri ustvarjanju zahteve.
num_imagesneobvezno num_outputs
Vrstainteger
Privzeto1
1 – 8
Število slik za ustvarjanje.
seedneobvezno
Vrstainteger | null
Vrednost semena za generiranje naključnih števil.
promptobvezno
Vrstastring
Poziv, ki opisuje zapolnitev maskiranega območja slike.
image_sizeneobvezno
Vrstaobject
Privzetosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Ločljivost izhodne slike.
negative_promptneobvezno
Vrstastring
Privzeto
Določite neželeno vsebino slike; opisi v glavnem pozivu imajo prednost pred opisi v negativnem pozivu.
reference_image_urlsobvezno
Vrstaurl[] · image
Referenčne slike lika v obliki JPEG, PNG ali WebP, s skupno omejitvijo 10 MB za vse reference lika. Trenutno je podprta 1 slika; dodatne slike se prezrejo.
reference_mask_urlsneobvezno
Vrstaurl[] · image
Maske referenc lika v obliki JPEG, PNG ali WebP; skupna velikost vseh referenc lika ne sme presegati 10 MB. Trenutno se uporablja samo 1 maska, dodatne pa se prezrejo.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
images
array of object {url, content_type, file_name, file_size}
seed
integerVrednost semena za generiranje naključnih števil.

Več modelov: Urejanje slik

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/ideogram/character.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt